Aller au contenu principal

Intégration Écocompteur Legrand pour Gladys Assistant

Intégration Écocompteur Legrand pour Gladys Assistant

Lit l'écocompteur Legrand (réf. 412000) sur votre réseau local.

Voir sur GitHubToutes les intégrations externes

Cette intégration lit l'écocompteur Legrand (réf. 412000) directement sur votre réseau local, sans compte ni service tiers. L'appareil expose deux endpoints HTTP (/inst.json et /data.json) que l'intégration interroge à intervalle régulier.

Ce qui remonte dans Gladys​

  • Puissance instantanée des 5 tores, en watts. Les features reprennent les libellés que vous avez saisis dans l'interface de l'écocompteur : si votre entrée 1 s'appelle « Chauffage », elle s'appelle « Chauffage » dans Gladys.
  • Index du compteur issus de la téléinformation : heures creuses et heures pleines, index Tempo (6 couleurs) ou index base selon votre option tarifaire (détectée automatiquement). En kWh.
  • Option tarifaire et Tarif en cours en texte lisible (« HC/HP », « Tempo », « Heure Pleine Bleu »...) plutôt qu'en code numérique brut.
  • Énergie consommée par tore, en kWh (« Chauffage (énergie) »...), voir plus bas.
  • Entrées à impulsions (gaz, eau) : seules celles activées dans l'écocompteur sont créées, avec leur volume en m³.

Énergie par tore​

L'écocompteur ne fournit que la puissance instantanée de ses tores, jamais un compteur cumulé. L'intégration reconstruit donc un index d'énergie pour chaque tore, en intégrant la puissance entre deux relevés. Comme les index téléinfo, ces index reçoivent automatiquement leur « Consommation 30 minutes » et leur « Coût 30 minutes » : vous pouvez suivre le coût de votre pompe à chaleur ou de votre borne de recharge séparément.

À savoir :

  • L'index démarre à 0 à l'installation : c'est un cumul relatif, pas l'historique réel du circuit. Gladys ne regarde que les différences, ça n'a pas d'incidence sur la consommation ni sur le coût.
  • C'est une approximation : un appareil qui s'allume et s'éteint entre deux relevés est plus ou moins bien compté. Plus l'intervalle de rafraîchissement est court, plus le résultat est précis.
  • Si l'écocompteur reste injoignable plus de 5 minutes, cette période n'est pas comptée : l'intégration préfère sous-estimer plutôt qu'inventer une consommation.
  • Le cumul est sauvegardé et survit au redémarrage de l'intégration.

Widget « Puissance en direct »​

L'intégration fournit un widget de tableau de bord (Gladys 5.1 minimum). Ajoutez-le depuis l'éditeur de tableau de bord, dans la section de l'intégration. Il affiche :

  • la puissance des 5 tores, mise à jour en direct ;
  • leur total ;
  • le tarif en cours, coloré selon la période (bleu, blanc ou rouge en Tempo, vert en heures creuses, orange en heures pleines).

Suivi de consommation et coût (option Tempo)​

Chaque index créé (heures creuses, heures pleines, ou l'une des 6 combinaisons Tempo) est une véritable feature « Index » Gladys : le cœur Gladys y ajoute automatiquement une feature « Consommation 30 minutes » et une feature « Coût 30 minutes », sans rien à faire côté configuration de l'intégration — seule une grille tarifaire dans Paramètres → Énergie est nécessaire pour que le coût se calcule.

En option Tempo, ça donne 6 index distincts, chacun avec son propre suivi consommation/coût :

IndexPériode
Index Heures Creuses BleuHeures creuses, jour bleu
Index Heures Pleines BleuHeures pleines, jour bleu
Index Heures Creuses BlancHeures creuses, jour blanc
Index Heures Pleines BlancHeures pleines, jour blanc
Index Heures Creuses RougeHeures creuses, jour rouge
Index Heures Pleines RougeHeures pleines, jour rouge

Gladys connaît lui-même le calendrier officiel des jours Tempo : il n'a pas besoin de l'écocompteur pour savoir quelle couleur s'applique quel jour, seulement des prix associés à chaque combinaison couleur/créneau.

Configuration​

  1. Donnez à votre écocompteur un bail DHCP fixe sur votre box. Son adresse sert d'identifiant : la changer créerait un nouvel appareil dans Gladys.
  2. Saisissez cette adresse dans le champ prévu (par exemple 192.168.1.140).
  3. Ajustez l'intervalle de rafraîchissement si besoin (60 secondes par défaut, de 1 seconde à 60 secondes).
  4. Utilisez le bouton Tester la connexion pour vérifier que l'appareil répond avant de lancer la découverte.

Remarques​

  • L'écocompteur renvoie ses index avec des zéros en tête, ce qui n'est pas du JSON valide ; l'intégration normalise la réponse avant de la parser.
  • Les libellés des tores sont repris de l'écocompteur à la création de l'appareil dans Gladys. Une fois l'appareil créé, ses noms appartiennent à Gladys (comme le nom de l'appareil ou sa pièce) : renommer une entrée dans l'écocompteur ensuite ne les met pas à jour. Renommez la fonctionnalité directement dans Gladys, ou supprimez puis recréez l'appareil depuis l'onglet Découverte (ce qui fait perdre son historique).
  • Un tore non câblé renvoie 0 W en permanence. Vous pouvez supprimer la feature correspondante dans Gladys si elle vous encombre.

Paramètres de configuration​

Voici les paramètres demandés par Écocompteur Legrand dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonL'écocompteur expose ses données en local, sans compte ni clé d'API. Attribuez-lui un bail DHCP fixe : son adresse identifie l'appareil dans Gladys.
Adresse de l'écocompteurstringOuiAdresse IP ou nom d'hôte sur votre réseau local, par exemple 192.168.1.140
Intervalle de rafraîchissementselectNonFréquence d'interrogation de l'écocompteur. Gladys n'autorise que ces valeurs fixes (poll_frequency est un enum, en millisecondes, côté cœur).
Publier les index du compteurbooleanNonAjoute les index heures creuses / heures pleines (ou base) lus via la téléinformation du compteur.

Comment installer Écocompteur Legrand dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Écocompteur Legrand 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/goldorakiller/gladys-integration-ecocompteur:1.3.0), 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/goldorakiller/gladys-integration-ecocompteur.

Écocompteur Legrand 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​

Écocompteur Legrand 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 goldorakiller, 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