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

La integración de sistemas de energía solar en plataformas de domótica como Home Assistant se ha convertido en una necesidad para los hogares inteligentes que buscan maximizar el autoconsumo y reducir la dependencia de la red eléctrica. Los inversores Hoymiles, conocidos por su eficiencia y fiabilidad en instalaciones fotovoltaicas de pequeña y mediana escala, ofrecen una puerta de entrada a la monitorización en tiempo real a través del protocolo Modbus. En esta guía, exploraremos cada paso necesario para lograr una integración exitosa, desde la preparación del hardware hasta la visualización de datos en paneles personalizados, con un enfoque técnico y práctico.

Requisitos Técnicos y Preparación del Hardware

Antes de comenzar con la configuración software, es fundamental contar con los elementos hardware adecuados. La integración vía Modbus requiere que el inversor Hoymiles tenga habilitado el puerto de comunicación RS485 o, en modelos más recientes, una interfaz Wi-Fi/DTU que exponga los datos Modbus sobre TCP/IP. A continuación, detallamos los componentes necesarios:

• Inversor Hoymiles compatible: Modelos como la serie HMS-XXXX o MI-XXXX suelen incluir un puerto RS485. Verifica la ficha técnica de tu modelo para confirmar la compatibilidad con Modbus RTU o Modbus TCP.
• Convertidor RS485 a USB o Ethernet: Si tu inversor utiliza RS485, necesitarás un adaptador como el Waveshare RS485 TO USB o un convertidor RS485 a Ethernet (por ejemplo, USR-W610) para conectar el inversor a la red local donde corre Home Assistant.
• Home Assistant: Una instancia de Home Assistant funcionando, ya sea en Raspberry Pi, un servidor NAS o una máquina virtual. Se recomienda la versión Home Assistant OS o Supervised para facilitar la instalación de complementos.

Además, es recomendable disponer de un cable de par trenzado apantallado para la conexión RS485, especialmente si la distancia entre el inversor y el convertidor supera los 10 metros. La correcta terminación de la línea con resistencias de 120 ohmios puede evitar problemas de comunicación en entornos con ruido eléctrico.

Configuración del Protocolo Modbus en el Inversor Hoymiles

Para que Home Assistant pueda comunicarse con el inversor, es necesario configurar los parámetros Modbus en el propio inversor. Esto se realiza típicamente a través de la aplicación oficial Hoymiles (DTU-Pro o S-Miles) o mediante el interfaz web del datalogger (DTU). Los parámetros clave son:

• Dirección Modbus (Slave ID): Por defecto suele ser 1, pero puede cambiarse si hay múltiples inversores en la misma línea RS485.
• Velocidad de transmisión (Baud Rate): Comúnmente 9600 bps, aunque algunos modelos soportan 19200 o 38400. Debe coincidir con la configuración del adaptador.
• Paridad y Bits de parada: Generalmente 8N1 (8 bits de datos, sin paridad, 1 bit de parada).

Si tu inversor cuenta con una DTU (Data Transfer Unit) que ya está conectada a internet, es posible que los datos Modbus se expongan a través de la red local mediante Modbus TCP. En ese caso, necesitarás la dirección IP de la DTU y el puerto (por defecto 502). La DTU actúa como un gateway que convierte la comunicación serial RS485 a TCP/IP.

Instalación y Configuración del Complemento Modbus en Home Assistant

Home Assistant dispone de una integración nativa para Modbus que permite leer y escribir registros. Para instalarla, ve a Configuración > Dispositivos y servicios > Añadir integración y busca 'Modbus'. Selecciona el tipo de conexión: 'Modbus TCP' si usas un convertidor Ethernet o DTU, o 'Modbus Serial' si conectas directamente por USB. A continuación, configura los parámetros:

