Intégration domotique Hubitat Elevation, gratuite et open source
Les appareils de votre hub Hubitat dans Gladys : lumières, prises, volets, capteurs. Non officiel.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à votre hub Hubitat Elevation par son app Maker API, et propose les appareils que vous y autorisez dans l'onglet Découverte de Gladys : interrupteurs, variateurs, ampoules couleur et blanches, prises avec leur consommation, volets, thermostats, serrures, portes de garage, boutons et capteurs. Une fois un appareil ajouté, son état suit le hub en direct, et Gladys le pilote à travers le hub, qui garde ses appareils Z-Wave, Zigbee, Matter et réseau. Tout reste sur votre réseau local. Non officiel, sans lien avec Hubitat.
Version de développement (0.1). Écrite à partir de la documentation de la Maker API et de l'intégration Home Assistant de la même API, et testée contre un hub simulé : elle n'a jamais été testée sur un vrai hub Hubitat pour l'instant. Vos retours sont les bienvenus sur le dépôt GitHub.
Ce que vous obtenez
| Capability Hubitat | Dans Gladys |
|---|---|
Switch, SwitchLevel | une lumière (ampoules, variateurs), sinon un interrupteur (prises) |
ColorControl, ColorTemperature (colorMode) | couleur (RVB) et température de couleur, celle qu'affiche l'ampoule |
PowerMeter, EnergyMeter, VoltageMeasurement, CurrentMeter | puissance, énergie (compteur), tension et courant |
WindowShade, WindowBlind | un volet : ouvrir, fermer, arrêter, position |
Thermostat (consignes chauffage et froid, mode, activité) | un thermostat, consignes en °C |
Lock | une serrure, en lecture seule tant que vous ne l'autorisez pas |
GarageDoorControl, DoorControl | un capteur de porte, et une commande en lecture seule par défaut |
PushableButton, HoldableButton, DoubleTapableButton… | un bouton par numéro : appui, double appui, appui long, relâché |
ContactSensor, MotionSensor, WaterSensor | détecteurs d'ouverture, de mouvement et de fuite |
SmokeDetector, CarbonMonoxideDetector, TamperAlert | détecteurs de fumée, de CO et de sabotage |
TemperatureMeasurement, RelativeHumidityMeasurement | température (°C) et humidité |
IlluminanceMeasurement, CarbonDioxideMeasurement, Battery… | luminosité, CO2, indice UV, batterie, présence |
Chaque appareil du hub donne un appareil Gladys, nommé d'après son libellé et sa pièce (« Plafonnier (Salon) ») ; son identifiant sur le hub, sa pièce et son driver sont gardés dans ses paramètres. Les appareils sans aucune de ces capabilities (enceintes, pour l'instant) sont écartés. Les vannes d'eau ne sont pas pilotées. L'interrupteur d'un appareil qui est aussi une serrure, une porte de garage, une vanne, une sirène ou un clavier d'alarme est affiché en lecture seule, quelles que soient les options : une scène « tout éteindre » ne l'atteint jamais.
Prérequis
- Un hub Hubitat Elevation (C-5, C-7, C-8 ou plus récent) sur le même réseau local que Gladys.
- L'app Maker API installée sur le hub (intégrée).
Installation
- Dans l'interface web de Hubitat, Apps → Add Built-In App → Maker API. Sélectionnez les appareils que Gladys peut voir et piloter, puis Done. Laissez « Allow Access via Remote / Cloud » désactivé : Gladys utilise les adresses locales.
- Rouvrez l'app Maker API : sa page affiche des URL du type
http://192.168.1.50/apps/api/12/devices?access_token=…. Notez :- l'adresse du hub (
192.168.1.50), - le numéro de l'app (
12, après/apps/api/), - le jeton d'accès (après
access_token=).
- l'adresse du hub (
- Dans Gladys, ouvrez l'intégration, Configuration, et remplissez les trois champs. Vous pouvez coller une URL de la Maker API dans le champ adresse, sans son jeton : l'adresse et le numéro de l'app en sont tirés.
- Cliquez sur Tester la connexion : le nombre d'appareils autorisés, les appareils proposés et le fonctionnement des événements en direct s'affichent.
- Ouvrez l'onglet Découverte et ajoutez les appareils voulus. Leurs valeurs sont envoyées dès leur ajout.
Options
- Échelle de température du hub : l'échelle réglée dans Hubitat (Settings → Location and modes). Gladys affiche toujours des °C et convertit ; quand le hub donne l'unité d'une mesure, c'est elle qui compte, et elle est gardée pour les lectures suivantes. Quand les unités du hub contredisent l'option, l'état de connexion le signale et les consignes de thermostat sont refusées. Une consigne est envoyée dans l'échelle de l'unité donnée par le hub quand elle est connue, sinon dans celle de cette option (avec ou sans événements en direct), et seulement si la consigne actuelle est connue et vraisemblable dans cette échelle : jusqu'à 35 en °C, à partir de 39 en °F. Un hub en °F réglé ici en °C est ainsi repéré.
- Événements en direct (activés par défaut) : l'intégration écoute le socket
d'événements du hub (
ws://<hub>/eventsocket). Les changements arrivent dans Gladys en une seconde, et les appuis sur les boutons arrivent à vos scènes. Désactivés, ou quand le socket est perdu, les appareils sont lus à l'intervalle ci-dessous. - Intervalle de lecture sans événements en direct : 30 secondes par défaut (10 à 3600). Avec les événements, la liste complète est relue toutes les 5 minutes de toute façon.
- Intervalle minimum entre deux mesures d'un capteur : 10 secondes par défaut (0 à 300). Une prise qui remonte sa puissance chaque seconde est envoyée à Gladys à ce rythme. Interrupteurs, lumières, boutons, détecteurs de mouvement et d'ouverture ne sont jamais retardés.
- Langue des noms des fonctionnalités : français ou anglais, pour les appareils ajoutés désormais.
- Autoriser le pilotage des serrures depuis Gladys (désactivé par défaut) : voir Sécurité.
- Autoriser le pilotage des portes de garage depuis Gladys (désactivé par défaut) : voir Sécurité.
Sécurité
- Serrures et portes de garage sont en lecture seule par défaut. Leur état s'affiche, mais toute commande est refusée tant que l'option correspondante n'est pas activée. Une fois activée, Gladys peut déverrouiller votre porte et ouvrir votre garage, depuis le tableau de bord, vos scènes et les assistants vocaux. La commande de la porte de garage fonctionne comme un volet (ouvrir 1, fermer -1 ; arrêt seulement si l'ouvre-porte a une commande d'arrêt) : une scène qui agit sur tous les volets l'atteint aussi.
- Avant une commande de serrure ou de porte de garage, l'intégration relit l'appareil sur le hub, et refuse si son état est inconnu ou en mouvement (ouverture, fermeture en cours) ; rien n'est envoyé s'il est déjà dans l'état voulu.
- Après la commande, l'appareil est sous garde : toute autre commande de serrure ou de porte de garage sur lui est refusée (« une commande est déjà en cours ») jusqu'à ce qu'il signale l'état demandé, ou pendant 20 secondes (serrure) / 60 secondes (porte de garage). Un rapport tardif de l'ancien état ou un état inconnu ne lève jamais la garde. Arrêter une porte de garage en mouvement (si l'ouvre-porte a une commande d'arrêt) reste possible pendant la garde. L'appareil est relu après 5 et 15 secondes (et 30 et 60 pour une porte de garage) ; si ces lectures échouent, ou si l'état n'arrive jamais, son badge indique « état non confirmé ».
- Les commandes d'un même appareil partent une par une. Gladys attend une réponse 5 secondes : une commande qui n'a pas pu partir en 3,5 secondes est refusée, jamais envoyée en retard.
- L'intégration ne modifie jamais l'alarme (HSM) ni les modes du hub : elle ne contient aucune commande de ce type.
Bon à savoir
- Le hub reste maître des appareils : Gladys envoie ses commandes à la Maker API, qui les pilote. Gardez le hub allumé.
- Boutons : chaque numéro de bouton est une fonctionnalité (
Bouton 1,Bouton 2…). Un appui est un clic, un double appui un double clic, un appui maintenu un appui long, le relâchement sa fin (un relâchement sans appui maintenu avant est un simple « relâché »). Les appuis n'arrivent que par les événements en direct : sans eux, les boutons restent muets. - Chien de garde des événements en direct : quand une lecture complète trouve un changement d'un état à deux valeurs (interrupteur, contact, mouvement, serrure, porte…) qu'aucun événement n'a annoncé, ou quand le socket est resté muet 30 minutes, il est rouvert aussitôt ; les badges ne passent à l'orange que si cette réouverture échoue.
- Énergie : l'index d'énergie ne fait que monter. Une valeur plus basse est retenue ; elle n'est acceptée que si une mesure suivante dépasse cette valeur basse (compteur remis à zéro qui recompte). La même valeur basse relue reste retenue : un index lu à 0 puis revenu à la normale ne crée aucune fausse consommation. Un driver qui donne des Wh est converti en kWh.
- Le socket d'événements transporte les événements de tous les appareils du hub, pas seulement de ceux que vous avez autorisés : l'intégration garde les autorisés et ignore les autres. Il ne demande pas de jeton.
- Contacts de porte : Gladys affiche 0 pour ouvert et 1 pour fermé ; l'intégration convertit.
- Badge de transport : un appareil passe « injoignable » quand le hub l'est,
ou quand Hubitat le signale hors ligne (
healthStatus) ; un point orange signifie que les événements en direct sont perdus et que l'état est lu à l'intervalle configuré. - Les appareils autorisés plus tard dans la Maker API apparaissent dans Découverte à la lecture complète suivante (5 minutes au plus). Le bouton Scanner les lit tout de suite.
Dépannage
| Message d'état | Que faire |
|---|---|
| La Maker API a refusé le jeton d'accès | Recopiez le jeton depuis la page de l'app Maker API. |
| Aucune app Maker API ne répond avec ce numéro | Vérifiez le numéro de l'app, après /apps/api/ dans ses URL. |
| Le hub Hubitat est injoignable | Vérifiez l'adresse, vue depuis la machine Gladys (pas localhost), et que le hub est allumé. |
| L'adresse contient le jeton d'accès | Ne laissez que l'adresse du hub dans ce champ, et collez le jeton dans son propre champ. |
| Pas d'événements en direct du hub | Gladys lit les appareils à l'intervalle configuré en attendant, et réessaie toute seule. |
Les logs de l'intégration (Gladys, page de l'intégration) donnent les détails.
Confidentialité
Tout reste sur votre réseau local : l'intégration ne parle qu'à votre hub, par la Maker API et son socket d'événements. Le jeton d'accès est gardé par Gladys dans sa base, jamais réaffiché, et envoyé seulement à votre hub ; il n'est jamais écrit dans les logs. Hubitat et Hubitat Elevation sont des marques de Hubitat, Inc. ; cette intégration est sans lien avec Hubitat.
Paramètres de configuration
Voici les paramètres demandés par Hubitat Elevation dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos appareils Hubitat Elevation dans Gladys | section | Non | Les appareils que vous autorisez dans l'app Maker API de votre hub sont proposés dans l'onglet Découverte : interrupteurs, variateurs, ampoules couleur et blanches, prises avec leur consommation, volets, thermostats, boutons, capteurs d'ouverture, de mouvement, de fuite, de fumée et de CO, température, humidité, luminosité, batterie. Les états suivent le hub en direct et Gladys pilote les appareils à travers lui, uniquement sur votre réseau local. Serrures et portes de garage restent en lecture seule tant que vous ne les autorisez pas ci-dessous ; l'alarme (HSM) et les modes ne sont jamais modifiés. Jamais testée sur un vrai hub pour l'instant. Non officiel, sans lien avec Hubitat. |
| Adresse du hub | string | Oui | L'adresse IP locale de votre hub Hubitat, par exemple 192.168.1.50. Une URL de la Maker API copiée depuis la page de l'app convient aussi, sans son access_token. |
| Numéro de l'app Maker API | string | Oui | Dans Hubitat, Apps → Maker API : le nombre après /apps/api/ dans les URL affichées par l'app. |
| Jeton d'accès de la Maker API | secret | Oui | Affiché sur la page de l'app Maker API. Gardé par Gladys dans sa base, jamais réaffiché, et envoyé seulement à votre hub. |
| Échelle de température du hub | select | Non | L'échelle réglée dans Hubitat (Settings → Location and modes). Gladys affiche les températures en °C et convertit. |
| Événements en direct | boolean | Non | Écoute le socket d'événements du hub (ws://<hub>/eventsocket) : les états suivent en une seconde et les appuis sur les boutons arrivent à vos scènes. Désactivé : les appareils sont lus à l'intervalle ci-dessous et les appuis ne sont pas vus. |
| Intervalle de lecture sans événements en direct (s) | number | Non | Fréquence de lecture de tous les appareils quand les événements en direct sont désactivés ou perdus (10 à 3600 s). Avec eux, toutes les 5 minutes. |
| Intervalle minimum entre deux mesures d'un capteur (s) | number | Non | Certains appareils remontent chaque seconde (mesures de puissance) : Gladys garde la dernière mesure à ce rythme. Interrupteurs, lumières, boutons, détecteurs de mouvement et d'ouverture ne sont jamais retardés. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des appareils ajoutés désormais. |
| Autoriser le pilotage des serrures depuis Gladys | boolean | Non | Désactivé par défaut : les serrures sont en lecture seule. Activé, Gladys peut les verrouiller et les DÉVERROUILLER, depuis le tableau de bord, les scènes et les assistants vocaux. |
| Autoriser le pilotage des portes de garage depuis Gladys | boolean | Non | Désactivé par défaut : les portes de garage sont en lecture seule. Activé, Gladys peut les ouvrir et les fermer, depuis le tableau de bord, les scènes et les assistants vocaux ; la commande fonctionne comme un volet (ouvrir, fermer). |
Comment installer Hubitat Elevation dans Gladys
- Dans Gladys, ouvrez Intégrations : Hubitat Elevation 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-hubitat: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-hubitat.
Hubitat Elevation 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
Hubitat Elevation 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