Cómo integrar un inversor solar SolarEdge en Home Assistant con Modbus TCP: Guía completa

La monitorización en tiempo real de un sistema fotovoltaico es esencial para maximizar su rendimiento y detectar fallos de manera temprana. Home Assistant, como plataforma de automatización del hogar, se ha convertido en el centro neurálgico de muchas viviendas inteligentes, y su capacidad para integrarse con inversores solares mediante protocolos estándar como Modbus TCP abre un abanico de posibilidades. En esta guía exhaustiva, exploraremos paso a paso cómo conectar un inversor SolarEdge a Home Assistant utilizando Modbus TCP, desde los fundamentos teóricos hasta la configuración avanzada, pasando por la resolución de problemas comunes y una comparativa detallada de modelos.

Fundamentos de la integración: SolarEdge, Home Assistant y Modbus TCP

Para abordar esta integración con éxito, es crucial comprender los tres pilares que intervienen: el inversor SolarEdge, la plataforma Home Assistant y el protocolo Modbus TCP. Cada uno juega un papel específico y su correcta interacción garantiza una comunicación fluida y fiable.

SolarEdge es uno de los fabricantes líderes en el sector de la energía solar, conocido por sus inversores con optimizadores de potencia a nivel de módulo. Esta tecnología permite un seguimiento individualizado de cada panel, maximizando la producción incluso en condiciones de sombreado parcial. Los inversores SolarEdge incorporan un puerto de comunicación que soporta varios protocolos, entre ellos Modbus TCP, que permite la lectura de una amplia gama de parámetros operativos.

Home Assistant (HA) es un software de automatización del hogar de código abierto que se ejecuta en dispositivos como Raspberry Pi, NUC o servidores dedicados. Actúa como un hub centralizado que integra múltiples dispositivos y servicios, ofreciendo una interfaz unificada y potentes capacidades de automatización. Su arquitectura modular y su gran comunidad de desarrolladores hacen posible la integración de prácticamente cualquier dispositivo que exponga una API o protocolo estándar.

El protocolo Modbus TCP es una variante del protocolo Modbus, diseñado para comunicaciones a través de redes Ethernet. Es ampliamente utilizado en la automatización industrial y en el sector de las energías renovables por su simplicidad, robustez y bajo consumo de recursos. En el contexto de SolarEdge, el inversor actúa como esclavo Modbus, exponiendo registros que contienen datos como potencia actual, energía total, tensiones, corrientes y temperaturas. Home Assistant, actuando como maestro, realiza consultas periódicas a estos registros mediante su integración Modbus.

Requisitos previos y preparación del entorno

Antes de sumergirnos en la configuración, es necesario asegurarse de que se cumplen todos los requisitos técnicos y de hardware. A continuación, detallamos los elementos necesarios y las consideraciones iniciales.

Hardware y firmware necesarios

En primer lugar, necesitaremos un inversor SolarEdge compatible con la comunicación Modbus TCP. La mayoría de los modelos actuales, como las series SE, SEK y StorEdge, incluyen esta funcionalidad. Es imprescindible que el firmware del inversor esté actualizado a una versión que soporte Modbus TCP; en caso contrario, la integración no funcionará correctamente. Consulta el manual del inversor o el portal de SolarEdge para verificar la compatibilidad.

Además, necesitaremos una instancia de Home Assistant funcionando, ya sea en un sistema operativo dedicado como Home Assistant OS, en una instalación supervisada o en un contenedor Docker. La integración Modbus está incluida en el núcleo de Home Assistant, por lo que no es necesario instalar complementos adicionales.

Por último, es fundamental que el inversor y el dispositivo que ejecuta Home Assistant estén conectados a la misma red local (LAN). La comunicación se realizará a través de la dirección IP del inversor, que deberá ser estática o reservada en el router para evitar cambios de IP que rompan la conexión.

Habilitar Modbus TCP en el inversor SolarEdge

