Intégration domotique ecobee, gratuite et open source
Thermostats et capteurs ecobee : température, consignes, modes, confort, présence.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.2.0
- ★ 0
1. Présentation
Cette intégration amène vos thermostats ecobee et leurs capteurs de pièce SmartSensor dans Gladys : température, humidité, consignes de chauffage et de climatisation, mode, mode confort (Maison / Absent / Sommeil), maintiens, ce que fait l’installation et présence. Depuis Gladys, vous changez la consigne, le mode, la ventilation et le mode confort, reprenez le programme, et lancez ou annulez des vacances depuis une scène.
Elle passe par le cloud ecobee, comme l’appli ecobee : le thermostat doit être connecté à internet.
Développée sans le matériel : vos retours sont les bienvenus. Cette intégration n’a aucun lien avec ecobee.
2. Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Un compte ecobee (celui de l’appli ecobee) avec au moins un thermostat.
- Si votre compte utilise la validation en deux étapes : votre application d’authentification, ou votre téléphone pour le code par SMS. Les notifications et les liens par e-mail ne sont pas pris en charge.
- Facultatif : une clé d’API développeur, si vous en avez encore une (ecobee n’en délivre plus depuis 2024).
3. Configuration
Installez l’intégration depuis le store des intégrations de Gladys, puis ouvrez son onglet Configuration.
Connexion par compte ecobee (recommandée)
- Saisissez l’e-mail et le mot de passe de l’appli ecobee, puis enregistrez.
- Sans validation en deux étapes, le statut passe au vert et les thermostats apparaissent dans l’onglet Découverte.
- Avec validation en deux étapes, le statut demande le code : lancez l’action Saisir le code de vérification avec le code à 6 chiffres de votre application d’authentification, ou du SMS qu’ecobee vient d’envoyer (dans les 10 minutes).
L’intégration garde ensuite une session (jeton de renouvellement) dans son volume /data et la
renouvelle seule. Le mot de passe reste dans la configuration de Gladys ; il ne sert à nouveau
que si ecobee met fin à la session. Se connecter et tester lit les thermostats et indique
combien ont été trouvés. Se déconnecter supprime la session conservée.
Avec une clé d’API développeur (facultatif)
Saisissez la clé dans Clé d’API et enregistrez (elle remplace l’e-mail et le mot de passe). Lancez Obtenir un code PIN : sur ecobee.com, ouvrez My Apps, Add application, et saisissez le code pendant sa validité. L’intégration détecte seule l’autorisation.
Réglages
- Unité de température : l’unité des fonctionnalités : celle affichée par le thermostat (par défaut), Celsius ou Fahrenheit. Gladys convertit aussi les mesures dans l’unité préférée de chaque utilisateur.
- Maintenir les changements faits depuis Gladys : une consigne ou un mode confort changé depuis Gladys est un maintien, comme dans l’appli ecobee. Par défaut il dure jusqu’au prochain changement du programme ; vous pouvez choisir jusqu’à nouvel ordre, 2 heures, 4 heures, ou le réglage de maintien du thermostat.
- Intervalle de lecture : la fréquence de lecture d’ecobee, 3 minutes au minimum.
- Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités à l’ajout d’un appareil.
Ajoutez ensuite les appareils depuis l’onglet Découverte.
4. Appareils
Un appareil par thermostat
| Fonctionnalité | Ce que c’est |
|---|---|
| Température, Humidité | mesures intérieures du thermostat |
| Consigne de chauffage | cible en chauffage (seulement si le thermostat pilote un chauffage) |
| Consigne de climatisation | cible en climatisation (seulement s’il pilote une climatisation) |
| Mode | arrêt, chauffage, climatisation, auto (selon l’installation) |
| Chauffage d’appoint seul | pompes à chaleur seulement : l’appoint chauffe seul (chauffage de secours) |
| État de fonctionnement | au repos, en chauffe, en refroidissement |
| Ventilation permanente | activée : la ventilation tourne en continu ; désactivée : automatique |
| Ventilation en marche | la ventilation tourne en ce moment |
| Mode confort | programme (suivre le programme), Maison, Absent, Sommeil — l’écrire crée un maintien |
| Mode confort en cours | le nom du mode confort appliqué, y compris ceux que vous avez créés |
| Maintien | ce qui prime : programme, maintien jusqu’à une heure, maintien permanent, vacances |
| Présence | le détecteur de présence du thermostat (absent sur l’ecobee3 lite) |
Écrire Programme (valeur 0) sur le mode confort reprend le programme : tous les maintiens sont annulés, ainsi que des vacances en cours. En mode auto, la consigne de climatisation reste au-dessus de celle de chauffage d’au moins l’écart minimal du thermostat.
Un appareil par capteur de pièce (SmartSensor) : température et présence.
Les fonctionnalités du thermostat utilisent la catégorie thermostat du cœur : le thermostat de Gladys 5.2 peut piloter un ecobee comme thermostat externe (choisissez la consigne de chauffage comme cible et le mode comme fonctionnalité de mode).
5. Widget de tableau de bord
Ajoutez le widget Thermostat ecobee et choisissez un thermostat. Il affiche la température, la ou les consignes et l’humidité en tuiles en direct, le mode, ce qui fonctionne, le mode confort et le maintien, et quatre boutons :
- Baisser / Monter : un pas de consigne (0,5 °C ou 1 °F) ; en auto, les deux consignes bougent ensemble. Masqués quand le thermostat est arrêté.
- Mode : la liste des modes du thermostat.
- Confort : programme, Maison, Absent, Sommeil.
6. Déclencheurs de scène
- ecobee : présence détectée (
home_occupied) : personne n’était détecté autour d’un thermostat (lui et ses capteurs), maintenant quelqu’un l’est. Variables : nom du thermostat, capteurs qui détectent quelqu’un. - ecobee : plus personne (
home_vacant) : plus aucun capteur du thermostat ne détecte quelqu’un. - ecobee : nouvelle alerte (
alert) : le thermostat a émis une alerte ou un rappel (filtre à changer, entretien, température hors limites…). Variables : nom du thermostat, texte, type.
La présence de chaque capteur est aussi une fonctionnalité : utilisez le déclencheur habituel « valeur d’un appareil » pour une seule pièce. Ces déclencheurs ajoutent ce qu’une fonctionnalité seule ne dit pas : toute la maison.
7. Actions de scène
- ecobee : reprendre le programme (
resume_program) : annule tous les maintiens et les vacances en cours. - ecobee : choisir un mode confort (
set_comfort) : maintient Maison, Absent ou Sommeil pour la durée choisie (celle de la configuration, jusqu’au prochain changement du programme, jusqu’à nouvel ordre, 2 ou 4 heures). - ecobee : partir en vacances (
start_vacation) : démarre des vacances ecobee maintenant pour un nombre de jours ; sans consignes, celles du mode Absent. Sortie : la date de fin. - ecobee : annuler les vacances (
cancel_vacation) : supprime les vacances en cours et prévues.
La consigne, le mode et la ventilation se règlent avec l’action « Contrôler un appareil » du cœur. Un capteur de pièce choisi dans une action vaut pour son thermostat.
8. Exemples de scènes
- Tout le monde est parti : quand l’alarme est armée, lancez choisir un mode confort Absent, jusqu’à nouvel ordre ; quand elle est désarmée, lancez reprendre le programme.
- Rappel du filtre : sur nouvelle alerte, envoyez le message « {{triggerEvent.data.text}} ».
- Fenêtre ouverte : quand un détecteur d’ouverture signale une ouverture depuis 5 minutes, passez le Mode à arrêt ; à la fermeture, repassez-le en chauffage.
- Long voyage : depuis le calendrier, lancez partir en vacances pour 10 jours.
9. Rafraîchissement et limites de l’API
ecobee demande aux clients de son API de ne pas lire les thermostats plus souvent que toutes les 3 minutes. L’intégration lit tous vos thermostats en une seule requête à chaque intervalle de lecture (3 minutes par défaut), plus une lecture quelques secondes après une commande pour en montrer l’effet. Seules les valeurs qui changent sont envoyées à Gladys, et chaque valeur au moins toutes les 6 heures. L’intégration se rafraîchit seule et ne dépend pas du sondage de Gladys.
10. Dépannage
- « ecobee a refusé l’e-mail ou le mot de passe » : vérifiez-les dans l’appli ecobee ; l’intégration ne réessaie jamais seule un mot de passe refusé, enregistrez à nouveau la configuration.
- Le statut demande un code de vérification : lancez Saisir le code de vérification. Un code par SMS vaut environ 10 minutes ; au-delà, l’action déclenche un nouveau SMS.
- « ecobee demande une étape dans un navigateur » : connectez-vous une fois sur ecobee.com (nouvelles conditions…), puis enregistrez à nouveau la configuration.
- « ecobee ne répond pas » : coupure d’internet ou d’ecobee ; l’intégration réessaie à chaque intervalle de lecture.
- Un thermostat est hors ligne : il a perdu sa connexion à ecobee ; ses dernières valeurs restent, les commandes sont refusées jusqu’à son retour.
- Journaux : l’intégration écrit sa connexion et les problèmes une fois ;
LOG_LEVEL=debugmontre chaque lecture.
11. Limites
- La connexion par compte utilise la même page de connexion que le portail web ecobee, comme Home Assistant : si ecobee la change, la connexion peut casser jusqu’à une mise à jour.
- La validation en deux étapes par notification ou lien par e-mail n’est pas prise en charge.
- Les lectures ont lieu au plus toutes les 3 minutes : la présence et l’état de fonctionnement ne sont pas instantanés.
- Non pris en charge : humidificateur, déshumidificateur et ventilateur d’air neuf, capteurs d’un mode confort, qualité de l’air, météo, et la modification du programme du thermostat.
- Les noms des fonctionnalités sont figés à l’ajout d’un appareil dans Gladys.
- Développée sans le matériel ni compte ecobee : testée seulement sur des réponses publiées de l’API. Vos retours sont les bienvenus.
Paramètres de configuration
Voici les paramètres demandés par ecobee dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte ecobee | section | Non | Saisissez l’e-mail et le mot de passe de l’appli ecobee, puis enregistrez. Si votre compte utilise la validation en deux étapes, saisissez le code avec l’action « Saisir le code de vérification ». Sans lien avec ecobee. |
string | Non | L’e-mail de votre compte ecobee. | |
| Mot de passe | secret | Non | Conservé par Gladys, réutilisé seulement quand ecobee met fin à la session. |
| Réglages | section | Non | Unité des températures, durée d’un changement fait depuis Gladys, fréquence de lecture d’ecobee. |
| Unité de température | select | Non | L’unité des fonctionnalités. Gladys convertit aussi les mesures dans l’unité de chaque utilisateur. |
| Maintenir les changements faits depuis Gladys | select | Non | Une consigne ou un mode confort changé depuis Gladys est un maintien, comme dans l’appli ecobee. |
| Intervalle de lecture (minutes) | number | Non | ecobee demande de ne pas lire plus souvent que toutes les 3 minutes. |
| Langue des noms de fonctionnalités | select | Non | Les noms sont figés quand l’appareil est ajouté à Gladys. |
| Clé d’API développeur (facultatif) | section | Non | ecobee ne délivre plus de clés d’API. Si vous en avez encore une, saisissez-la ici à la place de l’e-mail et du mot de passe, enregistrez, puis utilisez l’action « Obtenir un code PIN ». |
| Clé d’API | secret | Non |
Comment installer ecobee dans Gladys
- Dans Gladys, ouvrez Intégrations : ecobee 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/guim31/gladys-ecobee:1.0.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/guim31/gladys-ecobee.
ecobee nécessite Gladys >=5.2.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
ecobee 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 guim31, 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