Diseñado y fabricado en Francia 6K fans en Facebook · Síganos
HOME ASSISTANT8 min de lecturaPor el equipo de Pylon-MonitorActualizado el

Pylontech en Home Assistant: autodescubrimiento MQTT o REST

Dos caminos, los dos en el firmware, ninguno necesita un componente personalizado. Cómo funciona cada uno, qué obtiene y cuál elegir.

En resumen: hay dos maneras de llevar una batería Pylontech a Home Assistant con Pylon-Monitor, y las dos vienen ya en el dispositivo. Si usa el broker Mosquitto, elija el autodescubrimiento MQTT: cuatro campos que rellenar y once sensores aparecen solos, además de sensores para cada batería. Sin MQTT, elija la plataforma REST: el dispositivo genera el YAML por usted, listo para pegar. Sin componentes personalizados, sin HACS.

Dos caminos, los dos ya en el firmware

Si busca «Pylontech Home Assistant» encontrará componentes personalizados, repositorios HACS y YAML copiado de foros de hace años. Con Pylon-Monitor no hay que instalar nada en Home Assistant. Los dos métodos leen los mismos datos del puerto Console de la batería, así que la elección no depende de las funciones, sino de lo que ya tenga funcionando.

Opción 1: autodescubrimiento MQTT (la rápida)

Si Home Assistant ya tiene el complemento Mosquitto broker, como la mayoría de instalaciones, use esta. Introduzca la IP, el puerto, el usuario y la contraseña del broker en la página Settings del dispositivo y guarde. Unos cinco segundos después aparecen once sensores en Ajustes → Dispositivos y servicios → MQTT, agrupados en un único dispositivo llamado Pylon-Monitor. Sin YAML, sin reinicio, sin entidades que crear a mano.

Los once sensores son SOC, SOH, tensión, corriente, potencia, temperatura de la batería, temperatura de los MOSFET, ciclos de carga, estado de la batería, desequilibrio de celdas y número de baterías. Este último se añadió a petición de un cliente: la API JSON ya lo tenía, pero tenerlo en MQTT evita una llamada REST aparte. Con varias baterías, cada unidad tiene además sus propios sensores (SOC, SOH, ciclos, tensión, estado), con su modelo, versión de BMS y número de serie como atributos.

Hay también un topic de disponibilidad, respaldado por un mensaje MQTT de «última voluntad». Si el dispositivo pierde la alimentación o el WiFi, todos los sensores se ponen en gris en Home Assistant en lugar de quedarse congelados en su último valor. Importa más de lo que parece: un SOC congelado que parece normal es justo la razón por la que una alarma de batería baja no salta nunca.

Página Settings de Pylon-Monitor con los campos del broker MQTT de Home Assistant rellenados
IP del broker, puerto, usuario y contraseña: esa es toda la configuración MQTT en el dispositivo.
Panel de una batería Pylontech maestra: el cable RJ45 del puerto CONSOLE alimenta el Pylon-Monitor, mientras que el cable de encadenado sale del LINK PORT 1 hacia la batería esclava
En la batería maestra: CONSOLE al Pylon-Monitor, LINK PORT 1 a la batería esclava.
El error que comete casi todo el mundo: LINK PORT 1, no LINK PORT 0
El cable que encadena la batería maestra con la primera esclava debe salir del LINK PORT 1 de la maestra, nunca del LINK PORT 0. Se conecta al LINK PORT 0 de la esclava, y cada batería siguiente repite el mismo esquema 1 → 0. Al revés, la maestra nunca ve el resto de la pila y el Pylon-Monitor solo mostrará una batería, por muchas que tengas.
Consejo: cree un usuario MQTT propio para el dispositivo (en la configuración del complemento Mosquitto o en los ajustes de Personas de Home Assistant) en vez de reutilizar el suyo. Lleva un minuto y le permite retirarle el acceso por separado más adelante.

Opción 2: REST, si no usa MQTT

