Cómo integrar un inversor solar Growatt en Home Assistant con Modbus TCP: 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. En este artículo, te mostramos cómo integrar un inversor solar Growatt en Home Assistant mediante el protocolo Modbus TCP, una solución robusta y de código abierto que te permitirá visualizar y controlar tus datos de generación eléctrica sin depender de servicios en la nube. Aprenderás paso a paso desde la configuración inicial hasta la creación de sensores personalizados, con ejemplos prácticos y advertencias importantes para evitar errores comunes.

Introducción a la monitorización solar con Growatt y Home Assistant

Los inversores Growatt son ampliamente utilizados en instalaciones solares residenciales y comerciales debido a su eficiencia y fiabilidad. Sin embargo, su plataforma de monitoreo en la nube, aunque útil, puede presentar limitaciones en cuanto a la personalización y la integración con otros sistemas domóticos. Home Assistant, por otro lado, es un centro de automatización del hogar de código abierto que permite centralizar todos tus dispositivos en una única interfaz. Al combinar ambos mediante Modbus TCP, obtienes acceso directo a los registros del inversor, lo que te permite crear paneles de control personalizados, alertas y automatizaciones avanzadas.

Modbus es un protocolo de comunicación industrial ampliamente adoptado. En el caso de Growatt, la mayoría de los modelos modernos soportan Modbus TCP a través de su puerto Ethernet o Wi-Fi. Esto significa que puedes leer y escribir registros en el inversor de forma local, sin necesidad de conexión a internet. En esta guía, nos centraremos en la configuración necesaria para que Home Assistant se comunique con tu inversor Growatt utilizando el protocolo Modbus TCP.

Requisitos previos y consideraciones de seguridad

Antes de comenzar, es fundamental asegurarse de que tu inversor Growatt tenga habilitado el protocolo Modbus TCP. No todos los modelos lo incluyen de fábrica; algunos requieren una actualización de firmware o la activación manual a través de la pantalla del inversor. Consulta el manual de tu modelo específico o contacta con el soporte técnico de Growatt para confirmar esta funcionalidad.

Además, necesitarás tener Home Assistant instalado y funcionando, ya sea en una Raspberry Pi, un servidor dedicado o una máquina virtual. Asegúrate de tener acceso de administrador para poder editar los archivos de configuración y reiniciar el sistema cuando sea necesario.

Paso 1: Identificar la dirección IP y el puerto Modbus de tu inversor

El primer paso es conocer la dirección IP de tu inversor Growatt en tu red local. Puedes obtenerla desde el router o mediante la aplicación móvil de Growatt. Normalmente, el inversor usa el puerto 502 para Modbus TCP, que es el estándar. Sin embargo, algunos modelos pueden usar un puerto diferente, así que verifica en la documentación técnica.

Para probar la conectividad, puedes usar una herramienta como ping desde tu ordenador o desde Home Assistant. Si el inversor responde, estás listo para continuar. También puedes usar un escáner de puertos para confirmar que el puerto 502 está abierto.

Paso 2: Configurar la integración Modbus en Home Assistant

Home Assistant incluye una integración nativa para Modbus que puedes configurar fácilmente a través de la interfaz de usuario o mediante archivos YAML. Para una configuración más avanzada y personalizable, recomendamos usar la configuración por YAML, ya que te permite definir múltiples sensores y controles de manera precisa.

Primero, asegúrate de que la integración Modbus esté habilitada en tu configuración. Ve a Configuración > Dispositivos y servicios y busca 'Modbus'. Si no aparece, puedes añadirla manualmente editando el archivo configuration.yaml.

Configuración básica en configuration.yaml

A continuación, te mostramos un ejemplo de configuración mínima para conectar con tu inversor Growatt. Deberás reemplazar la IP y el puerto con los datos de tu dispositivo.

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

En este ejemplo, hemos definido un sensor llamado 'Potencia actual' que lee el registro en la dirección 1, con un tipo de dato de 32 bits sin signo. La escala y la precisión ajustan el valor para mostrarlo correctamente. Sin embargo, para obtener una monitorización completa, necesitarás conocer los registros específicos de tu modelo de inversor Growatt.

Paso 3: Conocer los registros Modbus de Growatt

Cada inversor Growatt tiene un mapa de registros Modbus específico que define las direcciones de los diferentes parámetros, como potencia, voltaje, corriente, energía total, temperatura, etc. Este mapa se encuentra en el manual de usuario o en la documentación técnica proporcionada por el fabricante. Es crucial obtener esta información para configurar correctamente los sensores.

Por ejemplo, en muchos modelos de la serie MIN, los registros suelen comenzar en la dirección 0 o 1. Algunos parámetros comunes son:

