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

La integración de un inversor solar Kostal en Home Assistant mediante Modbus TCP se ha convertido en una de las prácticas más demandadas por los entusiastas de la domótica y la eficiencia energética. A diferencia de otras marcas que limitan el acceso a los datos, Kostal ofrece un protocolo Modbus TCP robusto y documentado que permite extraer métricas en tiempo real de generación, consumo, exportación e importación. En esta guía exhaustiva, exploraremos desde los conceptos fundamentales del protocolo hasta la implementación práctica en Home Assistant, incluyendo la configuración del archivo YAML, la definición de sensores, la creación de automatizaciones y la resolución de errores comunes. Si posees un inversor Kostal Plenticore, Piko o incluso los modelos más antiguos con interfaz Modbus, este artículo te proporcionará todo el conocimiento necesario para transformar tu sistema solar en una fuente de datos inteligente y accionable.

1. Fundamentos del protocolo Modbus TCP en inversores Kostal

Antes de sumergirnos en la configuración, es crucial comprender qué es Modbus TCP y por qué Kostal lo implementa en sus inversores. Modbus es un protocolo de comunicación industrial creado en 1979 por Modicon, que ha perdurado gracias a su simplicidad y robustez. En su variante TCP, utiliza el puerto 502 por defecto y permite la lectura y escritura de registros (coils, discrete inputs, holding registers, input registers) a través de una red Ethernet. Los inversores Kostal, especialmente la serie Plenticore Plus y los modelos de la gama Piko, exponen una gran cantidad de datos a través de este protocolo, lo que los convierte en candidatos ideales para su integración en sistemas de monitorización como Home Assistant.

La arquitectura típica de comunicación implica que Home Assistant actúe como maestro Modbus, consultando periódicamente los registros del inversor (esclavo). Esto permite obtener valores como la potencia instantánea de generación, la energía total producida, la tensión de las cadenas fotovoltaicas, la temperatura del inversor, el estado de la batería (si está presente) y muchos otros parámetros. Es importante destacar que Kostal ofrece documentación oficial con el mapa de registros Modbus, que varía ligeramente entre modelos. Por ejemplo, el Plenticore Plus utiliza un conjunto de registros diferente al Piko MP Plus. Conocer esta distinción es esencial para una integración exitosa.

1.1. Ventajas de Modbus TCP frente a otras alternativas

A diferencia de las API en la nube, que dependen de la conexión a Internet y de los servidores del fabricante, Modbus TCP opera completamente en la red local. Esto garantiza una latencia mínima, mayor privacidad y la capacidad de seguir monitorizando incluso si la conexión a Internet falla. Además, al ser un protocolo estándar, Home Assistant puede consultarlo sin necesidad de complementos propietarios, utilizando la integración Modbus nativa. Otras alternativas como SunSpec o las integraciones personalizadas de HACS también son válidas, pero Modbus TCP ofrece un control granular y una fiabilidad probada.

2. Requisitos previos y preparación del entorno

Para llevar a cabo esta integración necesitarás una serie de elementos tanto hardware como software. En el lado hardware, es imprescindible que el inversor Kostal esté conectado a tu red local mediante cable Ethernet. Aunque algunos modelos disponen de Wi-Fi, la conexión por cable es mucho más estable para consultas Modbus frecuentes. También necesitarás un servidor donde se ejecute Home Assistant, ya sea una Raspberry Pi, un mini PC, un servidor NAS o una máquina virtual. Asegúrate de que ambos dispositivos estén en la misma subred o que exista enrutamiento adecuado entre ellos.

En cuanto al software, necesitas Home Assistant versión 2023.1 o superior, ya que la integración Modbus ha recibido mejoras significativas en los últimos años. No se requiere instalar complementos adicionales, ya que la plataforma Modbus es nativa. Sin embargo, para una gestión más sencilla, puedes utilizar el archivo configuration.yaml o, preferiblemente, un archivo independiente (por ejemplo, kostal_modbus.yaml) e incluirlo mediante la directiva !include. También es recomendable tener acceso a la documentación oficial de registros Modbus de Kostal para tu modelo específico, que puedes descargar desde su sitio web.

2.1. Configuración de red del inversor Kostal

El primer paso práctico es asegurar que el inversor tenga una dirección IP fija o una reserva DHCP en tu router. Esto evitará que la IP cambie y Home Assistant pierda la conexión. Accede a la interfaz web del inversor (normalmente escribiendo su IP en el navegador) y navega hasta la configuración de red. Allí podrás establecer una IP estática o, si lo prefieres, anotar la dirección MAC para configurar una reserva en tu servidor DHCP. Una vez hecho esto, verifica la conectividad haciendo ping desde el servidor de Home Assistant hacia la IP del inversor.

Además, es fundamental habilitar el servidor Modbus TCP en el inversor. En los modelos Plenticore, esta opción se encuentra en el menú 'Configuración' > 'Comunicación' > 'Modbus'. Debes activar la opción 'Servidor Modbus TCP' y asegurarte de que el puerto sea 502 (o el que hayas definido). Algunos modelos permiten establecer un ID de unidad (Unit ID), que normalmente es 71 para Kostal, pero consulta el manual. Si tu inversor es un Piko, el procedimiento puede variar ligeramente; en ese caso, revisa la guía específica.

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

Una vez preparado el entorno, es momento de editar la configuración de Home Assistant. La integración Modbus se define en el archivo configuration.yaml o en un archivo separado que luego se incluye. A continuación, presentamos un ejemplo completo de configuración para un inversor Kostal Plenticore Plus. Ten en cuenta que los registros pueden variar según el modelo, por lo que deberás ajustarlos según la documentación oficial.

