Intégration domotique energieleser, gratuite et open source
Non officiel : lecteur energieleser stromleser en local : puissance et index.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.2.0
- ★ 0
Intégration non officielle, sans lien avec energieleser (nineti GmbH). Elle lit un stromleser, le lecteur optique energieleser posé sur le port infrarouge d'un compteur d'électricité allemand, par son API locale : pas de cloud, pas de compte, rien d'envoyé au lecteur sinon une lecture toutes les 10 secondes.
Jamais testé avec un vrai lecteur energieleser : l'intégration a été écrite à partir de la bibliothèque Python du fabricant (celle de Home Assistant). Vos retours sont bienvenus.
Ce que vous obtenez
Un appareil par lecteur, nommé d'après son identifiant
(stromleser STROM_ONE_…), avec les valeurs que donne le compteur (un
compteur n'en envoie qu'une partie) :
| Fonction | Nature | Code du compteur |
|---|---|---|
| Puissance nette (voir plus bas) | capteur d'énergie, W | 16.7.0 |
| Index de consommation | index d'énergie, kWh | 1.8.0 |
| Index de consommation, tarifs 1 à 4 (kWh) | simple capteur | 1.8.1 à 1.8.4 |
| Index d'injection (kWh), tarifs 1 à 4 | simple capteur | 2.8.0 à 2.8.4 |
| Puissance prélevée, injectée, absolue (W) | simple capteur | 1.7.0, 2.7.0, 15.7.0 |
| Puissance L1, L2, L3 (W) | simple capteur, sans historique | 36.7.0, 56.7.0, 76.7.0 |
| Signal Wi-Fi (dBm) | simple capteur, sans historique | rssi |
- L'index de consommation alimente le suivi énergétique de Gladys, qui en tire la consommation et son coût. Il est publié chaque minute et vérifié d'abord : jamais 0 ; toute baisse, même d'1 Wh, ou un saut que le foyer n'a pas pu consommer est retenu (la dernière valeur acceptée est renvoyée) et affiché dans l'état de l'intégration. S'il est juste (nouveau compteur, longue coupure), cliquez sur Accepter l'index retenu : exactement la valeur affichée est prise. Enregistrer la configuration ne l'accepte jamais.
- L'injection n'entre jamais dans le suivi énergétique (elle serait facturée comme une consommation) : simples capteurs.
- Les puissances sont envoyées toutes les 10 secondes, seulement quand elles changent (et toutes les 10 minutes sinon). Quand le lecteur ne donne plus de nouveau relevé pendant 5 minutes (tête optique déplacée), elles ne sont plus envoyées et l'état le dit. Après un démarrage, elles attendent que le relevé bouge (une dizaine de secondes) : un relevé figé avant un redémarrage n'est jamais envoyé comme neuf. Un lecteur qui ne donne pas d'horodatage ne peut pas être vérifié : l'état le dit.
- La puissance nette est en général négative quand le foyer injecte, selon le compteur (à confirmer sur un vrai compteur).
- Quand le compteur donne plus tard de nouvelles valeurs (compteur débloqué par son PIN), l'appareil reçoit de nouvelles fonctions : dans l'onglet Découverte, cliquez sur Mettre à jour sur l'appareil pour les ajouter (son historique est gardé).
Installation
- Installez l'application energieleser, posez le stromleser sur votre compteur et connectez-le à votre Wi-Fi, comme l'explique le fabricant.
- Trouvez son adresse IP (dans votre box ou l'application) et donnez-lui de préférence une adresse fixe dans votre box.
- Dans Gladys, ouvrez l'intégration, saisissez cette adresse, enregistrez.
- Dans l'onglet Découverte, créez l'appareil.
Si l'état indique que le compteur ne donne pas de puissance, il est sans doute verrouillé par PIN : saisissez sur le compteur le PIN donné par votre gestionnaire de réseau pour débloquer ses données étendues. Les index continuent en attendant.
Boutons
- Tester la connexion : lit le lecteur quand une lecture est due (jamais plus d'une toutes les 10 secondes), sinon donne la dernière lecture.
- Accepter l'index retenu : voir plus haut.
Limites
- Seul le stromleser (électricité) est lu. Un gasleser, wasserleser ou wärmeleser à l'adresse est reconnu et refusé, avec son nom.
- Un lecteur par intégration. Un autre lecteur qui répond à l'adresse (une IP qui a changé) a son propre appareil : ses valeurs ne vont jamais au précédent.
- Un index du compteur sans unité connue (Wh, kWh, MWh) n'est jamais utilisé.
- Lecture seule : le lecteur ne reçoit aucune commande.
Dépannage
L'état de l'intégration dit ce qui se passe : adresse manquante, lecteur
injoignable (nouvel essai après 10 s, doublé jusqu'à 5 minutes), réponse
inattendue, lecteur qui demande d'attendre (HTTP 429 ou 5xx : lectures en
pause de 1 minute à 6 heures, gardée après un redémarrage), index retenu. Pour regarder le lecteur vous-même, ouvrez
http://<adresse>/v1/data dans un navigateur sur le même réseau.
Paramètres de configuration
Voici les paramètres demandés par energieleser dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| energieleser | section | Non | Connecteur non officiel, sans lien avec energieleser (nineti GmbH). Il lit votre stromleser, le lecteur optique posé sur le port infrarouge d'un compteur d'électricité allemand, par son API locale, sans cloud : la puissance toutes les 10 secondes, l'index de consommation (1.8.0) chaque minute pour le suivi énergétique de Gladys et, quand le compteur les donne, les index par tarif, l'injection (2.8.0) en simples capteurs, la puissance par phase et le signal Wi-Fi. Lecture seule. Les gasleser, wasserleser et wärmeleser ne sont pas encore pris en charge. Jamais testé avec un vrai lecteur energieleser. |
| Adresse du lecteur | string | Oui | L'adresse IP du stromleser sur votre réseau (visible dans votre box ou l'application energieleser), avec un port seulement s'il n'est pas 80. Donnez-lui de préférence une adresse fixe dans votre box ; si elle change, saisissez la nouvelle : l'appareil et son historique sont gardés. |
Comment installer energieleser dans Gladys
- Dans Gladys, ouvrez Intégrations : energieleser 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-energieleser: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-energieleser.
energieleser nécessite Gladys >=5.2.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
energieleser 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