El primer paso técnico es habilitar la comunicación Modbus TCP en el inversor. Esto se realiza a través del panel de configuración del inversor, accesible mediante su interfaz web local o a través de la plataforma de monitorización SolarEdge. Los pasos generales son los siguientes:

1. Accede a la interfaz de configuración del inversor. Normalmente, se introduce la dirección IP del inversor en un navegador web y se inicia sesión con las credenciales de instalador.
2. Navega hasta la sección de comunicación o red. Busca la opción de protocolo Modbus y selecciona TCP.
3. Configura la dirección IP del inversor (si no es estática, resérvala en el router) y el puerto Modbus TCP, que por defecto suele ser el 502.
4. Guarda los cambios y reinicia el inversor si es necesario.

Una vez habilitado, podemos verificar la conectividad utilizando herramientas como modbus-cli o simplemente haciendo una prueba de ping. Si el inversor responde, estamos listos para configurar Home Assistant.

Configuración de la integración Modbus en Home Assistant

Una vez que el inversor está listo, procedemos a configurar la integración Modbus en Home Assistant. Esto se realiza mediante la edición del archivo configuration.yaml, donde definiremos el servidor Modbus y los sensores que queremos leer.

Definición del servidor Modbus

En primer lugar, debemos declarar el servidor Modbus en el archivo de configuración. Añadimos un bloque modbus: con los datos de conexión. A continuación, un ejemplo básico:

modbus:
  - name: "SolarEdge"
    type: tcp
    host: "192.168.1.100"
    port: 502
    sensors:
      - name: "Potencia actual"
        unit_of_measurement: "W"
        address: 40083
        input_type: holding
        data_type: uint32
        scale: 1
        precision: 0
      - name: "Energía total"
        unit_of_measurement: "kWh"
        address: 40084
        input_type: holding
        data_type: uint32
        scale: 0.001
        precision: 3

En este ejemplo, hemos definido un servidor Modbus llamado 'SolarEdge' que se conecta a la IP 192.168.1.100 en el puerto 502. Luego, hemos definido dos sensores: uno para la potencia actual (registro 40083) y otro para la energía total (registro 40084). Es importante conocer los registros específicos de SolarEdge; más adelante proporcionaremos una tabla completa.

Registros Modbus comunes en inversores SolarEdge

SolarEdge publica un documento de referencia de registros Modbus, que detalla las direcciones y formatos de datos. A continuación, se muestran los registros más utilizados para la monitorización básica:

Estos registros son de tipo holding (lectura/escritura) y se acceden mediante la dirección indicada. Es fundamental respetar el tipo de dato y el factor de escala para obtener lecturas correctas. Por ejemplo, la energía total se expresa en Wh, pero podemos convertirla a kWh aplicando un factor de escala de 0.001.

Configuración avanzada de sensores

Además de los sensores básicos, podemos configurar sensores para otros parámetros como la potencia por optimizador, la tensión de cada módulo, etc. Sin embargo, esto requiere conocer los registros específicos de cada modelo. En la documentación de SolarEdge, se pueden encontrar los mapas de registros completos.

También es posible utilizar la integración Modbus para escribir registros, lo que permitiría, por ejemplo, limitar la potencia de salida del inversor desde Home Assistant. No obstante, esta operación debe realizarse con extrema precaución, ya que puede afectar al rendimiento del sistema solar. Recomendamos utilizar solo sensores de lectura para monitorización pasiva.

Visualización y automatizaciones con los datos del inversor

Una vez que los sensores están configurados y se actualizan correctamente, podemos aprovechar los datos para crear un panel de control atractivo y automatizaciones inteligentes.

Creación de un dashboard en Lovelace

Con los sensores disponibles, podemos añadirlos a un dashboard de Lovelace. Por ejemplo, podemos crear una tarjeta de entidad para mostrar la potencia actual y la energía total, o utilizar tarjetas más avanzadas como statistics-graph para visualizar la evolución de la producción a lo largo del tiempo. A continuación, un ejemplo de una tarjeta personalizada:

