En bref : il y a deux façons d'intégrer une batterie Pylontech dans Home Assistant avec Pylon-Monitor, et les deux sont déjà dans le boîtier. Si vous avez le broker Mosquitto, prenez l'auto-découverte MQTT : quatre champs à remplir, et onze capteurs apparaissent tout seuls, plus des capteurs pour chaque batterie. Sans MQTT, prenez la plateforme REST : le boîtier génère le YAML pour vous, prêt à coller. Aucun composant personnalisé, pas de HACS.
Deux portes d'entrée, déjà dans le firmware
Cherchez « Pylontech Home Assistant » et vous tomberez sur des composants personnalisés, des dépôts HACS et du YAML recopié de forums vieux de plusieurs années. Avec Pylon-Monitor, il n'y a rien à installer côté Home Assistant. Les deux méthodes lisent les mêmes données sur le port Console de la batterie : le choix ne porte donc pas sur les fonctions, mais sur ce que vous avez déjà en place.
Option 1 : l'auto-découverte MQTT (la plus rapide)
Si Home Assistant fait déjà tourner le module complémentaire Mosquitto broker, comme la plupart des installations, c'est celle-ci qu'il faut prendre. Saisissez l'adresse IP du broker, le port, l'utilisateur et le mot de passe dans la page Settings du boîtier, enregistrez. Environ cinq secondes plus tard, onze capteurs apparaissent dans Paramètres → Appareils et services → MQTT, regroupés sous un seul appareil nommé Pylon-Monitor. Pas de YAML, pas de redémarrage, pas d'entités à créer à la main.
Ces onze capteurs sont le SOC, le SOH, la tension, le courant, la puissance, la température de la batterie, celle des MOSFET, les cycles de charge, l'état de la batterie, le déséquilibre des cellules et le nombre de batteries. Ce dernier a été ajouté à la demande d'un client : l'API JSON le donnait déjà, mais l'avoir en MQTT évite un appel REST séparé. Avec plusieurs batteries, chaque unité a en plus ses propres capteurs (SOC, SOH, cycles, tension, état), avec son modèle, sa version de BMS et son numéro de série en attributs.
S'y ajoute un topic de disponibilité, appuyé sur un message MQTT de « dernière volonté ». Si le boîtier perd l'alimentation ou le WiFi, tous les capteurs passent en gris dans Home Assistant au lieu de rester figés sur leur dernière valeur. C'est plus important qu'il n'y paraît : un SOC figé qui a l'air normal, c'est exactement comme ça qu'une alarme de batterie faible ne se déclenche jamais.

