Aller au contenu principal

Intégration domotique Homey Pro bridge, gratuite et open source

Intégration Homey Pro bridge pour Gladys Assistant

Les appareils de votre Homey Pro dans Gladys : lumières, prises, volets, thermostats, capteurs…

Voir sur GitHubToutes les intégrations

Cette intégration relie Gladys à votre Homey Pro et propose chaque appareil Homey dans l'onglet Découverte de Gladys : lumières, prises, volets, thermostats, serrures, boutons, capteurs, compteurs. Une fois un appareil ajouté, ses états suivent Homey en direct, et Gladys le pilote à travers Homey, qui garde ses appareils Zigbee, Z-Wave, Matter, Wi-Fi et d'applications. Passez à Gladys à votre rythme, pièce par pièce, ou utilisez les deux côte à côte. Tout reste sur votre réseau local. Non officiel, sans lien avec Athom.

Version de développement (0.1). Écrite d'après la documentation de l'API Web de Homey et testée contre un Homey Pro simulé, pas encore sur un vrai. Vos retours sont les bienvenus sur le dépôt GitHub.

Quel Homey​

HomeyÇa marche ?
Homey Pro (Early 2023)Oui : il a l'API locale et les clés d'API qu'utilise l'intégration.
Homey Pro miniProbablement : même logiciel Homey Pro, avec les clés d'API. Pas encore testé.
Homey Self-Hosted ServerProbablement, s'il propose les clés d'API. Pas encore testé.
Homey Pro (Early 2019) et avantNon : ni clés d'API ni API locale (une application de pont MQTT est la voie pour eux).
Homey Cloud (Homey Bridge)Non : il tourne dans le cloud d'Athom, il n'y a pas d'API sur votre réseau local.

Ce que vous obtenez​

Capacité HomeyDans Gladys
onoff, dimune lumière (appareil lumière, ou prise d'une lampe), sinon un interrupteur
light_hue + light_saturation, light_temperature, light_modecouleur (RVB) et température de couleur, celle que montre Homey
windowcoverings_state (haut / arrêt / bas), windowcoverings_setun volet (ou un rideau) : ouvrir, fermer, arrêter, position
target_temperature, thermostat_mode (auto, chauffage, froid, arrêt)un thermostat : consigne et mode
lockedune serrure
buttonun bouton : chaque appui est un événement pour vos scènes, et il s'actionne
measure_temperature, _humidity, _pressure, _luminance, _co2, _pm25, _noisele capteur de la bonne catégorie
measure_power, meter_power, measure_voltage, measure_currentpuissance et énergie (sur l'interrupteur d'une prise), tension, courant
meter_gas, meter_waterun volume en m³
measure_battery, alarm_batteryle niveau de batterie, batterie faible
alarm_motion, alarm_contact, alarm_water, alarm_smoke, alarm_co, alarm_tamperdétecteurs de mouvement, d'ouverture, de fuite, de fumée, de CO et d'arrachement

Chaque appareil Homey donne un appareil Gladys, nommé d'après l'appareil et sa zone (« Lampe (Salon) ») ; son identifiant Homey, sa zone, sa classe et son pilote sont gardés dans ses paramètres. Les sous-capacités d'un appareil (« onoff.2 », une deuxième sortie ; « measure_temperature.outside ») deviennent des fonctionnalités à part, nommées avec leur titre Homey. Les appareils sans aucune de ces capacités (les enceintes, pour l'instant) sont écartés.

Prérequis​

  • Un Homey Pro (Early 2023), voir plus haut, sur le même réseau local que Gladys.
  • Une clé d'API de ce Homey.

Installation​

  1. Ouvrez l'application web Homey (https://my.homey.app), Settings → API Keys → New API Key (Réglages → Clés API). Donnez-lui un nom (« Gladys ») et ces permissions :

    • View devices et Control devices (obligatoires) ;
    • View zones (la pièce dans le nom des appareils) ;
    • View System (les mises à jour en direct : sans elle, Gladys lit les appareils toutes les 10 secondes).

    Homey n'affiche la clé qu'une fois : copiez-la.

  2. Dans Gladys, ouvrez l'intégration, Configuration :

    • Clé d'API Homey : collez-la.
    • Adresse de Homey : laissez-la vide, Gladys trouve votre Homey sur le réseau local. Ou saisissez son adresse IP, par exemple 192.168.1.20. Pas un nom en .local : l'intégration tourne dans son propre conteneur et ne sait pas les résoudre.

  3. Cliquez sur Tester la connexion : la version de Homey, son adresse, le nombre d'appareils et de zones, les appareils proposés et le fonctionnement des mises à jour en direct s'affichent.

  4. Ouvrez l'onglet Découverte et ajoutez les appareils voulus. Leurs valeurs sont envoyées dès leur ajout.

Options​

  • 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.
  • Autoriser le déverrouillage depuis Gladys (désactivé par défaut) : sans cette option, Gladys peut verrouiller une serrure par sa fonctionnalité « Verrouillé » (capacité locked), jamais la déverrouiller. L'interrupteur, la luminosité, le volet ou le bouton d'une serrure (classe lock, ou appareil qui a la capacité locked) demandent cette option dans les deux sens.
  • Autoriser le pilotage des portes de garage et portails (désactivé par défaut) : sans cette option, l'interrupteur, la luminosité, le volet et le bouton des appareils de classe garagedoor, ou qui ont la capacité garagedoor_closed, sont refusés.
  • Autoriser le pilotage des vannes et de l'arrosage (désactivé par défaut) : même chose pour les classes watervalve, sprinkler et faucet (ouverture et coupure).
  • Autoriser le pilotage des alarmes et sirènes (désactivé par défaut) : même chose pour les classes homealarm, smokealarm et siren, ou les appareils qui ont la capacité homealarm_state (armement, désarmement, arrêt).

Les classes sont celles de Homey (ou la classe virtuelle choisie dans l'application Homey) ; watervalve, sprinkler et siren existent depuis Homey 12.0. Limite : une vanne, une sirène ou un relais de portail rangés dans une autre classe (socket, relay, other, sensor) ne sont protégés que s'ils ont l'une des capacités ci-dessus ; sinon ils se pilotent comme une prise. Donnez-leur la bonne classe virtuelle dans Homey.

Ces commandes restent affichées comme pilotables dans Gladys (les fonctionnalités sont figées à la création de l'appareil) : c'est l'intégration qui les refuse, avec un message qui nomme l'option, tant que l'option est désactivée, y compris pour les appareils déjà ajoutés. Une fois autorisée, chaque commande de ce type relit d'abord l'appareil sur Homey et est refusée si Homey ne répond pas, s'il dit l'appareil indisponible, ou si l'état est inconnu (une capacité que Homey ne sait pas relire, getable à false, est donc refusée même avec l'option). Une commande qui n'a pas pu partir dans les 3,5 s est refusée sans rien envoyer ; une commande en plusieurs appels (couleur, température de couleur) va jusqu'au bout une fois le premier appel parti.

Bon à savoir​

  • Homey reste aux commandes des appareils : Gladys envoie ses ordres à Homey, qui les pilote. Gardez Homey allumé.
  • Mises à jour en direct : les changements arrivent dans Gladys en moins d'une seconde. La liste entière est relue toutes les 5 minutes. Quand les mises à jour en direct sont refusées ou perdues, les appareils sont lus toutes les 10 secondes en attendant, et Gladys réessaie le direct en arrière-plan.
  • Boutons : les boutons que Homey expose comme capacité (boutons virtuels de Homey, boutons de certaines applications) envoient chaque appui à vos scènes, et Gladys peut les actionner. La plupart des télécommandes (IKEA, Hue, Aqara…) n'existent dans Homey que comme déclencheurs de Flow, que l'API Web ne montre pas : faites un Flow Homey qui appuie sur un bouton virtuel, et utilisez ce bouton dans Gladys.
  • Couleurs : une ampoule en mode couleur montre sa couleur, en mode blanc sa température de couleur (le light_mode de Homey) ; Gladys change de mode quand il règle l'une ou l'autre.
  • Contacts de porte : Homey dit « alarme de contact » pour une porte ouverte, Gladys 0 pour ouvert et 1 pour fermé ; l'intégration convertit.
  • Badge de transport : un appareil passe « injoignable » quand Homey l'est, ou quand Homey le marque indisponible (avec la raison donnée par Homey) ; un point orange signale que le direct est coupé et que l'état est lu toutes les 10 secondes.
  • Appareils ajoutés, renommés ou déplacés dans Homey : ils apparaissent dans Découverte en quelques secondes (au plus tard à la lecture complète suivante). Le bouton Scanner les relit tout de suite.
  • Nouvelle adresse IP (DHCP) : quand Homey ne répond plus, Gladys le recherche sur le réseau par son identifiant et garde sa nouvelle adresse.

Dépannage​

Message d'étatQue faire
Homey a refusé la clé d'APICréez une nouvelle clé (Settings → API Keys) et collez-la.
Il manque une permission à la clé d'APICréez une clé avec View devices, Control devices, View zones et View System.
Homey a refusé les mises à jour en directDonnez la permission View System à la clé (créez-en une nouvelle). En attendant, Gladys lit toutes les 10 s.
Aucun Homey Pro trouvé sur le réseauSaisissez l'adresse IP de Homey dans la configuration.
Plusieurs Homey trouvésSaisissez l'adresse du vôtre dans la configuration.
Aucun Homey Pro ne répond à cette adresseVérifiez l'adresse IP. Un Homey Pro (Early 2019) ou un Homey Cloud ne peut pas être utilisé.
Homey est injoignable : connection refusedVérifiez l'adresse, vue depuis la machine Gladys (pas localhost), et que Homey est allumé.

Les journaux de l'intégration (Gladys, page de l'intégration) donnent le détail.

Vie privée​

Tout reste sur votre réseau local : l'intégration ne parle qu'à votre Homey, par son API locale. La clé d'API est stockée comme secret par Gladys et jamais écrite dans les journaux. Homey est une marque d'Athom B.V. ; cette intégration n'a aucun lien avec Athom.

Paramètres de configuration​

Voici les paramètres demandés par Homey Pro bridge dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Vos appareils Homey Pro dans GladyssectionNonChaque appareil de votre Homey Pro (2023 ou plus récent) est proposé dans l'onglet Découverte : lumières avec leur couleur, prises et interrupteurs avec leur consommation, volets, thermostats, serrures, boutons, détecteurs de mouvement, d'ouverture, de fuite et de fumée, température, humidité et qualité de l'air, compteurs. Les états suivent Homey en direct et Gladys pilote les appareils à travers Homey, qui garde ses appareils Zigbee, Z-Wave, Matter et d'applications : migrez à votre rythme, ou utilisez les deux côte à côte. Tout reste sur votre réseau local. Homey Pro (Early 2019) et plus anciens et Homey Cloud n'ont pas d'API locale : ils ne peuvent pas être utilisés. Non officiel, sans lien avec Athom.
Clé d'API HomeysecretOuiCréez-la dans l'application web Homey (my.homey.app) : Settings → API Keys → New API Key, avec les permissions View devices, Control devices, View zones et View System. Homey ne l'affiche qu'une fois : collez-la ici.
Adresse de HomeystringNonLaissez vide : Gladys cherche votre Homey sur le réseau local. Sinon son adresse IP, par exemple 192.168.1.20 (http://192.168.1.20).
Intervalle minimum entre deux mesures d'un capteur (s)numberNonCertains 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.
Autoriser le déverrouillage depuis GladysbooleanNonDésactivé par défaut : Gladys peut verrouiller une serrure (sa fonctionnalité Verrouillé), jamais la déverrouiller ; l'interrupteur, la luminosité, le volet et le bouton d'une serrure (classe lock, ou appareil avec la capacité locked) sont refusés dans les deux sens. Activé, Gladys peut DÉVERROUILLER, depuis le tableau de bord, les scènes et les assistants vocaux.
Autoriser le pilotage des portes de garage et portails depuis GladysbooleanNonDésactivé par défaut : l'interrupteur, la luminosité, le volet et le bouton des appareils Homey de classe garagedoor, ou avec la capacité garagedoor_closed (un relais de portail aussi), sont refusés. Un relais de portail rangé dans une autre classe sans cette capacité n'est pas protégé. Activé, Gladys peut les ouvrir et les fermer.
Autoriser le pilotage des vannes et de l'arrosage depuis GladysbooleanNonDésactivé par défaut : l'interrupteur, la luminosité, le volet et le bouton des appareils Homey de classe watervalve, sprinkler (Homey 12.0 ou plus récent) ou faucet sont refusés (ouverture et coupure). Une vanne rangée dans une autre classe (socket, relay, other) n'est pas protégée. Activé, Gladys peut les ouvrir et les fermer.
Autoriser le pilotage des alarmes et sirènes depuis GladysbooleanNonDésactivé par défaut : l'interrupteur, la luminosité, le volet et le bouton des appareils Homey de classe homealarm, smokealarm ou siren (Homey 12.0 ou plus récent), ou avec la capacité homealarm_state, sont refusés (armement, désarmement, arrêt). Une sirène rangée dans une autre classe (socket, relay, other, sensor) n'est pas protégée. Activé, Gladys peut les commander.

Comment installer Homey Pro bridge dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Homey Pro bridge apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-homey:0.1.3), 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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-homey.

Homey Pro bridge 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​

Homey Pro bridge 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.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le