WiesiDeluxe/ha-harvia-sauna v2.6.0

v2.6.0 — Light Sync, Cooldown Sessions & Door-Sensor Groundwork

on GitHub

⚠️ Superseded by v2.6.1 — this release contains UTF-8 mojibake (inherited from v2.5.0) in entity names and translations. Please update.

✨ New Features

Options Flow

Open Settings → Devices & Services → Harvia Sauna → Configure to access the new options.

Panel ↔ HA Light Sync

Link HA light entities (e.g. Hue strips) to the light button on the Harvia panel — even if no light is physically wired to the power unit. Three modes: disabled, panel → HA only, or bidirectional with loop protection (context tracking + echo consumption), any-on aggregation across multiple lights, and a 1 s debounce towards the cloud API.

Cooldown Session End Mode

For stone-heavy heaters (e.g. Legend with 100 kg of stones) the sauna stays hot long after the heater turns off. With session end behavior = cooldown, the session keeps running until the temperature drops below the target temperature (frozen at heater-off) minus a configurable hysteresis (default 2 °C). Optionally use an external HA temperature sensor as the reference and as the session max-temp source. Safety nets: external-sensor fallback to the internal sensor, and a maximum cooldown duration (default 180 min). Re-heating during cooldown continues the same session.

🐛 Fenix Fixes

• Merged @moritzj29's fix (a3f792d): signalStrength → WiFi RSSI, nested heater.on → active state (refs #1)
• The door binary sensor now shows unknown instead of a misleading "closed" until door data is actually received (refs #1, #3)
• Defensive door field candidate mapping (doorOpen/door/doorState/doorSensor + inverted doorSafetyState/safetyState) in both state and telemetry normalizers, with debug logging of the matched field

🔍 Diagnostics

The diagnostics download now includes the raw API payloads (last state, last telemetry, last 10 WebSocket messages) and the configured options. For door-sensor debugging (#1, #3), a single diagnostics download is now sufficient — no more debug logger setup needed.

Upgrade Notes

No breaking changes. Existing installations keep the classic behavior (session ends at heater-off, no lights linked) until options are changed.