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

La monitorización en tiempo real de un inversor solar es esencial para optimizar el rendimiento de una instalación fotovoltaica. Home Assistant, como plataforma de automatización del hogar, ofrece una flexibilidad inigualable para integrar dispositivos de energía, y los inversores Solis no son la excepción. En esta guía exhaustiva, exploraremos cómo conectar un inversor Solis a Home Assistant mediante el protocolo Modbus RTU, un estándar industrial de comunicación que permite extraer datos precisos de producción, tensión, corriente y estado del sistema. A lo largo de este artículo, cubriremos desde los fundamentos teóricos de Modbus RTU hasta la configuración práctica en Home Assistant, pasando por el cableado correcto, la instalación de integraciones, la creación de sensores personalizados y la resolución de problemas comunes. Si buscas un control total sobre tu generación solar, esta guía te proporcionará todos los conocimientos necesarios.

Fundamentos de Modbus RTU y su Aplicación en Inversores Solis

Modbus RTU (Remote Terminal Unit) es un protocolo de comunicación serial ampliamente utilizado en la industria para la supervisión y control de dispositivos electrónicos. Opera sobre conexiones físicas RS-485, que permiten la transmisión de datos a distancias de hasta 1200 metros, lo que lo hace ideal para entornos industriales y domésticos donde los inversores pueden estar ubicados lejos del centro de control. En el contexto de los inversores Solis, el protocolo Modbus RTU permite acceder a un amplio conjunto de registros (holding registers) que contienen información detallada sobre el funcionamiento del inversor, como la potencia generada en tiempo real, la energía total acumulada, las tensiones de entrada y salida, las corrientes, las temperaturas y los códigos de error.

La comunicación Modbus RTU se basa en una arquitectura maestro-esclavo. En este caso, Home Assistant (actuando como maestro) envía solicitudes de lectura a los registros específicos del inversor (esclavo), y el inversor responde con los datos solicitados. Cada inversor tiene una dirección Modbus única (por defecto, suele ser 1, pero puede configurarse), y los registros están mapeados según el modelo y el firmware. Para una integración correcta, es crucial conocer el mapa de registros específico de tu modelo de inversor Solis, que generalmente se encuentra en el manual técnico o en la documentación del fabricante.

La principal ventaja de utilizar Modbus RTU frente a otras opciones como la API en la nube de Solis es la independencia total: los datos se obtienen directamente del inversor sin depender de servicios externos, lo que garantiza la privacidad y la disponibilidad incluso sin conexión a Internet. Además, la latencia es mínima, lo que permite una monitorización casi en tiempo real. Sin embargo, requiere una configuración más técnica y un adaptador USB-RS485 para conectar el inversor al dispositivo que ejecuta Home Assistant.

Protocolo Modbus RTU: Estructura de Trama y Registros

Cada trama Modbus RTU incluye la dirección del esclavo, el código de función (por ejemplo, 0x03 para leer registros de retención), la dirección inicial del registro, la cantidad de registros a leer y un checksum CRC para la detección de errores. En el caso de los inversores Solis, los registros de retención (holding registers) son los más utilizados para la monitorización. Por ejemplo, el registro 0x0000 suele contener la potencia activa en vatios (W), el registro 0x0001 la energía diaria en kWh, y así sucesivamente. Es importante consultar el manual específico de tu modelo para obtener la tabla completa de registros, ya que la asignación puede variar.

Para la integración con Home Assistant, necesitaremos conocer al menos los registros de potencia actual, energía total, tensión de red, corriente de salida y estado del inversor. Muchos usuarios también monitorizan las tensiones de los paneles solares (entrada DC) y las temperaturas internas para detectar posibles problemas. A continuación, presentamos una tabla típica de registros para un inversor Solis de la serie S5, pero recuerda verificar la documentación oficial de tu modelo.

Requisitos Previos y Materiales Necesarios

Antes de comenzar con la integración, es fundamental asegurarse de que disponemos de todos los elementos necesarios. A continuación, detallamos los requisitos técnicos y materiales imprescindibles para llevar a cabo esta configuración con éxito.

