Cómo integrar un inversor Huawei SUN2000 en Home Assistant con Modbus TCP

La monitorización solar se ha convertido en un pilar fundamental para los propietarios de instalaciones fotovoltaicas que desean maximizar su rendimiento y controlar en tiempo real la generación de energía. Los inversores Huawei SUN2000, reconocidos por su eficiencia y fiabilidad, ofrecen la posibilidad de integrarse en sistemas domóticos como Home Assistant mediante el protocolo Modbus TCP. Esta guía técnica detallada te llevará desde la habilitación del servicio en el propio inversor hasta la visualización de datos en paneles interactivos, resolviendo los problemas más comunes que enfrentan los usuarios durante el proceso.

¿Qué necesitas para la integración Huawei SUN2000 Home Assistant?

Antes de comenzar, asegúrate de disponer del siguiente equipamiento y requisitos previos. La integración requiere que el inversor esté conectado a la misma red local que el servidor de Home Assistant, ya sea mediante cable Ethernet o a través de un adaptador Wi-Fi oficial de Huawei. Además, es imprescindible contar con un inversor Huawei SUN2000 que soporte el protocolo Modbus TCP; la mayoría de los modelos actuales lo incluyen, pero es recomendable verificar la hoja de especificaciones. Necesitarás también acceso físico al inversor para configurar los parámetros de comunicación, así como los datos de acceso a la aplicación FusionSolar para obtener la clave de habilitación Modbus.

Paso 1: Habilitar Modbus TCP en el inversor Huawei SUN2000

El primer paso para integrar tu inversor Huawei SUN2000 en Home Assistant es activar el servicio Modbus TCP. Este protocolo permite la comunicación bidireccional entre el inversor y otros dispositivos de la red. La configuración se realiza a través de la aplicación FusionSolar o mediante el panel de control local del inversor. A continuación, te explicamos el procedimiento detallado.

Configuración mediante la aplicación FusionSolar

Inicia sesión en la aplicación FusionSolar con tu cuenta de instalador o propietario. Selecciona la planta donde está instalado tu inversor y accede a la sección de configuración del dispositivo. Busca la opción 'Comunicación' o 'Modbus TCP' y actívala. Deberás establecer un puerto (por defecto 502) y una clave de acceso Modbus, que es un código numérico de 6 dígitos que protegerá la comunicación. Anota esta clave, ya que la necesitarás más adelante en Home Assistant. Guarda los cambios y reinicia el inversor si es necesario.

Configuración mediante el panel local (DDSU666 o similar)

Algunos inversores Huawei permiten la configuración local a través de un display o mediante el medidor inteligente DDSU666. Conecta el medidor al inversor y accede a su interfaz. Navega hasta los parámetros de comunicación y habilita Modbus TCP. Especifica la dirección IP que deseas asignar al inversor (preferiblemente fija) y el puerto. Asegúrate de que la máscara de subred y la puerta de enlace sean correctas para que el inversor esté en la misma red que Home Assistant. Una vez configurado, verifica la conectividad haciendo ping desde un ordenador de la red.

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

Home Assistant cuenta con una integración oficial para inversores Huawei que simplifica enormemente la conexión vía Modbus TCP. Esta integración, denominada 'Huawei Solar', se encarga de leer los registros Modbus y crear sensores automáticamente. Sigue estos pasos para instalarla y configurarla correctamente.

Instalación de la integración

Accede a la interfaz web de Home Assistant y dirígete a 'Configuración' > 'Dispositivos y servicios'. Haz clic en 'Añadir integración' y busca 'Huawei Solar'. Selecciona la integración oficial y sigue el asistente. Te pedirá la dirección IP del inversor, el puerto Modbus (por defecto 502) y la clave de acceso Modbus que configuraste en el paso anterior. Introduce los datos y espera a que Home Assistant verifique la conexión. Si todo es correcto, la integración se añadirá y comenzará a descubrir sensores.

Configuración avanzada mediante YAML (opcional)

Aunque la integración por interfaz gráfica cubre la mayoría de los casos, algunos usuarios prefieren un control más fino mediante la configuración YAML. Puedes añadir manualmente la integración en tu archivo 'configuration.yaml' con parámetros adicionales como el número de inversores, la tasa de actualización o registros específicos. A continuación, se muestra un ejemplo básico:

modbus:
  - name: huawei_inverter
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia actual"
        unit_of_measurement: "W"
        slave: 1
        address: 32064
        input_type: holding
        scale: 1
        precision: 0
        data_type: uint32

