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.

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.
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.
configuration.yaml, sin cambios.
Cuál elegir
- Ya tiene un broker Mosquitto: autodescubrimiento MQTT. Más rápido de configurar, más sensores, y solo la señal de disponibilidad ya compensa.
- Sin broker y sin ganas de instalar uno solo para esto: REST va perfectamente. Una lectura cada 30 segundos en lugar de un envío instantáneo no cambia nada en una batería, sus valores no se mueven tan rápido.
- Una instalación grande de Home Assistant con decenas de dispositivos MQTT: uno más en el broker no cuesta nada. Elija MQTT.
¿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:
- Aviso de batería baja. Una automatización que salta cuando el SOC baja de un umbral y manda una notificación por la app de Home Assistant. Útil si prefiere tener todas sus alertas en Home Assistant en lugar de usar la alarma Pushover del dispositivo.
- Vigilar el desequilibrio de celdas. Rara vez se dispara de un día para otro, pero una subida lenta durante semanas es justo lo que muestra un gráfico de historial de Home Assistant y no un vistazo a la pantalla.
- Una tarjeta junto a sus datos solares. Si ya sigue producción y consumo en Home Assistant, poner el SOC y la potencia de la Pylontech en el mismo panel le da la imagen completa en un solo sitio.
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
- La línea MQTT sigue en rojo: revise la IP del broker y las credenciales. Un usuario MQTT propio (vea el consejo anterior) suele resolver el caso de un usuario de Home Assistant reutilizado y rechazado.
- Entidades duplicadas: MQTT y REST están configurados para los mismos valores. Quite uno.
- Un sensor aparece como «no disponible»: si ocurre justo cuando el dispositivo pierde el WiFi o la alimentación, es la señal de disponibilidad haciendo su trabajo, no un fallo.
- Los sensores REST dejaron de funcionar tras una actualización: el firmware reciente exige la clave de acceso en la API. Vuelva a copiar el YAML desde la página Settings, ahora incluye la clave.
¿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.