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

**URL:** <https://community.gladysassistant.com/t/integration-externe-apsystems-ez1-solaire-de-balcon/11201>\
**Category:** Développement\
**Tags:** integration-externe\
**Created:** [Octobre 14, 2026, 4:18 UTC](https://community.gladysassistant.com/t/integration-externe-apsystems-ez1-solaire-de-balcon/11201 "2026-10-14T16:18:04Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![lmilcent](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/lmilcent/32/7023_2.png) [@lmilcent](https://community.gladysassistant.com/u/lmilcent)\
**Post date:** [Octobre 14, 2026, 4:18 UTC](https://community.gladysassistant.com/t/integration-externe-apsystems-ez1-solaire-de-balcon/11201/1 "2026-10-14T16:18:04Z")

</div>

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 ☀ » 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](https://github.com/LM1LC3N7/gladys-apsystems)

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](https://github.com/LM1LC3N7/gladys-apsystems)

---

<div class="post-metadata">

**Author:** ![StephaneB](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/stephaneb/32/15443_2.png) [@StephaneB](https://community.gladysassistant.com/u/StephaneB)\
**Post date:** [Octobre 18, 2026, 6:12 UTC](https://community.gladysassistant.com/t/integration-externe-apsystems-ez1-solaire-de-balcon/11201/2 "2026-10-18T06:12:13Z")

</div>

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](https://github.com/haedwin/homeassistant-apsystems_ecu_reader)

---

<div class="post-metadata">

**Author:** ![lmilcent](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/lmilcent/32/7023_2.png) [@lmilcent](https://community.gladysassistant.com/u/lmilcent)\
**Post date:** [Octobre 18, 2026, 5:30 UTC](https://community.gladysassistant.com/t/integration-externe-apsystems-ez1-solaire-de-balcon/11201/3 "2026-10-18T17:30:47Z")

</div>

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](https://github.com/LM1LC3N7/gladys-apsystems)
