Erweiterte Konfiguration

Erweiterte Konfiguration

Warum diese Funktion?

Die erweiterte Konfiguration von VTherm bietet grundlegende Tools, um die Sicherheit und Zuverlässigkeit Ihres Heizsystems zu gewährleisten. Diese Parameter ermöglichen es Ihnen, Situationen zu verwalten, in denen Temperatursensoren nicht mehr richtig kommunizieren, was zu gefährlichen oder unwirksamen Befehlen führen könnte.

Sicherheitskontext

Das Fehlen oder die Fehlfunktion eines Temperatursensors kann sehr gefährlich für Ihr Zuhause sein. Betrachten Sie dieses konkrete Beispiel:

Ihr Temperatursensor bleibt bei einem Wert von 10° stecken
Ihr VTherm vom Typ over_climate oder over_valve erkennt eine sehr niedrige Temperatur
Es befiehlt maximales Heizen der zugrunde liegenden Geräte
Ergebnis: der Raum überhitzt sich erheblich

Die Folgen können von einfachen Materialschäden bis hin zu schwereren Risiken wie Brand oder Explosion (bei einem fehlerhaften elektrischen Heizkörper) reichen.

Funktionsprinzip des Sicherheitsmodus

Was ist der Sicherheitsmodus?

Der Sicherheitsmodus ist ein Schutzmechanismus, der erkennt, wenn Temperatursensoren nicht mehr regelmäßig reagieren. Wenn ein Datenmangel erkannt wird, aktiviert VTherm einen speziellen Modus, der:

Sofortiges Risiko reduziert: das System befiehlt nicht mehr maximale Leistung
Minimale Heizung aufrechterhält: stellt sicher, dass sich das Haus nicht übermäßig abkühlt
Sie warnt: durch Änderung des Thermostatzustandes, sichtbar in Home Assistant

Wann wird er aktiviert?

Der Sicherheitsmodus wird aktiviert, wenn:

Innentemperatur fehlt: seit der konfigurierten maximalen Verzögerung keine Messung empfangen
Außentemperatur fehlt: seit der konfigurierten maximalen Verzögerung keine Messung empfangen (optional)
Sensor steckt: der Sensor sendet keine Wertänderungen mehr (typisches Verhalten von batteriebetriebenen Sensoren)

Eine besondere Herausforderung stellen batteriebetriebene Sensoren dar, die nur Daten senden, wenn sich ein Wert ändert. Es ist daher möglich, stundenlang keine Updates zu erhalten, ohne dass der Sensor wirklich fehlerhaft ist. Deshalb sind die Parameter konfigurierbar, um die Erkennung an Ihre Einrichtung anzupassen.

Einschränkungen

VTherm vom Typ over_climate mit Selbstregulierung: der Sicherheitsmodus ist automatisch deaktiviert. Es gibt kein Risiko, wenn sich das Gerät selbst regelt (es behält seine eigene Temperatur). Das einzige Risiko ist eine unbequeme Temperatur, kein physisches Risiko.

Konfiguration

Um erweiterte Sicherheitsparameter zu konfigurieren:

Öffnen Sie die Konfiguration Ihres VTherm
Greifen Sie auf die Parameter der allgemeinen Konfiguration zu
Scrollen Sie nach unten zum Abschnitt "Erweiterte Konfiguration"

Das Formular für erweiterte Konfiguration sieht wie folgt aus:

Ratschlag

Wenn Ihr Thermometer ein Attribut last_seen oder ähnliches hat, das die Zeit des letzten Kontakts angibt, konfigurieren Sie dieses Attribut in den Hauptselektionen Ihres VTherm. Dies verbessert die Erkennung erheblich und reduziert falsche Warnungen. Siehe Konfiguration der Basisattribute und Fehlerbehebung für weitere Details.

Sicherheitsparameter

Parameter	Beschreibung	Standardwert	Attributname
Maximale Verzögerung vor Sicherheitsmodus	Maximal zulässige Verzögerung zwischen zwei Temperaturmessungen, bevor VTherm in den Sicherheitsmodus wechselt. Falls nach dieser Verzögerung keine neue Messung empfangen wird, wird der Sicherheitsmodus aktiviert.	60 Minuten	`safety_delay_min`
Minimaler `on_percent`-Schwellenwert für Sicherheit	Mindestprozentsatz von `on_percent`, unter dem der Sicherheitsmodus nicht aktiviert wird. Dies verhindert die Aktivierung des Sicherheitsmodus, wenn der Heizkörper sehr wenig läuft (`on_percent` niedrig), da kein unmittelbares Überhitzungsrisiko besteht. `0.00` aktiviert immer den Modus, `1.00` deaktiviert ihn vollständig.	0.5 (50%)	`safety_min_on_percent`
Standard-`on_percent`-Wert im Sicherheitsmodus	Die Heizleistung, die verwendet wird, wenn sich der Thermostat im Sicherheitsmodus befindet. `0` stoppt die Heizung vollständig (Gefrierrisiko), `0.1` behält minimale Heizung bei, um Gefrieren bei längerer Sensorausfallzeit zu verhindern.	0.1 (10%)	`safety_default_on_percent`

Verfügbare Attribute

Wenn der Sicherheitsmodus aktiv ist, stellt VTherm folgende Attribute bereit:

safety_mode: "on"                # "on" oder "off"
safety_delay_min: 60             # Konfigurierte Verzögerung in Minuten
safety_min_on_percent: 0.5       # on_percent-Schwellenwert (0.0 bis 1.0)
safety_default_on_percent: 0.1   # Leistung im Sicherheitsmodus (0.0 bis 1.0)
last_safety_event: "2024-03-20 14:30:00"  # Zeitpunkt des letzten Ereignisses

Verfügbare Aktionen

Eine VTherm-Aktion ermöglicht die dynamische Neukonfiguration der 3 Sicherheitsparameter ohne Neustart von Home Assistant:

Service: versatile_thermostat.set_safety_parameters
Parameter:
- entity_id: der VTherm zum Neukonfigurieren
- safety_delay_min: neue Verzögerung (Minuten)
- safety_min_on_percent: neuer Schwellenwert (0.0 bis 1.0)
- safety_default_on_percent: neue Leistung (0.0 bis 1.0)

Dies ermöglicht die dynamische Anpassung der Empfindlichkeit des Sicherheitsmodus entsprechend Ihrer Nutzung (z. B. Verzögerung reduzieren, wenn Menschen zu Hause sind, oder erhöhen, wenn das Haus leer ist).

Erweiterte globale Konfiguration

Es ist möglich, die Überprüfung des Außenthermometers für den Sicherheitsmodus zu deaktivieren. Der Außensensor hat generell wenig Auswirkungen auf die Regelung (je nach Einstellung) und kann abwesend sein, ohne die Sicherheit des Hauses zu gefährden.

Fügen Sie dazu die folgenden Zeilen in Ihre configuration.yaml ein:

versatile_thermostat:
  safety_mode:
    check_outdoor_sensor: false

Wichtig

Diese Änderung ist für alle VTherm im System gemeinsam

Sie beeinflusst die Erkennung des Außenthermometers für alle Thermostate

Home Assistant muss neu gestartet werden, damit die Änderungen wirksam werden

Standardmäßig kann das Außenthermometer den Sicherheitsmodus auslösen, wenn es keine Daten mehr sendet

Praktische Tipps

Hinweise und Best Practices

Wiederherstellung nach Korrektur: Wenn der Temperatursensor wieder zum Leben erwacht und Daten sendet, wird der Voreinstellungsmodus auf seinen vorherigen Wert zurückgesetzt.
Zwei Temperaturen erforderlich: Das System benötigt sowohl die Innen- als auch die Außentemperatur, um richtig zu funktionieren. Wenn eine der beiden fehlt, wechselt der Thermostat in den Sicherheitsmodus.
Beziehung zwischen Parametern: Für natürliches Verhalten sollte der Wert safety_default_on_percent kleiner als safety_min_on_percent sein. Beispielsweise: safety_min_on_percent = 0.5 und safety_default_on_percent = 0.1.
Anpassung an Ihren Sensor:
- Bei falschen Warnungen die Verzögerung (safety_delay_min) erhöhen oder safety_min_on_percent verringern
- Bei batteriebetriebenen Sensoren die Verzögerung weiter erhöhen (z. B.: 2-4 Stunden)
- Bei Verwendung des Attributs last_seen kann die Verzögerung verkürzt werden (das System ist genauer)
Visualisierung in der Benutzeroberfläche: Wenn Sie die Versatile Thermostat UI-Karte verwenden, wird ein VTherm im Sicherheitsmodus visuell angezeigt durch:
- Einen gräulichen Schleier über dem Thermostat
- Anzeige des fehlerhaften Sensors
- Verstrichene Zeit seit der letzten Aktualisierung
.

Behebung von falschem Gerätezustand

Warum diese Funktion?

Bei der Verwendung eines VTherm mit Heizgeräten (over_switch, over_valve, over_climate, over_climate_valve) kann es vorkommen, dass das Gerät dem vom Thermostat gesendeten Befehl nicht richtig folgt. Zum Beispiel:

Ein klemmender Schalter, der nicht in den befohlenen Zustand wechselt
Ein thermostatisches Ventil, das Befehle nicht beachtet
Ein vorübergehender Kommunikationsverlust mit dem Gerät
Geräte, die zu lange brauchen, um zu reagieren

Die Funktion "Falschen Status reparieren" erkennt diese Situationen und sendet den Befehl automatisch erneut, um den aktuellen Zustand mit dem gewünschten Zustand zu synchronisieren.

Anwendungsfälle

Diese Funktion ist besonders nützlich für:

