v3.2.0: HA 2025.12 Features, Circuit Breaker, Unique ID Fix
⚠️ BREAKING CHANGE - Unique ID Format
Entity Unique IDs haben jetzt das DP (Data Point) eingeschlossen, um Kollisionen zu vermeiden:
- Alt:
{entry_id}_{platform}_{name} - Neu:
{entry_id}_{platform}_dp{dp}_{name}
Hinweis: Bestehende Entities werden nach dem Update möglicherweise dupliziert angezeigt. Die alten Entities können manuell entfernt werden.
🆕 Added
Home Assistant 2025.12+ Features
- retry_after Propagation: Rate-Limiting Support mit automatischer Retry-Verzögerung
KKTRateLimitErrorException mitretry_afterParameterUpdateFailedwird mitretry_afterfür HA 2025.12+ Coordinators propagiert
Circuit Breaker mit Exponential Backoff
- Exponential Backoff mit Jitter:
base * 2^attempts ± 25% - Circuit Breaker nach 10 fehlgeschlagenen Versuchen
POLL_INTERVAL_UNREACHABLE(300s) für den UNREACHABLE-Zustand- Neuer
DeviceState.UNREACHABLEZustand
Erweiterte Diagnostics
- DPS-Wert-Diagnostics mit sanitisierten Werten
- Error History Tracking (letzte 50 Fehler)
_record_error()Methode im Coordinator
🔧 Changed
- services.yaml: Verwendet jetzt
deviceundconfig_entrySelectors statt Text - base_entity.py: Unique ID enthält jetzt immer die DP-ID
- coordinator.py: Vollständige Circuit Breaker Implementation
- hybrid_coordinator.py: Fängt sowohl
KKTRateLimitErrorals auchTuyaRateLimitError - hacs.json: Minimum HA Version 2025.12.0
🐛 Fixed
- Unique ID Kollisionen bei Zone-Entities mit gleichem Namen aber verschiedenen DPs
TuyaRateLimitErrorImport inhybrid_coordinator.py- Rate Limit Chain von API → Coordinator → HA
📋 Requirements
- Home Assistant: 2025.12.0 oder höher
- HACS: Aktuelle Version
Vollständige Änderungen: CHANGELOG.md