Honeywell Total Connect Smart-Home-Integration, kostenlos und Open Source
WLAN-Thermostate von Honeywell / Resideo über das Portal Total Connect Comfort (USA, Kanada).
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Überblick
Diese Integration bringt die WLAN-Thermostate von Honeywell / Resideo aus dem Portal Total Connect Comfort (mytotalconnectcomfort.com, USA und Kanada) zu Gladys: Temperaturen, Luftfeuchtigkeit, Solltemperaturen zum Heizen und Kühlen, Systemmodus, Lüfter, Programm halten und Betriebszustand, samt ihrer Befehle.
Jedes Thermostat des Kontos wird ein Gladys-Gerät, in der Einheit, die das Thermostat anzeigt (°F oder °C).
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Die Integration beruht auf aufgezeichneten Antworten des Portals und wird gegen ein simuliertes Portal getestet; an einem echten Thermostat wurde sie noch nicht ausprobiert.
Diese Integration steht in keiner Verbindung zu Honeywell oder Resideo.
Voraussetzungen
- Gladys Assistant 5.2.0 oder neuer.
- Ein Total-Connect-Comfort-Konto (das der App „Total Connect Comfort“) mit mindestens einem Thermostat, zum Beispiel RTH6580WF, RTH8580WF, RTH9580WF, TH6320WF, TH8320WF oder die WLAN-Modelle VisionPRO.
- Nicht unterstützt: die Thermostate Lyric und T-Serie (T5, T6, T9, T10) sowie jedes Thermostat, das über die App „Resideo“ / „Honeywell Home“ läuft. Diese Geräte nutzen eine andere Cloud. Das europäische Portal Evohome wird ebenfalls nicht unterstützt.
Konfiguration
Öffne in Gladys Integrationen → Honeywell Total Connect und fülle aus:
- E-Mail-Adresse und Passwort: die deines Total-Connect-Comfort-Kontos.
- Portal abfragen alle: 2, 5 (Standard), 10 oder 15 Minuten.
- Sprache der Funktionsnamen: die Namen der Funktionen, wenn ein Thermostat zu Gladys hinzugefügt wird, und die Sprache der Meldungen (standardmäßig Französisch).
Klicke auf Verbindung testen: Die Integration meldet sich einmal an und listet die gefundenen Thermostate auf. Öffne dann den Tab Erkennung und füge deine Thermostate hinzu.
Zu Kontosperren. Das Portal sperrt ein Konto nach zu vielen fehlgeschlagenen
Anmeldungen, und ein gesperrtes Konto sperrt dich auch aus der Honeywell-App
aus. Deshalb versucht die Integration ein abgelehntes Passwort nie von selbst
erneut: Die Integration wartet, bis du neue Zugangsdaten speicherst oder auf Verbindung
testen klickst. Eine Anmeldeantwort, die sie nicht versteht, wird höchstens
alle 10 Minuten wiederholt, dreimal, dann hört sie genauso auf. Die Sitzung wird
unter /data (dem privaten Volume der Integration) gespeichert: Ein Neustart
von Gladys braucht keine neue Anmeldung.
Geräte und Funktionen
Ein Gerät pro Thermostat, mit den Funktionen, die es hat:
| Funktion | Was es ist |
|---|---|
| Innentemperatur | Die Temperatur, die das Thermostat misst. |
| Luftfeuchtigkeit innen | Wenn das Thermostat einen Feuchtesensor hat. |
| Außentemperatur, Luftfeuchtigkeit außen | Wenn ein Außenfühler am Thermostat angeschlossen ist. |
| Solltemperatur Heizen, Solltemperatur Kühlen | Steuerbar, in ganzen °F oder halben °C, innerhalb der Grenzen des Thermostats. |
| Systemmodus | Aus, Heizen, Kühlen, Auto (die Modi, die das Thermostat erlaubt). Die Notheizung zählt als „Heizen“. |
| Notheizung | Nur Wärmepumpen. Ausschalten kehrt zu „Heizen“ zurück, nie zu „Aus“. |
| Betriebszustand | Bereit, heizt oder kühlt (fehlt, wenn das Thermostat ihn nicht meldet). |
| Lüfter, Lüfter läuft | Auto, Ein, Umwälzen, nach Programm (die das Thermostat anbietet), und ob der Lüfter läuft. |
| Programm halten | Programm folgen, bis zur nächsten Periode, dauerhaft halten; ein Urlaubsmodus wird angezeigt, aber nur in der App eingestellt. |
Wie am Thermostat selbst hält eine Änderung der Solltemperatur bei laufendem Programm bis zur nächsten Programmperiode. Mit Programm halten machst du sie dauerhaft oder gibst das Thermostat seinem Programm zurück.
Ein Befehl wird sofort gesendet, sofort angezeigt, und das Thermostat wird etwa 15 Sekunden später erneut gelesen.
Dashboard-Widget
Honeywell-Thermostat: Wähle in seinen Einstellungen ein Thermostat. Es zeigt die Innen- und Außentemperatur, die Luftfeuchtigkeit und die aktiven Solltemperaturen (Live-Kacheln), dann den Modus, was die Anlage tut, den Lüfter, das Halten und die Verbindung. Schaltflächen:
- Einstellen: ein kurzes Formular mit den Solltemperaturen des aktuellen Modus, vorausgefüllt, und wie lange sie gelten (bis zur nächsten Periode oder bis du das Programm fortsetzt).
- Programm fortsetzen während eines Haltens, oder Halten, um die aktuellen Solltemperaturen zu behalten.
Das Thermostat-Widget von Gladys (Dashboard) funktioniert auch mit diesen Thermostaten: Lege in der Thermostat-Integration von Gladys ein „externes“ Thermostat an und verweise es auf die Solltemperatur Heizen.
Szenen-Auslöser
- Verbindung zum Thermostat verloren: Gladys erreicht ein Thermostat nicht
mehr. Filtere nach Thermostat und Ursache:
thermostat_offline(das Thermostat hat sein WLAN verloren),portal_unreachable(das Portal hat dreimal hintereinander nicht geantwortet) oderlogin_refused(das Portal hat die Anmeldung abgelehnt). Variablen:thermostat_name,cause. - Verbindung zum Thermostat wiederhergestellt: Das Thermostat antwortet
wieder. Variable:
thermostat_name.
Szenen-Aktion
Temperatur bis zu einer Uhrzeit halten: ein vorübergehendes Halten an einem
Thermostat, das zur angegebenen Uhrzeit von selbst zu seinem Programm
zurückkehrt (Uhrzeit des Thermostats, auf die nächste Viertelstunde
aufgerundet). Lass eine Solltemperatur leer, um sie zu behalten. Ausgabe:
until, das Ende des Haltens (HH:MM).
Szenen-Beispiele
- Heute Abend Gäste: Samstag um 18 Uhr „Temperatur bis zu einer Uhrzeit halten“ mit einer Solltemperatur Heizen von 72 bis 23:30. Das Programm läuft danach von selbst weiter.
- Alle sind weg: Wenn das Haus leer ist, stelle Programm halten auf „Dauerhaft halten“ und die Solltemperatur Heizen auf 62; wenn jemand zurückkommt, stelle Programm halten auf „Programm folgen“.
- Heizungsalarm: Bei „Verbindung zum Thermostat verloren“ mit der Ursache
thermostat_offlinesendest du die Nachricht „{{triggerEvent.data.thermostat_name}} ist offline“.
Aktualisierung und Grenzen des Portals
Total Connect Comfort hat keine öffentliche API: Die Integration nutzt das Webportal wie ein Browser. Das Portal nennt kein Kontingent, ist aber langsam und sperrt Konten, die es für zu aktiv hält. Deshalb:
- wird jedes zu Gladys hinzugefügte Thermostat einmal pro Periode gelesen (standardmäßig 5 Minuten, am schnellsten 2; Home Assistant liest alle 30 Sekunden);
- wird die Kontoliste nur beim Start, nach einer Konfigurationsänderung und bei einer neuen Suche im Tab Erkennung gelesen;
- gehen die Anfragen einzeln raus, und nur Änderungen werden an Gladys gesendet (ein unveränderter Wert wird alle 6 Stunden erneut gesendet, damit er nie veraltet wirkt).
Die Integration aktualisiert sich selbst, mit ihrem eigenen Timer, und hängt nicht von der Abfrage durch den Gladys-Kern ab.
Fehlerbehebung
- „Total Connect Comfort hat die E-Mail-Adresse oder das Passwort abgelehnt“: Prüfe sie auf mytotalconnectcomfort.com und speichere sie dann erneut in Gladys.
- „Das Konto ist gesperrt“: Warte, bis das Portal es entsperrt (melde dich zur Kontrolle auf der Website an), und klicke dann auf Verbindung testen.
- „Total Connect Comfort ist nicht erreichbar“: Das Portal ist gestört oder langsam; die Integration versucht es in jeder Periode erneut.
- Ein Thermostat erscheint als „nicht erreichbar“: Es hat sein WLAN verloren; prüfe es in der App Total Connect Comfort.
- Kein Thermostat gefunden: Das Konto ist vielleicht ein Resideo- / Honeywell-Home-Konto (Lyric, T-Serie), das diese Integration nicht unterstützt.
- Protokolle: Setze
LOG_LEVEL=debug, um jede Abfrage zu sehen. Passwörter und Sitzungs-Cookies werden nie in die Protokolle geschrieben.
Einschränkungen
- Ohne die Hardware entwickelt: Rückmeldungen sind willkommen.
- Nur das Portal für die USA und Kanada; kein Lyric, keine T-Serie, keine Resideo-App und kein Evohome.
- Befeuchter, Entfeuchter, Programme und Urlaubsmodus werden nicht verwaltet (ein Urlaubsmodus wird angezeigt, nicht eingestellt).
- Uhrzeiten sind die des Thermostats; das Portal rechnet in Viertelstunden.
- Das Portal ist keine offizielle API: Honeywell / Resideo kann es ohne Ankündigung ändern.
Konfigurationseinstellungen
Diese Einstellungen fragt Honeywell Total Connect in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Total-Connect-Comfort-Konto | section | Nein | Das Konto von mytotalconnectcomfort.com, das der App Total Connect Comfort. Lyric- und T-Serie-Thermostate (Resideo-App) nutzen eine andere Cloud und werden nicht unterstützt. Das Portal sperrt ein Konto nach zu vielen Fehlversuchen: Ein abgelehntes Passwort wird erst wieder versucht, wenn du neue Zugangsdaten speicherst. |
| E-Mail-Adresse | string | Ja | |
| Passwort | secret | Ja | |
| Portal abfragen alle | select | Nein | Das Portal ist langsam und mag keine eiligen Clients: 5 Minuten sind ein guter Takt. Ein Befehl wird ohnehin etwa 15 Sekunden später erneut gelesen. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen, wenn ein Thermostat zu Gladys hinzugefügt wird, und Sprache der Meldungen. |
So installierst du Honeywell Total Connect in Gladys
- Öffne in Gladys Integrationen: Honeywell Total Connect erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-honeywell-tcc:1.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/guim31/gladys-honeywell-tcc.
Honeywell Total Connect benötigt Gladys >=5.2.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
Honeywell Total Connect 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