Intégration domotique Zeversolar, gratuite et open source
Non officiel : onduleurs solaires Zeversolar en local : puissance, énergie du jour, index d'énergie.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.4
- Nécessite Gladys >=5.2.0
- ★ 0
Connecteur non officiel, sans lien avec Zeversolar. Il lit votre onduleur solaire Zeversolar sur votre réseau local, par la page d'état de sa carte Wi-Fi, sans cloud et sans compte.
Jamais testé avec un vrai onduleur Zeversolar : il a été construit à partir de la bibliothèque zeversolar (celle qu'utilise Home Assistant) et des exemples de sa documentation. Merci de signaler ce que vous voyez (voir « Retours » plus bas).
Ce que vous obtenez
Un appareil Gladys par onduleur, nommé d'après son numéro de série :
| Fonction | Ce que c'est |
|---|---|
| Production solaire (W) | la puissance produite en ce moment ; 0 la nuit |
| Énergie solaire du jour (kWh) | le compteur du jour de l'onduleur, tel qu'il le donne |
| Index de production solaire (kWh) | un index cumulé pour le suivi énergétique de Gladys (production par demi-heure, revenus) |
| Onduleur éveillé | 1 quand l'onduleur produit ou est prêt, 0 en veille (la nuit) |
| Défaut de l'onduleur | 1 quand l'onduleur signale une erreur |
| Liaison au cloud Zeversolar | 1 quand la carte Wi-Fi est connectée au cloud du fabricant |
Lecture seule : l'intégration n'envoie jamais de commande à l'onduleur (pas de marche/arrêt, pas de limite de puissance).
Mise en place
- Trouvez l'adresse IP de l'onduleur dans votre box (sa carte Wi-Fi y apparaît comme un appareil du réseau). Donnez-lui si possible une adresse fixe.
- Dans Gladys, ouvrez l'intégration, saisissez l'adresse (de jour : la nuit l'onduleur dort et ne répond pas) et enregistrez.
- Ouvrez l'onglet « Découverte » et créez l'appareil. Ses valeurs arrivent à la lecture suivante (dans la minute de jour).
- Facultatif mais conseillé : saisissez la puissance crête de vos panneaux (kWc, sur la facture de l'installateur). Elle borne ce que l'index d'énergie peut prendre entre deux lectures. Laissée vide, elle est apprise depuis la puissance atteinte par l'onduleur sur une semaine (30 kW d'ici là, ce qui laisse passer plus de lectures aberrantes). Ne saisissez jamais moins que la vraie puissance crête (une longue coupure à midi pourrait alors faire perdre le reste de la journée) : dans le doute, laissez vide.
Le bouton « Tester la connexion » lit l'onduleur si une lecture est due, sinon il donne la dernière lecture : l'intégration ne lit jamais plus d'une fois par minute, quoi qui le demande.
La nuit
Un onduleur Zeversolar est alimenté par ses panneaux : au coucher du soleil il s'arrête, et sa carte Wi-Fi répond sans production ou se tait. Ce n'est pas une erreur : après trois lectures sans réponse (ou tout de suite quand la carte le dit), l'onduleur est « en veille », sa puissance passe à 0, l'état reste vert et le dit, et il est lu toutes les 5 minutes jusqu'à son réveil. L'état passe au rouge si l'onduleur disparaît (ou si sa carte répond sans lui) alors qu'il produisait 50 W ou plus, si une autre carte Wi-Fi répond à l'adresse, si la réponse n'est pas sa page d'état, ou s'il n'y a aucune lecture pendant plus d'un jour ; après une heure de silence, il est considéré en veille malgré tout.
L'index d'énergie
L'onduleur ne donne qu'un compteur du jour (il repart chaque matin), jamais un compteur depuis sa mise en service, alors que le suivi énergétique de Gladys compte les hausses d'un index cumulé. L'intégration en construit donc un : l'index repart de sa dernière valeur et ajoute ce que le compteur du jour ajoute. Il ne repasse jamais à 0 et ne baisse jamais : un nouveau jour (le compteur revenu à 0 le matin) le laisse où il était. Quand l'onduleur réaffiche le compteur de la veille (au lever, ou après un redémarrage dans la journée), cette valeur reste hors de l'index et hors de l'énergie du jour. Les doutes sont tranchés du côté de compter moins : un redémarrage de l'onduleur qui remet vraiment son compteur à zéro dans la journée, un compteur qui saute (le reste de la journée peut alors être perdu), des heures sans lecture autour du changement de jour, une horloge mal réglée.
Risque restant (il compterait trop) : une valeur de la veille réaffichée plus de 0,1 kWh de la dernière valeur lue, au-dessus ou au-dessous, ou toute lecture fausse qui tient dans la puissance crête de l'installation depuis la dernière lecture. Saisir la puissance crête garde cette marge petite. Et une veille réaffichée à moins de 0,1 kWh au-dessus du compteur du jour peut être prise : 0,1 kWh au plus.
L'index passe aussi par une garde : un saut de l'index lui-même est retenu, affiché dans l'état de l'intégration, et pris seulement quand vous cliquez sur « Accepter l'index retenu » dans la configuration (il est alors compté d'un coup). Une baisse de l'index n'est jamais acceptée : elle se corrige seule, l'index reprend quand le compteur l'a rattrapé. Enregistrer la configuration n'accepte jamais rien.
Limites
- Seul le premier onduleur est lu quand la carte Wi-Fi en signale plusieurs.
- L'énergie du jour est lue comme la bibliothèque la lit : un seul chiffre après la virgule est un zéro manquant (« 14.9 » veut dire 14,09 kWh).
- Production après le minuit local (Grand Nord en juin, ou fuseau de Gladys à l'est de la maison) : la remise à zéro du compteur tombe le même jour local et cette journée est sous-comptée.
- L'intégration demande Gladys 5.2.0 ou plus récent.
Vie privée
Rien ne sort de votre réseau : l'intégration ne parle qu'à l'adresse saisie, avec une petite requête GET par minute (toutes les 5 minutes la nuit). La clé d'enregistrement de la carte Wi-Fi (sa clé pour le cloud du fabricant) n'est jamais gardée, journalisée ni affichée ; de son identifiant, seule une courte empreinte est gardée (pour distinguer une carte d'une autre).
Retours
Tickets et contributions : https://github.com/LM1LC3N7/gladys-zeversolar. Si
vous avez un onduleur Zeversolar, le texte de http://<adresse>/home.cgi (de
jour et de nuit, clé d'enregistrement et numéros de série masqués) aide
beaucoup.
Paramètres de configuration
Voici les paramètres demandés par Zeversolar dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Onduleur Zeversolar | section | Non | Connecteur non officiel, sans lien avec Zeversolar. Il lit la page d'état locale de votre onduleur Zeversolar (sa carte Wi-Fi), sans cloud, une fois par minute : puissance solaire, énergie du jour, et un index de production solaire pour le suivi énergétique de Gladys, construit à partir du compteur du jour. La nuit l'onduleur dort : la puissance passe à 0, l'index attend le matin. Lecture seule : il n'envoie jamais de commande à l'onduleur. Jamais testé avec un vrai onduleur Zeversolar. |
| 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. Saisissez-la de jour : la nuit l'onduleur dort et ne répond pas. 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. |
| Puissance crête de l'installation (kWc, facultatif) | number | Non | La puissance crête de vos panneaux (sur la facture de l'installateur). Elle borne ce que l'index d'énergie peut prendre entre deux lectures (une lecture aberrante est retenue). Vide : apprise depuis la puissance atteinte par l'onduleur sur une semaine (30 kW d'ici là). Ne saisissez jamais moins que la vraie puissance crête : dans le doute, laissez vide. |
Comment installer Zeversolar dans Gladys
- Dans Gladys, ouvrez Intégrations : Zeversolar 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-zeversolar:0.1.4), 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-zeversolar.
Zeversolar 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
Zeversolar 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