Documented services examples

README.md

@@ -89,6 +89,7 @@ Gear Sensors
 Disabled by default:
 
 ```text
+Badges
 Consumed KiloCalories
 Remaining KiloCalories
 Net Remaining KiloCalories
@@ -151,20 +152,20 @@ description: ""
 trigger:
   - platform: state
     entity_id:
-      - sensor.my_weight
+      - sensor.weight
 condition:
   - condition: and
     conditions:
       - condition: numeric_state
-        entity_id: sensor.my_weight
+        entity_id: sensor.weight
         above: 75
       - condition: numeric_state
-        entity_id: sensor.my_weight
+        entity_id: sensor.weight
         below: 88
 action:
   - service: garmin_connect.add_body_composition
     data:
-      entity_id: sensor.garmin_connect_weight
+      entity_id: sensor.weight
       weight: "{{trigger.to_state.state}}"
       timestamp: "{{ as_timestamp(now())  | timestamp_local}}"
       bmi: >-
@@ -172,6 +173,46 @@ action:
         }}
 mode: single
 ```
+
+### Examples on how to test services from HA GUI
+
+#### Add Body Composition
+
+```
+action: garmin_connect.add_body_composition
+data:
+  entity_id: sensor.weight
+  weight: 87
+  bmi: 25.5
+  bone_mass: 4.8
+  ...
+```
+
+NOTE: You need to enable Weight entity
+
+#### Set Active Gear
+
+```
+action: garmin_connect.set_active_gear
+data:
+  entity_id: sensor.adidas
+  activity_type: running
+  setting: set as default
+```
+
+#### Add Blood Pressure
+
+```
+action: garmin_connect.add_blood_pressure
+data:
+  entity_id: sensor.min_heart_rate
+  systolic: 120
+  diastolic: 80
+  pulse: 60
+  timestamp: 2025-1-21T07:34:00.000Z
+  notes: Measured with Beurer BC54
+```
+
 ## Debugging
 
 Add the relevant lines below to the `configuration.yaml`:

custom_components/garmin_connect/const.py

@@ -23,6 +23,19 @@ DAY_TO_NUMBER = {
     "Su": 7,
 }
 
+LEVEL_POINTS = {
+    1: 0,
+    2: 20,
+    3: 60,
+    4: 140,
+    5: 300,
+    6: 620,
+    7: 1260,
+    8: 2540,
+    9: 5100,
+    10: 10220,
+}
+
 GARMIN_ENTITY_LIST = {
     "totalSteps": ["Total Steps", "steps", "mdi:walk", None, SensorStateClass.TOTAL, True],
     "dailyStepGoal": ["Daily Step Goal", "steps", "mdi:walk", None, SensorStateClass.TOTAL, True],

custom_components/garmin_connect/services.yaml

@@ -2,6 +2,14 @@ set_active_gear:
   name: Set active gear for activity
   description: Set active gear for activity.
   fields:
+    entity_id:
+      name: entity
+      description: entity
+      required: true
+      selector:
+        entity:
+          integration: garmin_connect
+          device_class: garmin_gear
     activity_type:
       required: true
       name: activity type
@@ -28,6 +36,11 @@ set_active_gear:
             - set this as default, unset others
             - set as default
             - unset default
+
+add_body_composition:
+  name: Adds updated body composition metrics
+  description: Adds updated body composition metrics.
+  fields:
     entity_id:
       name: entity
       description: entity
@@ -35,12 +48,7 @@ set_active_gear:
       selector:
         entity:
           integration: garmin_connect
-          device_class: garmin_gear
-
-add_body_composition:
-  name: Adds updated body composition metrics
-  description: Adds updated body composition metrics.
-  fields:
+          device_class: weight
     weight:
       required: true
       name: Weight
@@ -106,14 +114,6 @@ add_body_composition:
       name: Visceral Fat Rating
       description: Visceral Fat Rating
       example: 10
-    entity_id:
-      name: entity
-      description: entity
-      required: true
-      selector:
-        entity:
-          integration: garmin_connect
-          device_class: weight
 
 add_blood_pressure:
   name: Adds updated blood pressure metrics
@@ -126,7 +126,7 @@ add_blood_pressure:
       selector:
         entity:
           integration: garmin_connect
-          device_class: weight
+          device_class: min_heart_rate
     systolic:
       required: true
       name: Systolic