Cómo integrar tu inversor solar Huawei en Home Assistant por Modbus TCP

La integración de inversores solares en sistemas de domótica como Home Assistant se ha convertido en una necesidad para los entusiastas del autoconsumo y la eficiencia energética. Los inversores Huawei, reconocidos por su fiabilidad y rendimiento, ofrecen un puerto de comunicación Modbus TCP que permite extraer datos en tiempo real de producción, consumo y estado del sistema. En esta guía exhaustiva, te mostraremos cada paso para lograr una integración completa, desde la identificación del hardware hasta la creación de automatizaciones avanzadas, utilizando exclusivamente herramientas de código abierto y configuraciones robustas.

Fundamentos de la comunicación Modbus TCP en inversores Huawei

Modbus TCP es un protocolo de comunicación industrial ampliamente utilizado para la monitorización y control de dispositivos. En el contexto de los inversores solares Huawei, este protocolo permite leer registros específicos (holding registers) que contienen información como potencia generada, tensión, corriente, temperatura, energía acumulada y estado de funcionamiento. La comunicación se realiza a través de la red Ethernet local, utilizando el puerto 502 por defecto. Para que la integración funcione, el inversor debe estar conectado a la misma red que el servidor de Home Assistant, ya sea mediante cable Ethernet directo o a través de un adaptador PLC si la distancia es grande. Es importante destacar que no todos los modelos de inversores Huawei soportan Modbus TCP; los modelos de la serie SUN2000 (como SUN2000-3KTL-M1, SUN2000-5KTL-M1, SUN2000-10KTL-M1, entre otros) suelen incluirlo, mientras que los modelos más antiguos o de gama de entrada pueden carecer de esta funcionalidad. Verifica las especificaciones técnicas de tu modelo antes de comenzar.

Requisitos previos y hardware necesario

Antes de iniciar la configuración, asegúrate de contar con los siguientes elementos: un inversor Huawei SUN2000 con soporte Modbus TCP (consulta la documentación oficial o la etiqueta del equipo), un cable Ethernet para conectar el inversor a tu router o switch de red (o un adaptador PLC si no es posible el cableado directo), un servidor con Home Assistant instalado (puede ser una Raspberry Pi, un NAS, un PC o una máquina virtual) y acceso a la interfaz web de Home Assistant con permisos de administrador. Adicionalmente, necesitarás conocer la dirección IP del inversor (puedes obtenerla desde la aplicación FusionSolar o desde el panel de administración de tu router) y el número de puerto Modbus (generalmente 502, aunque puede variar en configuraciones personalizadas). Si tu inversor está detrás de un cortafuegos o NAT, asegúrate de que el puerto 502 esté accesible desde la red local.

Instalación y configuración del add-on Modbus en Home Assistant

Home Assistant dispone de una integración nativa para Modbus, pero para una comunicación más fiable y con soporte para múltiples registros, recomendamos utilizar el add-on 'Modbus' disponible en el repositorio oficial de Home Assistant Community Store (HACS). Si aún no tienes HACS instalado, sigue los pasos en la documentación oficial. Una vez instalado HACS, busca 'Modbus' en la sección de integraciones y agrégalo a tu instancia. A continuación, configura la conexión: ve a Configuración > Dispositivos y servicios > Añadir integración > Modbus. Selecciona 'TCP' e introduce la dirección IP del inversor y el puerto (por defecto 502). Home Assistant intentará conectarse automáticamente. Si la conexión es exitosa, verás un mensaje de confirmación. Luego, deberás añadir los sensores definiendo los registros Modbus que deseas leer. Para ello, edita el archivo configuration.yaml de Home Assistant (puedes hacerlo desde el complemento 'File Editor' o mediante Samba). Añade el siguiente bloque de configuración, ajustando los valores según tu modelo de inversor (los registros pueden variar ligeramente; consulta la documentación técnica de Huawei para los códigos exactos):

