Skip to content

Release 3.0.0

Choose a tag to compare

View all tags
@cyberjunky cyberjunky released this 10 Apr 14:53
3.0.0
ac34ab7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

3.0.0 — Complete Rewrite

This is a major version release. The integration has been completely rewritten from the ground up using the new ha-garmin library and is now structured for HA Core readiness. (who knows)

⚠️ Breaking change: This version may not be 100% compatible with previous installed configurations. You must re-authenticate the integration after upgrading. And possibly some old sensors need to be manually removed, also services may have a slightly different syntax. So check your automations and dashboards.

What's New

Architecture

  • Full rewrite using the new ha-garmin library (replaces python-garminconnect)
  • Multiple data update coordinators — option to implement disabling of entity groups later to reduce unnecessary API calls
  • Token-based authentication with automatic token refresh
  • MFA support in config flow and reconfigure flow

New Sensors

  • VO2 Max — most recent VO2 Max value (mL/(kg·min))
  • Next Alarm — next scheduled watch alarm (timestamp)
  • Blood Pressure Category — human-readable BP category
  • Blood Pressure Measurement Time — local timestamp of most recent BP reading
  • Morning Training Readiness — readiness score and contributing factors
  • Training Status — current training status label
  • Endurance Score — aerobic endurance score
  • Hill Score — hill climbing score
  • Lactate Threshold HR and Speed
  • HRV — heart rate variability status and weekly average
  • Weekly Steps — 7-day step totals
  • Body Battery — with dynamic feedback events
  • Menstrual cycle sensors (disabled by default)
  • Gear sensors — dynamically created per piece of gear with usage stats

New Services / Actions

  • garmin_connect.add_hydration — log hydration intake (mL) with optional timestamp
  • garmin_connect.add_body_composition — log weight and body fat
  • garmin_connect.set_blood_pressure — log blood pressure reading
  • garmin_connect.create_activity — create a manual activity
  • garmin_connect.upload_activity — upload a .fit / .gpx file
  • garmin_connect.add_gear_to_activity — link gear to an activity

Map Card

  • Built-in Lovelace card showing last activity route using Leaflet (bundled locally)

Bug Fixes

  • Fix crash when gear item has no displayName or gearName
  • Fix null-value crashes in training and activity sensor lambdas
  • Fix 429 rate-limit errors not surfacing correctly in config flow
  • Fix MFA handling during reconfigure flow
  • Fix network errors (DNS failures, timeouts) no longer logged as "Unexpected error"
  • Fix VO2 Max showing as unknown on some devices (fallback to nested trainingStatus field)
  • Fix nextAlarm crash when alarm value is not a valid ISO datetime string
  • Fix body composition sensors showing 30-day averages instead of most recent measurement
  • And many others, not logged

Dependencies

  • Requires HACS 2.0.0+
Assets 2
Loading