Cómo Integrar un Inversor Solar Victron en Home Assistant con Modbus TCP: Guía Paso a Paso

En el mundo de la energía solar residencial y comercial, la monitorización precisa y en tiempo real es fundamental para maximizar el rendimiento, detectar fallos y optimizar el consumo. Los inversores Victron Energy son reconocidos por su robustez y fiabilidad, pero su integración con sistemas de domótica como Home Assistant puede parecer compleja. Sin embargo, gracias al protocolo Modbus TCP, es posible lograr una integración perfecta que desbloquea un sinfín de posibilidades: desde visualizar la producción solar en un panel personalizado hasta crear automatizaciones que gestionen cargas en función de la energía disponible. En esta guía paso a paso, te mostraremos cómo integrar tu inversor Victron en Home Assistant utilizando Modbus TCP, sin necesidad de hardware adicional costoso. Aprenderás los conceptos fundamentales, la configuración detallada y los trucos para evitar errores comunes. Al finalizar, tendrás un sistema de monitorización solar profesional, todo dentro de tu plataforma de domótica favorita.

Introducción a la Integración Victron Home Assistant Modbus TCP

La integración de un inversor Victron en Home Assistant mediante Modbus TCP se ha convertido en una de las prácticas más demandadas por los entusiastas de la energía solar y la domótica. Victron Energy, conocida por sus inversores/cargadores multiplus, reguladores de carga MPPT y sistemas de monitorización como el Cerbo GX, ofrece soporte nativo para Modbus TCP en la mayoría de sus dispositivos recientes. Esto significa que podemos acceder a una amplia gama de datos operativos: voltaje de batería, corriente de carga, potencia de salida, estado del inversor, estadísticas de producción y mucho más. Home Assistant, por su parte, es una plataforma de código abierto que permite centralizar el control de todos los dispositivos del hogar. Al combinar ambos, obtenemos un panel unificado donde podemos ver no solo el rendimiento solar, sino también correlacionarlo con el consumo de la casa, el precio de la luz y las condiciones meteorológicas. Esta guía está diseñada para llevarte desde cero hasta una integración funcional, explicando cada paso con detalle y proporcionando ejemplos prácticos. Ya sea que tengas un sistema Off-Grid, conectado a red o híbrido, los principios son los mismos. Prepárate para descubrir todo el potencial de tu inversor Victron.

¿Por qué usar Modbus TCP en lugar de otras integraciones?

Existen varias formas de conectar un Victron a Home Assistant: a través de la integración oficial de Victron (que utiliza MQTT), mediante el componente personalizado 'victron' de HACS, o directamente con Modbus TCP. Cada método tiene sus ventajas y desventajas. La integración vía MQTT es sencilla si ya tienes un Cerbo GX con Venus OS, pero puede ser limitada en cuanto a la frecuencia de actualización o la cantidad de registros expuestos. El componente de HACS ofrece una interfaz más amigable, pero depende de un complemento externo y puede no estar actualizado. Modbus TCP, en cambio, es un protocolo industrial estándar que te da acceso directo a los registros del dispositivo, permitiéndote leer y escribir valores con total control. Esto es ideal para usuarios avanzados que desean crear automatizaciones precisas o monitorizar parámetros específicos que no están disponibles en otras integraciones. Además, Modbus TCP es compatible con una amplia variedad de dispositivos Victron, desde el MultiPlus hasta el SmartShunt, y no requiere software adicional en el lado del inversor, solo la dirección IP y el puerto correcto. Si buscas flexibilidad y profundidad en los datos, Modbus TCP es el camino a seguir.

Análisis Técnico: Cómo Funciona Modbus TCP en Victron

Modbus es un protocolo de comunicación industrial que permite la lectura y escritura de registros en dispositivos electrónicos. En el caso de Victron, el dispositivo actúa como servidor Modbus TCP, escuchando en el puerto 502 (por defecto). Home Assistant, a través de la integración Modbus, actúa como cliente y consulta periódicamente los registros que le indiquemos. Cada dato (voltaje, corriente, potencia, etc.) está mapeado a una dirección de registro específica, y su formato puede ser entero, flotante o de 32 bits. Victron publica una lista completa de registros en su documentación técnica, conocida como 'CCGX Modbus TCP register list'. Es crucial entender que no todos los registros están disponibles en todos los dispositivos; por ejemplo, un inversor MultiPlus tendrá registros diferentes a un regulador MPPT. Por ello, es importante identificar el modelo exacto y consultar la lista correspondiente. Además, algunos registros son de solo lectura, mientras que otros permiten escritura para configurar parámetros. En esta sección, desglosaremos los conceptos clave para que puedas comprender y aplicar la integración correctamente.