modbus:
  - name: huawei_inverter
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia activa"
        unit_of_measurement: "W"
        address: 32064
        input_type: holding
        data_type: int32
        scale: 1
        precision: 0
      - name: "Energía total"
        unit_of_measurement: "kWh"
        address: 32106
        input_type: holding
        data_type: uint32
        scale: 0.1
        precision: 1
      - name: "Tensión DC"
        unit_of_measurement: "V"
        address: 32080
        input_type: holding
        data_type: uint16
        scale: 0.1
        precision: 1
      - name: "Corriente DC"
        unit_of_measurement: "A"
        address: 32082
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 2
      - name: "Temperatura"
        unit_of_measurement: "°C"
        address: 32144
        input_type: holding
        data_type: int16
        scale: 0.1
        precision: 1

Guarda el archivo y reinicia Home Assistant. Después del reinicio, los nuevos sensores aparecerán en el panel de entidades. Puedes personalizar los nombres y asignarlos a áreas para organizarlos mejor. Si algún sensor no muestra datos, verifica la dirección IP, el puerto y los registros. Algunos inversores requieren una unidad de identificación (Unit ID) que por defecto es 1; puedes especificarla añadiendo 'unit: 1' en la configuración del sensor.

Creación de automatizaciones y dashboards avanzados

Una vez que los sensores están funcionando, puedes crear automatizaciones para optimizar tu autoconsumo. Por ejemplo, puedes programar el encendido de electrodomésticos cuando la producción solar supere un umbral, o enviar notificaciones cuando la temperatura del inversor sea alta. Para ello, ve a Configuración > Automatizaciones y crea una nueva. Utiliza los sensores Modbus como desencadenantes (trigger) y acciones (action). Por ejemplo, una automatización para encender un calentador eléctrico cuando la potencia activa supere los 3000 W podría ser:

automation:
  - alias: "Encender calentador con excedente solar"
    trigger:
      - platform: numeric_state
        entity_id: sensor.potencia_activa
        above: 3000
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.calentador

Además, puedes crear un dashboard personalizado con tarjetas de tipo 'Sensor', 'Gráfico' y 'Gauge' para visualizar la producción en tiempo real. Utiliza la tarjeta 'Gauge' para mostrar la potencia actual con un rango de 0 a la potencia máxima del inversor, y tarjetas 'Gráfico' para ver la evolución horaria o diaria. También puedes añadir una tarjeta 'Entity' para mostrar la energía total generada. Para un dashboard más completo, considera usar la tarjeta 'Energy' de Home Assistant, que permite integrar sensores de producción y consumo para un seguimiento global.

Errores comunes y solución de problemas

Durante la integración, pueden surgir varios problemas. El más frecuente es la imposibilidad de conexión: verifica que el inversor esté encendido y conectado a la red, que la IP sea correcta y que el puerto 502 no esté bloqueado por un firewall. También asegúrate de que el inversor tenga habilitado el protocolo Modbus (en algunos modelos hay que activarlo desde la aplicación FusionSolar). Otro error común es la lectura de valores incorrectos o nulos: esto suele deberse a registros incorrectos o a un escalado inadecuado. Revisa la documentación técnica de tu modelo para confirmar las direcciones y el tipo de dato. Si los sensores aparecen como 'no disponibles', prueba a aumentar el tiempo de espera (timeout) en la configuración de Modbus añadiendo 'timeout: 10' en el bloque de configuración. Finalmente, si el inversor se desconecta periódicamente, puede deberse a interferencias en la red eléctrica o a un cable Ethernet defectuoso. Prueba con un cable blindado o utiliza un adaptador PLC de calidad.

Preguntas frecuentes sobre la integración Modbus TCP

Conclusiones y próximos pasos

La integración de tu inversor solar Huawei con Home Assistant mediante Modbus TCP te abre un mundo de posibilidades para la monitorización y automatización de tu sistema fotovoltaico. Con los pasos descritos en esta guía, podrás visualizar la producción en tiempo real, crear automatizaciones inteligentes para maximizar el autoconsumo y recibir alertas ante cualquier anomalía. Recuerda siempre verificar la compatibilidad de tu modelo, mantener actualizado Home Assistant y consultar la documentación oficial de Huawei para los registros específicos. Una vez que tengas la integración básica funcionando, puedes explorar opciones avanzadas como el almacenamiento de datos históricos en InfluxDB, la creación de paneles de control con Grafana o la integración con asistentes de voz para consultar tu producción solar.