El bloque principal de configuración incluye la definición del hub Modbus, donde se especifica el tipo (tcp), la dirección IP del inversor, el puerto (502), el tiempo de espera y el retardo entre consultas. Luego, se definen los sensores individuales, cada uno con su dirección de registro, tipo de dato, factor de escala y unidad. Es crucial respetar los tipos de datos (int16, uint16, int32, uint32, float32) y el orden de los bytes (big-endian o little-endian) según lo indique Kostal. Un error común es asumir que todos los registros son de 16 bits; algunos valores de energía requieren 32 bits y, por tanto, ocupan dos registros.

3.1. Ejemplo de configuración YAML para sensores clave

A continuación, se muestra un fragmento de configuración para los sensores más relevantes: potencia de generación, energía total, temperatura y estado. Recuerda que las direcciones de registro deben verificarse con la documentación de tu modelo. Para el Plenticore Plus, la potencia de generación se encuentra en el registro 582 (uint32, factor 0.1), la energía total en el 512 (uint32, factor 0.1), la temperatura en el 98 (int16, factor 0.1) y el estado en el 56 (uint16, sin factor).

La estructura YAML sería la siguiente: primero definimos el hub con 'modbus:' y luego una lista de 'sensors'. Cada sensor requiere un nombre único, la dirección de esclavo (unit_id, normalmente 71), el tipo de dato, la dirección del registro, el número de registros (count), el factor de escala (scale) y la precisión (precision). También podemos definir 'device_class' y 'state_class' para que Home Assistant los reconozca correctamente y los integre en el panel de energía. Por ejemplo, para la potencia, usaríamos device_class: power y state_class: measurement; para la energía, device_class: energy y state_class: total_increasing.

4. Guía paso a paso para la integración completa

Ahora que conocemos los fundamentos y la configuración básica, vamos a detallar el proceso completo desde cero. Sigue estos pasos meticulosamente para asegurar una integración exitosa.

Cada uno de estos pasos es fundamental. Presta especial atención al paso 3, ya que una mala configuración del YAML es la causa más común de fallos. Si encuentras errores, revisa la indentación y los tipos de datos. Una vez que los sensores estén funcionando, podrás disfrutar de una monitorización completa y en tiempo real.

4.1. Ejemplo de automatización para maximizar autoconsumo

Con los sensores ya integrados, podemos crear automatizaciones que aprovechen la energía solar excedente. Por ejemplo, encender un termo eléctrico o cargar un vehículo eléctrico cuando la potencia de generación supere un umbral y la batería esté llena. A continuación, se muestra un ejemplo de automatización en YAML que activa un interruptor cuando la potencia de exportación supera los 1500 W durante 5 minutos.

La automatización utiliza el trigger de tipo 'numeric_state' sobre el sensor de potencia de exportación, con condiciones de tiempo y estado de batería. Al activarse, enciende un interruptor (por ejemplo, una bomba de calor) y envía una notificación. Esta es solo una muestra del potencial que ofrece la integración. Combinando múltiples sensores y automatizaciones, puedes reducir significativamente tu factura eléctrica.

5. Errores comunes, limitaciones y seguridad

A pesar de la robustez de Modbus TCP, existen varios errores que los usuarios noveles suelen cometer. El más frecuente es la incorrecta interpretación de los registros: confundir registros de 16 bits con 32 bits, o no aplicar el factor de escala adecuado. Esto resulta en valores absurdos, como potencias de 65535 W o energías negativas. Otro error común es no ajustar el 'unit_id' correcto; para Kostal suele ser 71, pero en algunos modelos es 1. Verifica siempre la documentación.

Otra limitación importante es la frecuencia de sondeo. Modbus TCP no está diseñado para consultas de alta frecuencia; un intervalo de 5 a 10 segundos es suficiente para monitorización solar. Si se consulta demasiado rápido, el inversor puede bloquear la comunicación o devolver errores. Además, algunos inversores Kostal limitan el número de conexiones simultáneas, por lo que no es recomendable tener múltiples maestros Modbus (por ejemplo, Home Assistant y otro sistema) consultando al mismo tiempo.

En cuanto a la seguridad, es recomendable aislar la red de los inversores en una VLAN separada, especialmente si se exponen a Internet. Modbus TCP no tiene autenticación ni cifrado, por lo que cualquier persona con acceso a la red podría leer los datos. Si necesitas acceso remoto, utiliza una VPN en lugar de abrir puertos.

6. Tabla comparativa de métodos de integración

Existen varias formas de integrar un inversor Kostal en Home Assistant. Además de Modbus TCP, podemos encontrar la integración oficial de Kostal (a través de la nube), el uso de SunSpec (que es un subconjunto de Modbus) o incluso integraciones personalizadas de HACS. La siguiente tabla compara estas opciones según criterios de latencia, dependencia de Internet, facilidad de configuración y funcionalidad.

Como se puede observar, Modbus TCP ofrece el mejor equilibrio entre latencia, independencia de Internet y funcionalidad, aunque requiere una configuración manual más elaborada. La integración en la nube es más sencilla pero depende de servidores externos y puede tener retrasos. SunSpec es una opción interesante si tu inversor lo soporta, ya que simplifica el mapeo de registros. Las integraciones personalizadas de HACS pueden ser muy potentes pero suelen carecer de mantenimiento a largo plazo.

7. Preguntas frecuentes (FAQ)