type: entities
title: 'Inversor SolarEdge'
entities:
  - entity: sensor.solaredge_potencia_actual
    name: Potencia actual
  - entity: sensor.solaredge_energia_total
    name: Energía total
  - entity: sensor.solaredge_temperatura_inversor
    name: Temperatura

También podemos utilizar la tarjeta history-graph para mostrar la curva de potencia diaria, lo que resulta muy útil para detectar anomalías.

Automatizaciones basadas en la producción solar

Uno de los mayores beneficios de integrar el inversor en Home Assistant es la posibilidad de crear automatizaciones. Por ejemplo, podemos activar electrodomésticos de alto consumo cuando la producción solar supere un umbral, maximizando el autoconsumo. Un ejemplo de automatización:

automation:
  - alias: "Activar lavadora cuando haya excedente solar"
    trigger:
      - platform: numeric_state
        entity_id: sensor.solaredge_potencia_actual
        above: 3000
    condition:
      - condition: state
        entity_id: binary_sensor.lavadora
        state: 'off'
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.lavadora

De esta manera, aprovechamos al máximo la energía generada y reducimos la dependencia de la red eléctrica.

Solución de problemas comunes

A pesar de que la integración es relativamente sencilla, pueden surgir problemas. A continuación, abordamos los más frecuentes y sus soluciones.

El sensor no se actualiza o muestra valores incorrectos

Si los sensores no se actualizan, lo primero es verificar la conectividad entre Home Assistant y el inversor. Podemos usar el comando ping desde la terminal de Home Assistant para comprobar si el inversor es accesible. Si la conectividad es correcta, revisa la configuración del puerto y la dirección IP. También es posible que el inversor no esté respondiendo a las consultas Modbus; en ese caso, consulta los logs de Home Assistant para ver errores de timeout.

Si los valores son incorrectos, verifica el tipo de dato y el factor de escala. Por ejemplo, si la potencia aparece como un número enorme, es probable que estés leyendo un registro de 16 bits cuando debería ser de 32 bits, o que el factor de escala sea incorrecto.

El inversor no responde a las consultas Modbus

Esto puede deberse a que el Modbus TCP no está habilitado en el inversor o a que el puerto está bloqueado por un firewall. Asegúrate de que el puerto 502 esté abierto en la red local. También verifica que el inversor no esté en modo de espera o que no haya superado el número máximo de conexiones Modbus simultáneas.

Comparativa de modelos de inversores SolarEdge para integración con Home Assistant

A la hora de elegir un inversor SolarEdge, es importante considerar su compatibilidad con Modbus TCP y su rendimiento general. A continuación, presentamos una comparativa de tres modelos populares:

Como se observa, todos los modelos soportan Modbus TCP, por lo que la integración con Home Assistant será posible en todos ellos. La elección dependerá de la potencia necesaria para tu instalación fotovoltaica. Para una vivienda típica, el SE5000 suele ser una opción equilibrada.

Preguntas frecuentes

Conclusiones y plan de acción recomendado

La integración de un inversor SolarEdge con Home Assistant mediante Modbus TCP es una solución robusta y de código abierto que permite una monitorización detallada y la creación de automatizaciones inteligentes. A lo largo de esta guía, hemos cubierto desde los fundamentos hasta la resolución de problemas, pasando por ejemplos prácticos y comparativas.

Para comenzar, te recomendamos seguir estos pasos: primero, verifica la compatibilidad de tu inversor y actualiza el firmware si es necesario. Segundo, habilita Modbus TCP en el inversor y anota su IP. Tercero, configura la integración Modbus en Home Assistant con los registros básicos. Cuarto, crea un dashboard y automatizaciones para aprovechar los datos. Por último, no dudes en consultar la documentación oficial de SolarEdge y la comunidad de Home Assistant para resolver dudas específicas.