• Potencia activa (W): Dirección típica 1, tipo uint32, escala 1.
• Energía total (kWh): Dirección típica 2, tipo uint32, escala 0.1.
• Temperatura (ºC): Dirección típica 3, tipo int16, escala 0.1.

Es importante verificar el tipo de dato y la escala, ya que un error en estos parámetros puede dar lecturas incorrectas. Te recomendamos consultar el foro de la comunidad de Home Assistant, donde otros usuarios suelen compartir los mapas de registros para diferentes modelos de Growatt.

Paso 4: Crear sensores personalizados para Growatt

Una vez que tengas el mapa de registros, puedes ampliar la configuración en configuration.yaml para añadir todos los sensores que necesites. A continuación, te mostramos un ejemplo más completo con varios sensores típicos.

modbus:
  - name: growatt
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia actual"
        unit_of_measurement: "W"
        address: 1
        input_type: holding
        data_type: uint32
        scale: 1
        precision: 0
      - name: "Energía total"
        unit_of_measurement: "kWh"
        address: 2
        input_type: holding
        data_type: uint32
        scale: 0.1
        precision: 1
      - name: "Temperatura del inversor"
        unit_of_measurement: "°C"
        address: 3
        input_type: holding
        data_type: int16
        scale: 0.1
        precision: 1
      - name: "Voltaje de entrada DC"
        unit_of_measurement: "V"
        address: 4
        input_type: holding
        data_type: uint16
        scale: 0.1
        precision: 1

Después de editar el archivo, guarda los cambios y reinicia Home Assistant. Si la configuración es correcta, verás los nuevos sensores en el panel de estado. Puedes comprobarlo yendo a Desarrollador > Estados y buscando el nombre de tus sensores.

Paso 5: Añadir sensores a la interfaz de usuario

Una vez que los sensores están disponibles, puedes añadirlos a tu panel de control (Lovelace) para visualizarlos de forma atractiva. Puedes crear tarjetas de tipo 'Sensor' o 'Gauge' para mostrar la potencia actual, la energía total, etc. Además, puedes configurar tarjetas de 'Historia' para ver la evolución a lo largo del tiempo.

Por ejemplo, para añadir un sensor de potencia, ve a tu panel de control, haz clic en el icono de edición (lápiz) y añade una nueva tarjeta. Selecciona 'Sensor' y elige la entidad correspondiente. Personaliza el icono y el nombre según tus preferencias.

Paso 6: Crear automatizaciones y alertas

Una de las ventajas de integrar tu inversor en Home Assistant es la posibilidad de crear automatizaciones. Por ejemplo, puedes configurar una alerta cuando la potencia generada supere un umbral, o cuando el inversor esté fuera de línea. También puedes combinar los datos del inversor con otros sensores, como el consumo del hogar, para optimizar el uso de energía.

Para crear una automatización, ve a Configuración > Automatizaciones y crea una nueva. Por ejemplo, una automatización que envíe una notificación si la potencia cae a cero durante el día podría ser útil para detectar fallos.

Errores comunes y solución de problemas

A pesar de seguir los pasos correctamente, pueden surgir problemas. A continuación, te presentamos los errores más comunes y cómo solucionarlos.

Otro error común es usar una dirección de registro incorrecta o un tipo de dato equivocado. Esto puede provocar lecturas absurdas o valores negativos. Consulta el mapa de registros específico de tu modelo y prueba con diferentes direcciones si es necesario.

Comparativa de métodos de integración: Modbus TCP vs. API en la nube

Existen varias formas de obtener datos de tu inversor Growatt. La más común es utilizar la API en la nube de Growatt, pero tiene limitaciones. A continuación, comparamos ambas opciones.

Como se observa, Modbus TCP ofrece ventajas significativas en términos de velocidad, privacidad y flexibilidad. Por ello, es la opción recomendada para usuarios avanzados que desean un control total sobre sus datos.

Preguntas frecuentes sobre Growatt y Modbus TCP

Conclusión y recomendaciones finales

Integrar tu inversor solar Growatt con Home Assistant mediante Modbus TCP es una excelente manera de obtener un control total sobre tu sistema de energía solar. A lo largo de esta guía, hemos cubierto los pasos esenciales, desde la configuración inicial hasta la creación de automatizaciones. Hemos destacado la importancia de conocer los registros Modbus de tu modelo y de seguir las prácticas de seguridad recomendadas.

Esperamos que esta guía te haya sido de utilidad. Si tienes más preguntas, explora los recursos adicionales y comparte tus experiencias en los foros. ¡Buena suerte con tu proyecto de energía solar!