Tipos de registros y direcciones

Los registros Modbus se organizan en bloques y se direccionan mediante un número. Victron utiliza direcciones de 16 bits, pero a menudo se expresan en formato decimal. Por ejemplo, el registro 840 es el voltaje de la batería en un MultiPlus. Sin embargo, la dirección real que se envía en la trama Modbus puede ser 840 o 841 dependiendo del tipo (holding register vs input register). En Home Assistant, la integración Modbus permite especificar el tipo (holding, input, coil, discrete) y la dirección. Además, hay que tener en cuenta el 'unit ID' o 'slave ID', que para Victron suele ser 100 para el sistema principal, aunque puede variar. Para facilitar la tarea, la comunidad ha creado archivos YAML predefinidos que puedes copiar y adaptar. En los siguientes apartados, veremos ejemplos concretos de configuración.

Requisitos previos y preparación del entorno

Antes de sumergirnos en la configuración, es esencial asegurar que contamos con los elementos necesarios. Primero, un dispositivo Victron compatible con Modbus TCP: esto incluye los inversores/cargadores MultiPlus, Quattro, los reguladores MPPT SmartSolar, el monitor de baterías SmartShunt, y los controladores GX (Cerbo GX, Venus GX, etc.). Segundo, una red local estable, preferiblemente con IP fija para el dispositivo Victron. Tercero, Home Assistant instalado y funcionando, con acceso a la configuración (archivo configuration.yaml o integración vía UI). Cuarto, conocer la dirección IP del dispositivo Victron y verificar que el puerto 502 está abierto. Puedes probar la conexión con una herramienta como 'Modbus Poll' o 'QModMaster' desde un ordenador. Quinto, tener a mano la lista de registros Modbus de tu modelo específico, que puedes encontrar en el sitio web de Victron. Con estos elementos, estarás listo para comenzar.

Guía Paso a Paso para la Integración en Home Assistant

Ahora sí, vamos a la acción. La integración de Victron con Home Assistant vía Modbus TCP se realiza principalmente a través del archivo de configuración YAML. Aunque Home Assistant ha ido migrando hacia configuraciones por UI, Modbus todavía requiere edición manual en la mayoría de los casos. A continuación, te guiaremos paso a paso, desde la habilitación del servidor Modbus en Victron hasta la creación de sensores en Home Assistant. Sigue cada paso con atención y adapta los valores a tu equipo.

Paso 1: Habilitar Modbus TCP en el dispositivo Victron

Si tu dispositivo Victron es un controlador GX (Cerbo GX, Venus GX, etc.), el servidor Modbus TCP viene habilitado por defecto en el puerto 502. Sin embargo, es recomendable verificar. Accede a la interfaz web del GX (Remote Console) y ve a Settings > Services > Modbus TCP. Asegúrate de que esté en 'Enabled'. Si usas un inversor MultiPlus con un adaptador MK3-USB, necesitarás habilitar Modbus TCP a través de VEConfigure, pero esto es menos común. Para la mayoría de usuarios con GX, no hay que hacer nada adicional. Toma nota de la dirección IP del dispositivo, que puedes encontrar en Settings > Ethernet o WiFi.

Paso 2: Identificar los registros Modbus necesarios

Victron proporciona una hoja de cálculo con todos los registros Modbus para sus dispositivos. Puedes descargarla desde su página de soporte técnico. Busca la sección correspondiente a tu modelo. Por ejemplo, para un MultiPlus-II, los registros de interés suelen ser: 840 (Voltaje de batería), 841 (Corriente de batería), 842 (Potencia de batería), 843 (Voltaje de salida AC), 844 (Corriente de salida AC), 845 (Potencia de salida AC), 846 (Estado del inversor), etc. Para un SmartSolar MPPT, los registros son diferentes: 771 (Voltaje de batería), 772 (Corriente de carga), 773 (Potencia de carga), etc. Es importante anotar las direcciones exactas y el tipo de dato (entero, flotante). La hoja de cálculo indica el 'Data type' y el 'Scale factor' que a veces es necesario aplicar.

Paso 3: Configurar la integración Modbus en Home Assistant

Home Assistant tiene una integración Modbus que se configura en el archivo configuration.yaml. Añade el siguiente bloque, adaptando la IP y los registros:

