Intégration domotique Homematic IP, gratuite et open source
Homematic IP par le cloud : chauffage, contacts, capteurs, prises, volets, alarme.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Amène vos appareils Homematic IP (eQ-3) dans Gladys par le cloud Homematic IP, comme l'application officielle : thermostats de radiateur et muraux, pièces chauffées, contacts de fenêtre et de porte, détecteurs de mouvement, de présence, de fumée et d'eau, prises et actionneurs avec leur puissance, variateurs, volets et stores, interrupteurs muraux et télécommandes, capteurs météo, et le système d'alarme.
Developed without the hardware: feedback welcome. Cette intégration a été construite d'après le protocole public et des réponses enregistrées du cloud Homematic IP, sans point d'accès sous la main. Si quelque chose est faux ou manque, ouvrez une issue : github.com/guim31/gladys-homematicip/issues. Sans lien avec eQ-3 AG : Homematic IP est une marque d'eQ-3.
Prérequis
- Un point d'accès Homematic IP (HmIP-HAP, ou le point d'accès filaire HmIP-DRAP) installé dans l'application Homematic IP, avec ses appareils déjà appairés.
- Son SGTIN : le code de 24 caractères imprimé sous le point d'accès et
sur l'autocollant fourni (par exemple
3014-F711-A000-0000-0000-0000). - Un accès Internet pour Gladys : tout passe par le cloud Homematic IP.
- Gladys 5.1 ou plus récent.
La Home Control Unit (HCU) et sa « Connect API » locale ne sont pas prises en charge : cette intégration parle au cloud du point d'accès.
Configuration
Ouvrez l'onglet Configuration de l'intégration.
- SGTIN du point d'accès : saisissez le code imprimé sous le point d'accès (tirets et espaces acceptés), puis enregistrez.
- Code PIN du point d'accès : seulement si vous avez protégé votre point d'accès par un code PIN dans l'application. Il ne sert qu'à l'appairage.
- Langue des noms des appareils : la langue des noms des fonctionnalités des appareils que vous ajoutez (Température, Consigne, Ouverture…). Français par défaut.
- Pilotage de l'alarme : ce que Gladys peut faire avec le système d'alarme (voir plus bas).
Appairage
- Cliquez sur Démarrer l'appairage. Gladys demande l'accès au cloud, comme un nouveau client nommé « Gladys ».
- Appuyez sur le bouton bleu sur le dessus du point d'accès.
- Cliquez sur J'ai appuyé sur le bouton. Gladys reçoit son jeton, lit votre maison et liste les appareils dans l'onglet Découverte.
- Ajoutez les appareils voulus depuis l'onglet Découverte.
Le jeton est gardé dans le volume privé de l'intégration (/data), jamais
dans les journaux. « Gladys » apparaît alors parmi les clients de
l'application Homematic IP : le supprimer là-bas retire l'accès, et l'état de
l'intégration demande d'appairer de nouveau.
Relire la maison lit tout de suite tous les appareils et toutes les pièces, et dit combien ont été trouvés (utile après l'ajout d'un appareil dans l'application).
Pilotage de l'alarme
Lire l'alarme est toujours possible. La modifier est votre choix, dans Pilotage de l'alarme :
- Lecture seule (par défaut) : Gladys montre le mode de l'alarme et l'alarme, rien de plus ;
- Armer seulement : Gladys peut armer l'alarme (protection périphérique ou totale), jamais la désarmer ;
- Armer et désarmer : Gladys peut aussi la désarmer.
Le mode de l'alarme n'est jamais un interrupteur qu'un assistant vocal pourrait basculer par erreur : il se change par son sélecteur sur l'appareil, ou par l'action de scène Régler l'alarme Homematic IP, dans ce que ce réglage autorise.
Appareils
Trois sortes d'appareils apparaissent dans l'onglet Découverte.
Appareils Homematic IP
Un appareil Gladys par appareil Homematic IP, nommé comme dans l'application. Ses fonctionnalités dépendent de ce que l'appareil possède, quel que soit son modèle :
| Fonctionnalité | Appareils | Valeurs |
|---|---|---|
| Température | thermostats, capteurs climatiques et météo, STE2 (×2) | °C |
| Humidité | thermostats muraux, capteurs climatiques et météo | % |
| CO2 | capteurs de CO2 | ppm |
| Éclairement | détecteurs de mouvement et de présence, capteurs de lumière, météo | lux |
| Vitesse du vent | capteurs météo | km/h |
| Pluie | capteurs météo pro/plus, capteur de pluie | oui / non |
| Ouverture | contacts de fenêtre et de porte, poignées, entrées contact | ouvert / fermé (entrouvert = ouvert) |
| Mouvement | détecteurs de mouvement | oui / non |
| Présence | détecteurs de présence | oui / non |
| Fumée | détecteurs de fumée (fumée vue par celui-ci) | oui / non |
| Fuite d'eau / Niveau d'eau | détecteurs d'eau | oui / non |
| Chauffe | thermostats de radiateur (vanne ouverte) | arrêt / chauffe |
| Commutateur | prises, actionneurs, interrupteurs encastrés | marche / arrêt, pilotable |
| Puissance / Énergie | prises et actionneurs mesurants | W / kWh |
| Lumière / Luminosité | variateurs | marche / arrêt, %, pilotable |
| Position / Ouvrir/fermer | volets, stores, protections solaires | 0 % fermé à 100 % ouvert |
| Bouton | interrupteurs muraux, télécommandes, entrées bouton | appui court, appui long |
| Batterie faible / Sabotage | appareils à piles, appareils avec contact d'autoprotection | oui / non |
Un appareil à plusieurs canaux (un actionneur 4 voies, un interrupteur mural 6 touches) a une fonctionnalité par canal, nommée d'après le nom du canal dans l'application ou son numéro. Le point d'accès lui-même, et les appareils que cette version ne connaît pas (serrures, sirènes, actionneurs de plancher chauffant…), n'apparaissent pas.
Boutons : chaque appui est une nouvelle valeur de la fonctionnalité Bouton (appui court, appui long, relâchement), utilisable dans le déclencheur « état d'un appareil » des scènes Gladys. Le cloud ne signale que les appuis des appareils qui les envoient.
Pièces chauffées
Un appareil par pièce chauffée de l'application, nommé Chauffage suivi de la pièce :
- Température et Humidité de la pièce (thermostat mural, ou thermostat de radiateur) ;
- Consigne : la température visée, par demi-degrés, dans les limites de la pièce ;
- Mode : Automatique (programme hebdomadaire), Manuel ou Éco ;
- Boost : les vannes grandes ouvertes pendant la durée de boost réglée dans l'application ;
- Fenêtre : ouverte dès qu'un contact ou le thermostat la voit ouverte ;
- Chauffe : si une vanne de la pièce est ouverte.
Maison (mode éco et alarme)
Un appareil Homematic IP pour toute la maison :
- Mode éco (absence) : activé, toutes les pièces sont à leur température éco jusqu'à ce que vous le coupiez (un mode éco ou des vacances lancés depuis l'application s'affichent aussi ici) ;
- Mode de l'alarme : Désarmée, Protection périphérique ou Protection totale, modifiable dans ce que Pilotage de l'alarme autorise ;
- Alarme : activée tant que l'alarme sonne.
Widget
Le widget Chauffage Homematic IP montre toute la maison d'un coup d'œil : la température Extérieur que le cloud connaît pour votre maison, combien de pièces sont En chauffe, puis chaque pièce avec sa température, sa consigne et ce qu'elle fait (fenêtre, boost, éco). Son bouton lance le Mode éco de toute la maison (avec confirmation) ou, quand il tourne, propose Fin du mode éco. Dans ses réglages, choisissez les pièces à montrer (toutes si aucune n'est choisie).
Déclencheur de scène
Alarme Homematic IP déclenchée : le système d'alarme armé s'est déclenché. Filtrez sur le détecteur (n'importe lequel si vide) et sur la cause : Intrusion, Fumée, Eau, Sabotage, Autre. La scène reçoit le nom du détecteur et la cause en variables. Une alarme qui sonne déjà au démarrage de Gladys ne le déclenche pas.
Tout le reste (une fenêtre ouverte, une touche appuyée, la température d'une pièce) est une fonctionnalité d'appareil : utilisez le déclencheur « état d'un appareil » de Gladys.
Actions de scène
- Lancer le mode éco Homematic IP : toutes les pièces à leur température éco, pour un nombre d'heures, ou jusqu'à la fin (0).
- Lancer le mode vacances Homematic IP : toutes les pièces à une même température (5 à 30 °C) pendant un nombre de jours, puis retour au programme.
- Terminer le mode éco ou vacances Homematic IP : retour au programme normal.
- Régler l'alarme Homematic IP : désarmée, protection périphérique ou totale, dans ce que Pilotage de l'alarme autorise. Elle dit à la scène si le mode a été appliqué, et quels détecteurs l'ont bloqué (une fenêtre ouverte, par exemple).
Exemples de scènes
- Quand la dernière personne quitte la maison (présence Gladys) : Lancer le mode éco Homematic IP, puis Régler l'alarme Homematic IP en protection totale ; si le mode n'a pas été appliqué, envoyez-vous un message avec les détecteurs bloquants.
- Quand Alarme Homematic IP déclenchée avec la cause Intrusion : allumer toutes les lumières et envoyer un message nommant le détecteur.
- Quand l'Ouverture de la fenêtre de la salle de bain passe à ouvert : couper le Boost de la pièce.
Rafraîchissement et limites du cloud
Le cloud pousse chaque changement dès qu'il arrive (une connexion en direct, comme l'application) : les états s'affichent d'habitude en une ou deux secondes. En plus, Gladys lit toute la maison au démarrage, au retour de la connexion en direct, et toutes les 30 minutes (toutes les 5 minutes tant que la connexion en direct est coupée). Gladys n'interroge jamais ces appareils elle-même.
Le cloud Homematic IP freine les clients trop bavards et ne publie aucun quota : l'intégration envoie au plus 10 requêtes d'un coup, puis une toutes les 8 secondes, le rythme du client de référence qu'utilise Home Assistant. Une scène qui commande beaucoup d'appareils à la fois peut voir les dernières commandes refusées (« Trop de commandes Homematic IP à la suite ») : étalez-les, ou utilisez un groupe de l'application.
Dépannage
- « Ce n'est pas un SGTIN » : le code a 24 caractères, chiffres et lettres A à F. Recopiez-le depuis le dessous du point d'accès.
- « Le cloud Homematic IP a refusé la demande » : vérifiez le SGTIN et, si votre point d'accès a un code PIN, le champ Code PIN du point d'accès.
- « Le point d'accès n'a pas encore confirmé » : appuyez sur le bouton bleu du point d'accès, puis cliquez de nouveau sur J'ai appuyé sur le bouton juste après.
- « Le cloud Homematic IP refuse l'accès de Gladys » : Gladys a été supprimé des clients dans l'application. Recommencez l'appairage.
- « Le point d'accès n'est pas connecté » : le cloud répond encore, mais avec les dernières valeurs. Vérifiez l'alimentation et le câble réseau du point d'accès.
- Un appui sur une touche ne s'affiche pas : certains appareils n'agissent que sur leurs liens directs et n'envoient rien au cloud ; vérifiez dans l'application que la touche n'est pas seulement liée à un actionneur.
- Les détails sont dans les journaux de l'intégration ;
LOG_LEVEL=debugen montre davantage.
Limites
- Cloud seulement : pas d'API locale du point d'accès (la HCU n'est pas prise en charge), donc pas d'Internet, pas de pilotage.
- Pas repris dans cette version : serrures, sirènes, actionneurs de plancher chauffant, interfaces de compteur (HmIP-ESI), lumières RGB, modules de porte de garage, lamelles des stores, profils de chauffage.
- Le refroidissement n'est pas géré.
- Le déclencheur d'alarme suit l'alarme que le cloud signale pour toute la maison ; les détecteurs de fumée gardent leur propre fonctionnalité Fumée.
- Les noms des fonctionnalités sont fixés à l'ajout d'un appareil : changez la langue avant d'ajouter les appareils.
- Le jeton est perdu avec le volume
/data: il faut alors appairer de nouveau.
Support
Developed without the hardware: feedback welcome. Questions, bugs et appareils manquants : github.com/guim31/gladys-homematicip/issues. Ce projet n'a aucun lien avec eQ-3 AG.
Paramètres de configuration
Voici les paramètres demandés par Homematic IP dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter votre point d'accès | section | Non | Gladys rejoint votre point d'accès Homematic IP (HmIP-HAP) par le cloud Homematic IP, comme l'application. 1. Saisissez son SGTIN (imprimé sous le point d'accès) et enregistrez. 2. Cliquez sur « Démarrer l'appairage ». 3. Appuyez sur le bouton bleu sur le dessus du point d'accès, puis cliquez sur « J'ai appuyé sur le bouton ». 4. Ajoutez les appareils depuis l'onglet Découverte. |
| SGTIN du point d'accès | string | Oui | 24 caractères imprimés sous le point d'accès et sur son autocollant, tirets acceptés. |
| Code PIN du point d'accès | secret | Non | Seulement si vous avez défini un code PIN dans l'application Homematic IP. Sert à l'appairage uniquement. |
| Langue des noms des appareils | select | Non | Noms donnés aux fonctionnalités des nouveaux appareils (Température, Consigne, Ouverture…). |
| Pilotage de l'alarme | select | Non | Ce que Gladys peut faire avec le système d'alarme Homematic IP. Le lire reste toujours possible. |
Comment installer Homematic IP dans Gladys
- Dans Gladys, ouvrez Intégrations : Homematic IP 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/guim31/gladys-homematicip:1.0.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/guim31/gladys-homematicip.
Homematic IP 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
Homematic IP 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 guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation