Drayton Wiser Heating Smart-Home-Integration, kostenlos und Open Source

Steuere deine Drayton-Wiser-Heizung lokal: Räume, Warmwasser, Steckdosen und Ventile.
Steuere deine Drayton-Wiser-Heizung aus Gladys: Räume, Warmwasser, smarte Steckdosen, Heizkörperthermostate und Raumthermostate. Die Integration spricht direkt in deinem lokalen Netzwerk mit deinem Wiser HeatHub: kein Wiser-Cloud-Konto, nichts geht ins Internet, und sie funktioniert auch, wenn deine Internetverbindung ausfällt.
Was du bekommst
Nach der Konfiguration listet der Reiter Erkennung:
- Wiser HeatHub — Abwesenheitsmodus, Eco-Modus und ob der Heizkessel heizt.
- Ein Gerät pro Raum — Temperatur, Luftfeuchtigkeit (wenn ein Raumthermostat den Raum bedient), Solltemperatur, Modus (Aus, Manuell, Zeitplan), Heizzustand, Boost und Fenster (wenn ein Heizkörperthermostat es erkennt).
- Warmwasser (wenn der Hub einen Speicher steuert) — Modus (Aus, An, Zeitplan), Heizzustand und Boost.
- Smarte Steckdosen — an/aus, Leistung (W) und Energie (kWh).
- Heizkörperthermostate und Raumthermostate — Batterie, Funksignal und bei einem Heizkörperthermostat die Temperatur am Heizkörper.
So verhalten sich die Bedienelemente, wie in der Wiser-App:
- eine Solltemperatur, die gesetzt wird, während der Raum seinem Zeitplan folgt, gilt bis zum nächsten Abschnitt des Zeitplans; im manuellen Modus bleibt sie;
- Boost fügt der aktuellen Temperatur eine Zeit lang (standardmäßig 1 Stunde) einige Grad hinzu (standardmäßig 2 °C);
- der Abwesenheitsmodus senkt alle Räume auf die in der Wiser-App eingestellte Abwesenheitstemperatur.
Bevor du beginnst
Du brauchst zwei Dinge: die Adresse des Hubs und sein Secret.
1. Die Adresse des Hubs
Suche den HeatHub in deinem Router (sein Name beginnt mit WiserHeat) und
notiere seine IP-Adresse. Gib ihm eine feste Adresse (DHCP-Reservierung),
damit sie sich nicht ändert.
2. Das Secret des Hubs
Das Secret ist ein langer Schlüssel, den der Hub nur im Setup-Modus anzeigt. Der Hub hört dabei nicht auf zu arbeiten: Deine Heizung läuft während dieser Schritte weiter.
- Drücke einmal die Setup-Taste des Hubs (je nach Modell hinten oder seitlich). Seine Leuchte beginnt zu blinken.
- Verbinde dich mit einem Telefon oder Computer mit dem WLAN namens WiserHeatXXXXXX, das der Hub öffnet.
- Öffne http://192.168.8.1/secret in einem Browser: Kopiere den angezeigten
langen Text (er endet oft mit
==). - Drücke die Setup-Taste erneut (oder warte ein paar Minuten), damit der Hub den Setup-Modus verlässt, und verbinde dein Gerät wieder mit deinem WLAN.
Das Secret bleibt danach gleich; du musst es nur erneut auslesen, wenn du den Hub zurücksetzt.
Konfiguration
- Öffne den Reiter Konfiguration der Integration.
- Trage Adresse des HeatHub und Secret des HeatHub ein.
- Lass Verbindung auf Automatisch: Neuere Hubs der 2. Generation antworten nur über HTTPS, die Integration erkennt das selbst.
- Ändere bei Bedarf das Aktualisierungsintervall (standardmäßig 60 Sekunden: ein Lesevorgang umfasst alle Räume und Geräte), den Boost (Grad und Dauer) und die Dauer des Warmwasser-Boosts.
- Speichere und klicke dann auf Verbindung testen: Die Antwort zeigt die Firmware des Hubs und die Anzahl der Räume und Geräte.
- Öffne den Reiter Erkennung und füge die gewünschten Geräte hinzu.
Aktionen
- Verbindung testen — liest den Hub sofort und sagt, was er bereitstellt, oder was zu korrigieren ist (falsche Adresse, abgelehntes Secret…).
- Gerät identifizieren — wähle ein Gerät: Seine LEDs blinken. Wähle einen Raum, und alle Heizkörperthermostate und das Thermostat des Raums blinken.
Szenen
Die Integration fügt dem Szeneneditor (Gladys 5.1 oder neuer) eigene Karten in der Kategorie Integrationen hinzu.
Auslöser:
- Fenster geöffnet oder geschlossen — ein Heizkörperthermostat hat ein
offenes Fenster (plötzlicher Temperaturabfall) oder sein Schließen erkannt.
Variablen:
room,state(open/closed). - Abwesenheitsmodus geändert — der Abwesenheitsmodus wurde außerhalb von
Gladys ein- oder ausgeschaltet (Wiser-App, Hub-Taste). Variable:
state(on/off). - Batterie schwach — ein Heizkörperthermostat oder Thermostat braucht bald
neue Batterien. Variablen:
device_name,room,level,battery(%). - Verbindung zum HeatHub verloren oder wiederhergestellt — der Hub antwortet
nicht mehr (Stromausfall, WLAN, falsches Secret) oder wieder. Variablen:
state(lost/restored),reason.
Aktionen (jede liefert ein Ergebnis, das die folgenden Aktionen prüfen können):
- Raum boosten — Grad und Dauer; lass den Raum leer, um alle Räume zu boosten.
- Raumtemperatur einstellen — eine Dauer von 0 gilt bis zum nächsten Abschnitt des Zeitplans.
- Zurück zum Zeitplan — hebt Boosts und vorübergehende Temperaturen eines Raums oder aller Räume auf.
- Abwesenheitsmodus einstellen — an oder aus.
- Warmwasser boosten — für eine Anzahl von Minuten.
Dashboard
- Wiser-Heizung — alle Räume auf einen Blick (Temperatur, Sollwert, Modus und ein Abzeichen: heizt, Boost, Fenster offen, aus), die Verbindung zum Hub, Abwesenheits- und Eco-Modus, der Heizkessel, Warmwasser und Batterien. Tasten: Abwesenheitsmodus, zurück zum Zeitplan, Warmwasser-Boost.
- Wiser-Raum — wähle in den Widget-Einstellungen einen Raum: Temperatur, Sollwert und Luftfeuchtigkeit live, Modus, Heizen, Boost und Fenster. Tasten: Boost (fragt Grad und Dauer ab), Übersteuerung weg, Zeitplan folgen.
Fehlerbehebung
- „Der HeatHub hat das Secret abgelehnt“ — lies das Secret erneut aus (siehe oben); es ändert sich, wenn der Hub zurückgesetzt wird.
- „Der HeatHub antwortet nicht“ — prüfe die Adresse (sie kann sich ohne DHCP-Reservierung geändert haben) und ob der Hub Strom hat. Die Integration meldet den Hub erst nach zwei fehlgeschlagenen Lesevorgängen in Folge als verloren, nicht bei der ersten langsamen Antwort.
- Keine Luftfeuchtigkeit oder kein Fenster — sie gibt es nur, wenn der Raum ein Raumthermostat (Luftfeuchtigkeit) oder Heizkörperthermostate (Fenster) hat.
- Heizungsaktoren, Fußbodenheizungsregler, Lampen und Rollläden der Wiser-Reihe werden noch nicht unterstützt.
- Detaillierte Logs: Sieh dir die Logs der Integration in Gladys an (oder
docker logsauf dem Host).
Konfigurationseinstellungen
Diese Einstellungen fragt Drayton Wiser Heating in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Integration spricht direkt in deinem lokalen Netzwerk mit deinem Wiser HeatHub, ohne die Wiser-Cloud. Sie braucht die Adresse des Hubs (siehe deinen Router) und das Secret des Hubs: Drücke die Setup-Taste des Hubs, verbinde dich mit seinem WLAN WiserHeat und öffne http://192.168.8.1/secret. Die Dokumentation erklärt jeden Schritt. |
| Adresse des HeatHub | string | Ja | IP-Adresse oder Hostname des Hubs in deinem Netzwerk. Gib ihm im Router eine feste Adresse. |
| Secret des HeatHub | secret | Ja | Der lange Schlüssel von http://192.168.8.1/secret, verbunden mit dem Hub im Setup-Modus. |
| Verbindung | select | Nein | Automatisch passt für jeden Hub: Neuere Hubs der 2. Generation antworten nur über HTTPS. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft der Hub gelesen wird, in Sekunden. Ein Lesevorgang umfasst alle Räume und Geräte. |
| Boost (°C) | number | Nein | Grad, die ein Raum-Boost zur aktuellen Temperatur hinzufügt. |
| Boost-Dauer (Min.) | number | Nein | Wie lange ein Raum-Boost dauert, in Minuten. |
| Warmwasser-Boost (Min.) | number | Nein | Wie lange ein Warmwasser-Boost dauert, in Minuten. |
So installierst du Drayton Wiser Heating in Gladys
- Öffne in Gladys Integrationen: Drayton Wiser Heating erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-draytonwiserheating:0.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-draytonwiserheating.
Drayton Wiser Heating benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Drayton Wiser Heating ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation