Intégration domotique HomeKit Controller, gratuite et open source

Appairez et pilotez vos accessoires HomeKit Wi-Fi/Ethernet depuis Gladys, sans hub Apple.
Cette intégration fait de Gladys un contrôleur HomeKit : elle s'appaire directement avec vos accessoires HomeKit Wi-Fi / Ethernet et les pilote en local, sans iPhone, sans Apple TV ni HomePod, et sans cloud.
Avant de commencer
- Un accessoire HomeKit n'accepte qu'un seul contrôleur à la fois. S'il est déjà dans l'app Maison d'Apple (ou dans Home Assistant…), retirez-le d'abord. Sinon, faites une remise à zéro de l'accessoire.
- Gardez sous la main le code de configuration à 8 chiffres
(
123-45-678), imprimé sur l'accessoire, sa boîte ou sa notice. - L'accessoire doit être sur le même réseau local que Gladys.
- Seuls les accessoires IP (Wi-Fi, Ethernet) sont pris en charge. Les accessoires Bluetooth et Thread ne le sont pas.
- Il faut Gladys 5.3.0 ou plus récent.
Appairer un accessoire
- Ouvrez l'onglet Configuration de l'intégration.
- Cliquez sur Rechercher les accessoires. La liste affiche, pour chaque
accessoire : son nom, son type, son identifiant HomeKit, son adresse IP et
son état (
prêt à appairer,déjà appairé ailleurs,appairé à Gladys). - Cliquez sur Appairer un accessoire et renseignez :
- Accessoire : le nom, l'identifiant ou l'adresse IP affiché par la
recherche. Si la recherche ne le trouve pas, tapez son adresse sous la
forme
IP:port(par exemple192.168.1.20:51826) ; - Code de configuration : les 8 chiffres, avec ou sans tirets.
- Accessoire : le nom, l'identifiant ou l'adresse IP affiché par la
recherche. Si la recherche ne le trouve pas, tapez son adresse sous la
forme
- L'appairage prend quelques secondes (jusqu'à une minute sur les petits modules). Ensuite, ouvrez l'onglet Découverte : les appareils de l'accessoire y sont prêts à être ajoutés.
Un pont (bridge) HomeKit donne un appareil Gladys par accessoire relié.
Appareils pris en charge
| Service HomeKit | Dans Gladys |
|---|---|
| Ampoule | Marche/arrêt, luminosité, couleur, température |
| Interrupteur, prise, vanne | Marche/arrêt |
| Mesure d'énergie (Eve) | Puissance (W), énergie (kWh), tension, courant |
| Ventilateur | Marche/arrêt, vitesse |
| Thermostat | Température, consigne, humidité, mode, état |
| Climatiseur (chaud / froid) | Marche/arrêt, mode, consigne, température |
| Volet, store, fenêtre, porte | Position, ouvrir / stop / fermer |
| Serrure | Verrouillée / déverrouillée |
| Capteurs | Température, humidité, luminosité, mouvement, |
| présence, ouverture, fuite, fumée, CO, CO2, | |
| particules PM2.5 / PM10, COV, NO2, ozone, SO2 | |
| Batterie | Niveau, batterie faible |
| Bouton, sonnette | Appui |
Un bouton donne une fonctionnalité « Bouton » dont la valeur change à
chaque appui : 1 simple, 2 double, 6 long. Une sonnette donne une
fonctionnalité « Sonnette » (1 à chaque appui). Utilisez-les avec le
déclencheur habituel sur l'état d'un appareil, ou avec le déclencheur
Bouton HomeKit appuyé (voir plus bas).
Climatiseur : le mode vaut 0 auto, 1 froid, 2 chaud (HomeKit ne connaît
pas les modes déshumidification et ventilation). La consigne suit le mode :
seuil de chauffe en mode chaud, seuil de froid sinon.
Après une mise à jour de l'intégration, un appareil déjà créé peut gagner de nouvelles fonctionnalités : l'onglet Découverte propose alors de le mettre à jour.
Les autres services (caméras, télévisions…) sont ignorés pour l'instant. Les
logs listent, à chaque connexion, les services non pris en charge de chaque
accessoire (HomeKit service(s) not supported: …) et les caractéristiques
propres au fabricant (vendor characteristic(s) not supported: …) :
joignez ces lignes à une demande de prise en charge.
Mesure d'énergie : HomeKit n'a pas de caractéristique standard pour la puissance. L'intégration lit celles d'Eve (accessoires Eve, nombreux plugins Homebridge). Une prise qui ne publie sa consommation que dans son app (Aqara…) n'affiche que la marche/arrêt.
Seul ce que le pont publie en HomeKit est visible : un appareil qu'un hub ne partage qu'en Matter n'apparaît pas ici. C'est le cas des climatiseurs infrarouges des hubs Aqara (M2, M3) : ajoutez-les avec l'intégration Matter de Gladys.
Réglages
- Intervalle de rafraîchissement : HomeKit envoie les changements en temps réel. Gladys relit en plus tout l'accessoire à cet intervalle, par sécurité (60 s par défaut).
- Durée de recherche : temps d'écoute du réseau lors d'une recherche (10 s par défaut).
Actions
- Rechercher les accessoires : liste les accessoires HomeKit du réseau.
- Appairer un accessoire : voir plus haut.
- Identifier un appareil : l'accessoire se signale (il clignote, émet un son…), pratique pour le repérer.
- Désappairer un accessoire : retire l'appairage de l'accessoire et de Gladys. Pour un pont, tous ses appareils sont concernés. Supprimez ensuite les appareils dans Gladys.
Scènes
Déclencheurs (« Quand… ») :
- Bouton HomeKit appuyé : un bouton ou une sonnette a été appuyé. Filtres facultatifs : l'appareil, le type d'appui (simple, double, long) et le numéro du bouton (pour une télécommande à plusieurs boutons). Variables : accessoire, bouton, numéro du bouton, appui, sonnette.
- Accessoire HomeKit perdu / revenu : un accessoire est devenu injoignable, ou est revenu. Filtres facultatifs : l'appareil et l'état. Pour un pont, chaque appareil relié envoie son propre événement.
Pour choisir un bouton dans le filtre « Appareil », créez d'abord son appareil dans Gladys (onglet Découverte). Sinon, laissez le filtre vide.
Actions (« Alors… ») :
- Identifier un appareil HomeKit : l'accessoire se signale.
- Relire un appareil HomeKit : relit tout de suite toutes ses valeurs (utile avant une condition).
Widget du tableau de bord
Le widget Accessoires HomeKit affiche le nombre d'accessoires en ligne et hors ligne, la liste des accessoires (les injoignables en premier) et, s'il y en a un hors ligne, un bouton Reconnecter.
Dépannage
- L'accessoire n'apparaît pas dans la recherche : vérifiez qu'il est
allumé et sur le même réseau (même VLAN) que Gladys. Essayez d'augmenter
la durée de recherche, ou appairez-le avec
IP:port. - « déjà appairé ailleurs » : retirez-le de l'app Maison ou remettez-le à zéro.
- Accessoire injoignable : l'écran de configuration indique quels accessoires sont hors ligne. L'intégration réessaie toute seule et retrouve l'accessoire si son adresse IP a changé. Pour éviter ce cas, donnez-lui une adresse IP fixe (bail DHCP réservé).
- Les appairages sont stockés dans le volume
/datade l'intégration : ils sont conservés lors des mises à jour. - Pour le détail, consultez les logs de l'intégration (niveau
LOG_LEVEL=debug).
Paramètres de configuration
Voici les paramètres demandés par HomeKit Controller dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | 1. Retirez l'accessoire de l'app Maison d'Apple (un accessoire HomeKit n'accepte qu'un seul contrôleur). 2. Cliquez sur « Rechercher les accessoires » ci-dessous. 3. Cliquez sur « Appairer un accessoire » avec son nom et le code à 8 chiffres imprimé dessus. 4. Ajoutez ses appareils depuis l'onglet Découverte. |
| Intervalle de rafraîchissement (s) | number | Non | HomeKit envoie les changements en temps réel ; ce rafraîchissement complet n'est qu'une sécurité. |
| Durée de recherche (s) | number | Non | Durée pendant laquelle Gladys écoute les accessoires HomeKit sur le réseau. |
Comment installer HomeKit Controller dans Gladys
- Dans Gladys, ouvrez Intégrations : HomeKit Controller 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/prohand/gladys-homekitcontroller:1.4.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). - 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/prohand/gladys-homekitcontroller.
HomeKit Controller 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
HomeKit Controller 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 prohand, 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