Intégration domotique Legrand Home + Control, gratuite et open source
Céliane et dooxie with Netatmo : éclairages, variateurs, prises, volets et compteurs.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- 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 |
La position d'un volet est proposée pour les modules qui acceptent toutes les positions (NLLV) ; les autres s'ouvrent, se ferment et s'arrêtent. Le badge de chaque appareil indique si le module répond.
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.
- 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). 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.
- « 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. 1. Connectez-vous sur dev.netatmo.com avec votre compte Home + Control 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. Intégration non officielle, sans lien avec Legrand 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). |
| 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.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-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