Smart Valve Control hardening

⚠️ Upgrade Notes

• Upgrading from v2.x? v3.3.1 was the last version with v2.x migration support. If you go directly from v2.x to v4.0, the integration will fail to load and you'll need to remove and re-add it. To avoid this, upgrade to v3.3.1 first, then to v3.5.3, then to v4.0.
• Requires Home Assistant 2025.11+ (needed for the retry_after API quota feature).
• Works from v3.5.3 or any v4.0.0 beta — data migration is automatic.

What's New

This release hardens Smart Valve Control for real-world edge cases and fixes several issues found during beta testing.

Smart Valve Control Improvements

• No longer gets stuck when your Tado schedules are all OFF — If you use HA automations instead of Tado schedules, the controller now recovers when your automation sets a new temperature or resumes the schedule
• Cleans up stale overrides after HA crash — If HA lost power while the controller was active, the zone could be stuck at the wrong temperature. Now cleaned up automatically on restart
• Warns about non-zero TRV offsets — If your TRV has a temperature offset from a previous automation, the controller tells you to reset it to avoid double compensation
• Logs what it's doing — State changes and temperature writes now appear in your normal logs without needing debug mode
• Easier setup — Selecting an external sensor no longer requires toggling a separate switch first

Bug Fixes

• Fixed bridge sensors showing "unavailable" after HA restart
• Fixed translated placeholder names in 6 language files causing startup errors on non-English HA installations

Other Improvements

• Device and bridge serial numbers are now masked in logs to prevent accidental credential exposure

How to Update

HACS → Tado CE → ⋮ → Redownload → tick "Need a different version?" → select v4.0.0-beta.10 → Restart HA

Contributors

Thanks to @simonotter for extensive Smart Valve Control testing across multiple iterations, @wrowlands3 for flagging the all-OFF schedule scenario, and @driagi for the Italian debug log that uncovered the translation placeholder bug and the log masking suggestion.

Full changelog: https://github.com/hiall-fyi/tado_ce/blob/main/CHANGELOG.md