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 once 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 once sensores: SOC, SOH, voltaje, corriente, potencia, temperatura de batería, temperatura MOSFET, ciclos de carga, estado de la batería, desequilibrio de celdas y número de baterías. 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).
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, 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.
configuration.yaml — el bloque exacto de la página Settings, sin modificar nada.
¿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.
Tuya / SmartLife — un puente no oficial vía IFTTT, Make.com o Apilio
Los dispositivos Tuya y la app SmartLife solo se comunican con la nube propia de Tuya — no hay un endpoint JSON genérico de su lado como aquí, y no existe una integración oficial Pylontech-Tuya. Este dispositivo tampoco pretende serlo. Lo que sí ofrece es la pieza que falta para un puente sin código: active Settings > Public JSON access > "Enable a real public URL" y pylon-monitor.com vuelve a publicar el JSON de su dispositivo en un enlace HTTPS estable, accesible desde cualquier lugar — sin redirección de puertos, sin VPN, sin nada expuesto en su propio router.
Con esa URL en mano, una plataforma de automatización sin código (con nivel gratuito) puede consultarla y enviar los valores a un dispositivo virtual Tuya o a un webhook orientado a SmartLife:
- IFTTT — un applet Webhooks/JSON que consulta la URL según una programación, alimentando una acción de SmartLife.
- Make.com (antes Integromat) — un módulo HTTP que lee la URL, un analizador JSON, y luego un módulo Tuya/SmartLife o un webhook de vuelta a la plataforma IoT de Tuya.
- Apilio — construido específicamente en torno a automatizaciones Tuya/SmartLife, con su propio disparador de solicitud HTTP que puede consultar directamente una URL como esta.
Nada de esto está oficialmente soportado por Tuya ni por Pylon-Monitor — es un puente que usted mismo ensambla con herramientas gratuitas existentes, no una integración certificada. Pero si quiere el SOC o el estado de su batería en un panel de SmartLife, o en una rutina de Alexa/Google que solo entiende dispositivos Tuya, la URL pública de arriba es la pieza que le faltaba.
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 ambas integraciones ya incorporadas — el auto-descubrimiento MQTT y el generador de YAML REST ya están en el dispositivo, listos en cuanto lo conecte.
Pedir ahora — 59 € Compra única, 59 € en total — sin IVA, sin suscripción.