Skip to content

Sensors

Michal Zaniewicz edited this page Jul 22, 2026 · 3 revisions

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_id from your device name + the sensor name. If your device is named Suunto, the readiness sensor is sensor.suunto_readiness; if you renamed the device, the prefix changes (the unique IDs are stable, so renaming the device doesn't break automations that use entity_id only if you update them). Examples below use the sensor.suunto_... prefix.

unknown values 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.


Sleep (Source: History)

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.


Recovery (Source: History)

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.

Daily activity (Source: Live)

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_hr sensor only records the latest value at poll time - it cannot backfill an intraday curve. For a gap-free HR curve with workout peaks, use the suunto_app:hr statistic (see Long-term Statistics).


Last workout (Source: History)

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.

Per-workout derived (Source: History)

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.

Fitness (Source: History)

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_from attributes so you can see how old it is. On a cycling-heavy account the value can legitimately be months old.


Lifetime totals (Source: History)

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.

Weekly volume & counts (Source: History)

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.

Training load (derived) (Source: History)

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.


Recovery baselines & readiness (derived) (Source: History)

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.

Not a sensor: the workouts calendar

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.

Not sensors: long-term statistics

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.

Clone this wiki locally