Cómo integrar un inversor solar GoodWe con batería Pylontech en Home Assistant: Monitorización avanzada y automatización

La integración de un inversor solar GoodWe con baterías Pylontech en Home Assistant se ha convertido en una de las configuraciones más demandadas por los entusiastas de la energía solar y la domótica. Esta combinación permite no solo monitorizar en tiempo real la producción, el consumo y el estado de las baterías, sino también automatizar el uso de la energía en función de las tarifas eléctricas, la previsión meteorológica o las necesidades del hogar. En esta guía exhaustiva, exploraremos desde los conceptos técnicos fundamentales hasta la implementación práctica, incluyendo ejemplos de configuración, tablas comparativas y solución de problemas. Si estás buscando sacar el máximo partido a tu instalación fotovoltaica, has llegado al lugar adecuado.

Introducción a la integración GoodWe Pylontech Home Assistant

La integración de un inversor GoodWe con baterías Pylontech en Home Assistant es un proyecto que combina hardware y software para lograr un control total sobre la energía solar. GoodWe es uno de los fabricantes de inversores más reconocidos a nivel mundial, con una amplia gama de modelos híbridos que permiten la conexión de baterías de litio. Pylontech, por su parte, es un fabricante líder de baterías LiFePO4, conocidas por su fiabilidad y relación calidad-precio. La combinación de ambos es habitual en instalaciones residenciales y comerciales de pequeña escala.

Home Assistant, la plataforma de domótica de código abierto, ofrece múltiples vías para integrar estos dispositivos. Desde integraciones nativas hasta soluciones personalizadas mediante Modbus TCP, pasando por el uso de pasarelas como SolarMAN o SEMS Portal. El objetivo final es obtener una monitorización avanzada y la capacidad de automatizar el consumo energético. Esto permite, por ejemplo, cargar las baterías cuando la tarifa eléctrica es más barata, descargarlas en horas punta, o incluso vender excedentes a la red en el momento óptimo.

A lo largo de este artículo, detallaremos los pasos para lograr una integración robusta, los errores más comunes, y cómo evitar problemas de seguridad eléctrica. Además, presentaremos una comparativa de los métodos de integración disponibles, con sus ventajas y desventajas, para que puedas elegir el que mejor se adapte a tu instalación.

Análisis técnico y conceptos fundamentales

Antes de sumergirnos en la configuración, es crucial comprender los principios técnicos que rigen la comunicación entre el inversor GoodWe, las baterías Pylontech y Home Assistant. Esta base teórica nos permitirá tomar decisiones informadas y solucionar problemas con mayor eficacia.

Protocolos de comunicación: Modbus TCP vs. API en la nube

Los inversores GoodWe ofrecen varios métodos para acceder a sus datos. El más directo es el protocolo Modbus TCP, que permite leer y escribir registros internos del inversor a través de la red local. Este método es rápido, fiable y no depende de servicios en la nube, lo que garantiza la privacidad y la disponibilidad incluso sin conexión a internet. La mayoría de los modelos GoodWe (como la serie ET, EH, BT, etc.) exponen un servidor Modbus TCP en el puerto 502. Para utilizarlo, necesitamos conocer la dirección IP del inversor y una lista de registros (direcciones Modbus) que contienen la información de interés: potencia generada, estado de carga de la batería, consumo de la casa, etc.

Por otro lado, GoodWe también ofrece una API en la nube a través de su plataforma SEMS Portal. Esta API permite obtener datos de forma remota, pero introduce latencia y dependencia de internet. Además, la frecuencia de actualización suele ser limitada (cada 5-10 minutos), lo que no es ideal para automatizaciones en tiempo real. Sin embargo, para aquellos que no tengan acceso directo al inversor o prefieran no abrir puertos, puede ser una alternativa válida.

En el caso de las baterías Pylontech, la comunicación con el inversor se realiza a través del protocolo CAN o RS485. El inversor GoodWe actúa como maestro y solicita información a las baterías (estado de carga, voltaje, corriente, temperatura, etc.) y a su vez, esta información se refleja en los registros Modbus del inversor. Por lo tanto, al leer los registros del inversor, obtenemos también los datos de las baterías. No es necesario conectar directamente las Pylontech a Home Assistant, aunque existen integraciones específicas para ellas si se desea un control más granular.

Arquitectura de la integración en Home Assistant

