Intégration externe - APsystems EZ1 (solaire de balcon)

Salut tout le monde !

Le solaire de balcon se répand, et l’APsystems EZ1 est l’un des micro-onduleurs les plus vendus. Le voici dans Gladys, en local, par l’API que l’onduleur ouvre lui-même : ni cloud ni compte.

Ce que ça fait

  • Un appareil par onduleur :
    • la puissance produite, totale et par panneau ;
    • l’énergie du jour ;
    • l’énergie totale ;
    • la limite de puissance, réglable par un curseur ;
    • la marche et l’arrêt ;
    • les alarmes (hors réseau, défaut de sortie, court-circuit d’un panneau).
  • Le suivi d’énergie de Gladys : l’énergie totale est un index de production, et Gladys en tire sa production par demi-heure pour ses écrans Énergie.
  • Trois déclencheurs de scène : production démarrée (le matin), production arrêtée (le soir, avec l’énergie du jour), alarme d’onduleur.
  • Deux actions de scène : régler la limite de puissance, lire la production d’un onduleur ou de tous.
  • Un widget « Production solaire » : la puissance actuelle, le jour, le total, chaque panneau et la limite. Choisissez un onduleur, ou laissez vide pour le total de tous.

Le truc sympa

  • Le soir : « 3,2 kWh produits aujourd’hui :sun: » sur le téléphone.
  • Gros soleil à midi → le chauffe-eau ou la prise de la piscine s’allume.
  • La nuit n’est pas une erreur. L’EZ1 s’éteint sans soleil : l’intégration le met « en veille », garde les compteurs, et le statut reste vert.

Installation

Gladys 5.1 minimum. Elle arrive dans le store au prochain passage de l’indexeur. Vous êtes pressé ? Intégrations → Installer depuis GitHub, avec l’adresse GitHub - LM1LC3N7/gladys-apsystems: Gladys Assistant external integration for APsystems EZ1 micro-inverters (balcony solar): live production, daily energy, power limit and on/off through the local API. Unofficial, not affiliated with APsystems. · GitHub

  1. Dans l’application AP EasyPower, activez le mode local de l’onduleur et choisissez Continu. Donnez-lui une adresse fixe dans votre box.
  2. Saisissez son adresse dans la configuration, puis cliquez sur Tester les onduleurs, de jour.
  3. Ajoutez l’onduleur dans Découverte et placez le widget sur un tableau de bord.

Petites réserves honnêtes

  • Testeurs recherchés ! Je n’ai pas d’EZ1. L’intégration suit le manuel officiel de l’API locale et les retours des utilisateurs d’autres domotiques. Elle gère aussi les firmwares qui n’ont pas la marche/arrêt, ou dont les réponses diffèrent.
  • La limite de puissance n’est jamais écrite par l’intégration d’elle-même. APsystems ne dit pas si l’onduleur la garde en mémoire après un redémarrage.
  • Les courbes de l’écran Énergie sont à confirmer sur une vraie installation.

Même vocabulaire que l’intégration Hoymiles, publiée en même temps : mêmes déclencheurs, même widget. Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à APsystems.

Dépôt : GitHub - LM1LC3N7/gladys-apsystems: Gladys Assistant external integration for APsystems EZ1 micro-inverters (balcony solar): live production, daily energy, power limit and on/off through the local API. Unofficial, not affiliated with APsystems. · GitHub

Bonjour @lmilcent
Chez moi, mes deux panneaux solaires sont pilotés par un onduleur AP System ECU-B, qui n’est pas joignable directement, mais relié à une petite box DS3-L dont je peux voir les données dans l’appli EMA sur mon smartphone.
Est-ce que ton intégration pourrait être complétée pour interroger la box DS3-L ?

D’après mes recherches, elle serait interrogeable sur le port 8899 et il y a un plug-in HA qui le fait : GitHub - HAEdwin/homeassistant-apsystems_ecu_reader: APsystems ECU Local Query Integration for Home Assistant · GitHub

Merci @StephaneB pour la piste, c’est fait : la v0.1.2 de l’intégration lit maintenant les passerelles ECU d’APsystems (ECU-B, ECU-R, ECU-C) en local, par le port 8899, sur le modèle de l’intégration Home Assistant de HAEdwin que tu citais.

Ce que ça donne chez toi

  • Un appareil pour ton ECU-B : puissance actuelle, énergie du jour, énergie totale (dans les écrans Énergie de Gladys) et nombre d’onduleurs en ligne.
  • Un appareil pour ton DS3-L : en ligne, puissance de chaque panneau, tension, fréquence et température, si l’ECU les donne.
  • La nuit, tout passe « en veille », sans erreur.
  • Le widget et les déclencheurs « production démarrée / arrêtée » comptent aussi l’ECU.

Mise en place

  1. Mets à jour l’intégration depuis Gladys (ou « Installer depuis GitHub » si le store n’est pas encore passé).
  2. Donne une adresse fixe à l’ECU-B dans ta box (il est en Wi-Fi).
  3. Dans la configuration, remplis le nouveau champ « Adresses des passerelles ECU » avec son adresse, puis clique sur Tester les onduleurs.
  4. Ajoute l’ECU et le DS3-L dans Découverte.

Bon à savoir

  • L’ECU est fragile s’il est interrogé trop souvent : l’intégration le lit au plus toutes les 5 minutes, une seule connexion à la fois.
  • C’est en lecture seule : pas de marche/arrêt ni de limite de puissance par l’ECU.
  • Si l’énergie totale fait un saut anormal (remise à zéro, valeur aberrante), elle est retenue au lieu d’être comptée, et le bouton « Accepter l’énergie totale » permet de la valider.

Je n’ai pas d’ECU sous la main : tu serais le premier à l’essayer sur un vrai. Si quelque chose cloche (onduleur absent, valeurs bizarres), ouvre une issue sur GitHub ou réponds ici, avec le statut affiché dans la configuration : GitHub - LM1LC3N7/gladys-apsystems: Gladys Assistant external integration for APsystems EZ1 micro-inverters (balcony solar): live production, daily energy, power limit and on/off through the local API. Unofficial, not affiliated with APsystems. · GitHub