modbus:
  - name: victron
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: 'Victron Battery Voltage'
        slave: 100
        address: 840
        input_type: holding
        data_type: uint16
        scale: 0.1
        precision: 1
        unit_of_measurement: 'V'
        device_class: voltage
      - name: 'Victron Battery Current'
        slave: 100
        address: 841
        input_type: holding
        data_type: int16
        scale: 0.1
        precision: 1
        unit_of_measurement: 'A'
        device_class: current
      - name: 'Victron Battery Power'
        slave: 100
        address: 842
        input_type: holding
        data_type: int16
        scale: 1
        precision: 0
        unit_of_measurement: 'W'
        device_class: power

Observa que hemos usado 'slave: 100', que es el unit ID típico para el sistema principal en Victron. El 'scale' ajusta el valor según el factor de escala indicado en la documentación (por ejemplo, 0.1 para voltajes y corrientes). El 'data_type' puede ser uint16, int16, uint32, etc. Asegúrate de que coincides con el tipo de dato real. Después de guardar, reinicia Home Assistant. Los sensores aparecerán como entidades y podrás añadirlos a tu panel.

Paso 4: Verificar y solucionar problemas

Una vez reiniciado Home Assistant, ve a la sección de Desarrollador > Estados y busca las entidades creadas. Deberían mostrar valores numéricos. Si no aparecen o muestran 'unknown', revisa los logs de Home Assistant para ver errores de conexión. Los problemas más comunes son: IP incorrecta, puerto bloqueado por firewall, slave ID equivocado, o dirección de registro errónea. Para depurar, puedes usar la herramienta 'modbus' de línea de comandos o instalar la integración 'Modbus' desde HACS que ofrece una interfaz gráfica. También puedes probar con la aplicación 'Radzio Modbus Master' desde un PC para confirmar que los registros responden. Si todo está bien, ¡felicidades! Ya tienes tu Victron integrado.

Errores Comunes y Mejores Prácticas

La integración Modbus TCP es potente pero también propensa a errores si no se siguen ciertas pautas. En esta sección, enumeramos los fallos más frecuentes y cómo evitarlos, además de ofrecer recomendaciones para un funcionamiento estable y seguro.

Errores de configuración típicos

• Dirección IP incorrecta: Asegúrate de que la IP del dispositivo Victron es correcta y estática. Si usas DHCP, puede cambiar y romper la integración. Configura una reserva DHCP en tu router.
• Slave ID equivocado: El valor por defecto es 100, pero en algunos dispositivos puede ser 1 o 246. Consulta la documentación.
• Tipo de dato incorrecto: Usar uint16 cuando el registro es int16 puede dar valores erróneos. Verifica en la hoja de registros.
• Factor de escala omitido: Muchos registros vienen con un factor de escala (por ejemplo, 0.1). Si no lo aplicas, los valores serán 10 veces mayores.

Seguridad y rendimiento

Modbus TCP no tiene autenticación ni cifrado, por lo que es vulnerable si se expone a Internet. Nunca abras el puerto 502 a la WAN. Mantén el dispositivo Victron en una red local segura. Además, el polling frecuente puede consumir recursos del GX. Configura intervalos de escaneo de al menos 5-10 segundos para sensores no críticos. Si necesitas datos en tiempo real, considera usar MQTT en lugar de Modbus para ciertos parámetros. Por último, realiza copias de seguridad de tu configuration.yaml antes de hacer cambios.

Tabla Comparativa: Métodos de Integración Victron en Home Assistant

Para ayudarte a decidir si Modbus TCP es la mejor opción para tu caso, hemos elaborado una tabla comparativa con los tres métodos principales: Modbus TCP, MQTT (integración oficial) y el componente de HACS. Analizamos aspectos como facilidad de configuración, flexibilidad, latencia, y requisitos.

Como se puede apreciar, Modbus TCP destaca en flexibilidad y control, aunque requiere más conocimientos técnicos. MQTT es más sencillo pero limitado. El componente HACS es un punto intermedio. La elección depende de tus necesidades: si buscas automatizaciones avanzadas y acceso a todos los registros, Modbus TCP es la mejor opción.

Preguntas Frecuentes (FAQ)

Conclusiones y Plan de Acción

La integración de un inversor Victron en Home Assistant mediante Modbus TCP es un proyecto gratificante que te brinda un control sin precedentes sobre tu sistema solar. A lo largo de esta guía, hemos cubierto desde los conceptos básicos hasta la configuración práctica, incluyendo los registros esenciales, los errores comunes y las mejores prácticas. Ahora tienes el conocimiento para monitorizar tu producción solar, el estado de tus baterías y el consumo de tu hogar, todo en un solo panel. Además, puedes crear automatizaciones intelig