¿Sin broker? La plataforma rest integrada en Home Assistant puede leer el /api.json del dispositivo cada 30 segundos y crear seis sensores: SOC, SOH, tensión, corriente, potencia y estado. No tiene que escribir el YAML. La página Settings del dispositivo lo genera con su IP ya puesta y, con el firmware reciente, incluye también la clave de acceso que ahora pide la API. Copie, pegue en configuration.yaml y reinicie Home Assistant.

Bloque YAML REST para Home Assistant generado automáticamente por el dispositivo Pylon-Monitor
El bloque REST, generado por el dispositivo con la IP correcta. Nada que teclear de memoria.
Editor de configuration.yaml de Home Assistant con el bloque de sensores REST de Pylon-Monitor pegado
Pegado tal cual en configuration.yaml, sin cambios.
Tarjeta Indicador de Home Assistant con la entidad Pylontech SOC seleccionada, al 50 %
Uno de los nuevos sensores (Pylontech SOC) en una tarjeta Indicador, aquí al 50 %.
No use los dos para los mismos valores. Autodescubrimiento MQTT más el bloque REST da entidades duplicadas. Elija uno. MQTT ya cubre todo lo que hace REST, con cinco sensores más, los sensores por batería y la señal de disponibilidad, así que rara vez hay motivo para combinarlos.

Cuál elegir

¿Varios inversores y varias pilas de baterías separadas? Cada pila lleva su propio Pylon-Monitor, y cada uno aparece como un dispositivo distinto en Home Assistant. Un cliente con tres pilas de ocho US2000 nos lo preguntó; así funciona.

Qué hacer con los sensores

Unos sensores por sí solos son números en una tarjeta. Algunas automatizaciones que los hacen útiles:

Qué significan estos datos, y cuáles merecen una alarma de verdad, se explica en nuestra guía de SOC, SOH y diferencia entre celdas.

Solución rápida de problemas

¿No usa Home Assistant?

Todo esto se basa en el mismo punto de acceso /api.json y los mismos topics MQTT que las integraciones con Jeedom, Node-RED, Domoticz y openHAB. Esta guía cubre las demás plataformas.

Tuya / SmartLife

Tuya y SmartLife solo hablan con la nube de Tuya, y no hay una integración oficial de Pylontech para ellos. Aun así puede montar un puente no oficial con IFTTT, Make.com o Apilio, usando la URL pública que el dispositivo puede publicar (Settings > Public JSON access > «Enable a real public URL»). Los pasos están en nuestra guía de monitorización Pylontech y en nuestra respuesta a un cliente que lo preguntó.

Preguntas frecuentes

¿Necesito un broker MQTT para usar Pylontech en Home Assistant?
No. Si no usa un broker MQTT, la plataforma REST integrada de Home Assistant puede consultar directamente la API JSON del dispositivo y crear seis sensores — sin necesidad de broker.
¿Cuántos sensores da la monitorización Pylontech en Home Assistant?
El auto-descubrimiento MQTT crea 11 sensores más una señal de disponibilidad. La plataforma REST crea 6 sensores a partir de los mismos datos subyacentes. Si su pack tiene más de una batería Pylontech, MQTT también publica 5 sensores por batería (SOC, SOH, ciclos, voltaje, estado), y la API JSON siempre expone el detalle completo por batería sea cual sea la integración usada.
¿Puedo usar MQTT y REST al mismo tiempo?
Puede, pero no debería para los mismos valores — crea entidades duplicadas. Elija MQTT si tiene un broker (cubre todo lo que hace REST, y más); use REST solo si no lo tiene.

Pylon-Monitor trae los dos: el autodescubrimiento MQTT y el generador de YAML REST están en el dispositivo, listos en cuanto lo conecta.

Pedir ahora — 64 € Compra única, 64 € en total — sin IVA, sin suscripción.

Únase a los 6000 fans de Pylon-Monitor en Facebook

Novedades, actualizaciones de firmware, instalaciones reales y consejos: siga la página y haga sus preguntas a la comunidad.

Seguir en Facebook