Conçu et fabriqué en France 6K fans sur Facebook · Suivez-nous
HOME ASSISTANT8 min de lecturePar l'équipe Pylon-MonitorMis à jour le

Pylontech dans Home Assistant : auto-découverte MQTT ou REST

Deux portes d'entrée, toutes deux dans le firmware, sans composant personnalisé. Comment chacune fonctionne, ce qu'elle vous donne, et laquelle choisir.

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.

Page Settings de Pylon-Monitor avec les champs du broker MQTT Home Assistant remplis
IP du broker, port, utilisateur, mot de passe : c'est toute la configuration MQTT côté boîtier.
Panneau d'une batterie Pylontech maître : le câble RJ45 du port CONSOLE alimente le Pylon-Monitor, tandis que le câble de chaînage part du LINK PORT 1 vers la batterie esclave
Sur la batterie maître : CONSOLE vers le Pylon-Monitor, LINK PORT 1 vers la batterie esclave.
L'erreur que presque tout le monde fait : LINK PORT 1, pas LINK PORT 0
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.
Conseil : créez un utilisateur MQTT dédié au boîtier (dans la configuration du module Mosquitto ou dans les réglages Personnes de Home Assistant) plutôt que de réutiliser votre propre identifiant. Ça prend une minute et vous permet de lui retirer l'accès séparément plus tard.

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.

Bloc YAML REST pour Home Assistant généré automatiquement par le boîtier Pylon-Monitor
Le bloc REST, généré par le boîtier avec la bonne adresse IP. Rien à taper de mémoire.
Éditeur configuration.yaml de Home Assistant avec le bloc de capteurs REST Pylon-Monitor collé
Collé tel quel dans configuration.yaml, sans aucune modification.
Carte Jauge de Home Assistant avec l'entité Pylontech SOC sélectionnée, affichant 50 %
L'un des nouveaux capteurs (Pylontech SOC) sur une carte Jauge, ici à 50 %.
N'utilisez pas les deux pour les mêmes valeurs. L'auto-découverte MQTT plus le bloc REST, c'est des entités en double. Choisissez-en une. MQTT couvre déjà tout ce que fait REST, avec cinq capteurs de plus, les capteurs par batterie et le signal de disponibilité : il y a rarement une raison de cumuler.

Laquelle choisir

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 :

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

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.

Rejoignez les 6 000 fans de Pylon-Monitor sur Facebook

Nouveautés, mises à jour du firmware, installations réelles et astuces : suivez la page et posez vos questions à la communauté.

Suivre sur Facebook