Intégration domotique Honeywell Evohome, gratuite et open source
Chauffage Honeywell / Resideo Evohome : zones, consignes, modes du système, eau chaude.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration amène dans Gladys un chauffage Honeywell / Resideo Evohome par le cloud Total Connect Comfort international, celui de l'application Evohome (Europe, Royaume-Uni) : le contrôleur Evohome (Evotouch, Evohome Wi-Fi, Round Wireless avec sa passerelle RFG100), ses zones de chauffage et l'eau chaude. Elle utilise le compte de l'application. Non officielle, sans lien avec Honeywell ni Resideo.
Version de développement (0.1). Réalisée d'après le protocole d'evohome-async (la bibliothèque de l'intégration evohome de Home Assistant) et testée avec des réponses simulées, pas encore avec un vrai système Evohome. Vos retours sont les bienvenus sur le dépôt GitHub.
Quelle intégration Honeywell ?
| Votre application ou portail | Vos appareils | Intégration |
|---|---|---|
| Application Evohome, international.mytotalconnectcomfort.com (Europe) | Evohome, Evotouch, Round Wireless + RFG100 | celle-ci |
| Total Connect Comfort, mytotalconnectcomfort.com (États-Unis, Canada) | RTH6580WF, RTH8580WF, RTH9580WF, VisionPRO Wi-Fi… | guim31/gladys-honeywell-tcc |
| Application Honeywell Home / Resideo (API développeur) | Lyric Round, T5, T6, T9, T10 | guim31/gladys-honeywell-lyric |
Ce que vous obtenez
| Appareil | Dans Gladys |
|---|---|
| Le système | mode du système (réglable), fin d'un mode temporaire, défaut, défauts actifs |
| Chaque zone | température, consigne (réglable), chauffage marche/arrêt, mode de consigne (réglable), fin de la dérogation, batterie faible, défaut, défauts actifs |
| Eau chaude | température du ballon, marche/arrêt (réglable), mode (programme, marche, boost, arrêt), fin de la dérogation, batterie faible, défaut, défauts actifs |
- Modes du système : Auto (le programme), Économie, Absent, Jour de congé, Personnalisé, Chauffage arrêté, et « Auto, zones réinitialisées » (Auto et chaque zone revient à son programme), selon ce que propose votre contrôleur.
- Consigne : une consigne changée depuis Gladys tient 60 minutes par défaut (puis la zone reprend son programme), ou jusqu'au prochain changement : voir les options. Le mode de consigne de la zone indique si elle suit son programme ou tient une dérogation, et jusqu'à quand.
- Chauffage arrêté sur une zone la maintient à son minimum (5 °C, hors-gel) jusqu'à ce que vous choisissiez Chauffage, qui la remet sur son programme. Une zone se lit aussi « arrêt » quand tout le système est en Chauffage arrêté.
- Eau chaude : marche et arrêt sont permanents ; Boost la met en marche pour la durée configurée (60 minutes par défaut) ; Programme la remet sur son programme.
- Défauts : ceux du cloud Evohome (batterie faible, communication perdue
avec un capteur, un actionneur, la chaudière ou la passerelle…). « Défaut »
vaut 1 tant qu'un défaut est actif, « Défauts actifs » les liste,
« Batterie faible » vaut 1 quand l'un d'eux est une batterie faible. Quand
la passerelle perd sa connexion, le badge des appareils passe à
unreachableavec un point orange. - Les températures ont la précision que donne le cloud (souvent 0,5 °C), et le cloud apprend en quelques minutes un changement fait sur le contrôleur.
Installation
- Installez l'intégration depuis le store Gladys.
- Dans l'onglet Configuration, saisissez l'e-mail et le mot de passe de votre compte Total Connect Comfort (ceux de l'application Evohome), puis enregistrez.
- Le statut indique « Connecté à Evohome « Maison » : 6 zones et eau chaude ».
- Ouvrez l'onglet Découverte et ajoutez les appareils voulus. Leurs valeurs arrivent dès leur ajout.
Le bouton Tester la connexion relit le cloud et liste les emplacements du compte, le mode et les défauts.
Plusieurs logements
Un compte peut avoir plusieurs emplacements. L'intégration en suit un : le premier par défaut, ou celui dont vous saisissez le nom ou le numéro dans Emplacement. « Tester la connexion » donne les noms et les numéros.
Scènes
Quatre actions de scène :
- Régler le mode du système Evohome : un mode, en permanence ou pour un temps : des heures pour Économie (jusqu'à la fin de l'heure, 24 h au plus), des jours pour Absent, Jour de congé et Personnalisé (jusqu'à minuit, aujourd'hui comptant comme premier jour).
- Régler la consigne d'une zone Evohome : une zone et une température, pendant un nombre de minutes (vide : la valeur de la configuration ; 0 : en permanence).
- Remettre une zone Evohome sur son programme.
- Régler l'eau chaude Evohome : marche, arrêt ou programme, en permanence ou pendant un nombre de minutes.
Elles renvoient until, la fin de la dérogation (UTC, vide si permanente).
Trois déclencheurs de scène :
- Mode du système Evohome changé : le mode a changé hors de Gladys (sur
le contrôleur, dans l'application, à la fin d'un mode temporaire).
Variables :
system_name,mode,previous_mode,permanent,until. Un mode réglé depuis Gladys ne le déclenche pas. - Défaut Evohome détecté et Défaut Evohome résolu : pour un appareil
ou tous ; variables
device_name,fault_type(ex.TempZoneActuatorLowBattery) etsince.
Les défauts déjà actifs au démarrage de l'intégration ne déclenchent rien. Les températures et consignes fonctionnent avec le déclencheur habituel « Changement d'état d'un appareil ».
Fréquence de lecture
Honeywell limite le nombre de connexions et de requêtes par compte (un blocage d'une heure a été signalé). L'intégration :
- se connecte une fois et garde la session (environ 30 minutes, renouvelée
avec son jeton de rafraîchissement) dans son dossier
/data: un redémarrage ne se reconnecte pas ; - lit l'état de l'emplacement en une requête, toutes les 5 minutes par défaut (60 s minimum, comme Home Assistant), plus une lecture 15 s après une commande ;
- lit l'installation (zones, eau chaude, modes permis) au démarrage, une fois par jour et sur Scanner dans l'onglet Découverte (au plus toutes les 10 minutes) ;
- attend 1, 2, 5, 10 puis 15 minutes après une erreur, et aussi longtemps que Honeywell le demande après un « trop de requêtes » (30 minutes sinon, une heure après trop de connexions).
Options
| Option | Défaut | Rôle |
|---|---|---|
| E-mail, mot de passe | — | le compte Total Connect Comfort de l'application Evohome |
| Emplacement | vide (le premier) | l'emplacement à suivre quand le compte en a plusieurs |
| Consigne réglée depuis Gladys | pendant la durée | une consigne de zone tient un moment, ou jusqu'au prochain changement |
| Durée de la dérogation de consigne (min) | 60 | durée d'une consigne réglée depuis Gladys (10 à 1440) |
| Durée du boost d'eau chaude (min) | 60 | durée de marche de l'eau chaude en Boost (10 à 1440) |
| Intervalle de rafraîchissement (s) | 300 | fréquence de lecture de l'état (60 à 3600) |
| Langue des noms des fonctionnalités | Français | noms des fonctionnalités et des modes des appareils ajoutés désormais |
Dépannage
- « Total Connect Comfort a refusé l'e-mail ou le mot de passe » : vérifiez-les sur international.mytotalconnectcomfort.com, puis dans la configuration. L'intégration ne réessaie pas seule : elle attend une modification ou un clic sur Tester la connexion.
- « Trop de connexions » ou « demande de ralentir » : Honeywell bloque le compte un moment. Ne baissez pas l'intervalle de rafraîchissement ; arrêtez si possible les autres outils qui lisent le même compte (Home Assistant, Homebridge…).
- « Total Connect Comfort est injoignable » : le cloud ou votre accès Internet est en panne (état du service : https://status.resideo.com).
- Une zone n'a pas de température : son capteur ne répond plus au contrôleur (voir ses défauts).
- Un thermostat américain ou canadien, ou un Lyric / série T : ce n'est pas la bonne intégration, voir le tableau en haut.
Vie privée
L'e-mail et le mot de passe sont stockés par Gladys comme un secret (jamais
renvoyé au navigateur). L'intégration ne les envoie qu'à tccna.resideo.com,
le cloud Total Connect Comfort de l'application Evohome, pour ouvrir une
session ; elle garde les jetons d'accès et de rafraîchissement et
l'identifiant d'utilisateur dans son dossier /data (avec une empreinte de
l'e-mail, jamais le mot de passe). Honeywell, Evohome et Total Connect Comfort
sont des marques de leurs propriétaires ; cette intégration est sans lien avec
Honeywell ni Resideo.
Paramètres de configuration
Voici les paramètres demandés par Honeywell Evohome dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Total Connect Comfort | section | Non | Amène votre système Honeywell / Resideo Evohome dans Gladys par le cloud Total Connect Comfort international (celui de l'application Evohome, Europe) : chaque zone de chauffage avec sa température et sa consigne, le mode du système (Auto, Économie, Absent, Jour de congé, Personnalisé, Chauffage arrêté), l'eau chaude, les défauts, et des actions et déclencheurs de scène. Saisissez l'e-mail et le mot de passe de l'application, puis ajoutez les appareils depuis l'onglet Découverte. Lu toutes les 5 minutes par défaut : Honeywell limite les connexions et les requêtes. Pour le portail États-Unis et Canada (mytotalconnectcomfort.com) ou l'application Honeywell Home (Lyric, série T), utilisez les autres intégrations Honeywell du store. Non officiel, sans lien avec Honeywell ni Resideo. |
| E-mail Total Connect Comfort | string | Oui | |
| Mot de passe Total Connect Comfort | secret | Oui | |
| Emplacement (plusieurs logements seulement) | string | Non | Nom ou numéro de l'emplacement à suivre quand le compte en a plusieurs. Vide : le premier. « Tester la connexion » les liste. |
| Consigne réglée depuis Gladys | select | Non | Une consigne de zone changée depuis le tableau de bord tient un moment (puis le programme reprend), ou jusqu'au prochain changement. |
| Durée de la dérogation de consigne (min) | number | Non | Durée d'une consigne réglée depuis Gladys, en minutes (10 à 1440, par pas de 10). |
| Durée du boost d'eau chaude (min) | number | Non | Durée de marche de l'eau chaude en mode Boost, en minutes (10 à 1440). |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture de l'état, en secondes (60 à 3600). Une requête par lecture ; Honeywell bloque les comptes qui lisent trop souvent. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités et des modes des appareils ajoutés désormais. |
Comment installer Honeywell Evohome dans Gladys
- Dans Gladys, ouvrez Intégrations : Honeywell Evohome apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-evohome:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-evohome.
Honeywell Evohome nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Honeywell Evohome est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation