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

Pylontech con Jeedom, Node-RED, Domoticz y openHAB

¿No usa Home Assistant? El mismo punto de acceso JSON y los mismos topics MQTT funcionan en Jeedom, Node-RED, Domoticz, openHAB y cualquier cosa que haga una petición HTTP.

En resumen: sí, una batería Pylontech puede leerse desde Jeedom, Node-RED, Domoticz, openHAB o Grafana. Pylon-Monitor ofrece los datos de la batería en JSON sencillo, en una sola dirección de su red, /api.json, y además puede publicarlos por MQTT. Cualquier cosa capaz de hacer una petición HTTP o suscribirse a un topic MQTT puede usarlos, sin plugin nuestro y sin SDK del fabricante.

Un único punto de acceso JSON para todas las plataformas

Home Assistant se lleva casi toda la atención, y tiene su propia guía. Por debajo, el mecanismo es simple a propósito: una dirección HTTP, GET /api.json?key=…, con la clave de acceso que aparece en la página Settings del dispositivo, y JSON plano como respuesta. Jeedom, Node-RED, Domoticz, openHAB, Grafana, un script en Python o una tarea cron con curl leen exactamente los mismos datos.

Respuesta de la API JSON de un monitor Pylontech con datos estructurados de la batería
Esta única respuesta JSON alimenta todas las integraciones de abajo. Nada específico de una plataforma 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.

Jeedom

Jeedom no necesita un plugin de Pylontech. Instale el plugin JSON estándar desde el market de Jeedom, apunte un equipo a http://<ip-del-dispositivo>/api.json?key=<clave-de-acceso> y asocie rutas JSON a comandos: summary>soc, summary>voltage, summary>state, net>rssi, etc. Una consulta cada 30 a 60 segundos es más que suficiente. Una batería no cambia tan deprisa como para pedir más.

Node-RED

Dos formas, parecidas a la elección en Home Assistant. O consultar con un nodo http request (método GET, URL http://<ip-del-dispositivo>/api.json?key=<clave-de-acceso>, retorno «a parsed JSON object»), disparado por un nodo inject con temporizador, y leer después campos como msg.payload.summary.soc. O, si MQTT está configurado en el dispositivo, suscribirse a pylon-monitor/state con un nodo MQTT-in. Los datos llegan entonces en cuanto se publican, sin bucle de consulta que gestionar.

Domoticz

Domoticz no trae un tipo de sensor que consulte JSON, pero el apaño habitual está muy probado: un pequeño script (Python, o los eventos Lua o Blockly de Domoticz) descarga /api.json cada cierto tiempo y envía los valores a sensores virtuales (Dummy) mediante la API de Domoticz. Lleva unos minutos más que Jeedom o Node-RED, pero solo se hace una vez. Después, los sensores se comportan como cualquier otro dispositivo de Domoticz, con historiales y notificaciones.

openHAB

El HTTP Binding de openHAB lo resuelve de forma nativa. Defina un Thing que apunte a http://<ip-del-dispositivo>/api.json?key=<clave-de-acceso> con un intervalo de actualización y asocie cada canal a una ruta JSON con una transformación JSONPath para obtener summary.soc, summary.voltage, etc. en Items separados. Basta con el binding HTTP genérico, no hace falta uno específico.

Grafana, scripts y todo lo demás

Si una herramienta tiene una fuente de datos «JSON API» o «HTTP», puede leer este punto de acceso igual: el plugin JSON API de Grafana, la entrada HTTP de Telegraf, un script de Python con requests, una línea de shell con curl | jq. Al dispositivo le da igual lo que haya al otro lado de la petición. Eso también significa que no se vuelve inútil el día que cambie de plataforma domótica.

Tuya / SmartLife

Tuya y SmartLife solo hablan con la nube de Tuya, así que la dirección JSON local no les sirve directamente. El dispositivo puede publicar ese mismo JSON en un enlace HTTPS público (Settings > Public JSON access > «Enable a real public URL»), que IFTTT, Make.com o Apilio pueden leer y pasar a SmartLife. Es no oficial y lo monta usted. Los detalles están en nuestra guía de monitorización Pylontech y en nuestra respuesta a un cliente que lo preguntó.

¿Consulta periódica o MQTT?

La mayoría de las plataformas anteriores consultan la API JSON cada cierto tiempo. Es sencillo y funciona en todas partes. Si su plataforma también habla MQTT (Node-RED y Home Assistant lo hacen), suscribirse a pylon-monitor/state hace que los datos lleguen en cuanto se publican y no en la siguiente consulta. También tiene el topic de disponibilidad retenido, que le avisa en el acto si el propio dispositivo se ha desconectado, en vez de adivinarlo por un valor viejo. Dicho esto, una lectura cada 30 a 60 segundos es de sobra para una batería. Nada de esto necesita actualizarse al segundo.

Los mismos datos en todas partes. Home Assistant tiene su propio autodescubrimiento porque es lo que más nos piden, no porque las demás plataformas sean de segunda. Todas leen la misma estructura JSON y los mismos topics MQTT. Cuando los datos ya fluyan, aquí tiene lo que significa cada campo.

Preguntas frecuentes

¿La monitorización Pylontech funciona con Jeedom?
Sí. El plugin JSON estándar disponible en la tienda de Jeedom puede consultar directamente el endpoint /api.json del dispositivo y asociar campos a comandos — no se necesita ningún plugin Jeedom personalizado.
¿Puedo conectar una batería Pylontech a Node-RED?
Sí, de dos formas: consultar /api.json con un nodo http request, o suscribirse al topic de estado MQTT con un nodo MQTT-in si MQTT está configurado en el dispositivo.
¿Esto también funciona con Domoticz u openHAB?
Sí. Domoticz normalmente usa un pequeño script para enviar valores a sensores Dummy/Virtual mediante su propia API; el HTTP Binding integrado de openHAB puede consultar el endpoint JSON directamente, sin binding personalizado.

La API JSON y los topics MQTT de Pylon-Monitor son abiertos, están documentados y no dependen de ninguna plataforma: conéctelo a lo que ya usa.

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