Intégration domotique Qbus, gratuite et open source
Domotique Qbus : lumières, variateurs, volets, thermostats et scènes en MQTT local.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.0.0
- ★ 0
Cette intégration apporte dans Gladys les sorties de vos contrôleurs domotiques Qbus (CTD 3.x, la domotique filaire du fabricant belge Qbus), sur votre réseau local, via la passerelle MQTT Qbus et votre propre broker MQTT. Rien ne passe par Internet.
Cette intégration n'a jamais été testée avec une vraie installation Qbus : elle suit le protocole de qbusmqttapi, la bibliothèque écrite par Qbus pour Home Assistant. Vos retours sont les bienvenus sur le forum. Non officiel, sans lien avec Qbus.
Ce que vous obtenez
| Sortie Qbus | Dans Gladys |
|---|---|
| Relais (marche/arrêt) | déclaré sûr : un interrupteur ; sinon un état en lecture seule et des boutons « Allumer » / « Éteindre » |
| Variateur (analog) | déclaré sûr : une lumière (marche/arrêt, luminosité) ; sinon un état et un niveau en lecture seule, et les boutons |
| Lumière couleur (multicolor) | une lumière : marche/arrêt, luminosité, couleur |
| Volet, store | un volet : ouvrir / fermer / stop, et sa position quand le contrôleur la donne |
| Thermostat | la température de la pièce et la consigne (commandes de consigne désactivées par défaut, voir plus bas) |
| Scène | un bouton poussoir « Lancer » |
| Jauge | un capteur : température, humidité, CO2, luminosité, pression, puissance, courant, tension, vent |
| Humidité, ventilation | capteur d'humidité, capteur de CO2 |
| Station météo | température extérieure, luminosité, vent, pluie |
Pas dans cette version : les sélecteurs (stepper), les régimes (préréglages) des thermostats et des ventilations, les lames des stores vénitiens, les effets des lumières couleur, les jauges cumulées (énergie, eau, volume), les jauges de débit (gaz, débit de gaz, débit d'eau), les jauges de niveau d'eau et de bruit (sans unité Gladys pour elles). Les volets et les thermostats ne sont jamais des interrupteurs : un « éteins tout » d'un assistant vocal ou d'une scène ne les atteint pas.
Relais et variateurs : déclarez ceux qui sont sûrs
Un relais ou un variateur Qbus peut alimenter n'importe quoi : une lampe, mais aussi un circulateur, la demande de chauffe de la chaudière, un radiateur électrique, un congélateur, une pompe de relevage, l'impulsion d'une porte de garage, une vanne ou une vitesse de VMC en 0-10 V. Un « éteins tout / allume tout » d'un assistant vocal ou d'une scène atteint chaque interrupteur et chaque lumière. Par défaut, un relais ou un variateur est donc seulement affiché, en lecture seule, avec des boutons « Allumer » / « Éteindre » qui ne font rien tant que vous n'activez pas Autoriser les boutons « Allumer » / « Éteindre ».
Listez dans Sorties déclarées sûres les relais et variateurs qu'on peut
couper ou allumer à tout moment (des lampes) : leur référence est le
paramètre QBUS_OUTPUT de l'appareil dans l'onglet Découverte (10, 28).
Les références sont numérotées par contrôleur : une référence seule ne vaut
que si la passerelle n'a qu'un contrôleur. S'il y en a plusieurs, écrivez
série:référence (000123:10, la série est le paramètre QBUS_CONTROLLER) ;
une référence seule n'est alors appliquée nulle part et le statut le
signale. Ils deviennent alors un interrupteur (relais) ou une
lumière (variateur). Un interrupteur créé avant qu'une sortie quitte la liste
reste, affiche son état et refuse les commandes.
Scènes : un bouton « Lancer » démarre une scène du contrôleur telle que Qbus System Manager la définit. Une scène Qbus peut aussi changer le chauffage ou ouvrir quelque chose : l'option et le plafond des consignes de cette intégration ne s'y appliquent pas.
Avant de commencer
- Un broker MQTT sur votre réseau (Mosquitto, par exemple l'extension de votre NAS, ou le broker du serveur Qbus).
- La passerelle MQTT Qbus (qbusMqttGw), installée et reliée à votre
contrôleur Qbus et à ce broker, comme l'explique Qbus sur
iot.qbus.be. Elle publie sous
cloudapp/QBUSMQTTGW/.... - Dans Gladys, installez l'intégration depuis le store.
Configuration
- Adresse du broker MQTT : l'adresse IP du broker (
192.168.1.20, port 1883), oumqtts://adresse:8883en TLS. - Utilisateur et Mot de passe : ceux du broker, s'il en demande. Le
mot de passe est gardé par Gladys dans sa base, jamais réaffiché, et envoyé
seulement à votre broker. Il ne va jamais dans les journaux ni dans
/data. - Vérifier le certificat TLS : activé par défaut ; à désactiver seulement pour un broker au certificat auto-signé sur votre réseau.
- Numéro de série du contrôleur : vide pour tous les contrôleurs de la passerelle, ou le numéro d'un contrôleur (comme l'affiche Qbus System Manager).
- Sorties déclarées sûres et Autoriser les boutons « Allumer » / « Éteindre » : voir plus haut.
- Autoriser les commandes de consigne : désactivé par défaut, voir plus bas.
- Plafond des consignes : 24 °C par défaut (16 à 30 °C).
- Intervalle minimum entre deux mesures : 10 s par défaut. Marche/arrêt, positions et consignes ne sont jamais retardés.
- Langue des messages : français ou anglais.
Utilisez ensuite Tester la connexion : il indique combien de contrôleurs, de sorties et d'appareils la passerelle a. Les appareils apparaissent dans l'onglet Découverte de l'intégration : créez ceux que vous voulez.
Consignes de chauffage
Les thermostats Qbus pilotent le chauffage. Gladys affiche toujours leur température et leur consigne. Changer une consigne depuis Gladys (tableau de bord, scènes, assistants vocaux) est refusé tant que vous n'activez pas Autoriser les commandes de consigne. Une fois activé :
- la consigne reste entre 5 °C et le plafond de la configuration (24 °C par défaut, jamais au-dessus de 30 °C), et dans les limites que le contrôleur déclare pour le thermostat, par pas de 0,5 °C ;
- l'intégration relit d'abord le thermostat et son contrôleur, décide seulement sur cette relecture, et revérifie l'option et le plafond juste avant l'envoi ;
- la commande part dans les 3,5 s après le clic, ou elle est refusée, non envoyée ;
- si le contrôleur ne la confirme pas à temps, Gladys affiche « Commande envoyée, sans confirmation » : vérifiez le thermostat un instant plus tard.
Erreurs et limites
- Jamais testé avec un vrai appareil : signalez sur le forum ce qui ne marche pas (avec les journaux de l'intégration).
- Identifiants refusés par le broker : l'intégration s'arrête et réessaie après 15 min, 1 h, 6 h, puis toutes les 24 h (conservé après un redémarrage). Enregistrer d'autres identifiants ou Tester la connexion réessaie tout de suite.
- Broker injoignable, ou qui refuse pour une autre raison (serveur indisponible, identifiant refusé) : un nouvel essai toutes les 10 s.
- Taille des messages : l'intégration ignore une configuration de plus de 2 Mo et un état de plus de 64 Ko, mais seulement une fois reçus ; MQTT 3.1.1 autorise des paquets plus grands. Réservez le broker à votre domotique (réglez max_packet_size dans Mosquitto si d'autres clients l'utilisent).
- Un état conservé par le broker (retain) est ignoré : seuls comptent les états que la passerelle envoie maintenant.
- 2000 appareils au plus (une limite de Gladys) : les autres sont laissés de côté et le statut le dit.
- Passerelle hors ligne, contrôleur déconnecté : le statut le dit, les appareils apparaissent « injoignables » et les commandes sont refusées, jamais mises en attente.
- Gladys accepte 300 états par minute : les mesures sont espacées, le reste part en premier.
Assistance
Questions et retours : le forum de la communauté Gladys. Code source et tickets : https://github.com/LM1LC3N7/gladys-qbus.
Paramètres de configuration
Voici les paramètres demandés par Qbus dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre installation Qbus dans Gladys | section | Non | Lit et commande les sorties de vos contrôleurs Qbus (CTD) via la passerelle MQTT Qbus (qbusMqttGw) et VOTRE broker MQTT, sur votre réseau local : relais, variateurs, lumières couleur, volets et stores, thermostats, scènes, et les capteurs (jauges, humidité, CO2, station météo). Installez et réglez d'abord la passerelle MQTT Qbus avec votre broker (voir le guide), puis saisissez l'adresse du broker ci-dessous. Rien ne passe par Internet. Jamais testé avec une vraie installation. Non officiel, sans lien avec Qbus. |
| Adresse du broker MQTT | string | Oui | Le broker où publie la passerelle MQTT Qbus : son adresse IP (port 1883), ou mqtts://adresse:8883 en TLS. |
| Utilisateur | string | Non | L'utilisateur du broker, s'il en demande un. |
| Mot de passe | secret | Non | Le mot de passe du broker : gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à votre broker. |
| Vérifier le certificat TLS du broker (mqtts) | boolean | Non | À désactiver seulement pour un broker au certificat auto-signé sur votre réseau local. |
| Numéro de série du contrôleur (facultatif) | string | Non | Vide : tous les contrôleurs de la passerelle. Sinon seulement celui-ci (comme l'affiche Qbus System Manager, par exemple 000123). |
| Relais et variateurs | section | Non | Un relais ou un variateur Qbus peut alimenter n'importe quoi (une lampe, mais aussi un circulateur, la chaudière, un radiateur, un congélateur, une porte de garage), et un « éteins tout / allume tout » d'un assistant vocal ou d'une scène atteint chaque interrupteur et chaque lumière. Un relais ou un variateur est donc seulement affiché dans Gladys, en lecture seule, avec des boutons « Allumer » / « Éteindre », jusqu'à ce que vous le déclariez sûr ci-dessous : il devient alors un interrupteur (relais) ou une lumière (variateur). |
| Sorties déclarées sûres | string | Non | Les références des relais et variateurs (paramètre QBUS_OUTPUT dans l'onglet Découverte), séparées par des virgules. Avec plusieurs contrôleurs, écrivez série:référence (paramètre QBUS_CONTROLLER, par exemple 000123:10) : une référence seule n'est alors appliquée nulle part. Seulement des charges qu'on peut couper ou allumer à tout moment (une lampe, une prise de lampe). |
| Autoriser les boutons « Allumer » / « Éteindre » | boolean | Non | Désactivé par défaut : les boutons des relais et variateurs non déclarés sûrs ne font rien. Activé : un appui (tableau de bord, scène) commande la sortie. |
| Consignes de chauffage | section | Non | Les thermostats Qbus pilotent le chauffage. Gladys affiche leur température et leur consigne ; changer une consigne depuis Gladys (tableau de bord, scènes, assistants vocaux) est refusé tant que vous ne l'autorisez pas ici, et reste entre 5 °C et le plafond ci-dessous. |
| Autoriser les commandes de consigne | boolean | Non | Désactivé par défaut. Activé : Gladys peut changer les consignes des thermostats, sous le plafond. |
| Plafond des consignes (°C) | number | Non | Aucune consigne au-dessus de cette température n'est envoyée (16 à 30 °C). |
| Intervalle minimum entre deux mesures (s) | number | Non | Les jauges peuvent publier chaque seconde : Gladys garde la dernière mesure à ce rythme. Marche/arrêt, positions et consignes ne sont jamais retardés. |
| Langue des messages | select | Non |
Comment installer Qbus dans Gladys
- Dans Gladys, ouvrez Intégrations : Qbus 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-qbus: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-qbus.
Qbus nécessite Gladys >=5.0.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
Qbus 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