Optionale Einstellungen (Experimentelle Funktionen)¶

Übersicht¶

Optionale Einstellungen sind Feature-Flags, mit denen neue, experimentelle Implementierungen in der Homematic(IP) Local Integration getestet werden können. Diese Einstellungen werden über die Home Assistant Integrationsoptionen konfiguriert.

Wichtig: Dies sind experimentelle Funktionen. Sie sind standardmäßig nicht aktiviert und sollten nur eingeschaltet werden, wenn die Bereitschaft besteht, Feedback zu geben und mögliche Instabilität in Kauf zu nehmen.

Aktueller Status: Alle experimentellen Funktionen haben umfassende Unit- und Integrationstests bestanden. Sie wurden zudem von Entwicklern mit realer Hardware (CCU3, OpenCCU) getestet. Der nächste Schritt sind Feldtests durch Benutzer mit unterschiedlichen Setups, um die Kompatibilität über alle Umgebungen hinweg vor der allgemeinen Veröffentlichung sicherzustellen.

Warum gibt es diese Einstellungen?¶

Die Herausforderung¶

Die Homematic(IP) Local Integration unterstützt eine Vielzahl von Backend-Systemen:

• CCU3/CCU2 - Originale eQ-3 Homematic-Zentralen
• OpenCCU - Community-basierte CCU für Raspberry Pi und andere Plattformen
• Homegear - Open-Source Homematic-Backend
• CCU-Jack - JSON-RPC-Bridge für CCU
• debmatic - Homematic auf Debian-basierten Systemen

Jedes dieser Systeme weist subtile Verhaltensunterschiede auf. Wenn neue, verbesserte Implementierungen von Kernkomponenten entwickelt werden, kann der bestehende Code nicht einfach über Nacht ersetzt werden - dies würde riskieren, Systeme für Tausende von Benutzern zu beeinträchtigen.

Die Lösung: Opt-In-Tests¶

Anstatt neuen Code für alle zu erzwingen, werden Feature-Flags verwendet:

1. Eigene Entscheidung, ob die neue Implementierung ausprobiert wird
2. Alter und neuer Code existieren nebeneinander
3. Einfaches Zurücksetzen - die Einstellung einfach deaktivieren, wenn etwas schiefgeht
4. Das Feedback hilft, Probleme vor der allgemeinen Veröffentlichung zu identifizieren

Dieser Ansatz ermöglicht es, neue Architekturen gründlich in realen Umgebungen zu testen, bevor sie für alle zum Standard werden.

Zugriff auf optionale Einstellungen¶

Um experimentelle Funktionen zu aktivieren oder zu deaktivieren:

1. Einstellungen -> Geräte & Dienste öffnen
2. Homematic(IP) Local suchen und anklicken
3. Auf Konfigurieren klicken
4. Zur Konfigurationsseite Erweitert navigieren
5. Den Abschnitt Optionale Einstellungen suchen
6. Die gewünschten Einstellungen aktivieren
7. Home Assistant neu starten, damit die Änderungen wirksam werden

Verfügbare Einstellungen¶

Entwickler-/Debugging-Einstellungen¶

Die folgenden Einstellungen sind nicht für normale Benutzer gedacht. Sie dienen ausschließlich zu Debugging-Zwecken und sollten nur aktiviert werden, wenn ein Entwickler dies zur Diagnose eines Problems ausdrücklich anfordert.

Diese Einstellungen nicht aktivieren, es sei denn, ein Entwickler fordert dazu auf. Sie erzeugen zusätzliche Daten, können die Leistung beeinträchtigen und bieten im Normalbetrieb keinen Vorteil.

Wer sollte diese Einstellungen verwenden?¶

Feedback geben¶

Beim Testen einer experimentellen Funktion ist das Feedback unschätzbar wertvoll. Folgende Informationen sind am hilfreichsten:

Warum sind Diagnosen und Protokolle so wichtig? - Detaillierte Erklärung, welche Daten benötigt werden und warum.

Was funktioniert hat¶

• "Interface Client funktioniert einwandfrei mit OpenCCU 3.x"

Was nicht funktioniert hat¶

Bitte Folgendes angeben:

1. Welche Einstellung aktiviert wurde
2. Der Backend-Typ (CCU3, OpenCCU, Homegear usw.)
3. Was passiert ist (Fehlermeldungen, unerwartetes Verhalten)
4. Home Assistant-Protokolle mit aktivierter Debug-Protokollierung (siehe unten)

Debug-Protokollierung aktivieren¶

Option 1: Über die Home Assistant UI

1. Einstellungen -> Geräte & Dienste öffnen
2. Homematic(IP) Local suchen und anklicken
3. Auf Debug-Protokollierung aktivieren klicken
4. Das Problem reproduzieren
5. Auf Debug-Protokollierung deaktivieren klicken - die Protokolldatei wird automatisch heruntergeladen

Option 2: Über configuration.yaml

logger:
  logs:
    aiohomematic: debug

Nach dem Hinzufügen Home Assistant neu starten und die Protokolle unter Einstellungen -> System -> Protokolle prüfen.

Wo melden¶

• GitHub Issues: https://github.com/sukramj/aiohomematic/issues
• Beim Melden den Tag experimental-feature verwenden

Risiken und Empfehlungen¶

Vor dem Aktivieren einer experimentellen Einstellung¶

1. Eine Sicherung der CCU erstellen
2. Die aktuelle Konfiguration notieren, für den Fall einer notwendigen Rücksetzung
3. Debug-Protokollierung aktivieren, damit Daten verfügbar sind, falls etwas schiefgeht

Nach dem Aktivieren¶

1. Home Assistant neu starten, damit die Einstellung wirksam wird
2. Die Geräte testen - prüfen, ob Schalter, Sensoren, Thermostate korrekt reagieren
3. 24-48 Stunden überwachen, bevor die Einstellung als stabil betrachtet wird

Wenn etwas schiefgeht¶

1. Die experimentelle Einstellung deaktivieren in den Integrationsoptionen
2. Home Assistant neu starten
3. Das Problem melden mit den Protokollen

Der Vorteil von Feature-Flags ist, dass das Zurücksetzen immer nur einen Klick entfernt ist.

Fahrplan¶

Sobald eine experimentelle Funktion über verschiedene Backend-Typen hinweg gründlich getestet wurde und positives Feedback erhält, wird sie zur Standardimplementierung befördert. Zu diesem Zeitpunkt wird die alte Implementierung als veraltet markiert und schließlich entfernt.

Zusammenfassung¶

• Experimentelle Einstellungen ermöglichen eine Vorschau auf kommende Verbesserungen
• Das Feedback beeinflusst direkt, ob Funktionen veröffentlicht werden
• Einfaches Zurücksetzen, wenn etwas schiefgeht
• Nicht für jeden - nur aktivieren, wenn die Bereitschaft besteht, Probleme zu melden
• Debugging-Einstellungen sind Entwicklerwerkzeuge, keine Benutzerfunktionen

Vielen Dank für die Mithilfe bei der Verbesserung von Homematic(IP) Local!