Dokumentation von Versatile Thermostat

Versatile Thermostat (VTherm) ist eine Home-Assistant-Integration, die Wasserheizkörper mit Thermostatventilen (TRV) in intelligente Thermostate verwandelt: Voreinstellungen, Fenstererkennung, Anwesenheit, direkte Ventilsteuerung und die Ansteuerung eines zentralen Heizkessels.

VTherm steuert auch Wärmepumpen, Klimaanlagen und elektrische Heizkörper. Alle Funktionen werden über die Oberfläche von Home Assistant konfiguriert, ohne Skripte oder komplizierte Automatisierungen: Niemand ist zu Hause, ein Fenster ist offen, der Heizkessel soll anspringen? Der Thermostat erledigt das selbst.

• Dokumentation von Versatile Thermostat
  • Installationsbeispiel
  • Unterstützte Geräte
  • Voraussetzungen
  • Geräte
  • Inhalt der Dokumentation
    • Erste Schritte
    • VTherm-Typen
    • Funktionen
    • Regelung
    • Hilfe und Referenz
    • Weiterführende Themen
  • Nächster Schritt

Installationsbeispiel

Für Thermostatventile:

1. Ist die Ventilöffnung Ihres TRV in Home Assistant steuerbar (z. B. Sonoff TRVZB), erstellen Sie ein VTherm vom Typ over_climate mit direkter Ventilsteuerung: VTherm regelt dann die Raumtemperatur über die Ventilöffnung. Ein Ventil, das nur als number-Entity verfügbar ist, steuern Sie mit einem VTherm vom Typ over_valve.
2. Die Schnellstart-Anleitung für TRV der Website beschreibt die Konfiguration Schritt für Schritt.
3. Gleichen Sie bei Bedarf das interne Thermometer des TRV mit der Synchronisierung der internen Gerätetemperatur ab und nutzen Sie die Ventilkalibrierung, wenn die Ventile nicht mehr richtig öffnen oder schließen.
4. Fügen Sie die nützlichen Funktionen hinzu: Steuerung der Zentralheizung, um den Heizkessel einzuschalten, sobald ein Raum Wärme benötigt, Erkennung offener Fenster und Anwesenheitsverwaltung.

Unterstützte Geräte

VTherm steuert die in Home Assistant verfügbaren Heiz- und Kühlgeräte:

• Wasserheizkörper mit Thermostatventilen (TRV), mit oder ohne direkte Ventilsteuerung: TRV-Anleitung,
• Ventile, die über eine number-Entity gesteuert werden, ohne zugehörigen Thermostat,
• Zentralheizung: VTherm schaltet den Heizkessel ein, sobald ein Raum Wärme benötigt (siehe Steuerung der Zentralheizung),
• Wärmepumpen, Klimaanlagen und HLK-Systeme mit climate-Entity: Wärmepumpen-Anleitung,
• Elektrische Heizkörper, gesteuert über einen Schalter oder ein Steuerleitungsmodul: Steuerleitungs-Anleitung,
• Pelletöfen, mit dem Plugin VTherm Pellet stove: Pelletofen-Anleitung.

Welcher VTherm-Typ für welches Gerät erstellt wird, erklärt Wahl eines VTherm.

Voraussetzungen

• Home Assistant und die über HACS installierte Integration Versatile Thermostat (siehe Installation),
• das zu steuernde Gerät, in Home Assistant verfügbar,
• ein Temperatursensor für den Raum: Jeder in Home Assistant verfügbare Sensor kann verwendet werden, ebenso eine input_number,
• ein Außentemperatursensor: Die Wetterintegration von Home Assistant reicht aus.

Geräte

Die mit VTherm getesteten Thermostatventile sind im Gerätekatalog der Website aufgeführt, mit ihrem Unterstützungsgrad und Konfigurationshinweisen. Der Katalog enthält außerdem Thermometer, Geräte mit climate-Entity und Geräte für elektrische Heizungen.

