Integración externa - Modbus TCP (PAC, inversores, contadores)

¡Hola a todos! :waving_hand:

Bomba de calor, inversor solar, contador eléctrico en el panel, estación de carga, automatismo… ¡Muchos dispositivos hablan Modbus, y hasta ahora Gladys no los veía. Es la integración «pivotal» de la lista de @pierre-gilles: una sola integración, docenas de dispositivos. Aquí está Modbus TCP, en local.

Qué hace

  • Perfiles listos para usar, sin configurar nada a mano:
    • contadores Eastron SDM630 / SDM120 (a través de una pasarela Modbus TCP);
    • inversores y contadores SunSpec: el modelo se detecta automáticamente, lo que cubre muchos inversores de una vez (SMA, Fronius, SolarEdge, Kostal…);
    • Huawei SUN2000, con su contador y su batería LUNA2000 si están presentes;
    • Victron GX.
  • Registros personalizados para todo lo demás, una línea por medida, por ejemplo: Salida calefacción: holding 100 int16 scale=0.1 temperatura. Todos los tipos de datos están incluidos (16, 32 o 64 bits, flotantes, bits, orden de las palabras…). En caso de error, la configuración indica qué línea es incorrecta y por qué.
  • Los índices de energía alimentan el seguimiento de energía de Gladys.
  • Dos acciones que ahorrarán horas: «Probar una lectura», que muestra el valor bruto y todas sus interpretaciones posibles, y «Verificar la configuración».
  • Disparadores «dispositivo inalcanzable / de vuelta», y un widget «Dispositivo Modbus».
  • Las pasarelas RS-485 → TCP («RTU over TCP») están gestionadas.
  • En francés, inglés, alemán y español.

La escritura está desactivada por defecto. Una vez autorizada en la configuración, solo los interruptores y las consignas de temperatura limitadas que declares tú mismo son controlables. Escribir en el registro equivocado puede desconfigurar una instalación: debe usarse con conocimiento de causa.

La parte divertida

Producción solar superior al consumo → se lanza el calentador de agua
La bomba de calor no responde → notificación
El contador del panel supera los 6 kW → se corta la estación de carga

Instalación

:warning: Gladys 5.1 mínimo.

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-modbus: Modbus TCP devices for Gladys Assistant: heat pumps, inverters, meters, chargers, with ready-made device profiles · GitHub

  1. En la configuración: la dirección del dispositivo o de la pasarela, el puerto (502), el identificador de esclavo, luego un perfil o tus registros.
  2. Probar una lectura para verificar, luego pestaña Descubrimiento para añadir el dispositivo.

Pequeñas reservas honestas

  • Desarrollado sin el hardware: todo se ha probado contra un servidor Modbus falso relleno según las tablas oficiales de los fabricantes, no en un dispositivo real. Tus comentarios son valiosos, especialmente si tienes una bomba de calor o un inversor a mano :folded_hands:
  • El Modbus «serie» directo (una clave USB RS-485 conectada a la máquina de Gladys) no está gestionado: se necesita una pasarela TCP.

Como los anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a las marcas de los perfiles.

Depósito: GitHub - guim31/gladys-modbus: Modbus TCP devices for Gladys Assistant: heat pumps, inverters, meters, chargers, with ready-made device profiles · GitHub