• Para Modbus TCP: Introduce la dirección IP del convertidor o DTU (ej. 192.168.1.100) y el puerto (502).
• Para Modbus Serial: Selecciona el puerto serie (ej. /dev/ttyUSB0) y configura baudrate, paridad y bits de parada según los valores del inversor.

Una vez añadida la integración, podrás crear sensores Modbus que lean los registros del inversor. Los registros más comunes para inversores Hoymiles incluyen:

Para crear un sensor, ve a Configuración > Dispositivos y servicios > Modbus > Configurar y selecciona 'Añadir sensor'. Introduce la dirección del registro (en decimal), el tipo de dato (holding register o input register), la escala si es necesario y la unidad de medida. Por ejemplo, para la potencia actual, el registro 31001 es un input register que devuelve un valor en vatios sin escala.

Configuración Avanzada mediante YAML

Para usuarios que prefieren el control total a través del archivo configuration.yaml, Home Assistant permite definir sensores Modbus de forma manual. A continuación, se muestra un ejemplo de configuración para un inversor Hoymiles conectado por Modbus TCP:

modbus:
  - name: hoymiles
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia Actual"
        slave: 1
        address: 31001
        input_type: input
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "Energía Diaria"
        slave: 1
        address: 31003
        input_type: input
        unit_of_measurement: "kWh"
        device_class: energy
        state_class: total_increasing
      - name: "Tensión Red"
        slave: 1
        address: 31005
        input_type: input
        unit_of_measurement: "V"
        device_class: voltage
        state_class: measurement
      - name: "Corriente Salida"
        slave: 1
        address: 31007
        input_type: input
        unit_of_measurement: "A"
        device_class: current
        state_class: measurement

Es importante ajustar el campo 'slave' con la dirección Modbus configurada en el inversor. Además, algunos modelos pueden requerir que los registros se lean como 'holding' en lugar de 'input'. Consulta la documentación específica de tu modelo para confirmar el tipo de registro. Tras añadir esta configuración, reinicia Home Assistant para que los sensores aparezcan en el registro de entidades.

Visualización de Datos en el Panel de Home Assistant

Una vez que los sensores están activos, puedes crear un panel personalizado para monitorizar la producción solar. Utiliza la interfaz de Lovelace para añadir tarjetas como 'Sensor', 'Gauge' o 'Gráfico de historial'. Por ejemplo, una tarjeta de tipo 'Gauge' para la potencia actual se configura fácilmente desde el editor visual. También puedes agrupar varios sensores en una tarjeta 'Entidades' para tener una visión general.

Para una visualización más avanzada, puedes instalar el complemento 'ApexCharts' que permite gráficos interactivos con múltiples series. Por ejemplo, puedes superponer la potencia generada con la irradiancia solar si dispones de un sensor meteorológico.

Solución de Problemas Comunes

Durante el proceso de integración, pueden surgir varios problemas. A continuación, se presentan los más frecuentes y sus soluciones:

• Sensores no disponibles: Verifica la conexión física, la dirección IP y que el puerto Modbus esté abierto. Prueba con un escáner Modbus como 'modscan' para confirmar que el inversor responde.
• Valores incorrectos o desfasados: Asegúrate de que la escala y el tipo de registro son correctos. Algunos inversores devuelven valores en décimas o centésimas; ajusta el factor de escala en la configuración del sensor.
• Errores de timeout: Si la comunicación es inestable, reduce el tiempo de polling (scan_interval) en la configuración del sensor. Por defecto, Home Assistant actualiza los sensores Modbus cada 10 segundos.

Preguntas Frecuentes

Conclusiones y Recomendaciones Finales

Integrar un inversor solar Hoymiles en Home Assistant mediante Modbus 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 de la producción solar, posibilidad de crear automatizaciones para optimizar el autoconsumo y una mayor independencia de las plataformas en la nube. Durante la guía, hemos cubierto desde la preparación del hardware hasta la solución de problemas comunes, proporcionando una hoja de ruta clara para una integración exitosa.