En este ejemplo, se define un sensor que lee la potencia activa actual del inversor. La dirección 32064 corresponde al registro Modbus estándar para la potencia de salida en inversores Huawei. Puedes encontrar la lista completa de registros en el manual de programación del inversor. Recuerda que al usar YAML, debes reiniciar Home Assistant para que los cambios surtan efecto.

Paso 3: Visualizar los datos en el panel de energía de Home Assistant

Una vez que la integración está activa y los sensores se han creado, el siguiente paso es incorporar los datos al panel de energía de Home Assistant. Este panel ofrece una visión global del consumo y la generación de energía en tu hogar, permitiéndote ver en tiempo real cuánta electricidad produce tu instalación fotovoltaica y cómo se distribuye.

Configuración del panel de energía

Ve a 'Configuración' > 'Panel de energía' en Home Assistant. En la sección 'Generación de energía solar', haz clic en 'Añadir fuente' y selecciona el sensor de potencia generada por tu inversor Huawei. Normalmente, la integración crea un sensor llamado 'sensor.huawei_solar_power' o similar. Asígnale una entidad y un nombre descriptivo. También puedes añadir sensores de consumo si tienes medidores inteligentes. Una vez configurado, el panel mostrará gráficos de barras y líneas con la producción diaria, mensual y anual.

Creación de tarjetas personalizadas en el dashboard

Para un control más detallado, puedes añadir tarjetas personalizadas a tu dashboard de Home Assistant. Utiliza la tarjeta 'Energía' o 'Gauge' para mostrar la potencia actual, la energía total generada, o la tensión y corriente de los paneles. Por ejemplo, una tarjeta de tipo 'Gauge' con el sensor de potencia te permite ver de un vistazo si el sistema está produciendo al máximo. También puedes crear tarjetas de tipo 'Historial' para analizar tendencias a lo largo del tiempo. La integración Huawei Solar expone múltiples sensores: potencia activa, energía total, tensión de entrada, corriente, temperatura del inversor, etc. Explora las entidades disponibles y añade las que más te interesen.

Solución de problemas comunes en la conexión Modbus TCP

A pesar de seguir los pasos correctamente, pueden surgir dificultades técnicas que impidan la comunicación entre Home Assistant y el inversor Huawei. A continuación, analizamos los problemas más frecuentes y sus soluciones.

El inversor no responde a las peticiones Modbus

Este es el problema más común. Verifica primero que el inversor esté encendido y operativo. Comprueba la conectividad de red haciendo ping a la IP del inversor desde el servidor de Home Assistant. Si no hay respuesta, revisa la configuración de red del inversor: asegúrate de que la IP, máscara y puerta de enlace sean correctas. También es posible que el puerto Modbus (502) esté bloqueado por un firewall. Temporalmente, desactiva el firewall para probar la conexión. Si el problema persiste, reinicia tanto el inversor como el servidor de Home Assistant.

La integración no descubre sensores

Si la integración se añade correctamente pero no aparecen sensores, es probable que la clave Modbus sea incorrecta o que el inversor esté configurado con un ID de esclavo diferente al esperado. Revisa la clave en la aplicación FusionSolar y asegúrate de haberla introducido sin espacios. También puedes probar con el ID de esclavo 1, que es el valor por defecto para inversores Huawei. Otra posibilidad es que el inversor tenga una versión de firmware que no soporte ciertos registros; consulta el manual técnico para verificar la compatibilidad.

Tabla comparativa de modelos Huawei SUN2000 compatibles

A continuación, se presenta una tabla comparativa de los modelos más comunes de inversores Huawei SUN2000 y su compatibilidad con la integración Modbus TCP en Home Assistant. Los datos se basan en las especificaciones oficiales y la experiencia de la comunidad.

Como se observa, la mayoría de los modelos domésticos (hasta 10 kW) son totalmente compatibles con la integración oficial. Los modelos de mayor potencia pueden requerir configuración manual mediante YAML o el uso de integraciones de terceros. Siempre consulta la documentación oficial de Huawei para tu modelo específico.

Preguntas frecuentes sobre la integración Huawei SUN2000 Home Assistant

Conclusión y plan de acción recomendado

Integrar tu inversor Huawei SUN2000 en Home Assistant mediante Modbus TCP te permite monitorizar tu producción solar con un nivel de detalle y personalización que supera a las aplicaciones oficiales. Siguiendo los pasos descritos en esta guía, podrás tener tu sistema operativo en menos de una hora. Recuerda siempre priorizar la seguridad eléctrica y verificar la compatibilidad de tu modelo antes de comenzar. Una vez configurado, explora las posibilidades de automatización: por ejemplo, puedes programar alertas si la producción cae por debajo de un umbral, o activar cargas cuando haya excedente de energía.