v4.7.2 — Bessere Fehlerdiagnose, Service-API für Cache + Firmware

Hotfix für 4.7.1

Auto-Cache-Refresh entfernt

Die in 4.7.1 eingebaute Auto-Cache-Refresh-Logik war destruktiv: Manager.update_device_cache() macht intern device_map.clear() BEVOR es neu fetcht. Wenn re-fetch fehlschlägt (Network/Auth/Rate-Limit), bleibt cache leer und alle anderen Operations brechen — inkl. MQTT-Push und nachfolgende Send-Commands.

Cache-Refresh ist jetzt nur noch manueller Service (siehe unten).

Bessere Fehlerdiagnose

Tuya-Error-Code-Decode

Statt nacktem network error:(2008) 2008 jetzt:

smartlife: network error:(2008) 2008 | meaning: device offline OR command code not in device.function (most common: stale spec) | attempted code='RGB' for DP 101 | WARNING: 'RGB' not in device's known codes — device accepts: switch_led, work_mode, scene_data

Decoded: 1004 (signature invalid), 1010 (token invalid), 1100 (param missing), 1106 (permission denied), 1109 (param value invalid), 2001 (device not found), 2008 (offline / unknown code), 2009 (hardware error), 28841105 (no permission).

Reicher Send-Fail-Context

Bei jeder SmartLife-Send-Failure zeigt die WARNING jetzt direkt:

• Welcher Code für welche DP versucht wurde
• Liste der echten Codes aus device.local_strategy
• Ob unser versuchter Code überhaupt in der Cloud-Spec ist

→ 1-Klick-Diagnose ohne Diagnostics-Download.

Neue Services

kkt_kolbe.refresh_smartlife_cache

Manuell den SmartLife-SDK-Cache refreshen (z.B. nach Firmware-Update). Feuert kkt_kolbe_smartlife_cache_refreshed Event.

Warnung: destruktiv — siehe oben. Nur nutzen wenn Send-Commands wegen stale spec scheitern.

kkt_kolbe.get_firmware_info

Firmware-Version + Update-Verfügbarkeit beim Tuya-Cloud-Endpoint abfragen. Feuert kkt_kolbe_firmware_info Event.

Hinweis: SmartLife-Tokens haben oft keinen IoT-Platform-Scope für diesen Endpoint. Wenn so, sagt das Event available: false und verweist auf die SmartLife/Tuya-App (Gerät → ⋮ → Firmware-Update).

Optional: device_id Parameter um nur ein Gerät zu prüfen.

Tests

239/239 passing.

Upgrade

HACS → Updates → KKT Kolbe → Update → Restart Home Assistant