Heatzy Smart-Home-Integration, kostenlos und Open Source
Heatzy-Steuerdrahtmodule: Modus jedes Heizkörpers, Urlaub, Widget und Szenen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Steuere deine Heatzy-Steuerdrahtmodule über Gladys: den Modus jedes Elektroheizkörpers (Komfort, Öko, Frostschutz, Aus sowie Komfort -1°C / -2°C bei den Modulen, die sie haben), den Urlaubsmodus, die Kindersicherung und das Wochenprogramm, dazu die Raumtemperatur bei den Modellen, die sie messen. Ein Dashboard-Widget schaltet alle Heizkörper auf einmal, und Szenen reagieren, wenn ein Heizkörper den Modus wechselt oder ein Modul offline geht.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit einer simulierten Heatzy-Cloud gebaut und getestet, gespeist mit den echten Modulen aus den Tests von hass-heatzy (Home Assistant), nicht mit einem echten Heatzy-Konto. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Ein Heatzy-Konto (E-Mail-Adresse und Passwort der Heatzy-App), deine Module bereits in der App eingerichtet.
- Eine Internetverbindung: Die Module sind nur über die Heatzy-Cloud (Gizwits) erreichbar, es gibt keine lokale API.
Unterstützte Module: Pilote v1, Pilote v2 und v3 (auch Elec Pro), Pilote v4, Pilote Pro, Glow, Onyx, Inea und Bloom. Ein anderes Heatzy-Modul wird mit dem gemeinsamen Protokoll der neueren Module angezeigt.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib unter Konfiguration die E-Mail-Adresse und das Passwort deines Heatzy-Kontos ein und speichere.
- Klicke auf Verbindung testen: Die Meldung unter der Taste listet die Module des Kontos auf.
- Öffne den Tab Erkennung: ein Gerät pro Modul, benannt wie in der Heatzy-App. Klicke auf Hinzufügen, wähle einen Raum, speichere.
Optionen:
- Aktualisierungsintervall: wie oft die Module gelesen werden, von 1 bis 10 Minuten (standardmäßig 2 Minuten). Eine Änderung über Gladys erscheint sofort und wird einige Sekunden später geprüft; eine Änderung in der Heatzy-App erscheint beim nächsten Lesen.
- Sprache der Namen: Englisch, Französisch, Deutsch oder Spanisch (standardmäßig Französisch), für die Funktionsnamen (beim Hinzufügen eines Geräts vergeben) und die Meldungen der Integration.
Das Gerät jedes Moduls
| Funktion | Was es ist |
|---|---|
| Steuerdraht-Modus | Der Modus des Heizkörpers, mit der Steuerdraht-Auswahl von Gladys: Komfort, Komfort -1°C, Komfort -2°C, Öko, Frostschutz, Aus |
| Kindersicherung | Sperrt die Tasten des Moduls (nicht beim Pilote v1 und beim Bloom) |
| Wochenprogramm | Ein: Das Modul folgt dem in der Heatzy-App eingestellten Programm; aus: Es behält den gewählten Modus (nicht beim Pilote v1) |
| Raumtemperatur | Nur Glow, Onyx, Inea, Bloom und Pilote Pro, nur lesbar |
| Luftfeuchtigkeit | Nur Pilote Pro, nur lesbar |
Komfort -1°C und -2°C gibt es beim Pilote v4, Pilote Pro, Glow, Onyx, Inea und Bloom: Die anderen Module lehnen sie mit einer Meldung ab. Das Abzeichen des Geräts zeigt Cloud, solange das Modul mit der Heatzy-Cloud verbunden ist, und Nicht erreichbar, wenn es offline ist.
Die Komfort- und Öko-Sollwerte von Glow, Onyx, Inea, Bloom und Pilote Pro werden nicht angezeigt: Gladys, HomeKit und die Sprachassistenten würden einen Sollwert für ein Thermostat halten, und ein Steuerdraht ist keins. Stelle sie in der Heatzy-App ein.
Dashboard
Füge das Widget Heatzy-Heizkörper zu einem Dashboard hinzu. Standardmäßig listet es alle Heizkörper mit ihrem Modus auf (und nach einem Punkt Urlaub, Boost, Programm und die Raumtemperatur); wähle in seinen Einstellungen einen Heizkörper, um nur diesen zu zeigen. Seine vier Tasten wirken auf das, was das Widget zeigt:
- Komfort, Öko, Frostschutz: sofort;
- Aus: nach einer Bestätigung, da die Räume dann unbeheizt bleiben.
Die Taste des aktuellen Modus trägt ein Häkchen, wenn alle gezeigten Heizkörper in diesem Modus sind. Komfort -1°C und -2°C findest du in der Auswahl des Geräts.
Szenen
Auslöser
- Heizkörpermodus außerhalb von Gladys geändert: Die Heatzy-App, das
Wochenprogramm oder eine Taste am Modul hat den Modus eines Heizkörpers
geändert. Filter: der Heizkörper, der neue Modus. Variablen: Name und Gerät
des Heizkörpers, neuer Modus, vorheriger Modus (
comfort,comfort_1,comfort_2,eco,frost_protection,off), Wochenprogramm aktiv. Änderungen durch Gladys werden nicht gemeldet (eine Szene, die darauf reagiert, könnte sich im Kreis drehen); der Geräte-Auslöser von Gladys auf der Funktion Steuerdraht-Modus sieht jede Änderung. - Heatzy-Modul offline: Ein Modul hat die Verbindung zur Cloud verloren (WLAN, Stromausfall). Filter: der Heizkörper.
- Heatzy-Modul wieder online: Das Modul ist wieder verbunden. Filter: der Heizkörper.
Aktionen
- Modus von Heatzy-Heizkörpern setzen: ein Heizkörper oder alle, wenn der Heizkörper leer bleibt. Ein laufender Urlaub wird beendet und das Wochenprogramm ausgeschaltet, damit der Modus bleibt. Bei allen Heizkörpern überspringen Komfort -1°C und -2°C die Module ohne diese Modi. Ausgabe: die Anzahl der Module, die angenommen haben.
- Heatzy-Urlaubsmodus starten: Frostschutz für 1 bis 255 Tage, danach kehrt das Modul zu seinem Programm zurück. Nicht beim Pilote v1.
- Heatzy-Urlaubsmodus beenden: beendet den Urlaub (oder einen in der Heatzy-App gestarteten Boost).
Für einen einzelnen Heizkörper funktioniert auch die Gladys-Aktion Gerät steuern auf seiner Funktion Steuerdraht-Modus.
Szenen-Ideen
- Haus verlassen (Alarm aktiviert): Modus von Heatzy-Heizkörpern setzen, alle Heizkörper, Öko; bei der Rückkehr: Komfort.
- Fenster offen (Öffnungssensor des Raums): diesen Heizkörper auf Frostschutz stellen; wieder geschlossen: Komfort.
- Ein Modul nachts offline: Heatzy-Modul offline → Nachricht senden: „Der Heizkörper {{triggerEvent.data.radiator}} ist offline".
Fehlerbehebung
- „Heatzy lehnt die E-Mail-Adresse oder das Passwort ab": Prüfe sie, indem du dich in der Heatzy-App anmeldest. Nach diesem Fehler hört die Integration auf, es zu versuchen (um das Konto nicht zu sperren), bis du die Konfiguration speicherst oder auf Verbindung testen klickst.
- „Zu viele Anfragen": Die Heatzy-Cloud begrenzt die Anfragen; die Integration wartet zehn Minuten. Wähle ein längeres Intervall, wenn es wieder vorkommt.
- Ein Heizkörper wechselt den Modus nicht: Prüfe in der Heatzy-App, ob das Modul online ist. Ein in Gladys gewählter Modus schaltet das Wochenprogramm aus, damit er bleibt: Schalte es wieder ein, um zum Programm zurückzukehren.
- Ein Modus erscheint ein paar Minuten zu spät: Änderungen außerhalb von Gladys werden beim nächsten Lesen gesehen (das Aktualisierungsintervall).
- Mehr Details: die Protokolle der Integration (Einstellungen → Integrationen → Heatzy). Darin stehen nie das Passwort oder das Token.
Grenzen
- Nur Cloud: Ohne Internet oder wenn die Heatzy-Cloud ausfällt, lässt sich über Gladys nichts steuern (die Module behalten ihren Modus und ihr Programm).
- Höchstens einmal pro Minute lesen: Die Heatzy-Cloud (Gizwits) wird von allen Heatzy-Nutzern geteilt und hat Kontingente. Jedes Lesen kostet eine Anfrage plus eine pro Modul.
- Das Wochenprogramm selbst, die Sollwerte, der Boost und die Anwesenheitserkennung des Pilote Pro werden in der Heatzy-App eingestellt.
- Das Pilote Pro zeigt den Modus, den es anwendet (der vom angeforderten abweichen kann, zum Beispiel bei einem erkannten offenen Fenster).
- Ohne die Hardware entwickelt: Rückmeldungen willkommen.
- Nicht mit Heatzy verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Heatzy in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Heatzy-Konto | section | Nein | Das Konto der Heatzy-App: Jedes Modul des Kontos wird zu einem Gerät im Tab Erkennung. Die Integration liest die Heatzy-Cloud: Eine Internetverbindung ist nötig. |
| E-Mail-Adresse | string | Ja | Die, mit der du dich in der Heatzy-App anmeldest. |
| Passwort | secret | Ja | Das Passwort der Heatzy-App. Es bleibt in Gladys und wird nur an die Heatzy-Cloud gesendet. |
| Aktualisierungsintervall | select | Nein | Wie oft die Module gelesen werden. Eine Änderung über Gladys erscheint sofort. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und der Meldungen der Integration. |
So installierst du Heatzy in Gladys
- Öffne in Gladys Integrationen: Heatzy erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-heatzy:1.0.0) 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/guim31/gladys-heatzy.
Heatzy 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
Heatzy 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 guim31 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