Instabile Relais: Relais, die haften oder nicht immer richtig wechseln
Intermittierende Zigbee/WiFi-Kommunikation: Geräte, die gelegentlich die Verbindung verlieren
Langsame Ventile: thermostatische Ventile, die langsam auf Befehle reagieren
Fehlerhafte Geräte: Elektroradiatoren oder Ventile, die nicht mehr auf Befehle reagieren
Wärmepumpen: um sicherzustellen, dass die Wärmepumpe Heiz-/Kühlbefehle richtig ausführt

Funktionsprinzip

Bei jedem Thermostat-Regelzyklus führt die Funktion folgende Schritte durch:

Vergleicht Zustände: überprüft, ob der tatsächliche Zustand jedes Geräts mit dem befohlen Zustand übereinstimmt
Erkennt Abweichungen: wenn das Gerät dem Befehl nicht folgte, ist das eine Abweichung
Sendet den Befehl erneut: wenn eine Abweichung erkannt wird, sendet es den Befehl erneut, um den Zustand zu synchronisieren
Zählt Versuche: die Anzahl der Reparaturen wird begrenzt, um Endlosschleifen zu vermeiden
Steuert die Aktivierungsverzögerung: die Funktion wird nur nach einer Mindestverzögerung aktiviert, damit die Geräte ihre Initialisierung abschließen können

Konfiguration

Diese Funktion wird in der VTherm-Konfigurationsoberfläche konfiguriert:

Öffnen Sie Ihre VTherm-Konfiguration
Greifen Sie auf die Parameter der allgemeinen Konfiguration zu
Scrollen Sie nach unten zum Abschnitt "Erweiterte Konfiguration"
Aktivieren Sie die Option "Falschen Gerätezustand reparieren"

Parameter

Parameter	Beschreibung	Standardwert
Falschen Status reparieren	Aktiviert oder deaktiviert die automatische Erkennung und Reparatur von Zustandsabweichungen. Wenn aktiviert, wird bei jeder erkannten Abweichung der Befehl erneut gesendet.	Deaktiviert

Interne Systemparameter

Einige Parameter werden auf Systemebene konfiguriert und können nicht geändert werden:

Mindestverzögerung vor Aktivierung: 30 Sekunden nach dem Start des Thermostats (ermöglicht allen Geräten, zu initialisieren)

Maximale aufeinanderfolgende Versuche: 5 aufeinanderfolgende Reparaturen vor temporärem Stopp

Zurücksetzverzögerung: der Reparaturzähler wird zurückgesetzt, sobald Geräte den korrekten Zustand wieder erreichen

Verfügbare Attribute

Wenn die Reparaturfunktion aktiviert ist, stellt VTherm das folgende Attribut bereit:

repair_incorrect_state_manager:
  consecutive_repair_count: 2       # Anzahl der durchgeführten Reparaturen
  max_attempts: 5                   # Grenzwert vor temporärem Stopp
  min_delay_after_init_sec: 30      # Mindestverzögerung vor Aktivierung
is_repair_incorrect_state_configured: true  # Funktionsstatus

Der Zähler consecutive_repair_count ermöglicht es Ihnen:

Häufige Hardwareprobleme zu diagnostizieren
Fehlerhafte Geräte zu identifizieren
Die Stabilität Ihrer Anlage zu überwachen

Einschränkungen und Sicherheit

Wichtig

Keine Verhaltensänderung: Diese Funktion ändert nicht die Heizlogik. Sie stellt lediglich sicher, dass Ihre Befehle ordnungsgemäß ausgeführt werden.
Sicherheitsgrenzen: Die maximalen aufeinanderfolgenden Versuche (5) verhindern Endlosschleifen. Wenn diese Grenze erreicht wird, wird ein Fehler protokolliert und die Reparaturen werden vorübergehend gestoppt.
Startverzögerung: Die Funktion wird erst nach 30 Sekunden aktiviert, um allen Geräten Zeit zur vollständigen Initialisierung zu geben.
Für alle VTherm-Typen anwendbar: Diese Funktion funktioniert für alle Typen over_switch, over_valve, over_climate und over_climate_valve (die over_climate mit direkter Ventilregelung). Für letztere wird der Zustand des zugrunde liegenden climate sowie der Ventilöffnungszustand überprüft.
Symptome von Überaktivität: Wenn Sie regelmäßig Warnmeldungen über Reparaturen sehen, deutet dies auf ein Hardwareproblem hin:
- Überprüfen Sie die Geräteverbindung
- Überprüfen Sie die Netzwerkstabilität (Zigbee/WiFi)
- Testen Sie das Gerät manuell über Home Assistant
- Erwägen Sie den Austausch bei anhaltendem Problem
Zähler zurücksetzen: Der Zähler wird automatisch zurückgesetzt, sobald die Geräte den korrekten Zustand wieder erreichen, was neue Versuche bei intermittierenden Problemen ermöglicht.
Regelmäßige Wiederholung: Nach 5 fehlgeschlagenen Reparaturversuchen wird die Reparatur unterbrochen, um Endlosschleifen zu vermeiden. Sie wird nach 10 Zyklen ohne Reparatur wiederaufgenommen und ermöglicht neue Versuche bei intermittierenden Problemen.