Guía completa: Integrar inversor Fronius en Home Assistant con Modbus TCP

La integración de inversores solares en sistemas de domótica se ha convertido en una necesidad para los hogares inteligentes que buscan maximizar el autoconsumo y optimizar el uso de la energía solar. Entre las marcas más populares, Fronius destaca por su fiabilidad y soporte de protocolos abiertos como Modbus TCP. En esta guía exhaustiva aprenderás a conectar tu inversor Fronius a Home Assistant paso a paso, desde los requisitos previos hasta la configuración avanzada y la resolución de problemas comunes.

Requisitos previos y consideraciones técnicas

Antes de comenzar con la integración, es fundamental asegurarse de que disponemos del hardware y software adecuados. En primer lugar, necesitamos un inversor solar Fronius que soporte el protocolo Modbus TCP. La mayoría de los modelos modernos de las series Symo, Primo y Galvo incluyen esta funcionalidad, aunque es recomendable verificar en la ficha técnica o en el menú de red del inversor. También requerimos una red local estable (Ethernet o Wi-Fi) que conecte el inversor y el equipo donde se ejecuta Home Assistant. Por último, es necesario tener instalado Home Assistant (preferiblemente en una Raspberry Pi, un servidor NAS o un contenedor Docker) con acceso a la interfaz web y capacidad para instalar integraciones personalizadas.

El protocolo Modbus TCP es un estándar de comunicación industrial ampliamente utilizado en dispositivos de automatización y energía. En el caso de Fronius, el inversor actúa como servidor Modbus, exponiendo una serie de registros que contienen datos en tiempo real como potencia generada, tensión, corriente, energía total, estado del inversor, entre otros. Home Assistant, mediante la integración Modbus, puede leer estos registros periódicamente y crear sensores que luego podemos visualizar en dashboards, automatizar reglas o enviar notificaciones. Es importante destacar que la comunicación se realiza a través del puerto 502 (el estándar Modbus) y que debemos asegurarnos de que no haya conflictos con otros dispositivos en la red.

AtenciónAntes de manipular la configuración de red del inversor, consulta el manual de usuario de Fronius. Algunos modelos requieren habilitar explícitamente el servidor Modbus desde el panel de control o mediante la herramienta 'Fronius Solar.start'. Además, asegúrate de que la versión de firmware de tu inversor sea compatible con Modbus TCP; en caso contrario, puede ser necesario actualizarla.

Paso 1: Configurar el inversor Fronius para Modbus TCP

El primer paso es acceder a la interfaz web del inversor Fronius. Para ello, necesitamos conocer su dirección IP. Podemos obtenerla a través del router (buscando dispositivos conectados) o directamente desde la pantalla del inversor si dispone de ella. Una vez identificada la IP, abrimos un navegador web y escribimos esa dirección. Se nos pedirá un nombre de usuario y contraseña; por defecto, suele ser 'admin' y 'admin' o 'user' y 'user' (recomendamos cambiarlo por seguridad). Dentro del panel de administración, buscamos la sección de 'Red' o 'Network' y luego 'Modbus'. Allí debemos activar la opción 'Modbus TCP' y, si es posible, especificar el puerto (502 por defecto). Algunos modelos permiten configurar una lista de direcciones IP autorizadas; si es así, añadimos la IP del equipo donde corre Home Assistant para mayor seguridad. Guardamos los cambios y reiniciamos el inversor si es necesario.

Una vez activado el servidor Modbus, podemos verificar que está funcionando correctamente utilizando herramientas como 'Modbus Poll' (Windows) o 'mbpoll' (Linux). Desde un terminal, ejecutamos un comando similar a: mbpoll -a 1 -t 4:float -r 0 -c 10 [IP_del_inversor]. Esto leerá los primeros 10 registros holding (tipo 4) como números flotantes. Si obtenemos valores coherentes (por ejemplo, potencia en vatios), la comunicación Modbus funciona. En caso de error, revisa la conectividad de red, el firewall y la configuración del inversor.

