Skip to content

v3.2.0: HA 2025.12 Features, Circuit Breaker, Unique ID Fix

Choose a tag to compare

@moag1000 moag1000 released this 05 Jan 19:15

⚠️ 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
  • KKTRateLimitError Exception mit retry_after Parameter
  • UpdateFailed wird mit retry_after fü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.UNREACHABLE Zustand

Erweiterte Diagnostics

  • DPS-Wert-Diagnostics mit sanitisierten Werten
  • Error History Tracking (letzte 50 Fehler)
  • _record_error() Methode im Coordinator

🔧 Changed

  • services.yaml: Verwendet jetzt device und config_entry Selectors 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 KKTRateLimitError als auch TuyaRateLimitError
  • hacs.json: Minimum HA Version 2025.12.0

🐛 Fixed

  • Unique ID Kollisionen bei Zone-Entities mit gleichem Namen aber verschiedenen DPs
  • TuyaRateLimitError Import in hybrid_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