Intégration domotique APsystems EZ1, gratuite et open source

Connecteur non officiel : micro-onduleurs APsystems EZ1, production solaire et limite de puissance.

• Publiée par LM1LC3N7
• Appareils
• Version 0.1.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Connecteur non officiel, sans lien avec APsystems. Il lit vos micro-onduleurs APsystems EZ1 (solaire de balcon : EZ1-M, et les autres modèles EZ1 qui offrent l'API locale) sur votre réseau local, via l'API locale que l'onduleur ouvre lui-même : ni cloud ni compte, rien ne sort de chez vous. APsystems est une marque d'Altenergy Power System Inc.

Ce que vous obtenez

Surface	Contenu
Un appareil par onduleur	puissance produite (W, totale et par panneau), énergie du jour (kWh), énergie totale (kWh, un index de production pour le suivi énergétique de Gladys, avec sa production par tranche de 30 minutes), limite de puissance (W, réglable), marche/arrêt, joignable, alarmes
Déclencheurs de scène	production solaire démarrée (le matin), production solaire arrêtée (le soir), alarme d'onduleur solaire (hors réseau, défaut de sortie, court-circuit DC sur un panneau)
Actions de scène	régler la limite de puissance solaire d'un onduleur, lire la production solaire (puissance, énergie du jour et totale, d'un onduleur ou de tous)
Widget	Production solaire : puissance actuelle, énergie du jour et totale, par panneau, la limite et l'état d'un onduleur, ou le total de tous

Installation

1. Activez l'API locale de chaque onduleur, une fois : dans l'application AP EasyPower, connectez-vous à l'onduleur (Bluetooth, « Connexion directe »), ouvrez Réglages → Mode local, activez-le et choisissez Continu. L'application affiche l'adresse IP de l'onduleur.
2. Dans votre box, donnez à chaque onduleur une adresse fixe (réservation DHCP) : l'intégration retrouve les onduleurs par leur adresse.
3. Dans Gladys, saisissez les adresses dans Adresses des onduleurs, séparées par des virgules : 192.168.1.50, 192.168.1.51. Le port est 8050 ; ajoutez :port seulement si le vôtre est différent.
4. Enregistrez, puis cliquez sur Tester les onduleurs : chaque adresse répond avec son modèle, son numéro de série, son firmware et sa puissance actuelle. Faites-le de jour : un EZ1 dort la nuit.
5. Ouvrez Découverte et ajoutez les onduleurs. Placez le widget Production solaire sur un tableau de bord : choisissez un onduleur, ou laissez vide pour le total de tous.

Chaque onduleur est lu toutes les 30 secondes (option Intervalle de rafraîchissement, 10 s minimum : l'EZ1 répond lentement) ; ses alarmes et sa marche/arrêt toutes les 5 minutes, ses informations et sa limite de puissance toutes les heures.

La nuit

Un EZ1 est alimenté par ses panneaux : sans soleil il s'éteint, Wi-Fi compris. C'est normal et pas une erreur : après trois lectures sans réponse, l'onduleur est affiché en veille (nuit), sa puissance passe à 0 W, ses compteurs d'énergie gardent leur valeur, et il n'est plus essayé que toutes les 5 minutes jusqu'à son réveil. Le statut de connexion reste vert.

Le statut ne passe au rouge que si un onduleur disparaît en pleine production (au moins 50 W à sa dernière réponse), ou reste muet une journée entière : vérifiez alors son Wi-Fi, son adresse, et que le mode local est toujours activé.

L'énergie du jour est le compteur de l'onduleur depuis son réveil ce matin ; elle garde la valeur du soir pendant la nuit et repart au lever du soleil. Un redémarrage de l'onduleur dans la journée (un nuage très sombre) est additionné, pas perdu.

Suivi de l'énergie

La fonctionnalité énergie totale est un index de production : Gladys le transforme en production par tranche de 30 minutes (la fonctionnalité « Lifetime energy (30-minute production) », que Gladys remplit elle-même) pour ses écrans d'énergie. L'index ne fait jamais de chute suivie d'une remontée : une lecture basse isolée (un raté au réveil) est ignorée, pour qu'elle ne soit jamais comptée deux fois comme production.

Limite de puissance et marche/arrêt

• Limite de puissance : plafonne la production, dans les bornes que l'onduleur annonce (30 à 800 W sur un EZ1-M). L'intégration ne l'écrit jamais d'elle-même, et ne réécrit pas une valeur que l'onduleur a déjà. APsystems ne dit pas si l'onduleur la garde en mémoire : une scène qui la change toutes les quelques secondes n'est pas une bonne idée, une fois toutes les quelques minutes suffit largement.
• Marche/arrêt : arrête ou relance la production ; l'API locale continue de répondre onduleur arrêté. Certains firmwares (ceux qui finissent par _b, pour les systèmes avec batterie) n'ont pas de marche/arrêt : la fonctionnalité n'est alors pas proposée.

Scènes

• Production solaire démarrée : un onduleur a produit 10 W ou plus pendant une minute. Variables : la puissance et l'énergie du jour jusque-là.
• Production solaire arrêtée : sous 5 W pendant 15 minutes, ou en veille. Variable : {{triggerEvent.data.energy_today}}, l'énergie du jour (le bon moment pour un message « production du jour »).
• Alarme d'onduleur solaire : une alarme s'est levée : hors réseau (vérifiez le raccordement AC), défaut de sortie (le raccordement AC aussi), court-circuit DC (vérifiez le connecteur du panneau de cette entrée, {{triggerEvent.data.input}}). La première lecture après le démarrage ou après la nuit ne déclenche rien : l'onduleur vérifie le réseau chaque matin.

Dans chaque déclencheur, choisissez un onduleur ou laissez vide pour n'importe lequel. Les variables contiennent toujours le nom de l'onduleur, {{triggerEvent.data.name}}, et son numéro de série, {{triggerEvent.data.serial}}.

• L'action régler la limite de puissance solaire prend un onduleur et une valeur en W, et donne limit, la limite appliquée.
• L'action lire la production solaire prend un onduleur, ou aucun pour tous, et donne power (W), energy_today et energy_total (kWh), producing, sleeping et inverters (le nombre d'onduleurs comptés), pour un message ou une condition. Elle utilise les dernières lectures ; seul un onduleur pas encore lu depuis le démarrage est lu d'abord.