Paso 2: Instalar y configurar la integración Modbus en Home Assistant

Home Assistant incluye una integración oficial para Modbus que permite conectarse a dispositivos Modbus TCP. Para instalarla, ve a 'Configuración' > 'Dispositivos y servicios' > 'Agregar integración' y busca 'Modbus'. Selecciona la opción 'Modbus TCP' e introduce la dirección IP del inversor Fronius y el puerto (502). Puedes dejar el ID de esclavo en 1 (el valor por defecto para Fronius). Una vez añadida la integración, Home Assistant creará un nodo Modbus en el que podremos definir sensores personalizados.

Sin embargo, la integración básica solo establece el canal de comunicación. Para leer los registros específicos del inversor, necesitamos crear sensores Modbus en el archivo 'configuration.yaml' de Home Assistant. A continuación, te mostramos un ejemplo de configuración para los datos más comunes de un inversor Fronius. Recuerda ajustar las direcciones de registro según el modelo de tu inversor (consulta el manual de Fronius Modbus o la documentación técnica).

modbus:
  - name: hub1
    type: tcp
    host: 192.168.1.100
    port: 502

sensor:
  - platform: modbus
    scan_interval: 10
    registers:
      - name: "Potencia actual"
        hub: hub1
        unit_of_measurement: "W"
        slave: 1
        register: 0
        register_type: holding
        data_type: float
        scale: 1
        precision: 1
      - name: "Energía total"
        hub: hub1
        unit_of_measurement: "kWh"
        slave: 1
        register: 2
        register_type: holding
        data_type: float
        scale: 1
        precision: 1
      - name: "Tensión de red"
        hub: hub1
        unit_of_measurement: "V"
        slave: 1
        register: 4
        register_type: holding
        data_type: float
        scale: 1
        precision: 1
      - name: "Corriente"
        hub: hub1
        unit_of_measurement: "A"
        slave: 1
        register: 6
        register_type: holding
        data_type: float
        scale: 1
        precision: 2

Después de guardar los cambios, reinicia Home Assistant para que cargue la nueva configuración. En el panel de 'Entidades' deberían aparecer los sensores con los nombres que hemos definido. Si no aparecen, revisa los logs de Home Assistant (Configuración > Registro) para identificar errores de conexión o de formato de datos. Es posible que algunos registros no sean de tipo float sino entero (int) o que la dirección de registro no sea la correcta; en ese caso, ajusta los parámetros 'data_type' y 'register' según la documentación de Fronius.

ConsejoPara obtener una lista completa de los registros Modbus disponibles en tu modelo de Fronius, descarga el documento 'Modbus TCP Interface' desde el sitio web oficial de Fronius. Allí encontrarás las direcciones, tipos de datos y unidades para cada variable. También puedes utilizar la herramienta 'Fronius Datamanager' para explorar los registros en tiempo real.

Paso 3: Crear un dashboard de monitorización solar

Una vez que los sensores están disponibles, podemos diseñar un panel de control personalizado en Home Assistant para visualizar la producción solar. Utilizando la interfaz de Lovelace, podemos añadir tarjetas como 'Sensor', 'Gauge' o 'History Graph' para mostrar la potencia actual, la energía total y otras métricas. Por ejemplo, una tarjeta de tipo 'Gauge' es ideal para mostrar la potencia en tiempo real con un rango de 0 a la capacidad máxima del inversor. También podemos crear una tarjeta de 'Energy Dashboard' si configuramos la entidad de energía total como fuente de energía solar.

Para un dashboard más completo, podemos agrupar varios sensores en una sola vista. A continuación, un ejemplo de código YAML para una tarjeta de tipo 'grid' que muestra la potencia, tensión y corriente:

type: grid
cards:
  - type: gauge
    entity: sensor.potencia_actual
    name: Potencia
    unit: W
    min: 0
    max: 3000
    severity:
      green: 0
      yellow: 1500
      red: 2500
  - type: sensor
    entity: sensor.tension_de_red
    name: Tensión
    icon: mdi:flash
  - type: sensor
    entity: sensor.corriente
    name: Corriente
    icon: mdi:current-ac
