Diseñado y fabricado en Francia
🚚 Todos los pedidos realizados antes del 27 de septiembre ya se han enviado. Ahora estamos preparando los siguientes pedidos (27, 28 de septiembre…). Haremos todo lo posible para entregar lo antes posible.
INTEGRACIONES7 min de lectura

Más allá de Home Assistant: Pylontech con Jeedom, Node-RED, Domoticz y openHAB

¿No usa Home Assistant? El mismo endpoint JSON y los mismos topics MQTT que alimentan su integración funcionan de forma idéntica en Jeedom, Node-RED, Domoticz, openHAB, y cualquier cosa capaz de hacer una petición HTTP.

Un único endpoint JSON, todas las plataformas

Home Assistant se lleva la mayor parte de la atención — comprensible, es la plataforma domótica más extendida, y le hemos dedicado una guía entera. Pero el mecanismo real por debajo es deliberadamente simple: un único endpoint HTTP, GET /api.json?key=… (la clave de acceso que aparece en los Settings del dispositivo), JSON plano de vuelta. Cualquier cosa capaz de hacer una petición HTTP y analizar JSON puede extraer de ahí los datos de la batería Pylontech. Eso incluye Jeedom, Node-RED, Domoticz, openHAB, Grafana, un script de Python, una tarea cron con curl — todos leyendo exactamente el mismo dato, ninguno necesita un SDK propietario ni una clave API.

Respuesta de la API JSON de un dispositivo de monitorización Pylontech mostrando datos estructurados de la batería
La misma respuesta JSON alimenta todas las integraciones siguientes — no se necesita ningún plugin específico de 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 Pylontech dedicado. Instale el plugin estándar JSON desde la tienda de Jeedom, apunte un equipo a http://<ip-dispositivo>/api.json?key=<access-key>, y asocie rutas JSON a comandos — summary>soc, summary>voltage, summary>state, net>rssi, etc. Un intervalo de sondeo de 30–60 segundos es más que suficiente; la telemetría de la batería no cambia lo bastante rápido como para necesitar algo más ajustado.

Node-RED

Dos opciones, que reflejan casi exactamente la elección en Home Assistant. Consultar con un nodo http request (método GET, URL http://<ip-dispositivo>/api.json?key=<access-key>, tipo de retorno "a parsed JSON object"), activado por un nodo inject con temporizador, y leer campos como msg.payload.summary.soc más adelante en el flujo. O, si MQTT ya está configurado en el dispositivo, suscribirse directamente a pylon-monitor/state con un nodo MQTT-in en su lugar — las actualizaciones llegan según ocurren, sin bucle de sondeo que gestionar.

Puertos del dispositivo Pylon-Monitor — conector RJ45 Console y alimentación USB-C
Un cable RJ45 al puerto Console de la batería, un cable USB-C para la alimentación — todo lo demás ocurre por red, hacia la plataforma que esté escuchando.

Domoticz

Domoticz no trae de fábrica un tipo de sensor nativo de sondeo JSON, pero la solución habitual está bien probada: un pequeño script (Python, o el propio scripting de eventos Lua/Blockly de Domoticz) obtiene /api.json con un temporizador y envía los valores a sensores Dummy/Virtual a través de la propia API JSON de Domoticz. Requiere unos minutos más de configuración que Jeedom o Node-RED, pero es una tarea de una sola vez, y los sensores se comportan después exactamente como cualquier otro dispositivo Domoticz — gráficos de historial completos, notificaciones, todo.

openHAB

El HTTP Binding de openHAB lo gestiona de forma nativa: defina un Thing que apunte a http://<ip-dispositivo>/api.json?key=<access-key> con un intervalo de actualización, y luego asocie canales individuales a rutas JSON mediante una transformación (JSONPath) para extraer summary.soc, summary.voltage, etc. en Items separados. No hace falta un binding personalizado — el binding HTTP genérico lo cubre.

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.

Página Settings de Pylon-Monitor — acceso JSON público con un token privado y la URL pública resultante
Settings > Public JSON access: una clave privada, una casilla, y pylon-monitor.com vuelve a publicar su JSON en un enlace que funciona desde cualquier lugar.

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:

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.

Grafana, scripts y cualquier otra cosa

Si una herramienta tiene una fuente de datos "JSON API" o "HTTP" —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— puede leer este endpoint de la misma manera. Esto no es deliberadamente un jardín vallado: al dispositivo no le importa qué hay al otro lado de la petición HTTP, lo que significa que no se vuelve obsoleto el día que cambie de plataforma domótica.

Sondeo vs. MQTT: qué usar y dónde

La mayoría de las plataformas anteriores sondean por defecto la API JSON con un temporizador, lo cual es simple y funciona en todas partes. Si su plataforma también habla MQTT (Node-RED y Home Assistant lo hacen de forma nativa), suscribirse a pylon-monitor/state en su lugar significa que las actualizaciones llegan en el momento en que se publican en lugar de esperar al siguiente sondeo — y además obtiene gratis el topic de disponibilidad retenido, para saber de inmediato si el propio dispositivo se ha desconectado en lugar de adivinarlo por un valor obsoleto. Aun así, sondear cada 30–60 segundos es más que suficiente para cualquier cosa relacionada con la batería — no son datos que se beneficien de una latencia de menos de un segundo.

Mismos datos, sin favoritismos. Home Assistant tiene una vía de auto-descubrimiento dedicada porque es la solicitud más frecuente, no porque las demás plataformas sean de segunda categoría. Todas las anteriores leen exactamente la misma estructura JSON y los mismos topics MQTT — vea lo que esos campos realmente significan una vez que los datos estén fluyendo.

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 son independientes de plataforma desde el primer día — conéctelos a lo que ya use.

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