Intégration domotique IMEON, gratuite et open source
Non officiel : onduleurs hybrides IMEON en local : solaire, batterie, réseau, index d'énergie.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.2
- Nécessite Gladys >=5.2.0
- ★ 0
Intégration non officielle, sans lien avec Imeon Energy. Elle lit votre onduleur hybride IMEON (IMEON 3.6, 9.12, 3-25…) sur votre réseau local, par l'API locale d'OS One, sans cloud, une fois par minute. Lecture seule : elle ne change jamais un réglage de l'onduleur (mode, charge de la batterie, injection, relais).
Jamais testé avec un vrai onduleur IMEON : l'intégration a été écrite à partir de la bibliothèque officielle d'Imeon Energy (imeon_inverter_api) et de l'intégration Home Assistant qui l'utilise. Vos retours sont les bienvenus.
Prérequis
- Un onduleur IMEON avec OS One, joignable sur votre réseau local (adresse IP fixe conseillée dans votre box).
- Le module API activé sur l'onduleur (sans lui, l'intégration indique « réponse qui n'est pas celle d'un IMEON »).
- L'identifiant et le mot de passe de l'interface locale de l'onduleur (souvent
user@local). Un compte utilisateur suffit : l'intégration ne fait que lire.
Configuration
- Dans Gladys, installez l'intégration IMEON depuis le catalogue.
- Saisissez l'adresse de l'onduleur (ex.
192.168.1.50), l'identifiant et le mot de passe. Le mot de passe est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à l'onduleur sur votre réseau. - Cliquez sur Tester la connexion : le modèle et le numéro de série de l'onduleur s'affichent.
- Dans l'onglet Découverte, créez l'appareil « IMEON … ». Ses valeurs arrivent aussitôt, puis chaque minute.
Ce que vous obtenez
- Solaire : production totale (
energy-production-sensor, W), par chaîne, part consommée dans la maison, part injectée. - Batterie : charge (%), puissance, état (1 = en charge, 2 = en décharge, 3 = chargée), puissances stockée et consommée.
- Réseau : puissance prélevée (
energy-sensor, W, lue par les contrats d'énergie), puissance injectée, flux, tension et courant par phase, fréquence. - Maison : consommation (W), entrée et sortie AC, compteur d'énergie, températures de l'onduleur, autoconsommation et autosuffisance sur 24 h, état et mode de l'onduleur (en lecture seule), limites de courant de charge et de puissance d'injection.
- Compteurs du jour (kWh) : production solaire, prélevé et injecté sur le réseau, consommation de la maison, stocké dans et pris à la batterie, prévisions restantes. Ce sont de simples capteurs : ils repartent de 0 chaque nuit et ne sont jamais comptés par le suivi énergétique.
- Deux index d'énergie pour le suivi énergétique de Gladys : l'index de consommation réseau (le cœur en tire la consommation et son coût) et l'index de production solaire (le cœur en tire la production par demi-heure).
Les phases L2 et L3 n'apparaissent qu'une fois que l'onduleur les montre (onduleur triphasé).
Les index d'énergie
L'API locale de l'onduleur ne donne que des compteurs du jour, qui repartent de 0 à minuit, et aucun compteur cumulé. Le suivi énergétique de Gladys a besoin d'un index cumulé. L'intégration le construit donc : index = somme des journées terminées + compteur du jour.
Règle : chaque doute compte moins, jamais plus.
- Une baisse du compteur n'est un nouveau jour qu'autour du minuit local (de
23 h à 3 h, fuseau
TZdu conteneur, Europe/Paris par défaut), une fois par nuit, ou si la dernière valeur prise date d'un jour précédent (coupure au-delà de minuit), et seulement jusqu'à 36 kWh au plus. L'index reste alors exactement où il était : ni la première valeur du nouveau jour, ni ce que l'onduleur a compté entre la dernière lecture et son minuit ne sont comptés (un peu moins). - Une deuxième baisse pendant que le premier nouveau jour peut être annulé (une valeur basse obsolète juste avant minuit, puis le vrai 0) annule le premier : un seul nouveau jour compte.
- Une autre baisse (redémarrage, horloge perdue, incident en journée) ne donne pas d'index tant que le compteur n'est pas revenu au-dessus de sa dernière valeur (l'état le dit). Ce qui ne revient pas n'est pas compté.
- Une hausse plus rapide que la marge depuis la dernière valeur prise (36 kW pour la consommation, la marge apprise pour la production, voir plus bas) est un saut : jamais prise, jamais confirmée par le temps.
- Un « nouveau jour » pris par erreur (compteur à 0 près de minuit) est annulé si, dans les 3 h, le compteur revient plus vite que possible, revient directement à la valeur exacte de la veille, ou, lu après un trou de plus de 3 minutes, revient à au moins la moitié de la veille : un redémarrage nocturne de l'onduleur (non lu, 0 ou valeur obsolète, non lu, retour) est un seul incident. Seule exception : une vraie coupure au-delà de minuit (baisse lue hors de la fenêtre de minuit, après 3 h, jour local changé et plus d'1 h sans lecture avant la baisse, mesurée sur l'horloge monotone : une horloge murale qui avance n'en fabrique pas). La nuit est alors consommée : une valeur sous celle de la veille ne donne pas d'index tant que le compteur ne l'a pas dépassée ou que le jour local n'a pas changé.
- Une horloge qui recule ne donne pas d'index tant qu'elle n'a pas rattrapé la dernière lecture.
- Si l'intégration est arrêtée plusieurs heures autour de minuit, l'énergie de ces heures n'est pas comptée.
- Risque restant près de minuit : après un nouveau jour encore annulable, une valeur relue après un trou mais inférieure à la moitié de la veille est prise comme la consommation du nouveau jour (au plus cette valeur comptée en trop) ; et après une vraie coupure au-delà de minuit (baisse lue après 3 h du matin, plus d'1 h sans lecture), un retour au niveau de la veille après un nouveau trou, assez lent pour être plausible, compterait la veille une seconde fois : il faut un onduleur dont le minuit a plus de 3 h de retard, une coupure, un compteur à presque 0 et un retour. La garde ci-dessous retient encore tout saut de l'index.
Le compteur de la veille réaffiché (un redémarrage de l'onduleur) est gardé hors de l'index : après minuit, une valeur à 0,1 kWh près de la dernière lue tant que l'onduleur n'a pas commencé son nouveau jour ; plus tard le même jour, une valeur à 0,1 kWh près de celle de la veille alors que le compteur du jour est encore à plus de 0,1 kWh en dessous (un saut, jamais une montée lente). Le compteur du jour n'est pas envoyé non plus pour cette lecture, et l'état le signale. Le repère de la veille est noté pour la nuit du nouveau jour, même quand l'onduleur remet à zéro un peu avant notre minuit. Après une mise à jour depuis 0.1.1, cette protection commence au premier minuit qui suit (ou tout de suite si la mise à jour tombe dans les 3 h après un nouveau jour).
Chaque index passe ensuite la garde reprise de l'intégration P1 Monitor : jamais 0 ; une hausse plausible passe (au plus 36 kW en moyenne depuis la dernière valeur, plus 0,5 kWh, pour l'index de consommation réseau ; pour l'index de production solaire, 1,5 × la plus forte puissance solaire des 30 derniers jours une fois 7 jours connus, entre 2 et 36 kW, et 36 kW avant) ; une baisse ou un saut est retenu (la dernière valeur acceptée est renvoyée), affiché dans l'état de l'intégration et gardé après un redémarrage.
- Un saut n'est pris que par le bouton Accepter l'index retenu, et seulement pour la valeur affichée (plus ce qui a pu venir depuis) : il est alors compté d'un coup.
- Une baisse n'est jamais acceptée : l'index construit à partir du
compteur du jour ne baisse que lorsqu'il reprend des valeurs déjà envoyées
(ou quand
/dataest plus ancien que Gladys), jamais parce qu'un compteur a été remplacé. Rien à faire : il se corrige seul et reprend quand le compteur l'a rattrapé ; seule l'énergie nouvelle est comptée. Le bouton répond qu'une baisse n'est jamais acceptée. - Enregistrer la configuration n'accepte jamais rien.
Pour l'index de production, quand le compteur du jour n'avance que par paliers (toutes les quelques minutes), la hausse d'un palier est jugée sur le temps écoulé depuis le palier précédent (20 min au plus, jamais au-delà de 36 kW), pas sur une seule minute. Des paliers plus longs, ou trop forts pour 36 kW, peuvent encore faire perdre le reste d'une journée (comme en 0.1.1).
Risque restant (il compterait trop) :
- une veille réaffichée à plus de 0,1 kWh de la dernière valeur lue, au-dessus ou au-dessous, est prise comme une hausse du jour, ou réaffichée alors que le compteur du jour en est déjà à moins de 0,1 kWh en dessous : au plus 0,1 kWh ;
- toute lecture fausse qui tient dans la marge passe : pour la consommation, 36 kW × la durée du silence (une seule valeur fausse après 30 min sans lecture : +6,35 kWh mesurés) ; pour la production, 36 kW les 7 premiers jours et après une mise à jour, puis la marge apprise.
Limite (il compte moins) : après un saut refusé, plus rien n'est pris ce jour-là pour cet index (sauf si le compteur revient tout près de sa dernière valeur prise) ; l'index repart au nouveau jour. Si vous supprimez puis recréez l'appareil, ses index repartent de zéro.
Erreurs et pauses
- Identifiant ou mot de passe refusé : les lectures s'arrêtent (gardé après un redémarrage), un seul nouvel essai après 1 h, puis 2 h… jusqu'à 24 h. Corrigez-les et enregistrez la configuration pour repartir aussitôt. Le bouton de test ne force jamais d'essai pendant cet arrêt.
- HTTP 429 ou 5xx : pause de 1 minute à 6 heures (gardée après un redémarrage), jamais de lecture avant la fin.
- Onduleur injoignable : nouvel essai après 1 minute, puis doublé jusqu'à 15 minutes.
- Session terminée : l'intégration se reconnecte une seule fois par lecture, jamais en boucle.
- Une page secondaire (températures, prévisions, état…) qui ne répond pas ne bloque jamais les autres valeurs.
Limites connues
- Jamais testé avec un vrai onduleur IMEON : les noms des champs et leurs unités viennent de la bibliothèque et de l'intégration Home Assistant.
- Lecture seule en v0.1 : pas de changement de mode, de charge réseau, de décharge nocturne, d'injection ni de relais.
- Les messages de la chronologie de l'onduleur ne sont pas lus en v0.1.
- Un seul onduleur par intégration.
Données et vie privée
Tout reste sur votre réseau local : l'intégration ne parle qu'à l'onduleur.
Le dossier /data de l'intégration ne garde que le numéro de série, l'état
des index et des gardes, et les pauses en cours : jamais le mot de passe ni le
cookie de session.
Paramètres de configuration
Voici les paramètres demandés par IMEON dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Onduleur IMEON | section | Non | Connecteur non officiel, sans lien avec Imeon Energy. Il lit votre onduleur hybride IMEON par l'API locale d'OS One (le « module API » doit être activé), sans cloud, une fois par minute : production solaire, batterie, réseau, consommation de la maison, températures, et deux index d'énergie pour le suivi énergétique de Gladys (prélevé sur le réseau, production solaire), construits à partir des compteurs du jour de l'onduleur. Lecture seule : il ne change jamais un réglage de l'onduleur. Jamais testé avec un vrai onduleur IMEON. |
| Adresse de l'onduleur | string | Oui | L'adresse IP de l'onduleur sur votre réseau (visible dans votre box), 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. |
| Identifiant | string | Oui | L'identifiant de l'interface locale de l'onduleur (OS One), souvent une adresse comme user@local. Un compte utilisateur suffit : l'intégration ne fait que lire. |
| Mot de passe | secret | Oui | Le mot de passe de ce compte. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à l'onduleur sur votre réseau. |
Comment installer IMEON dans Gladys
- Dans Gladys, ouvrez Intégrations : IMEON 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-imeon:0.1.2), 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-imeon.
IMEON 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
IMEON 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