Les actions suivantes de la scène trouvent ces sorties dans leur liste de variables (écrites {{<étape>.<action>.<clé>}}, par exemple {{0.0.power}} quand l'action de lecture est la première de la scène).

Dépannage

• Pas de réponse de jour : vérifiez l'adresse (une adresse fixe), que le mode local est activé et réglé sur « Continu », et que Gladys peut joindre le réseau de l'onduleur (l'intégration tourne dans un conteneur sur l'hôte Gladys).
• « …does not answer: it sleeps without sun » sur une commande : l'onduleur dort ; réessayez quand il produit.
• Pas de marche/arrêt : le firmware n'en a pas (voir plus haut).
• L'énergie totale a baissé : certains firmwares remettent ce compteur à zéro ; une lecture basse isolée est ignorée, une baisse durable est publiée.
• Logs : le niveau de log de l'intégration se règle avec la variable LOG_LEVEL.

Confidentialité

Tout reste sur votre réseau local : l'intégration ne parle qu'aux adresses que vous avez saisies, en HTTP sur le port 8050.

Paramètres de configuration

Voici les paramètres demandés par APsystems EZ1 dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Vos micro-onduleurs EZ1 dans Gladys	section	Non	Connecteur non officiel, sans lien avec APsystems. Il lit vos micro-onduleurs EZ1 (solaire de balcon) sur votre réseau local, via l'API locale que chaque onduleur ouvre une fois le « Mode local » activé dans l'application AP EasyPower (choisissez « Continu ») : ni cloud ni compte. Un appareil par onduleur : puissance produite (totale et par panneau), énergie du jour, énergie totale pour le suivi énergétique de Gladys, limite de puissance, marche/arrêt et alarmes. Des déclencheurs de scène au début et à la fin de la production et sur alarme, des actions de scène pour régler la limite et lire la production, un widget. La nuit, un EZ1 dort (pas de soleil, pas de Wi-Fi) : c'est normal, pas une erreur.
Adresses des onduleurs	string	Non	L'adresse IP de chaque EZ1, séparées par des virgules (port 8050 par défaut, ajoutez :port sinon). Donnez à chaque onduleur une adresse fixe dans votre box (réservation DHCP). Ouvrez ensuite Découverte.
Intervalle de rafraîchissement (s)	number	Non	Fréquence de lecture de la production. L'EZ1 répond lentement : 30 s est un bon rythme, 10 s le minimum. La nuit, un onduleur en veille n'est essayé que toutes les 5 minutes.

Comment installer APsystems EZ1 dans Gladys

1. Dans Gladys, ouvrez Intégrations : APsystems EZ1 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/lm1lc3n7/gladys-apsystems: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).
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/LM1LC3N7/gladys-apsystems.

APsystems EZ1 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

APsystems EZ1 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

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 🙂