Intégration domotique Heatzy, gratuite et open source
Modules fil pilote Heatzy : mode de chaque radiateur, vacances, widget et scènes.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos modules fil pilote Heatzy depuis Gladys : le mode de chaque radiateur électrique (Confort, Eco, Hors gel, Off, et Confort -1°C / -2°C sur les modules qui les ont), le mode vacances, le verrouillage et la programmation, ainsi que la température ambiante sur les modèles qui la mesurent. Un widget de tableau de bord change tous les radiateurs d'un coup, et des scènes réagissent quand un radiateur change de mode ou qu'un module passe hors ligne.
Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été construite et testée sur un cloud Heatzy simulé, alimenté par les vrais modules des tests de hass-heatzy (Home Assistant), pas avec un vrai compte Heatzy. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.
Ce qu'il vous faut
- Gladys Assistant 5.1.0 ou plus récent.
- Un compte Heatzy (l'adresse e-mail et le mot de passe de l'application Heatzy), avec vos modules déjà installés dans l'application.
- Une connexion Internet : les modules ne sont joignables que par le cloud Heatzy (Gizwits), il n'existe pas d'API locale.
Modules pris en charge : Pilote v1, Pilote v2 et v3 (Elec Pro compris), Pilote v4, Pilote Pro, Glow, Onyx, Inea et Bloom. Un autre module Heatzy est affiché avec le protocole commun des modules récents.
Mise en route
- Installez l'intégration depuis le catalogue de Gladys.
- Dans Configuration, saisissez l'Adresse e-mail et le Mot de passe de votre compte Heatzy, puis enregistrez.
- Cliquez sur Tester la connexion : le message sous le bouton liste les modules du compte.
- Ouvrez l'onglet Découverte : un appareil par module, nommé comme dans l'application Heatzy. Cliquez sur Ajouter, choisissez une pièce, enregistrez.
Options :
- Intervalle de rafraîchissement : la fréquence de lecture des modules, de 1 à 10 minutes (2 minutes par défaut). Un changement fait depuis Gladys s'affiche tout de suite et est vérifié quelques secondes plus tard ; un changement fait dans l'application Heatzy apparaît à la lecture suivante.
- Langue des noms : anglais, français, allemand ou espagnol (français par défaut), pour les noms de fonctionnalités (donnés à l'ajout d'un appareil) et les messages de l'intégration.
L'appareil de chaque module
| Fonctionnalité | Ce que c'est |
|---|---|
| Mode fil pilote | Le mode du radiateur, avec le sélecteur fil pilote de Gladys : Confort, Confort -1°C, Confort -2°C, Eco, Hors gel, Off |
| Verrouillage | Verrouille les boutons du module (pas sur le Pilote v1 ni le Bloom) |
| Programmation | Allumée : le module suit la programmation réglée dans l'application Heatzy ; éteinte : il garde le mode choisi (pas sur le Pilote v1) |
| Température ambiante | Glow, Onyx, Inea, Bloom et Pilote Pro seulement, en lecture seule |
| Humidité | Pilote Pro seulement, en lecture seule |
Confort -1°C et -2°C existent sur les Pilote v4, Pilote Pro, Glow, Onyx, Inea et Bloom : les autres modules les refusent avec un message. Le badge de l'appareil indique Cloud tant que le module est connecté au cloud Heatzy et Injoignable quand il est hors ligne.
Les consignes confort et éco des Glow, Onyx, Inea, Bloom et Pilote Pro ne sont pas affichées : une consigne serait prise pour un thermostat par Gladys, HomeKit et les assistants vocaux, ce qu'un fil pilote n'est pas. Réglez-les dans l'application Heatzy.
Tableau de bord
Ajoutez le widget Radiateurs Heatzy à un tableau de bord. Par défaut, il liste tous les radiateurs avec leur mode (et, après un point, vacances, boost, programme et la température ambiante) ; choisissez un radiateur dans ses réglages pour ne montrer que lui. Ses quatre boutons agissent sur ce que le widget montre :
- Confort, Eco, Hors gel : immédiatement ;
- Off : après une confirmation, puisqu'il laisse les pièces sans chauffage.
Le bouton du mode en cours porte une coche quand tous les radiateurs montrés y sont. Confort -1°C et -2°C sont sur le sélecteur de l'appareil.
Scènes
Déclencheurs
- Mode d'un radiateur changé hors de Gladys : l'application Heatzy, la
programmation ou un bouton du module a changé le mode d'un radiateur. Filtres
: le radiateur, le nouveau mode. Variables : nom et appareil du radiateur,
nouveau mode, mode précédent (
comfort,comfort_1,comfort_2,eco,frost_protection,off), programmation active. Les changements faits par Gladys ne sont pas annoncés (une scène qui y réagirait pourrait boucler) ; le déclencheur d'appareil de Gladys sur la fonctionnalité Mode fil pilote voit tous les changements. - Module Heatzy hors ligne : un module a perdu sa connexion au cloud (Wi-Fi, coupure de courant). Filtre : le radiateur.
- Module Heatzy de retour en ligne : le module est de nouveau connecté. Filtre : le radiateur.
Actions
- Mettre des radiateurs Heatzy dans un mode : un radiateur, ou tous si le radiateur est laissé vide. Des vacances en cours sont arrêtées, et la programmation éteinte pour que le mode tienne. Sur tous les radiateurs, Confort -1°C et -2°C sautent les modules qui ne les ont pas. Sortie : le nombre de modules ayant accepté.
- Démarrer le mode vacances Heatzy : hors gel pendant 1 à 255 jours, puis le module reprend sa programmation. Pas sur le Pilote v1.
- Arrêter le mode vacances Heatzy : arrête les vacances (ou un boost lancé dans l'application Heatzy).
Pour un seul radiateur, l'action Gladys Contrôler un appareil sur sa fonctionnalité Mode fil pilote fonctionne aussi.
Idées de scènes
- Départ de la maison (alarme activée) : Mettre des radiateurs Heatzy dans un mode, tous les radiateurs, Eco ; au retour : Confort.
- Fenêtre ouverte (détecteur d'ouverture de la pièce) : passer ce radiateur en Hors gel ; refermée : Confort.
- Un module hors ligne pour la nuit : Module Heatzy hors ligne → envoyer un message : « Le radiateur {{triggerEvent.data.radiator}} est hors ligne ».
Dépannage
- « Heatzy refuse l'adresse e-mail ou le mot de passe » : vérifiez-les en vous connectant à l'application Heatzy. Après cette erreur, l'intégration arrête d'essayer (pour ne pas bloquer le compte) jusqu'à ce que vous enregistriez la configuration ou cliquiez sur Tester la connexion.
- « Trop de requêtes » : le cloud Heatzy limite les requêtes ; l'intégration patiente dix minutes. Choisissez un intervalle plus long si cela revient.
- Un radiateur ne change pas de mode : vérifiez que le module est en ligne dans l'application Heatzy. Un mode choisi dans Gladys éteint la Programmation, pour qu'il tienne : rallumez-la pour revenir à la programmation.
- Un mode s'affiche avec quelques minutes de retard : les changements faits hors de Gladys sont vus à la lecture suivante (l'intervalle de rafraîchissement).
- Plus de détails : les journaux de l'intégration (Paramètres → Intégrations → Heatzy). Ils ne contiennent jamais le mot de passe ni le jeton.
Limites
- Cloud uniquement : sans Internet, ou quand le cloud Heatzy est en panne, rien ne se pilote depuis Gladys (les modules gardent leur mode et leur programmation).
- Lecture toutes les minutes au plus : le cloud Heatzy (Gizwits) est partagé par tous les utilisateurs Heatzy et a des quotas. Chaque lecture coûte une requête, plus une par module.
- La programmation elle-même, les consignes, le boost et la détection de présence du Pilote Pro se règlent dans l'application Heatzy.
- Le Pilote Pro affiche le mode qu'il applique (qui peut différer du mode demandé, par exemple quand il détecte une fenêtre ouverte).
- Développée sans le matériel : vos retours sont les bienvenus.
- Sans lien avec Heatzy.
Paramètres de configuration
Voici les paramètres demandés par Heatzy dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Heatzy | section | Non | Le compte de l'application Heatzy : chaque module du compte devient un appareil dans l'onglet Découverte. L'intégration lit le cloud Heatzy : une connexion Internet est nécessaire. |
| Adresse e-mail | string | Oui | Celle qui sert à vous connecter à l'application Heatzy. |
| Mot de passe | secret | Oui | Le mot de passe de l'application Heatzy. Il reste dans Gladys et n'est envoyé qu'au cloud Heatzy. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture des modules. Un changement fait depuis Gladys s'affiche tout de suite. |
| Langue des noms | select | Non | Langue des noms de fonctionnalités et des messages de l'intégration. |
Comment installer Heatzy dans Gladys
- Dans Gladys, ouvrez Intégrations : Heatzy 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-heatzy:1.0.0), 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-heatzy.
Heatzy 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
Heatzy 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