Home Assistant puede integrarse con el inversor GoodWe de varias formas. La más común es mediante la integración personalizada 'goodwe' disponible a través de HACS (Home Assistant Community Store). Esta integración utiliza Modbus TCP para leer los registros del inversor y crear entidades (sensores) en Home Assistant. Otra opción es utilizar el componente nativo 'modbus' de Home Assistant, que permite definir manualmente los registros a leer. Esta segunda opción es más flexible pero requiere un mayor conocimiento técnico.

Además, existen integraciones para las baterías Pylontech, como 'pylontech' o 'pylontech_serial', que se conectan directamente al BMS de la batería mediante un adaptador USB-RS485. Esta opción proporciona datos más detallados, como el voltaje de cada celda, pero implica una conexión física adicional. En la mayoría de los casos, la información proporcionada por el inversor es suficiente para monitorizar y automatizar.

Es importante destacar que la integración con Home Assistant no solo se limita a la monitorización. Podemos crear automatizaciones que actúen sobre el inversor, como forzar la carga de la batería en determinados momentos, limitar la exportación a la red, o cambiar el modo de operación (por ejemplo, de 'autoconsumo' a 'respaldo'). Esto se logra escribiendo en registros Modbus específicos, siempre con precaución y siguiendo las especificaciones del fabricante.

Requisitos previos y hardware necesario

Antes de comenzar, asegúrate de contar con los siguientes elementos:

• Inversor GoodWe: Compatible con Modbus TCP. Modelos como GW5000-EH, GW10K-ET, etc. Consulta la documentación de tu modelo para confirmar.
• Baterías Pylontech: Conectadas al inversor mediante cable CAN o RS485. Asegúrate de que la configuración de las baterías esté correcta (direcciones, protocolo).
• Home Assistant: Instalado en un dispositivo (Raspberry Pi, mini PC, etc.) con acceso a la red local.
• Red local: Conexión Ethernet o Wi-Fi entre el inversor y Home Assistant. Se recomienda cable Ethernet para mayor estabilidad.
• HACS (opcional): Para instalar la integración personalizada de GoodWe.

Guía de instalación y configuración paso a paso

Una vez comprendidos los conceptos básicos, procederemos a la instalación y configuración práctica. Dividiremos el proceso en varias etapas: preparación de la red, instalación de la integración en Home Assistant, configuración de los sensores y creación de automatizaciones.

Paso 1: Preparación de la red y acceso al inversor

El primer paso es asegurar que el inversor GoodWe esté conectado a la red local y que podamos acceder a él mediante Modbus TCP. Para ello, necesitamos conocer su dirección IP. Esta se puede obtener desde el router (lista de dispositivos conectados) o mediante la aplicación móvil de GoodWe (SEMS Portal) que muestra la IP en la configuración de red. También podemos usar un escáner de red como Fing o nmap.

Una vez tengamos la IP, verificaremos que el puerto 502 (Modbus TCP) esté abierto. Podemos usar la herramienta 'telnet' o 'nc' desde otro ordenador: telnet 192.168.1.100 502. Si la conexión se establece, el puerto está accesible. Si no, puede que el inversor tenga el Modbus deshabilitado o que haya un firewall. En algunos modelos, es necesario habilitar el Modbus TCP desde el menú de configuración del inversor (normalmente en 'Configuración avanzada' > 'Comunicación').

Es recomendable asignar una IP estática al inversor desde el router DHCP para evitar que cambie y rompa la integración. También se sugiere crear una VLAN o segmento de red separado para dispositivos IoT, aunque esto es opcional.

Paso 2: Instalación de la integración GoodWe en Home Assistant

Existen dos métodos principales: usar la integración personalizada de HACS o configurar el componente Modbus manualmente. Recomendamos la integración de HACS por su facilidad y actualizaciones.

Para instalar la integración GoodWe desde HACS:

1. Abre Home Assistant y ve a HACS > Integraciones.
2. Haz clic en 'Explorar y descargar repositorios'.
3. Busca 'GoodWe' y selecciona la integración 'goodwe' (desarrollada por mletenay o similar).
4. Instala la integración y reinicia Home Assistant.
5. Ve a Configuración > Dispositivos y Servicios > Añadir integración.
6. Busca 'GoodWe' y selecciona. Ingresa la IP del inversor y el puerto (502).
7. La integración detectará el modelo y creará las entidades correspondientes.