Le câble qui relie votre batterie maître à la première esclave doit partir du LINK PORT 1 de la maître — jamais du LINK PORT 0. Il se branche sur le LINK PORT 0 de l'esclave, et chaque batterie suivante répète le même schéma 1 → 0. Câblé à l'envers, la maître ne voit jamais le reste de la pile : le Pylon-Monitor n'affiche alors qu'une seule batterie, quel que soit leur nombre.
Option 2 : REST, si vous n'utilisez pas MQTT
Pas de broker ? La plateforme rest intégrée à Home Assistant peut lire le /api.json du boîtier toutes les 30 secondes et créer six capteurs : SOC, SOH, tension, courant, puissance et état. Vous n'avez pas à écrire le YAML. La page Settings du boîtier le génère avec votre adresse IP déjà remplie, et sur les firmwares récents il contient aussi la clé d'accès que l'API demande désormais. Copiez, collez dans configuration.yaml, redémarrez Home Assistant.
configuration.yaml, sans aucune modification.
Laquelle choisir
- Vous avez déjà un broker Mosquitto : l'auto-découverte MQTT. Plus rapide à mettre en place, 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 convient très bien. Une lecture toutes les 30 secondes au lieu d'un envoi instantané ne change rien pour une batterie, ses valeurs ne bougent pas si vite.
- Une grosse installation Home Assistant avec des dizaines d'appareils MQTT : un appareil de plus sur le broker ne coûte rien. Partez sur MQTT.
Plusieurs onduleurs, plusieurs piles de batteries séparées ? Chaque pile a son propre Pylon-Monitor, et chacun apparaît comme un appareil distinct dans Home Assistant. Un client avec trois piles de huit US2000 nous a posé la question ; voici comment ça se passe.
Que faire de ces capteurs
Des capteurs seuls, ce ne sont que des chiffres sur une carte. Quelques automatisations qui les rendent utiles :
- Notification de batterie faible. Une automatisation qui se déclenche quand le SOC passe sous un seuil et envoie une notification par l'appli Home Assistant. Pratique si vous préférez regrouper toutes vos alertes dans Home Assistant plutôt que d'utiliser l'alarme Pushover du boîtier.
- Suivre le déséquilibre des cellules. Il bondit rarement du jour au lendemain, mais une lente montée sur plusieurs semaines, c'est exactement ce que montre un graphique d'historique Home Assistant et que rate un coup d'œil à l'écran.
- Une carte à côté de vos données solaires. Si vous suivez déjà production et consommation dans Home Assistant, mettre le SOC et la puissance Pylontech sur le même tableau de bord vous donne la vue complète au même endroit.
Ce que veulent dire ces chiffres, et lesquels méritent une vraie alarme, est expliqué dans notre guide SOC, SOH et écart entre cellules.
Dépannage rapide
- La ligne MQTT reste rouge : vérifiez l'adresse IP du broker et les identifiants. Un utilisateur MQTT dédié (voir le conseil plus haut) règle le plus souvent le cas d'un identifiant Home Assistant réutilisé et refusé.
- Entités en double : MQTT et REST sont configurés pour les mêmes valeurs. Supprimez l'un des deux.
- Un capteur affiche « indisponible » : si c'est pile au moment où le boîtier perd le WiFi ou l'alimentation, c'est le signal de disponibilité qui fait son travail, pas un bug.
- Les capteurs REST se sont arrêtés après une mise à jour : les firmwares récents exigent la clé d'accès sur l'API. Recopiez le YAML depuis la page Settings, il contient maintenant la clé.
Vous n'utilisez pas Home Assistant ?
Tout ceci repose sur le même point d'accès /api.json et les mêmes topics MQTT que les intégrations Jeedom, Node-RED, Domoticz et openHAB. Ce guide couvre les autres plateformes.
Tuya / SmartLife
Tuya et SmartLife ne parlent qu'au cloud de Tuya, et il n'existe pas d'intégration Pylontech officielle pour eux. Vous pouvez quand même monter un pont non officiel avec IFTTT, Make.com ou Apilio, à partir de l'URL publique que le boîtier peut publier (Settings > Public JSON access > « Enable a real public URL »). La marche à suivre est dans notre guide de la surveillance Pylontech, et dans notre réponse à un client qui nous l'a demandé.
Questions fréquentes
- Ai-je besoin d'un broker MQTT pour utiliser Pylontech dans Home Assistant ?
- Non. Si vous n'utilisez pas de broker MQTT, la plateforme REST intégrée à Home Assistant peut interroger directement l'API JSON de l'appareil et créer six capteurs — aucun broker requis.
- Combien de capteurs le monitoring Pylontech donne-t-il dans Home Assistant ?
- L'auto-découverte MQTT crée 11 capteurs plus un signal de disponibilité. La plateforme REST crée 6 capteurs à partir des mêmes données sous-jacentes. Si votre pack compte plus d'une batterie Pylontech, MQTT publie aussi 5 capteurs par batterie (SOC, SOH, cycles, tension, état), et l'API JSON expose toujours le détail complet par batterie quelle que soit l'intégration utilisée.
- Puis-je utiliser MQTT et REST en même temps ?
- Vous pouvez, mais vous ne devriez pas pour les mêmes valeurs — cela crée des entités en double. Choisissez MQTT si vous avez un broker (il couvre tout ce que fait REST, et plus) ; utilisez REST uniquement si ce n'est pas le cas.
Pylon-Monitor intègre les deux : l'auto-découverte MQTT et le générateur de YAML REST sont dans le boîtier, prêts dès le branchement.
Commander — 64 € Achat unique, 64 € au total — TVA non applicable, sans abonnement.