Intégration domotique ebusd, gratuite et open source
Chaudières et PAC Vaillant, Saunier Duval, Wolf… sur l’eBUS, via ebusd, en local.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration fait entrer votre chauffage eBUS dans Gladys : Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder et les autres marques dont les chaudières, pompes à chaleur et régulateurs dialoguent sur l’eBUS. Elle passe par ebusd, un programme libre qui écoute le bus au moyen d’un adaptateur eBUS et connaît les messages de chaque appareil.
Chaque appareil eBUS connu d’ebusd devient un appareil Gladys : la chaudière, la pompe à chaleur, le régulateur, les circuits de chauffage, plus ebusd lui-même avec le signal eBUS. Les valeurs qui changent sur le bus arrivent en direct ; les autres sont lues toutes les quelques minutes. Tout reste sur votre réseau local.
Intégration non officielle, sans lien avec le projet ebusd ni les marques citées.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- ebusd qui tourne sur un Raspberry Pi, un NAS, la machine de Gladys (image Docker
john30/ebusd) ou en module complémentaire Home Assistant, avec un adaptateur eBUS (par exemple l’eBUS Adapter Shield). - ebusd avec ses fichiers de configuration (par défaut) et son port TCP 8888 joignable depuis Gladys : ne le lancez pas avec
--localhost. Vérifiez avecebusctl infoqu’il voit vos appareils et affiche une configurationloadedpour chacun.
Configuration
ebusd
- Adresse d’ebusd : l’adresse IP ou le nom de la machine où tourne ebusd.
localhostne fonctionne pas : Gladys fait tourner l’intégration dans son propre conteneur. - Port TCP : 8888 sauf si vous avez changé
--port. - Utilisateur et secret : seulement si ebusd utilise un fichier d’accès (
--aclfile). - Intervalle de lecture : de 1 à 10 minutes (2 par défaut). L’eBUS est lent et partagé avec votre chauffage ; les valeurs qui changent arrivent de toute façon en direct.
- Valeurs proposées : les valeurs utiles (températures, pression, flamme, modulation, puissance, énergie, heures, démarrages, modes, erreur), ou toutes celles qu’ebusd a vues.
- Messages en plus : des messages toujours proposés et lus, nommés comme dans ebusd (
ebusctl find), par exemplebai.PumpPower, 700.Z1NightTemp. - Langue : la langue des noms d’appareils et de fonctionnalités et des messages d’erreur.
Appuyez sur Tester ebusd et chercher les appareils : la réponse donne la version d’ebusd, le signal eBUS et les appareils trouvés avec leur nombre de valeurs.
Modifier les réglages
Désactivé par défaut : Gladys ne fait que lire. Cochez Autoriser les modifications pour que Gladys puisse changer ce que le régulateur ouvre à tout le monde :
- les consignes ambiantes (jour, nuit…) : de 5 à 30 °C ;
- la consigne d’eau chaude : de 35 à 70 °C ;
- les marches/arrêts et les modes de fonctionnement (chauffage, eau chaude : off, auto, jour, nuit…).
Jamais les réglages installateur ou SAV. Une même valeur n’est jamais réécrite, un même message au plus une fois par minute, 100 modifications par jour au maximum ; la valeur est relue après l’écriture.
Utilisation
Appareils
Dans Intégrations → ebusd → Découverte, ajoutez les appareils voulus :
- ebusd : le signal eBUS (allumé quand l’adaptateur entend le bus) ;
- un appareil par circuit eBUS, nommé d’après son type et son modèle, par exemple Chaudière bai (Vaillant BAI00) ou Régulateur 700 (Vaillant 70000).
Leurs fonctionnalités sont les valeurs utiles : températures de départ, de retour, extérieure, ambiante, d’eau chaude et du ballon, pression d’eau, flamme, modulation, heures et démarrages, modes chauffage et eau chaude, erreur en cours… Un nouvel appareil apparaît quelques minutes après qu’ebusd a chargé sa configuration : relancez Scanner.
Widgets
- Chauffage : les principales températures, la pression et la modulation, en direct, puis la flamme, les modes, la consigne d’eau chaude et l’erreur en cours.
- Courbes du chauffage : températures extérieure, de départ, de retour et d’eau chaude sur 24 heures, 3 ou 7 jours.
- eBUS : ebusd, le trafic du bus et les appareils vus avec leur modèle et leur logiciel.
Scènes
Déclencheurs : Un appareil eBUS signale une erreur (avec le code d’erreur), Une erreur eBUS disparaît, ebusd ne répond plus, ebusd répond de nouveau.
Actions : Lire une valeur eBUS (n’importe quel message par circuit et nom : valeur, nombre, unité, tous les champs) et Écrire une valeur eBUS (un message ouvert à tous, quand les modifications sont autorisées).
Exemples :
- Quand la chaudière signale une erreur, envoyer un message avec le code d’erreur.
- Quand ebusd ne répond plus, prévenir : la maison n’est peut-être plus chauffée.
- Chaque matin, lire
bai WaterPressure; sous 1 bar, rappeler de remettre en pression le chauffage.
Dépannage
- ebusd ne répond pas : vérifiez l’adresse et le port, qu’ebusd écoute sur le réseau (pas
--localhost) et qu’aucun pare-feu ne bloque le port 8888. - Pas de signal eBUS : ebusd tourne mais l’adaptateur n’entend rien ; vérifiez l’adaptateur, son câblage et
ebusctl state. - Un appareil ou une valeur manque : attendez qu’ebusd charge la configuration de l’appareil (
ebusctl info), puis relancez la recherche ; choisissez « Toutes celles qu’ebusd a vues » ou indiquez le message dans « Messages en plus ». - Une modification est refusée : cochez Autoriser les modifications ; un même message peut changer une fois par minute ; les réglages installateur ne sont jamais écrits.
- Journaux : l’onglet Journaux de la page de l’intégration.
Paramètres de configuration
Voici les paramètres demandés par ebusd dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre ebusd | section | Non | ebusd est un programme libre qui dialogue avec l’eBUS de votre chauffage (Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder…) au moyen d’un adaptateur eBUS (par exemple l’eBUS Adapter Shield). Faites-le tourner sur un Raspberry Pi, un NAS ou la machine de Gladys, avec ses fichiers de configuration (par défaut) et son port TCP 8888 ouvert au réseau (sans --localhost). Gladys le lit sur le réseau local : rien ne sort de chez vous. Sans lien avec le projet ebusd ni les marques citées. |
| Adresse d’ebusd | string | Non | L’adresse IP ou le nom de la machine où tourne ebusd (« localhost » ne fonctionne pas : Gladys fait tourner l’intégration dans son propre conteneur). |
| Port TCP | number | Non | L’option --port d’ebusd, 8888 sauf si vous l’avez changée. |
| Utilisateur (facultatif) | string | Non | Seulement si ebusd utilise un fichier d’accès (--aclfile) : l’utilisateur avec lequel Gladys se connecte. |
| Secret (facultatif) | secret | Non | Le secret de cet utilisateur dans le fichier d’accès. |
| Ce que Gladys lit | section | Non | Gladys suit en direct chaque valeur qui change sur le bus, et lit les autres à l’intervalle ci-dessous, dans la mémoire d’ebusd quand elle est assez récente. Chaque appareil eBUS (chaudière, régulateur, pompe à chaleur, circuit de chauffage…) devient un appareil Gladys ; ses fonctionnalités sont les valeurs utiles qu’ebusd a déjà vues (températures, pression, flamme, modes, heures, démarrages, erreur), plus les valeurs connues des installations Vaillant. |
| Intervalle de lecture | select | Non | L’eBUS est lent et partagé avec votre chauffage : quelques minutes suffisent largement. |
| Valeurs proposées | select | Non | |
| Messages en plus (facultatif) | string | Non | Noms de circuit et de message tels qu’ebusd les affiche (ebusctl find), séparés par des virgules : Gladys les lit même si ebusd ne les a pas encore vus. |
| Modifier les réglages | section | Non | Désactivé par défaut : Gladys ne fait que lire. Une fois autorisé, Gladys peut changer ce que le régulateur laisse changer à tout le monde : consignes ambiantes (5 à 30 °C), consigne d’eau chaude (35 à 70 °C), modes de fonctionnement, marche/arrêt. Jamais les réglages installateur ou SAV. Un même message au plus une fois par minute, 100 modifications par jour au maximum. |
| Autoriser les modifications | boolean | Non | À cocher seulement si vous connaissez ces réglages : un mauvais réglage peut laisser la maison froide. Consultez la notice de votre régulateur. |
| Langue des noms et des textes | select | Non | Gladys n’indique pas aux intégrations la langue de ses utilisateurs : choisissez celle des noms des appareils et des fonctionnalités et des messages d’erreur. |
Comment installer ebusd dans Gladys
- Dans Gladys, ouvrez Intégrations : ebusd 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/william-de71/gladys-ebusd:0.1.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/William-De71/gladys-ebusd.
ebusd nécessite Gladys >=5.3.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
ebusd 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 William-De71, 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