• Inversor Solar Solis compatible: La mayoría de los inversores Solis de las series S5, S6 y S7 incluyen un puerto de comunicación RS-485. Verifica que tu modelo tenga este puerto y que sea accesible. Consulta el manual del inversor para confirmar la compatibilidad con Modbus RTU.
• Adaptador USB a RS-485: Necesitarás un adaptador USB-RS485 para conectar el inversor a tu servidor Home Assistant (Raspberry Pi, NUC, etc.). Asegúrate de que el adaptador sea compatible con Linux y que utilice el chip FTDI o CH340 para una fácil detección.
• Cable de par trenzado blindado: Para la conexión RS-485, se recomienda utilizar cable de par trenzado blindado (STP) para minimizar interferencias electromagnéticas. La longitud máxima recomendada es de 1200 metros, pero en instalaciones domésticas suele ser mucho menor.
• Home Assistant instalado: Debes tener Home Assistant funcionando en un dispositivo dedicado (Raspberry Pi, NUC, etc.) con acceso a la línea de comandos o a la interfaz web para editar archivos de configuración.
• Documentación del inversor: Ten a mano el manual técnico de tu inversor Solis, especialmente la sección de comunicación Modbus, donde se detallan los registros y la configuración de fábrica.

Cableado y Conexión Física del Inversor Solis

La correcta conexión física es el primer paso crítico. Un error en el cableado puede dañar el inversor o el adaptador. Sigue estos pasos con precisión.

Identificación de los Terminales RS-485 en el Inversor

Localiza en el inversor los terminales de comunicación RS-485. Suelen estar etiquetados como 'RS-485', 'COM', o 'A/B'. En la mayoría de los modelos Solis, encontrarás dos tornillos o conectores: uno para 'A' (o D+) y otro para 'B' (o D-). Algunos modelos también tienen un terminal de tierra (GND) que puede ser necesario conectar para evitar diferencias de potencial.

Es importante consultar el manual para confirmar la disposición exacta, ya que la polaridad es fundamental. Un cableado invertido (A con B) impedirá la comunicación. Además, algunos inversores requieren una resistencia de terminación de 120 ohmios entre A y B en el extremo del bus, especialmente si la distancia es larga.

Conexión del Adaptador USB-RS485

Conecta el adaptador USB-RS485 a tu servidor Home Assistant. En la mayoría de los casos, el sistema operativo lo detectará automáticamente como un dispositivo serie, por ejemplo, /dev/ttyUSB0. Para verificar que el adaptador es reconocido, puedes ejecutar el comando 'ls /dev/ttyUSB*' en la terminal.

A continuación, conecta los cables del adaptador a los terminales del inversor: el cable 'A' del adaptador al terminal 'A' del inversor, y el cable 'B' al terminal 'B'. Si el adaptador tiene un cable de tierra (GND), conéctalo al terminal de tierra del inversor si está disponible. Asegúrate de que los cables estén firmemente sujetos y que no haya cortocircuitos.

Configuración de la Dirección Modbus del Inversor

Cada inversor en un bus Modbus debe tener una dirección única. Por defecto, los inversores Solis suelen venir con la dirección 1. Si tienes varios inversores, deberás cambiar la dirección de cada uno mediante el panel de visualización del inversor o mediante un software de configuración. En Home Assistant, tendremos que especificar esta dirección en la configuración.

Para cambiar la dirección, consulta el manual del inversor. Normalmente, se accede al menú de configuración avanzada y se busca la opción 'Modbus Address'. Asegúrate de anotar la dirección configurada, ya que la necesitarás más adelante.

Configuración de Home Assistant para Modbus RTU

Una vez que la conexión física está lista, el siguiente paso es configurar Home Assistant para que pueda comunicarse con el inversor a través de Modbus. Existen dos métodos principales: la integración nativa Modbus y la integración personalizada Solis Modbus. A continuación, describimos ambos.

Integración Nativa Modbus en Home Assistant

Home Assistant incluye una integración Modbus que permite configurar sensores y lecturas de registros. Para utilizarla, debes editar el archivo 'configuration.yaml' y añadir la configuración correspondiente. Primero, define el puerto serie y la dirección del inversor. Luego, crea sensores que lean los registros deseados.

A continuación, se muestra un ejemplo de configuración para un inversor Solis con dirección 1, asumiendo que el adaptador USB está en /dev/ttyUSB0 y que los registros son los mencionados anteriormente. Deberás adaptar los nombres y las unidades según tus necesidades.

# configuration.yaml
modbus:
  - name: "solis_inverter"
    type: serial
    port: /dev/ttyUSB0
    baudrate: 9600
    bytesize: 8
    parity: N
    stopbits: 1
    timeout: 5

sensor:
  - platform: modbus
    name: "Potencia Actual"
    slave: 1
    registers:
      - name: "Potencia"
        unit_of_measurement: "W"
        register: 0
        data_type: int
        scale: 1
        precision: 0
      - name: "Energía Diaria"
        unit_of_measurement: "kWh"
        register: 1
        data_type: int
        scale: 0.001
        precision: 3
      - name: "Energía Total"
        unit_of_measurement: "kWh"
        register: 2
        data_type: int
        scale: 0.001
        precision: 3

