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

La integración de inversores solares en sistemas de domótica como Home Assistant se ha convertido en una necesidad para los entusiastas de la energía solar que desean maximizar el rendimiento de sus instalaciones. GoodWe, uno de los fabricantes líderes en inversores fotovoltaicos, ofrece soporte nativo para el protocolo Modbus TCP, lo que permite una comunicación bidireccional eficiente y fiable. En esta guía exhaustiva, exploraremos cada paso necesario para conectar tu inversor GoodWe a Home Assistant, desde los requisitos de hardware hasta la creación de paneles de control personalizados. Aprenderás a configurar la integración, interpretar los datos en tiempo real y solucionar los problemas más comunes. Tanto si eres un instalador profesional como un aficionado al bricolaje solar, este artículo te proporcionará el conocimiento técnico necesario para llevar tu monitorización solar al siguiente nivel.

1. Introducción a la integración GoodWe y Home Assistant

Home Assistant se ha consolidado como la plataforma de código abierto más popular para la automatización del hogar, y su capacidad para integrarse con dispositivos energéticos es uno de sus puntos fuertes. Los inversores GoodWe, por su parte, son conocidos por su fiabilidad y eficiencia, y muchos modelos incluyen un puerto Ethernet o Wi-Fi que permite la comunicación Modbus TCP. Esta combinación ofrece una monitorización en tiempo real de la producción solar, el consumo del hogar y el estado de la batería, si está presente. La integración no solo permite visualizar datos, sino también tomar acciones automatizadas, como activar cargas cuando hay excedente solar o ajustar el consumo en función de la previsión meteorológica. A lo largo de esta guía, desglosaremos cada aspecto técnico, desde la identificación del modelo de inversor hasta la configuración avanzada de sensores en Home Assistant. El objetivo es que cualquier usuario con conocimientos básicos de redes y domótica pueda completar la integración con éxito.

2. Requisitos previos y preparación del inversor

Antes de comenzar, es fundamental asegurarse de que el inversor GoodWe sea compatible con Modbus TCP. La mayoría de los modelos de las series BT, DT, ES, EH, ET, BH y BP fabricados a partir de 2018 incluyen esta funcionalidad. Para verificarlo, consulta la etiqueta del inversor o el manual de usuario. Además, necesitarás una conexión de red estable entre el inversor y el equipo donde se ejecuta Home Assistant. El inversor debe estar conectado a la misma red local (LAN) mediante cable Ethernet o, en algunos modelos, mediante Wi-Fi. Si utilizas Wi-Fi, asegúrate de que la señal sea fuerte y estable, ya que las desconexiones pueden provocar pérdida de datos. También es recomendable asignar una dirección IP fija al inversor a través del router para evitar que cambie con el tiempo. Para ello, accede a la configuración del router, localiza la IP del inversor en la lista de dispositivos conectados y asígnale una reserva DHCP. Anota la dirección IP, el puerto Modbus (por defecto 502) y la dirección del dispositivo (por defecto 1). Estos datos serán necesarios para la configuración en Home Assistant.

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

Home Assistant incluye una integración nativa para Modbus que permite conectarse a dispositivos mediante TCP. Para configurarla, sigue estos pasos:

3.1. Instalación de la integración Modbus

Ve a 'Configuración' > 'Dispositivos y servicios' > 'Añadir integración' y busca 'Modbus'. Selecciona la integración y elige 'Modbus TCP'. Introduce la dirección IP del inversor, el puerto (502) y la dirección del dispositivo (1). Puedes dejar el resto de opciones por defecto. Haz clic en 'Enviar' y la integración se añadirá. Si todo está correcto, verás un mensaje de éxito. A continuación, deberás configurar los sensores para leer los registros Modbus específicos de GoodWe.

3.2. Configuración de sensores mediante YAML

Aunque la integración Modbus permite configurar sensores desde la interfaz gráfica, la forma más completa y flexible es mediante la edición del archivo 'configuration.yaml'. Abre el archivo con el editor de texto de Home Assistant (o mediante Samba/SCP) y añade la siguiente configuración, adaptándola a tu modelo de inversor. A continuación se muestra un ejemplo para un inversor GoodWe monofásico con batería:

modbus:
  - name: goodwe
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia actual"
        unit_of_measurement: "W"
        slave: 1
        address: 35152
        input_type: holding
        data_type: uint32
        scale: 1
        precision: 0
      - name: "Energía total generada"
        unit_of_measurement: "kWh"
        slave: 1
        address: 35154
        input_type: holding
        data_type: uint32
        scale: 0.1
        precision: 1
      - name: "Tensión panel 1"
        unit_of_measurement: "V"
        slave: 1
        address: 35160
        input_type: holding
        data_type: uint16
        scale: 0.1
        precision: 1