columns: 3

Además, podemos añadir la tarjeta 'Energy Distribution' si tenemos un medidor de consumo general, para ver el flujo de energía entre la producción solar, el consumo del hogar y la red eléctrica. Esto permite identificar oportunidades de ahorro y ajustar hábitos de consumo.

Errores comunes y solución de problemas

Durante la integración, pueden surgir varios problemas. Uno de los más frecuentes es la imposibilidad de conectar con el inversor. Verifica que el inversor esté encendido y que su dirección IP sea accesible desde la red de Home Assistant. Puedes hacer un ping desde el terminal de Home Assistant (si tienes acceso) o desde otro equipo en la misma red. También comprueba que el puerto 502 no esté bloqueado por un firewall. En algunos routers, es necesario abrir el puerto o crear una regla de reenvío si el inversor está en una subred diferente.

Otro error común es la lectura de valores incorrectos o nulos. Esto suele deberse a una configuración errónea de los registros: tipo de dato incorrecto (float vs int), dirección de registro equivocada o factor de escala inadecuado. Por ejemplo, algunos modelos de Fronius reportan la potencia en vatios como un entero de 32 bits en lugar de un float. En ese caso, cambia 'data_type: float' por 'data_type: int32' y ajusta el scale si es necesario. También es posible que el inversor requiera una dirección de esclavo diferente a 1; consulta el manual para confirmar.

AtenciónSi después de varios intentos no logras establecer comunicación, prueba a deshabilitar temporalmente el cortafuegos de tu sistema operativo o del router. Además, asegúrate de que no haya otro cliente Modbus conectado al mismo inversor, ya que algunos modelos solo permiten una conexión simultánea. En entornos con múltiples inversores, asigna a cada uno una dirección IP fija y un ID de esclavo único.

Tabla comparativa de modelos Fronius compatibles con Modbus TCP

A continuación, presentamos una tabla comparativa de los modelos más comunes de Fronius que soportan Modbus TCP, junto con sus características principales. Esta información te ayudará a identificar si tu inversor es compatible y qué esperar de la integración.

Modelo	Potencia (kW)	Modbus TCP	Registros disponibles
Fronius Symo	3.0 - 10.0	Sí	Completos
Fronius Primo	3.0 - 8.2	Sí	Completos
Fronius Galvo	1.5 - 3.0	Limitado	Básicos
Fronius SnapINverter	3.0 - 12.0	Sí	Completos

Como se observa, la mayoría de los modelos actuales ofrecen soporte completo para Modbus TCP, lo que permite acceder a una amplia gama de registros. Los modelos Galvo, al ser más antiguos o de gama básica, pueden tener un conjunto limitado de registros, pero aún así es posible leer las métricas principales como potencia y energía. Si tu modelo no aparece en la tabla, consulta la documentación oficial o contacta con el soporte de Fronius.

Preguntas frecuentes (FAQ)

¿Qué hago si Home Assistant no encuentra el inversor?

En primer lugar, verifica que el inversor esté encendido y conectado a la red. Comprueba la dirección IP: puede haber cambiado si no tienes una IP fija asignada. Accede al router y busca la IP del inversor por su nombre de host o MAC. También asegúrate de que el puerto 502 esté abierto y que no haya un firewall bloqueando la conexión. Si usas Docker, revisa la configuración de red del contenedor de Home Assistant; debe estar en modo 'host' o tener acceso a la red local. Por último, prueba a conectar con un cliente Modbus externo (como 'Modbus Poll') para confirmar que el servidor Modbus del inversor responde.

¿Es seguro exponer el inversor a la red local?

