Pylontech dans Home Assistant : le guide complet de l'intégration MQTT et REST

Deux portes d'entrée, toutes deux déjà intégrées au firmware

Demandez à dix personnes comment connecter une batterie Pylontech à Home Assistant et vous obtiendrez dix réponses à moitié différentes, impliquant des composants personnalisés, des dépôts HACS, ou du YAML copié-collé depuis un forum vieux de trois ans. Avec Pylon-Monitor, pas besoin de deviner : l'appareil embarque deux voies d'intégration directement dans son firmware, et aucune des deux ne nécessite d'installer quoi que ce soit côté Home Assistant.

Les deux lisent la même donnée sous-jacente — le port Console de la batterie — donc le choix n'est pas une question de capacité, mais de ce que vous avez déjà en place.

Option 1 — Auto-découverte MQTT, la voie rapide

Si Home Assistant fait déjà tourner l'add-on Mosquitto broker (c'est le cas de la plupart des installations), c'est l'option à utiliser. Renseignez l'IP du broker, le port, l'identifiant et le mot de passe sur la page Settings de l'appareil, enregistrez, et en environ cinq secondes dix capteurs apparaissent automatiquement dans Paramètres → Appareils et services → MQTT — regroupés sous une seule carte appareil nommée Pylon-Monitor. Aucun YAML, aucun redémarrage, aucune entité à définir manuellement.

Les dix capteurs : SOC, SOH, tension, courant, puissance, température batterie, température MOSFET, cycles de charge, état de la batterie, et déséquilibre des cellules. Plus un signal supplémentaire qui compte plus qu'on ne le pense : un topic de disponibilité adossé à un vrai Last-Will-and-Testament MQTT, qui fait que chaque capteur grise correctement dans Home Assistant dès que l'appareil perd l'alimentation ou le WiFi — au lieu de rester figé silencieusement sur sa dernière valeur connue, ce qui est exactement le mode de panne qui piège les gens (une alarme qui ne se déclenche jamais parce que le « dernier SOC connu » avait l'air normal).

Option 2 — REST, si vous n'utilisez pas MQTT

Pas de broker, pas de problème. La plateforme rest intégrée à Home Assistant peut interroger directement le point d'accès /api.json de l'appareil toutes les 30 secondes et créer six capteurs — SOC, SOH, tension, courant, puissance et état. Le bloc YAML n'est pas à écrire de zéro : la page Settings de l'appareil le génère elle-même pour vous, avec votre IP actuelle déjà renseignée. Copiez, collez dans configuration.yaml, redémarrez Home Assistant.

Laquelle choisir concrètement ?

• Vous faites déjà tourner un broker Mosquitto ? Utilisez l'auto-découverte MQTT. C'est plus rapide à configurer, ça donne plus de capteurs, et le signal de disponibilité à lui seul en vaut la peine.
• Pas de broker, et pas envie d'en installer un juste pour ça ? REST fonctionne très bien. Les dix secondes de latence d'interrogation en plus par rapport au push quasi instantané de MQTT n'ont pas d'importance pour de la télémétrie batterie — ça n'évolue pas vite.
• Vous faites tourner une grosse instance HA avec déjà des dizaines d'appareils MQTT ? Un appareil de plus sur le broker ne coûte rien. Partez sur MQTT.

Que faire concrètement de ces capteurs

Dix (ou six) nouveaux capteurs, seuls, ce ne sont que des chiffres sur une carte. Quelques idées d'automatisations pour en faire quelque chose d'utile :

• Notification SOC bas. Une automatisation simple déclenchée quand le capteur SOC passe sous un seuil — notification push via l'app Home Assistant, sans avoir besoin de l'alarme Pushover propre à l'appareil si vous préférez centraliser les alertes dans HA.
• Surveillance du déséquilibre des cellules. Le déséquilibre grimpe rarement d'un coup, mais une lente dérive à la hausse sur plusieurs semaines, c'est exactement ce qu'un graphique d'historique Home Assistant repère et qu'un simple coup d'œil sur l'écran TFT ne verra jamais.
• Une carte de tableau de bord à côté de vos données solaires/onduleur. Si vous suivez déjà production et consommation dans Home Assistant, placer les capteurs SOC et puissance Pylontech sur le même tableau de bord vous donne enfin la vue d'ensemble à un seul endroit, au lieu de jongler entre applications.

Pour aller plus loin sur ce que ces chiffres signifient vraiment et lesquels méritent une véritable alarme (par opposition à un simple bruit de fond), voir Diagnostic Pylontech 101.

Dépannage express

• La ligne MQTT reste rouge / ne se connecte pas : revérifiez l'IP et les identifiants du broker — un utilisateur MQTT dédié (voir l'astuce ci-dessus) résout le plus souvent le problème quand un identifiant HA réutilisé échoue de façon inattendue.
• Entités en double : vous avez configuré MQTT et REST en même temps pour les mêmes valeurs — supprimez l'un des deux.
• Un capteur affiche « indisponible » : si cela arrive précisément quand l'appareil perd le WiFi ou l'alimentation, c'est le signal de disponibilité qui fonctionne comme prévu, pas un bug.

Vous n'utilisez pas Home Assistant ?

Tout ce qui précède repose sur le même point d'accès /api.json et les mêmes topics MQTT qui alimentent aussi les intégrations Jeedom, Node-RED, Domoticz et openHAB — voir toutes les autres façons de connecter une batterie Pylontech à une plateforme domotique si Home Assistant n'est pas votre solution.