Dieser Katalog ist nicht vollständig: Ein Gerät, das nicht aufgeführt ist, ist nicht unbedingt inkompatibel. Die inkompatiblen Geräte und die teilweise unterstützten Geräte werden dort mit ihren bekannten Einschränkungen beschrieben.

Inhalt der Dokumentation

Erste Schritte

• Installation: die Integration mit HACS installieren.
• Schnellstart: ein funktionierendes VTherm in wenigen Schritten, je nach Gerät.
• Wahl eines VTherm: zentrale Konfiguration oder nicht, Wahl des VTherm-Typs.
• Auswahl der grundlegenden Attribute: Name, Temperatursensoren und zu aktivierende Funktionen.

VTherm-Typen

• over_climate Thermostattyp: Thermostatventile, Wärmepumpen und Klimaanlagen mit climate-Entity.
• over_valve Thermostattyp: Ventile, die über eine number-Entity gesteuert werden.
• over_switch Thermostattyp: elektrische Heizkörper mit Schalter oder Steuerleitung.

Funktionen

• Komfort und Einsparungen
  • Voreinstellungen: voreingestellte Temperaturen (Komfort, Eco, Frostschutz...).
  • Zeitgesteuerte Voreinstellung: eine Voreinstellung für eine bestimmte Dauer anwenden.
  • Anwesenheits-/Abwesenheitsverwaltung: den Sollwert absenken, wenn niemand zu Hause ist.
  • Erkennung von Bewegung oder Aktivität: die Voreinstellung je nach Aktivität im Raum ändern.
  • Erkennung offener Türen/Fenster: reagieren, wenn eine Tür oder ein Fenster geöffnet wird.
  • Externer Luftfeuchtigkeitssensor: die von einem externen Sensor gemessene Luftfeuchtigkeit anzeigen.
• Steuerung der Anlage
  • Steuerung der Zentralheizung: den Heizkessel einschalten, wenn ein VTherm heizen muss.
  • Zentralisierte Steuerung: alle VTherm auf einmal steuern.
  • Energieverwaltung (Lastabwurf): die verfügbare Leistung nicht überschreiten.
  • Auto-Start / Auto-Stopp: ein over_climate anhalten, wenn es nicht gebraucht wird.
  • Sperrfunktion: Änderungen über die Oberfläche oder Automatisierungen verhindern.
• Sicherheit
  • Erweiterte Konfiguration und Sicherheitsmodus: Sensor, der nicht mehr antwortet, falscher Gerätezustand.
  • Erkennung von Heizungsstörungen: die Temperatur folgt dem Befehl nicht.

Regelung

• Selbstregulierung: den an ein over_climate gesendeten Sollwert anpassen oder das Ventil direkt steuern.
• Ventilkalibrierung: der Dienst recalibrate_valves.
• Synchronisierung der internen Gerätetemperatur: das interne Thermometer des Geräts an die Raumtemperatur angleichen.
• Die verschiedenen benutzten Algorithmen: TPI, SmartPI und weitere Algorithmen als Plugins.
• Auto TPI: automatisches Lernen der TPI-Koeffizienten.
  • Auto TPI: Detaillierter technischer Leitfaden
• Tuning-Beispiele: kommentierte Einstellungen für verschiedene Installationsarten.

Hilfe und Referenz

• Störungsbeseitigung: häufige Probleme und ihre Lösungen.
• Frühere Protokolle herunterladen: gezielte Protokolle sammeln und im Log-Analyser der Website öffnen.
• Referenzdokumentation: Parameter, Sensoren, Aktionen, Ereignisse und Attribute.
• Anmerkungen zum Release

Weiterführende Themen

• Einige unverzichtbare Ergänzungen: UI-Karte, Zeitplaner, Kurven, Benachrichtigungen.
• Plugin-Katalog: Algorithmen, Karten und Gerätehilfen.
• Gerätekatalog: getestete Geräte und ihr Unterstützungsgrad.

Nächster Schritt

Installation: Versatile Thermostat in Home Assistant installieren.

Für gängige Geräte fasst der Schnellstart die gesamte Konfiguration auf einer Seite zusammen.