Intégration domotique Legrand Home + Control, gratuite et open source
Céliane, dooxie with Netatmo et Bubendorff iDiamant : éclairages, prises, volets, compteurs.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.3
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez depuis Gladys les modules Céliane with Netatmo et dooxie with Netatmo de votre passerelle Legrand Home + Control : éclairages et variateurs, prises, contacteurs, volets roulants et compteurs d'énergie. L'intégration passe par le cloud Netatmo (le service derrière l'application Home + Control) avec l'API officielle Netatmo Connect, en votre nom. Intégration non officielle, sans lien avec Legrand ni Netatmo.
Version de développement (0.1). Développée d'après la documentation Netatmo et des réponses enregistrées, pas encore testée sur une vraie installation. Vos retours sont les bienvenus sur le dépôt GitHub.
Ce que vous obtenez
| Module | Dans Gladys |
|---|---|
| Prise, prise mobile, sortie de câble (NLP, NLPM, NLC) | un interrupteur : marche/arrêt et puissance (W) |
| Télérupteur, contacteur, contact sec (NLPT, NLPO, NLPD) | un interrupteur (une lampe s'il commande une lampe) |
| Interrupteur, micromodule, double interrupteur (NLL, NLM, NLIS) | une lampe : marche/arrêt et puissance (une par voie) |
| Variateur (NLF, NLFN, NLFE) | une lampe : marche/arrêt, luminosité et puissance |
| Interrupteur de volet (NLV, NLLV), volet Zigbee (Z3V) | un volet : ouvrir, fermer, stop (et position) |
| Compteur modulaire, délesteur, compteur triphasé (NLPC, NLPS, NLY) | puissance consommée (par phase pour le NLY) |
| Commande sans fil (NLT, NLD) | niveau de batterie |
| Volet Bubendorff iDiamant (NBR, NBO, NBS) | un volet : ouvrir, fermer, stop (et position) |
La position d'un volet est proposée pour les modules qui acceptent toutes les positions (NLLV, et les volets qui annoncent un pas inférieur à 100) ; les autres s'ouvrent, se ferment et s'arrêtent. Le badge de chaque appareil indique si le module répond.
Volets Bubendorff iDiamant with Netatmo
Les volets Bubendorff derrière une passerelle iDiamant (NBG) passent par la même API Netatmo Connect : ils apparaissent dans Découverte comme des volets (jamais comme des interrupteurs), avec ouvrir, fermer et stop, et une position seulement quand le module en donne une (la plupart des volets iDiamant s'ouvrent, se ferment et s'arrêtent seulement). La position favorite de la télécommande Bubendorff n'est pas encore proposée.
Jamais testé avec de vrais volets Bubendorff : développé d'après les réponses enregistrées par pyatmo. Vos retours sont les bienvenus.
Le bouton Connecter demande désormais aussi les droits Bubendorff
(read_bubendorff, write_bubendorff). Si vous vous êtes connecté avant
cette version, rien ne change pour vos modules Legrand ; si des volets
Bubendorff sont trouvés sans le droit write_bubendorff, le statut vous
invite à cliquer à nouveau sur Connecter pour ajouter Bubendorff. Si votre
application Netatmo ne propose pas ces droits, l'intégration se replie sur les
seuls droits Home + Control : tout de suite si Netatmo les refuse à la liaison,
et sinon quand vous cliquez à nouveau sur Connecter après une page
d'autorisation Netatmo qui ne vous a pas ramené dans Gladys (ce clic-là demande
les seuls droits Home + Control).
Une commande de volet n'est jamais envoyée en retard : une à la fois par volet (un stop n'attend jamais), refusée si Netatmo n'a pas pu la prendre en quatre secondes, et signalée envoyée, sans confirmation quand elle est partie sans réponse, l'état étant relu quelques secondes après.
Pas encore : les sorties de câble en mode fil pilote (radiateurs : leur puissance seulement), la VMC (NLLF), la porte de garage (NLJ), les lignes de l'écocompteur (NLE), les appuis sur les commandes sans fil, l'historique d'énergie. Ils sont prévus.
Installation
Il vous faut une application Netatmo à vous (gratuite, cinq minutes) : elle donne à l'intégration le droit d'utiliser l'API avec votre compte.
- Allez sur dev.netatmo.com et connectez-vous avec le compte de l'application Home + Control (ou Bubendorff iDiamant).
- Créez une application : nom et description libres (ex. « Gladys »), votre nom et votre e-mail comme contact protection des données.
- Dans la configuration de l'intégration dans Gladys, copiez l'URI de redirection que Gladys affiche pour le bouton Connecter, et collez-la dans le champ Redirect URI de l'application Netatmo. Enregistrez l'application.
- Copiez le client ID et le client secret de l'application dans la configuration Gladys, et enregistrez.
- Cliquez sur Connecter : Netatmo vous demande de vous identifier et
d'accepter les droits Home + Control (
read_magellan,write_magellan) et, pour les volets Bubendorff,read_bubendorffetwrite_bubendorff. Vous revenez dans Gladys, connecté. - Ouvrez l'onglet Découverte : vos modules y sont, ajoutez ceux que vous voulez.
Tester la connexion indique combien de logements et d'appareils ont été trouvés.
Options
| Option | Défaut | Rôle |
|---|---|---|
| Intervalle de rafraîchissement | 60 s | fréquence de lecture des états (une minute minimum, une heure max) |
Une commande part tout de suite et l'état est relu quelques secondes après. Netatmo limite les requêtes (500 par heure et par utilisateur) : l'intégration les espace, envoie ensemble les commandes d'un même instant et fait une pause quand Netatmo le demande. Avec plusieurs logements ou beaucoup de commandes, un intervalle plus long est plus sûr.
Dépannage
- « Netatmo a refusé l'autorisation » : l'autorisation a expiré ou a été révoquée (depuis le compte Netatmo), ou le client secret est erroné. Vérifiez le client ID et le client secret, enregistrez, puis cliquez à nouveau sur Connecter.
- La page de connexion affiche une erreur : l'URI de redirection de l'application Netatmo n'est pas exactement celle que Gladys affiche (recopiez-la, sans espace).
- « Lecture seule » : les droits Home + Control n'ont pas tous été acceptés : cliquez à nouveau sur Connecter et acceptez-les.
- « reconnectez-vous pour ajouter Bubendorff » : votre autorisation date d'avant les droits Bubendorff. Cliquez sur Connecter et acceptez-les ; les modules Legrand continuent de fonctionner en attendant.
- « Limite d'usage atteinte » : Netatmo a demandé de ralentir ; l'intégration réessaie seule. Augmentez l'intervalle si cela se répète.
- Un module manque : les logs listent les modules que l'intégration ne sait pas encore afficher ; Tester la connexion les compte.
- Un appareil est « injoignable » : le module ou la passerelle ne répond plus à Netatmo (coupure de courant, Wi-Fi de la passerelle).
Confidentialité
L'intégration ne parle qu'à api.netatmo.com, avec votre propre application
Netatmo. Le client secret et les jetons sont conservés par Gladys et
n'apparaissent jamais dans les logs. Rien ne passe par Gladys Plus.
Paramètres de configuration
Voici les paramètres demandés par Legrand Home + Control dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre installation Legrand Home + Control | section | Non | Pilotez les modules Céliane with Netatmo et dooxie with Netatmo de votre passerelle Home + Control via le cloud Netatmo : éclairages et variateurs, prises, contacteurs, volets roulants et compteurs d'énergie ; et les volets Bubendorff iDiamant with Netatmo (jamais testé avec de vrais volets Bubendorff). 1. Connectez-vous sur dev.netatmo.com avec votre compte Home + Control ou iDiamant et créez une application. 2. Dans son champ Redirect URI, collez l'URI de redirection que Gladys affiche pour le bouton Connecter ci-dessous. 3. Copiez ici le client ID et le client secret de l'application et enregistrez. 4. Cliquez sur Connecter et acceptez les droits Home + Control et Bubendorff. Intégration non officielle, sans lien avec Legrand, Bubendorff ni Netatmo. |
| Client ID | string | Oui | Le client ID de l'application créée sur dev.netatmo.com. |
| Client secret | secret | Oui | Le client secret de la même application. Conservé dans Gladys, jamais réaffiché. |
| Compte Netatmo | oauth2 | Non | Enregistrez d'abord le client ID et le client secret, puis connectez-vous : Netatmo vous demande de vous identifier et d'accepter les droits Home + Control (read_magellan, write_magellan) et Bubendorff (read_bubendorff, write_bubendorff). Déjà lié ? Vos modules Legrand continuent de fonctionner ; reconnectez-vous seulement pour ajouter Bubendorff. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture des états chez Netatmo, en secondes (une minute minimum, dans les limites d'usage Netatmo). Une commande est confirmée quelques secondes après son envoi. |
Comment installer Legrand Home + Control dans Gladys
- Dans Gladys, ouvrez Intégrations : Legrand Home + Control 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-legrand-home-control: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). - 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-legrand-home-control.
Legrand Home + Control 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
Legrand Home + Control 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