Pylontech en Home Assistant: la guía completa de integración MQTT y REST

Dos vías de entrada, ambas ya integradas en el firmware

Pregunte a diez personas cómo conectarían una batería Pylontech a Home Assistant y obtendrá diez medias respuestas distintas, con componentes personalizados, repositorios de HACS, o YAML copiado de un foro de hace tres años. Con Pylon-Monitor no hay que adivinar nada: el dispositivo trae dos vías de integración directamente en el firmware, y ninguna requiere instalar nada en el lado de Home Assistant.

Ambas leen el mismo dato subyacente —el puerto Console de la batería—, así que la elección no es una cuestión de capacidad, sino de lo que ya tiene funcionando.

Opción 1 — Auto-descubrimiento MQTT, la vía rápida

Si Home Assistant ya tiene el complemento Mosquitto broker en marcha (la mayoría de instalaciones lo tienen), esta es la opción a usar. Introduzca la IP del broker, el puerto, el usuario y la contraseña en la página Settings del dispositivo, guarde, y en unos cinco segundos aparecen automáticamente diez sensores en Ajustes → Dispositivos y servicios → MQTT — agrupados bajo una única tarjeta de dispositivo llamada Pylon-Monitor. Sin YAML, sin reiniciar, sin definir entidades manualmente.

Los diez sensores: SOC, SOH, voltaje, corriente, potencia, temperatura de batería, temperatura MOSFET, ciclos de carga, estado de la batería y desequilibrio de celdas. Más una señal extra que importa más de lo que parece: un topic de disponibilidad respaldado por un auténtico Last-Will-and-Testament MQTT, que hace que cada sensor se atenúe correctamente en Home Assistant en cuanto el dispositivo pierde alimentación o WiFi — en lugar de quedarse congelado silenciosamente en su último valor conocido, que es exactamente el modo de fallo que perjudica a la gente (una alarma que nunca salta porque el "último SOC conocido" parecía normal).

Opción 2 — REST, si no usa MQTT

Sin broker, sin problema. La plataforma rest integrada de Home Assistant puede consultar directamente el endpoint /api.json del dispositivo cada 30 segundos y crear seis sensores —SOC, SOH, voltaje, corriente, potencia y estado. El bloque YAML no hay que escribirlo desde cero: la propia página Settings del dispositivo lo genera por usted, con su IP actual ya rellenada. Copie, pegue en configuration.yaml, reinicie Home Assistant.

¿Cuál elegir en la práctica?

• ¿Ya tiene un broker Mosquitto en marcha? Use el auto-descubrimiento MQTT. Se configura más rápido, da más sensores, y solo la señal de disponibilidad ya merece la pena.
• ¿Sin broker, y sin ganas de instalar uno solo para esto? REST funciona perfectamente. Los diez segundos extra de latencia de sondeo frente al envío casi instantáneo de MQTT no importan para telemetría de batería — no cambia rápido.
• ¿Una instancia grande de HA con ya docenas de dispositivos MQTT? Un dispositivo más en el broker no cuesta nada. Vaya con MQTT.

Qué hacer realmente con los sensores

Diez (o seis) sensores nuevos, por sí solos, son solo números en una tarjeta. Algunas ideas de automatización para convertirlos en algo útil:

• Notificación de SOC bajo. Una automatización sencilla activada cuando el sensor SOC cae por debajo de un umbral —notificación push vía la app de Home Assistant, sin necesitar la alarma Pushover propia del dispositivo si prefiere centralizar las alertas en HA.
• Vigilancia del desequilibrio de celdas. El desequilibrio rara vez sube de golpe, pero una lenta tendencia al alza durante semanas es exactamente lo que un gráfico de historial de Home Assistant detecta y un vistazo puntual a la pantalla TFT nunca vería.
• Una tarjeta de panel junto a sus datos solares/de inversor. Si ya sigue la producción y el consumo en Home Assistant, colocar los sensores de SOC y potencia de Pylontech en el mismo panel le da por fin la imagen completa en un solo lugar, en lugar de cambiar entre apps.

Para profundizar en lo que estos números significan de verdad y cuáles merecen una alarma real (frente a los que son solo ruido de fondo), vea Diagnóstico Pylontech 101.

Solución rápida de problemas

• La línea MQTT sigue en rojo / no conecta: revise la IP y las credenciales del broker — un usuario MQTT dedicado (ver el consejo anterior) es la solución más común cuando un login de HA reutilizado falla inesperadamente.
• Entidades duplicadas: tiene MQTT y REST configurados a la vez para los mismos valores — elimine uno.
• Un sensor muestra "no disponible": si ocurre justo cuando el dispositivo pierde WiFi o alimentación, es la señal de disponibilidad funcionando como debe, no un error.

¿No usa Home Assistant?

Todo lo anterior se apoya en el mismo endpoint /api.json y los mismos topics MQTT que también alimentan las integraciones con Jeedom, Node-RED, Domoticz y openHAB — vea todas las demás formas de conectar una batería Pylontech a una plataforma domótica si Home Assistant no es su sistema.