-
Notifications
You must be signed in to change notification settings - Fork 0
Sensors
Every sensor exposed by the integration. All live under one Suunto device. The Source column tells you which coordinator updates it - Live (your "Live data interval", default 15 min) or History (your "History interval", default 60 min). See Configuration for the intervals and Derived Metrics for the maths behind the computed ones.
Entity IDs: Home Assistant builds
entity_idfrom your device name + the sensor name. If your device is namedSuunto, the readiness sensor issensor.suunto_readiness; if you renamed the device, the prefix changes (the unique IDs are stable, so renaming the device doesn't break automations that useentity_idonly if you update them). Examples below use thesensor.suunto_...prefix.
unknownvalues are normal for some sensors - depending on your watch model and what has synced. E.g. light/REM sleep, SpO₂ or HRV may be absent. See Troubleshooting & FAQ.
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Sleep duration | sensor.suunto_sleep_duration |
h | Total of all fragments of the night. |
| Deep sleep | sensor.suunto_sleep_deep |
min | |
| Light sleep | sensor.suunto_sleep_light |
min | May be unknown on some watches. |
| REM sleep | sensor.suunto_sleep_rem |
min | May be unknown on some watches. |
| Sleep average heart rate | sensor.suunto_sleep_avg_hr |
bpm | |
| Sleep minimum heart rate | sensor.suunto_sleep_min_hr |
bpm | Used as the resting-HR signal. |
| Sleep quality | sensor.suunto_sleep_quality |
% | |
| Sleep blood oxygen (SpO₂) | sensor.suunto_sleep_spo2 |
% | May be unknown. |
| Sleep HRV | sensor.suunto_sleep_hrv |
ms | Feeds the HRV baseline. |
| Sleep start | sensor.suunto_sleep_time |
timestamp | When the night began. |
| Wake-up time | sensor.suunto_wake_time |
timestamp | End of the last sleep fragment (derived - the API has no explicit wake field). |
A night is returned by the API in multiple fragments (one per wake). The integration groups them with a noon-to-noon key and sums durations / duration-weights the rates, matching what the Suunto app shows. See Data & Units.
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Recovery balance | sensor.suunto_recovery_balance |
% | Suunto's resources/balance metric. |
| Stress state | sensor.suunto_stress_state |
- | Enum-style integer from the watch. |
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Current heart rate | sensor.suunto_current_hr |
bpm | Latest 24/7 sample (steps to the newest synced value). |
| Daily steps | sensor.suunto_daily_steps |
steps | Today's sum; total_increasing. |
| Daily energy | sensor.suunto_daily_energy |
kcal | Today's sum; total_increasing. |
The live
current_hrsensor only records the latest value at poll time - it cannot backfill an intraday curve. For a gap-free HR curve with workout peaks, use thesuunto_app:hrstatistic (see Long-term Statistics).
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Last activity | sensor.suunto_last_activity |
- | Activity name (see Activity Types). |
| Last workout start | sensor.suunto_last_workout_start |
timestamp | |
| Last workout location | sensor.suunto_last_workout_location |
- | State = "lat, lon"; the latitude/longitude attributes plot it on a Map card. unknown for indoor workouts with no GPS. See Dashboard Examples. |
| Last workout distance | sensor.suunto_last_distance |
m | |
| Last workout duration | sensor.suunto_last_duration |
min | |
| Last workout ascent | sensor.suunto_last_ascent |
m | |
| Last workout descent | sensor.suunto_last_descent |
m | |
| Last workout ascent time | sensor.suunto_last_ascent_time |
min | Time spent climbing. |
| Last workout descent time | sensor.suunto_last_descent_time |
min | Time spent descending. |
| Last workout min altitude | sensor.suunto_last_min_altitude |
m |
unknown indoors - no barometer reading. |
| Last workout max altitude | sensor.suunto_last_max_altitude |
m |
unknown indoors - no barometer reading. |
| Workout recovery time | sensor.suunto_recovery_time |
h | Suunto's recommended recovery. |
| Recovered at | sensor.suunto_recovery_until |
timestamp | When the recovery countdown ends (workout end + recovery time). |
| Last workout average heart rate | sensor.suunto_last_avg_hr |
bpm | |
| Last workout max heart rate | sensor.suunto_last_max_hr |
bpm | |
| Last workout average speed | sensor.suunto_last_avg_speed |
km/h | |
| Last workout average pace | sensor.suunto_last_avg_pace |
min/km | |
| Last workout cadence | sensor.suunto_last_cadence |
rpm | Unit is correct for cycling; for running it may read as cycle-rpm/spm depending on the watch. |
| Last workout training stress (TSS) | sensor.suunto_last_tss |
- | Drives the training-load model. |
| Peak Training Effect (PTE) | sensor.suunto_last_pte |
- | Suunto's own 1..5 rating of the session's impact - measured by the watch, not derived here. Also shown in the workouts calendar. |
| Time in HR zone 1...5 |
sensor.suunto_last_zone1 ... _zone5
|
min | Five sensors. |
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| % of max HR | sensor.suunto_last_pct_hrmax |
% | avg HR / user max HR. |
| Calories per km | sensor.suunto_last_cal_per_km |
kcal/km | |
| Ascent rate | sensor.suunto_last_ascent_rate |
m/h | |
| Stride length | sensor.suunto_last_stride |
m | Only for foot-based activities (empty for cycling, where cadence is pedal RPM). See Activity Types. |
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| VO2max | sensor.suunto_vo2max |
ml/kg/min | As measured by the watch. |
| Estimated VO2max | sensor.suunto_estimated_vo2max |
ml/kg/min | The watch's own estimate. |
| Fitness age | sensor.suunto_fitness_age |
years |
Suunto derives all three from runs and walks only - they are always null on a ride. Each sensor therefore holds its most recent non-null reading from the whole fetched history, and carries
measured_at/measured_fromattributes so you can see how old it is. On a cycling-heavy account the value can legitimately be months old.
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Lifetime distance | sensor.suunto_lifetime_distance |
km |
total_increasing. |
| Lifetime training time | sensor.suunto_lifetime_time |
h |
total_increasing. |
| Lifetime energy | sensor.suunto_lifetime_energy |
kcal |
total_increasing. |
| Lifetime workouts | sensor.suunto_lifetime_workouts |
workouts |
total_increasing. |
| Lifetime active days | sensor.suunto_lifetime_days |
d |
total_increasing. |
| Lifetime by activity | sensor.suunto_lifetime_by_activity |
- | State = number of sports; the per-sport totals (distance/time/count/energy) ride in the activities attribute. See Dashboard Examples. |
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Distance (7 days) | sensor.suunto_weekly_distance |
km | Rolling 7-day workout distance. |
| Training time (7 days) | sensor.suunto_weekly_time |
h | Rolling 7-day workout time. |
| Workouts (7 days) | sensor.suunto_workouts_7d |
workouts | |
| Workouts (30 days) | sensor.suunto_workouts_30d |
workouts | Explicitly filtered to 30 days. |
| Recent workouts | sensor.suunto_workouts_recent |
workouts | State = count; the last 15 sessions ride in the workouts attribute for a table card. See Workouts Calendar & Recent. |
| Sensor | Entity (example) | Notes |
|---|---|---|
| Fitness (CTL) | sensor.suunto_fitness_ctl |
Chronic Training Load (42-day EWMA of TSS). |
| Fatigue (ATL) | sensor.suunto_fatigue_atl |
Acute Training Load (7-day EWMA of TSS). |
| Form (TSB) | sensor.suunto_form_tsb |
CTL - ATL. Positive = fresh, negative = fatigued. |
| Acute:chronic load ratio (ACWR) | sensor.suunto_acwr |
Safe zone ~0.8-1.3. |
Full formulas in Derived Metrics.
| Sensor | Entity (example) | Unit | Notes |
|---|---|---|---|
| Readiness | sensor.suunto_readiness |
% (0-100) | Heuristic blend of sleep, HRV, resting HR, recovery balance. Not an official Suunto metric. |
| HRV baseline | sensor.suunto_hrv_baseline |
ms | Mean over the sleep-night HRV series. |
| HRV status | sensor.suunto_hrv_status |
enum |
low / balanced / high vs +/-1 SD. |
| Resting heart rate | sensor.suunto_resting_hr |
bpm | |
| Resting heart rate baseline | sensor.suunto_resting_hr_baseline |
bpm | Mean over the night series. |
There is also a calendar entity (every past workout as an event). It is on the same device but is not in the sensor count. See Workouts Calendar & Recent.
The suunto_app:* long-term statistics are external statistics, not entities - they won't show up in the entity list and don't add to the sensor count. View them in a Statistics Graph card. See Long-term Statistics.
ha-suunto - Unofficial Suunto integration for Home Assistant - Not affiliated with Suunto / Amer Sports / Sports-Tracker - Report an issue
Getting started
Reference
Build with it
Under the hood
Help