Sí, siempre que tomes precauciones básicas. No expongas el inversor directamente a Internet; mantenlo en una red local aislada. Cambia la contraseña de administrador del inversor por una segura. Si tu router lo permite, crea una VLAN separada para dispositivos IoT. Además, en la configuración Modbus del inversor, puedes restringir las direcciones IP autorizadas para que solo Home Assistant pueda conectarse. De esta forma, minimizas el riesgo de accesos no autorizados.

¿Puedo integrar varios inversores Fronius en un solo Home Assistant?

Sí, es posible. Debes configurar un hub Modbus para cada inversor, con su respectiva IP y puerto. En el archivo 'configuration.yaml', puedes definir varios hubs bajo la clave 'modbus'. Luego, en los sensores, asigna cada uno al hub correspondiente. Asegúrate de que los inversores tengan direcciones IP fijas y, si es necesario, IDs de esclavo diferentes. Esto te permitirá monitorizar múltiples sistemas solares de forma centralizada.

¿Qué hago si los valores leídos son incorrectos?

Los valores incorrectos suelen deberse a un tipo de datos mal configurado. Por ejemplo, si esperas un float pero el registro es un entero, obtendrás números sin sentido. Revisa la documentación de Fronius para conocer el tipo de dato exacto de cada registro. También verifica el factor de escala: algunos registros entregan valores en décimas o centésimas. Ajusta 'scale' y 'precision' en la configuración del sensor. Otra causa posible es que la dirección del registro no sea la correcta; utiliza la herramienta 'Modbus Poll' para explorar los registros y confirmar las direcciones.

Automatizaciones avanzadas con datos solares

Una vez que los datos del inversor están disponibles en Home Assistant, podemos crear automatizaciones para optimizar el consumo energético. Por ejemplo, podemos programar el encendido de electrodomésticos de alto consumo (lavadora, lavavajillas, termo eléctrico) cuando la producción solar supere un umbral determinado. También podemos activar un sistema de almacenamiento en batería cuando haya excedentes o, si no tenemos baterías, verter el excedente a la red (si la normativa local lo permite).

Un ejemplo sencillo de automatización en YAML sería encender un enchufe inteligente cuando la potencia generada supere los 2000 W:

automation:
  - alias: "Encender carga cuando haya excedente solar"
    trigger:
      platform: numeric_state
      entity_id: sensor.potencia_actual
      above: 2000
    action:
      service: switch.turn_on
      target:
        entity_id: switch.carga_inteligente

Además, podemos combinar estos datos con sensores de consumo del hogar para calcular el balance neto y mostrar en el dashboard si estamos comprando o vendiendo energía. Con un medidor de energía bidireccional (como un Shelly EM o un P1 meter), podemos integrar la lectura de la red y visualizar el flujo en tiempo real.

Conclusiones y próximos pasos

La integración de un inversor solar Fronius en Home Assistant mediante Modbus TCP es un proceso accesible para cualquier aficionado a la domótica con conocimientos básicos de redes y configuración. Los beneficios son inmediatos: monitorización en tiempo real, históricos de producción, automatizaciones inteligentes y un mayor control sobre el autoconsumo. Hemos recorrido desde la configuración inicial del inversor, la instalación de la integración Modbus, la creación de sensores personalizados, hasta el diseño de dashboards y automatizaciones.

RecomendaciónSi eres nuevo en Home Assistant, te sugerimos comenzar con una configuración básica de pocos sensores (potencia y energía) e ir añadiendo más registros a medida que te familiarices con el sistema. No olvides mantener copias de seguridad de tu configuración y documentar los cambios. Para usuarios avanzados, explorar la integración con 'Energy Dashboard' de Home Assistant y sistemas de baterías virtuales puede llevar tu gestión energética al siguiente nivel.

En resumen, con esta guía tienes todas las herramientas necesarias para integrar tu inversor Fronius en Home Assistant. La comunidad de Home Assistant es muy activa y siempre dispuesta a ayudar; no dudes en consultar los foros si encuentras algún obstáculo. ¡Disfruta de tu hogar inteligente y sostenible!

Cómo integrar un inversor solar Fronius en Home Assistant con Modbus TCP