v4.0.0-beta.2 — Real-Time HomeKit Updates

[hiall-fyi]

Pre-release build. See Discussion #219 for setup instructions and feedback.

⚠️ Upgrade Notes

Upgrading from beta.1? Just update through HACS and restart — no config changes needed.

Upgrading from v3.x? Make sure you're on v3.5.3 first, then upgrade to beta.2. Direct v2.x → v4.0 upgrades are not supported — upgrade to v3.3.1 first if you're still on v2.x.

⚠️ Minimum Home Assistant Version

Tado CE requires Home Assistant 2025.11 or later for smarter rate limit handling. Older HA versions will work but fall back to a fixed 15-minute retry interval after quota exhaustion.

What's New

• Real-time HomeKit data on your dashboard (Discussion #219 - @jeverley, @ChrisMarriott38) — Temperature and humidity from the HomeKit bridge now appear on your dashboard within 2 seconds. Previously they only updated at the polling interval, producing the same step pattern as cloud-only mode.
• HomeKit writes verified against Tado's servers — After every local write, the integration checks that Tado's servers actually received the change. If they didn't, future writes switch to the cloud API until the local path recovers.
• More reliable HomeKit savings counters — Counters now use the API quota reset as a single source of truth and survive HA restarts.
• Smarter API error handling — HTTP 404 on DELETE treated as success, 422 logged with response body, 429 reads the Retry-After header, 5xx retried with backoff on idempotent methods, failed state restores fall back to resuming the schedule.

Bug Fixes

• Fixed heating controls getting permanently stuck after a failed HomeKit write
• Fixed repeated commands being silently ignored when optimistic state was unconfirmed
• Fixed climate entity not updating after service calls like set_open_window_mode and restore_previous_state (Discussion #219 - @jeverley)
• Fixed entity attributes showing blank after writes in HomeKit mode
• Fixed background tasks and event subscriptions not being cleaned up on integration reload

How to Install

1. In HACS, open Tado CE
2. Tap the overflow menu (⋮) → Redownload → tick "Need a different version?"
3. Select v4.0.0-beta.2
4. Restart HA

Contributors

Thanks to @jeverley for catching the service refresh gap and the overnight polling step pattern, and @ChrisMarriott38 for confirming the same issue with humidity data and providing before/after graphs!

---

This discussion was created from the release Real-Time HomeKit Updates.