Si prefieres la configuración manual con Modbus, deberás editar el archivo 'configuration.yaml' y añadir una sección 'modbus' con los registros específicos. Este método requiere conocer las direcciones Modbus de tu modelo, que puedes encontrar en la documentación técnica de GoodWe o en foros especializados. Por ejemplo:

modbus:
  - name: GoodWe
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: Potencia Solar
        slave: 1
        address: 35103
        input_type: input
        count: 2
        data_type: uint32
        unit_of_measurement: W
        scale: 1
        precision: 0

Este ejemplo lee la potencia solar del inversor. Deberás repetir para cada sensor que desees. La ventaja de la integración HACS es que ya incluye muchos sensores predefinidos.

Paso 3: Configuración de sensores y entidades

Una vez instalada la integración, se crearán automáticamente varias entidades. Las más importantes son:

• sensor.goodwe_pv_power: Potencia instantánea generada por los paneles solares.
• sensor.goodwe_battery_soc: Estado de carga de la batería (porcentaje).
• sensor.goodwe_battery_power: Potencia de carga/descarga de la batería (positivo carga, negativo descarga).
• sensor.goodwe_load_power: Potencia consumida por la vivienda.
• sensor.goodwe_grid_power: Potencia importada/exportada de la red (positivo importación, negativo exportación).

Además, podemos crear sensores personalizados utilizando plantillas (template) para calcular valores derivados, como el autoconsumo instantáneo o la energía acumulada. Por ejemplo, para calcular la energía solar generada diaria, podemos usar el sensor de potencia y la integración de Riemann sum:

sensor:
  - platform: integration
    source: sensor.goodwe_pv_power
    name: Energía Solar Diaria
    unit_prefix: k
    round: 2

Este sensor acumulará la energía en kWh.

Paso 4: Automatizaciones avanzadas

La verdadera potencia de Home Assistant reside en las automatizaciones. Con los datos del inversor y las baterías, podemos crear rutinas que optimicen el consumo energético. Algunos ejemplos:

Para implementar estas automatizaciones, utilizaremos el editor visual de automatizaciones de Home Assistant o el archivo 'automations.yaml'. Es fundamental conocer los registros Modbus de escritura para cambiar el modo de operación. En los inversores GoodWe, el registro 47511 (holding register) controla el modo de operación (0: Auto, 1: Forced Charge, 2: Forced Discharge, etc.). Siempre debemos consultar el manual de nuestro modelo específico.

Errores comunes, limitaciones y seguridad eléctrica

A pesar de los beneficios, la integración de GoodWe y Pylontech en Home Assistant presenta desafíos. A continuación, detallamos los errores más frecuentes y cómo evitarlos.

Problemas de conectividad

El error más común es no poder conectar con el inversor. Esto puede deberse a:

• IP incorrecta: Verifica la IP del inversor. Puede haber cambiado si no tiene IP estática.
• Puerto bloqueado: Algunos routers bloquean el puerto 502 por seguridad. Asegúrate de que no haya firewall.
• Modbus deshabilitado: En algunos modelos, el Modbus TCP viene desactivado de fábrica. Actívalo desde el menú del inversor.
• Versión de firmware: Algunas versiones antiguas tienen bugs en Modbus. Actualiza el firmware del inversor a la última versión.

Incompatibilidades y limitaciones

No todos los inversores GoodWe son compatibles con Pylontech. Es crucial verificar la lista de baterías compatibles en el manual del inversor. Además, la integración con Home Assistant puede no exponer todos los registros disponibles. En algunos casos, ciertos sensores no se actualizan con la frecuencia deseada. La integración HACS suele tener un intervalo de actualización de 10-30 segundos, lo cual es suficiente para la mayoría de los casos, pero no para control en tiempo real.

Otra limitación es que la escritura en registros Modbus para controlar el inversor no está soportada por todas las integraciones. La integración HACS de GoodWe se centra en la lectura. Para escribir, es posible que necesitemos usar el componente Modbus directamente o desarrollar scripts personalizados.

Seguridad eléctrica y normativa

La seguridad es primordial. Nunca manipules el inversor o las baterías sin seguir las instrucciones del fabricante y las normativas locales (REBT en España, por ejemplo). Algunos aspectos clave:

• Protecciones eléctricas: Asegúrate de que la instalación cuenta con las protecciones adecuadas (diferencial, magnetotérmico, sobretensiones).
• Conexión de baterías: Las Pylontech deben conectarse con cables de sección adecuada y terminales bien apretados. Sigue el diagrama del fabricante.