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

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, sin autenticación, 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.

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, 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, 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.

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 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.

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.