AECC Battery (Local TCP) : ma Sunpura S2400 enfin dans Home Assistant en local

Dans mon test de la Sunpura S2400 publié fin mai, j’avais noté une limite claire : pas d’intégration Home Assistant officielle, et un écosystème communautaire encore en chantier. Près de six mois plus tard, un projet a mûri. Il s’appelle AECC Battery (Local TCP), il tourne maintenant chez moi, et il répond à ce reproche.

Il ne vient pas de Sunpura. C’est un projet open source maintenu par StekkerDeal, aux Pays-Bas, qui vise toutes les batteries construites sur la plateforme logicielle AECC. La Sunpura S2400 en fait partie, et elle est listée comme « Fully tested » dans la documentation du projet.

Pour la petite histoire

Je rappelle le contexte. J’ai une Sunpura S2400 dans mon garage depuis le 17 avril. Elle lit ma consommation via mon HomeWizard P1 déjà en place, elle arbitre charge et décharge pour limiter l’injection vers le réseau, et elle fait bien son travail dans son coin. Le détail du setup est dans mon test de la batterie Sunpura S2400.

Il manquait en revanche la batterie dans Home Assistant : pas de niveau de charge, pas de puissance en direct, pas de commande depuis mes automatisations. L’application Sunpura faisait le travail, mais elle vivait à part, alors que tout le reste de la maison passe par HA.

Une intégration locale, sans le cloud Sunpura

AECC Battery (Local TCP) est une intégration Home Assistant qui parle directement à la batterie en TCP, sur le port 8080. Pas de passage par le cloud Sunpura, rien qui sort du réseau local. L’intégration garde une connexion ouverte et interroge la batterie toutes les cinq secondes.

Le projet couvre l’ensemble de la plateforme AECC. Les modèles testés par le mainteneur sont la Sunpura S2400, la Lunergy Hub 2400 AC, la JET GreenARK Pro et la TSUN MAU5000. La communauté la fait aussi tourner sur AEG Solarcube, Voltdeer SR5000, AFERIY PS240, AccuMate, Oscal, Fossibot et Humsienk. Ce sont pour la plupart des produits en marque blanche qui partagent le même firmware.

Le projet est actif. Licence MIT, une vingtaine d’étoiles sur GitHub, une version stable 1.8.0 sortie le 11 octobre et une préversion 1.9.0-beta.1 publiée le 6 novembre. Les versions s’enchaînent toutes les deux à trois semaines, ce qui est un rythme correct pour un projet communautaire porté par une seule personne.

Installer AECC Battery (Local TCP) via HACS

Il faut Home Assistant 2026.8.0 au minimum. Tout passe ensuite par HACS, le gestionnaire d’intégrations communautaires de Home Assistant.

On ajoute le dépôt github.com/StekkerDeal/aecc-battery-local comme dépôt personnalisé dans HACS, catégorie Integration. Après un redémarrage de Home Assistant, l’intégration apparaît dans Paramètres, Appareils et services, Ajouter une intégration, sous le nom « AECC Battery (Local TCP) ».

Elle demande l’adresse IP locale de la batterie, le port (8080 par défaut), un nom, puis la marque et le modèle. Je vous conseille de réserver l’IP de la batterie dans votre routeur pour qu’elle ne change pas.

Chez moi, la batterie est apparue tout de suite : un appareil et 34 entités. On y trouve 27 capteurs, un capteur binaire de défaut et 6 contrôles. Les capteurs couvrent le niveau de charge, les puissances côté batterie, solaire, réseau et secours, l’énergie chargée et déchargée, et, via Modbus depuis la version 1.7.0, trois températures internes et des compteurs à vie. Les contrôles permettent de régler la consigne de puissance, le mode de fonctionnement et les limites de charge et de décharge. Deux anciennes entités restent là pour la compatibilité.

Ma batterie tourne en mode « Self-Consumption (AI) », avec une charge limitée à 98 % et une décharge arrêtée à 10 %. Ses compteurs indiquent 545 kWh chargés et 498 kWh restitués depuis sa mise en service.

Tableau de bord Énergie et automatisations

Dans le tableau de bord Énergie de Home Assistant, ma batterie était jusqu’ici suivie par la prise HomeWizard sur laquelle elle est branchée. Je l’ai remplacée par les compteurs d’énergie chargée et déchargée de l’intégration, qui tiennent compte du solaire branché directement sur la batterie depuis la version 1.8.0. J’ai aussi repris la puissance instantanée de la batterie. L’intégration la donne positive en charge, à l’inverse de la convention de Home Assistant, mais l’option d’inversion du tableau Énergie règle ce détail. L’historique de la batterie dans ce tableau repart simplement de l’installation de l’intégration.

La consigne de puissance et le mode de fonctionnement sont aussi accessibles en écriture. Une automatisation peut donc forcer une décharge quand l’électricité est chère, ou une charge depuis le réseau quand elle ne coûte presque rien, à condition d’avoir un contrat à tarif dynamique. Jusqu’ici, ce genre de réglage passait par l’application Sunpura.

Tout cela passe par le réseau local. Home Assistant n’a pas besoin du cloud Sunpura pour lire ou commander la batterie, et l’application Sunpura n’est plus indispensable au quotidien.

800 W par défaut, un seul client et pas de support officiel

L’intégration limite par défaut la charge et la décharge à 800 W. C’est un garde-fou du plugin, pas une limite du matériel : la documentation indique qu’on peut monter à 2400 W par direction, 2500 W sur certains modèles. Le plafond « On Grid Output » de la batterie se règle en revanche dans l’application Sunpura, pas en TCP. Avant de monter, vérifiez que votre installation électrique et votre cadre d’injection le permettent.

La batterie n’accepte qu’un seul client local à la fois. Home Assistant, Homey ou une autre instance qui parle ce protocole se gênent. Sur certains modèles, un nouveau client ne peut se connecter que pendant une trentaine de secondes après le redémarrage du module de communication. Quelques utilisateurs signalent aussi sur GitHub des pertes de connexion ponctuelles, réglées par un rechargement de l’intégration.

Ce n’est pas non plus une intégration officielle Sunpura. Rien ne garantit qu’une mise à jour du firmware ne cassera rien, et le projet repose sur un seul mainteneur. Le code a déjà changé de mains : Mathieuleysen a ouvert la voie avec Sunpura-Local-TCP, slaapyhoofd a poursuivi avec Lunergy-Local-TCP, puis StekkerDeal a repris et élargi le travail. Si le projet principal s’arrête, quelqu’un d’autre pourra le reprendre.

Mon retour

Dans mon test de la Sunpura S2400, j’écrivais que si Home Assistant était votre priorité absolue, la Sunpura n’était pas le meilleur choix. Cette conclusion ne tient plus de la même façon. AECC Battery (Local TCP) apporte une intégration locale, riche en entités, pilotable et maintenue activement.

Je continue à recommander la Sunpura S2400 aux trois profils cités dans le premier article. J’en ajoute un quatrième : si vous êtes sur Home Assistant et que vous acceptez une intégration communautaire installée via HACS, la combinaison Sunpura, HomeWizard P1 et AECC Battery (Local TCP) donne un setup énergie cohérent et entièrement local.

Je suivrai la version 1.9.0. Si elle change quelque chose d’important, je mettrai cet article à jour.

Questions fréquentes sur AECC Battery (Local TCP)