Es importante conocer los registros Modbus específicos de tu modelo. GoodWe publica un mapa de registros (Modbus map) que puedes solicitar al fabricante o encontrar en foros especializados. Los registros más comunes incluyen potencia actual, energía total, tensión y corriente de cada string, temperatura del inversor, estado de la batería, etc. Una vez editado el archivo, reinicia Home Assistant para que los cambios surtan efecto. Si los sensores aparecen en 'Estados' con valores, la configuración es correcta.

4. Creación de un dashboard de monitorización solar

Una vez que los sensores están funcionando, el siguiente paso es crear un panel de control atractivo y funcional. Home Assistant permite diseñar dashboards personalizados con tarjetas que muestran gráficos, indicadores y datos en tiempo real. A continuación, se presenta un ejemplo de cómo estructurar un dashboard para monitorizar tu inversor GoodWe.

Para crear el dashboard, ve a 'Panel lateral' > 'Paneles' y crea un nuevo panel. Añade las tarjetas arrastrando los sensores desde el selector de entidades. Personaliza los colores, iconos y nombres para que se adapten a tu estilo. Puedes usar el modo 'YAML' para un control más fino. Por ejemplo, una tarjeta de sensor personalizada podría verse así:

type: sensor
entity: sensor.potencia_actual
name: Potencia Solar
unit: W
icon: mdi:solar-power
state_color: true

5. Automatizaciones avanzadas con datos solares

Una de las mayores ventajas de integrar el inversor en Home Assistant es la posibilidad de crear automatizaciones inteligentes. Por ejemplo, puedes programar que un calentador eléctrico se encienda cuando haya excedente solar, o que las baterías se carguen solo durante las horas de tarifa baja. A continuación, se muestran dos ejemplos prácticos.

5.1. Encendido de carga excedentaria

Supongamos que tienes un termo eléctrico y quieres que se encienda cuando la producción solar supere los 2000 W. Crea una automatización con el siguiente disparo y acción:

• Disparo: Sensor de potencia actual supera 2000 W.
• Acción: Encender el termo mediante un relé inteligente o interruptor.
• Condición: La temperatura del termo es inferior a 60°C.

De esta forma, aprovechas la energía solar sin desperdiciarla, reduciendo tu factura eléctrica.

5.2. Gestión de batería según tarifa

Si tienes una batería GoodWe, puedes programar su carga durante las horas de tarifa baja (valle) y su descarga durante las horas punta. Para ello, necesitas un sensor de tarifa eléctrica (por ejemplo, integración con la API de tu compañía) y crear una automatización que ajuste el modo de funcionamiento del inversor. Algunos modelos GoodWe permiten cambiar el modo de operación mediante registros Modbus de escritura. Por ejemplo, el registro 35171 (Modo de funcionamiento) puede escribirse con valores como 0 (Autoconsumo), 1 (Batería primero), etc. Consulta el mapa de registros de tu modelo para más detalles.

6. Solución de problemas comunes

Durante la integración, pueden surgir varios problemas. Aquí se presentan los más frecuentes y cómo resolverlos.

Si después de verificar todo sigues teniendo problemas, prueba a usar una herramienta como 'Modbus Poll' (Windows) o 'mbpoll' (Linux) para leer los registros directamente desde tu PC. Esto te permitirá confirmar que el inversor responde correctamente y que los registros son los adecuados.

7. Preguntas frecuentes (FAQ)

8. Conclusiones y próximos pasos

La integración de un inversor solar GoodWe en Home Assistant mediante Modbus TCP es un proceso accesible que ofrece un control y monitorización sin precedentes sobre tu sistema fotovoltaico. Hemos recorrido desde la configuración inicial del inversor hasta la creación de automatizaciones inteligentes que optimizan el autoconsumo. Con los datos en tiempo real, puedes tomar decisiones informadas sobre tu consumo energético, reducir tu factura y contribuir a un hogar más sostenible. Los próximos pasos incluyen explorar integraciones con servicios meteorológicos para predecir la producción, o con sistemas de gestión de energía como Tesla Powerwall. La comunidad de Home Assistant es activa y constantemente surgen nuevas formas de aprovechar los datos. Te animamos a experimentar y compartir tus descubrimientos. Recuerda que la clave está en la personalización: cada instalación es única, y con las herramientas adecuadas, puedes adaptar la monitorización a tus necesidades específicas.