En este ejemplo, se define un sensor que lee los registros 0, 1 y 2. El parámetro 'data_type' puede ser 'int' o 'uint' dependiendo del formato de los datos. La escala se utiliza para convertir el valor crudo a la unidad deseada. Por ejemplo, si el registro de energía diaria está en unidades de 0.001 kWh, multiplicamos por 0.001 para obtener kWh.

Después de guardar el archivo, reinicia Home Assistant para que los cambios surtan efecto. Si todo está correctamente configurado, verás los sensores en el panel de energía y podrás añadirlos a tu dashboard.

Integración Personalizada Solis Modbus

Existe una integración personalizada llamada 'Solis Modbus' desarrollada por la comunidad, que simplifica la configuración y añade sensores predefinidos para los inversores Solis. Esta integración se instala a través de HACS (Home Assistant Community Store). Para ello, primero debes tener HACS instalado en tu Home Assistant.

Una vez que HACS esté listo, busca 'Solis Modbus' en el catálogo e instálalo. Después de la instalación, reinicia Home Assistant. A continuación, ve a Configuración > Dispositivos y Servicios > Añadir Integración y busca 'Solis Modbus'. Se te pedirá que configures los parámetros de conexión: puerto serie, dirección Modbus, modelo de inversor, etc. La integración creará automáticamente un conjunto de sensores con nombres descriptivos y unidades correctas.

Esta integración personalizada es más fácil de usar y está optimizada para los inversores Solis, por lo que es la opción recomendada para la mayoría de los usuarios. Además, incluye soporte para múltiples inversores y permite configurar la dirección de cada uno.

Creación de Sensores y Automatizaciones Avanzadas

Una vez que los sensores básicos están disponibles, puedes crear automatizaciones para aprovechar los datos. Por ejemplo, puedes configurar una notificación cuando la producción supere un umbral, o integrar los datos en el panel de energía de Home Assistant para un seguimiento visual. A continuación, se presentan algunas ideas y ejemplos prácticos.

Añadir Sensores al Panel de Energía

Home Assistant tiene un panel de energía que muestra el consumo y la producción de energía. Para añadir tu inversor solar, ve a Configuración > Energía y en la sección 'Producción de energía' haz clic en 'Añadir producción'. Selecciona el sensor de potencia actual (en vatios) y el sensor de energía diaria (en kWh). Esto te permitirá ver gráficos de producción y comparar con el consumo.

Además, puedes configurar el panel para que muestre la energía total acumulada, lo que te dará una visión a largo plazo del rendimiento de tu instalación.

Automatización para Alertas de Producción

Puedes crear una automatización que te notifique cuando la producción caiga por debajo de un valor esperado, lo que podría indicar un problema con los paneles o el inversor. Por ejemplo, si la potencia actual es inferior a 100 W durante el día, podrías recibir una notificación en tu teléfono.

Otra automatización útil es la de encender o apagar cargas inteligentes cuando la producción supere un umbral, maximizando el autoconsumo. Por ejemplo, si la producción supera los 3000 W, se podría activar un calentador de agua eléctrico.

A continuación, se muestra un ejemplo de automatización en YAML para notificar cuando la producción es baja:

# automation.yaml
- alias: "Alerta de baja producción"
  trigger:
    - platform: numeric_state
      entity_id: sensor.potencia_actual
      below: 100
      for:
        minutes: 10
  condition:
    - condition: sun
      state: "above_horizon"
  action:
    - service: notify.mobile_app_phone
      data:
        title: "Producción baja"
        message: "La producción solar ha caído por debajo de 100 W durante 10 minutos."
  mode: single

Monitorización de Tensión y Temperatura

Además de la potencia, es importante monitorizar las tensiones de entrada y salida, así como la temperatura del inversor. Estas variables pueden indicar problemas de cableado, sombreado parcial o sobrecalentamiento. Añade sensores para los registros correspondientes y crea tarjetas en el dashboard para visualizarlos.

Por ejemplo, si la tensión de red se desvía significativamente del valor nominal, podría haber un problema con la red eléctrica. La temperatura del inversor, si supera los 80 grados Celsius, podría provocar una reducción de potencia o un apagado de seguridad.

Errores Comunes y Solución de Problemas

A pesar de una configuración cuidadosa, pueden surgir problemas. A continuación, se describen los errores más comunes y cómo solucionarlos.

Comparativa: Modbus RTU vs. API en la Nube de Solis

Existen varias formas de monitorizar un inversor Solis. La más común es utilizar la plataforma en la nube del fabricante (Solis Cloud) o su API. Sin embargo, la integración local mediante Modbus RTU ofrece ventajas significativas. A continuación, presentamos una tabla comparativa detallada.