Cómo Integrar un Inversor Solar Chint en Home Assistant con Modbus TCP: Guía Paso a Paso

La integración de inversores solares en sistemas de domótica se ha convertido en una práctica esencial para maximizar el autoconsumo y monitorizar la producción energética en tiempo real. En este artículo, exploraremos en profundidad cómo conectar un inversor solar de la marca Chint (modelos como el CHINT PV Box o la serie de inversores de cadena) con Home Assistant utilizando el protocolo Modbus TCP, una de las opciones más flexibles y robustas para la comunicación industrial. A lo largo de esta guía detallada, aprenderás desde los fundamentos técnicos del protocolo Modbus hasta la configuración avanzada en Home Assistant, incluyendo la creación de sensores personalizados, la automatización de alertas y la integración con paneles de control visuales.

Fundamentos Técnicos: Protocolo Modbus y su Aplicación en Inversores Solares

Modbus es un protocolo de comunicación serial desarrollado originalmente por Modicon (ahora Schneider Electric) en 1979. Se ha convertido en el estándar de facto en la industria para la interconexión de dispositivos electrónicos, especialmente en entornos de automatización y energía. Su popularidad radica en su simplicidad, fiabilidad y bajo coste de implementación. En el contexto de los inversores solares, Modbus permite leer y escribir registros que contienen datos cruciales como la potencia instantánea, la energía total generada, las tensiones y corrientes de cada cadena fotovoltaica, las temperaturas internas y los códigos de error.

Existen dos variantes principales de Modbus: Modbus RTU, que utiliza comunicación serie (RS-485) y tramas binarias, y Modbus TCP, que emplea redes Ethernet/IP y encapsula los datos en paquetes TCP/IP. Para la integración con Home Assistant, Modbus TCP es la opción más recomendada por varias razones: permite una conexión directa a través de la red local sin necesidad de adaptadores USB adicionales, ofrece mayor velocidad de comunicación y simplifica la configuración en entornos domésticos donde ya existe una infraestructura de red. La mayoría de los inversores Chint modernos incluyen un puerto Ethernet o un módulo Wi-Fi que soporta Modbus TCP, lo que facilita enormemente la integración.

Para entender cómo funciona Modbus, es esencial conocer los conceptos de direcciones de registro y tipos de datos. Cada registro en Modbus tiene una dirección de 16 bits y puede almacenar valores de 16 o 32 bits, dependiendo del tipo (holding register, input register, etc.). En el caso de los inversores solares, los datos se almacenan típicamente en registros de entrada (input registers) para lecturas y en registros de retención (holding registers) para parámetros configurables. Por ejemplo, la potencia actual de CA puede estar en la dirección 30057, mientras que la energía total generada puede ocupar dos registros consecutivos (32 bits) en las direcciones 30055 y 30056. Conocer el mapa de registros específico del modelo de inversor Chint es crucial para realizar una integración correcta.

Preparación del Inversor y Requisitos Previos

Antes de comenzar con la configuración en Home Assistant, es necesario asegurarse de que el inversor Chint esté correctamente preparado para la comunicación Modbus TCP. En primer lugar, verifica que tu modelo de inversor disponga de un puerto Ethernet o de un módulo de comunicación opcional (como el Chint Smart Dongle) que soporte Modbus TCP. Consulta el manual del usuario o la ficha técnica del dispositivo para confirmar esta característica. Si tu inversor solo dispone de puerto RS-485, necesitarás un conversor RS-485 a Ethernet, como el USR-W630, que actuará como puente entre el protocolo serie y TCP/IP.

Una vez confirmada la conectividad, accede a la interfaz web del inversor o a la aplicación de monitorización proporcionada por Chint. Normalmente, la dirección IP del inversor se puede encontrar a través del router o mediante el software de escaneo incluido. En la configuración de red, asigna una IP fija al inversor para evitar cambios de dirección que rompan la conexión. Anota también la máscara de subred y la puerta de enlace. A continuación, localiza los ajustes de protocolo de comunicación. En algunos modelos, es necesario habilitar la opción Modbus TCP y especificar el puerto (por defecto suele ser el 502). Si existe un parámetro de unidad ID, establece el valor a 1, aunque algunos fabricantes utilizan 247 o 255; consulta el manual para el valor correcto.

Además, es importante conocer las credenciales de acceso si el inversor exige autenticación para la lectura de datos. Aunque la mayoría de los inversores permiten la lectura sin autenticación, algunos modelos requieren un usuario y contraseña. En ese caso, deberás configurar las credenciales en Home Assistant o utilizar un proxy Modbus que gestione la autenticación. Por último, asegúrate de que el inversor esté actualizado con el último firmware, ya que las actualizaciones suelen corregir errores de comunicación y añadir nuevas funcionalidades.

Configuración del Componente Modbus en Home Assistant

Home Assistant ofrece un componente integrado llamado modbus que permite conectar dispositivos Modbus TCP o RTU. Para configurarlo, debes editar el archivo configuration.yaml. La estructura básica para una conexión Modbus TCP es la siguiente:

modbus:
  - name: "chint_inversor"
    type: tcp
    host: "192.168.1.100"
    port: 502
    timeout: 10
    sensors:
      - name: "Potencia CA"
        unit_of_measurement: "W"
        address: 30057
        input_type: input
        data_type: uint32
        scale: 1
        precision: 0

En este ejemplo, definimos un hub Modbus llamado "chint_inversor" con los parámetros de conexión. La lista sensors nos permite declarar los sensores que deseamos leer. Cada sensor requiere un nombre, una dirección de registro, el tipo de registro (input o holding), el tipo de dato (uint16, uint32, float, etc.) y opcionalmente un factor de escala y precisión. Es fundamental consultar el mapa de registros del inversor Chint para conocer las direcciones exactas y los tipos de datos. Por ejemplo, la potencia de CA suele ser un valor de 32 bits sin signo en las direcciones 30057-30058, mientras que la energía total puede ser un valor de 32 bits en las direcciones 30055-30056.

Además de los sensores básicos, el componente Modbus permite definir interruptores, selectores y números para controlar parámetros del inversor, como encender/apagar o limitar la potencia. Sin embargo, para la monitorización inicial, nos centraremos en los sensores. Es recomendable comenzar con un número reducido de sensores para verificar la comunicación y luego ir añadiendo más según sea necesario. Para probar la conexión, puedes utilizar la herramienta de desarrollo de Home Assistant o la línea de comandos con herramientas como modbus-cli.

Mapeo de Registros Comunes en Inversores Chint

Cada modelo de inversor Chint tiene un mapa de registros específico, pero muchos comparten direcciones similares. A continuación, presentamos una tabla con los registros más comunes que puedes encontrar en los inversores Chint para la monitorización básica. Es importante que verifiques estas direcciones con el manual de tu modelo, ya que pueden variar ligeramente.

En la tabla anterior, las direcciones son orientativas y pueden variar. Por ejemplo, algunos inversores utilizan direcciones a partir de 30000 para registros de entrada y 40000 para registros de retención. En Home Assistant, al especificar la dirección, debes usar la dirección relativa sin el prefijo 3 o 4, y configurar el campo input_type como input para registros de entrada o holding para registros de retención.

Guía Paso a Paso para la Configuración en Home Assistant

A continuación, te presentamos un procedimiento detallado para integrar tu inversor Chint en Home Assistant, desde la verificación de la conectividad hasta la creación de un panel de control personalizado.

Paso 1: Verificar la Conectividad del Inversor

Antes de tocar la configuración de Home Assistant, asegúrate de que el inversor es accesible desde tu red. Utiliza el comando ping 192.168.1.100 (reemplaza con la IP de tu inversor) desde una terminal para comprobar que responde. Si no responde, revisa la conexión Ethernet o la configuración de red del inversor. Si responde, puedes probar el puerto Modbus con una herramienta como nmap o netcat. Por ejemplo, nc -zv 192.168.1.100 502 para ver si el puerto 502 está abierto.

Paso 2: Instalar y Configurar el Componente Modbus

En Home Assistant, ve a Configuración > Dispositivos y Servicios y busca la integración Modbus. Si no aparece, puedes añadirla manualmente a través del archivo configuration.yaml como se mostró anteriormente. Una vez guardado el archivo, reinicia Home Assistant para que cargue la nueva configuración. En el área de integraciones, deberías ver el hub Modbus con el nombre que le asignaste. Si hay errores de conexión, aparecerán en el registro de logs.

Paso 3: Añadir Sensores Personalizados

Después de verificar la conexión, es hora de añadir los sensores que deseas monitorizar. Puedes hacerlo de dos maneras: editando directamente el archivo configuration.yaml o utilizando la interfaz gráfica de la integración Modbus, que permite añadir sensores uno a uno. La interfaz gráfica es más sencilla para principiantes, pero la edición YAML ofrece más control y permite añadir muchos sensores de una sola vez. En YAML, puedes definir una lista de sensores bajo el hub Modbus, como se muestra en el ejemplo. Para cada sensor, especifica el nombre, la dirección, el tipo de dato y cualquier factor de escala. Por ejemplo, si la tensión se reporta en voltios sin decimales, puedes usar data_type: uint16 y scale: 0.1 si el valor real es 230.0 y el registro devuelve 2300.

Paso 4: Probar la Lectura de Datos

Una vez configurados los sensores, ve a Desarrollador > Estados y busca los nombres de tus sensores. Deberías ver valores actualizados. Si algún sensor muestra "desconocido" o "no disponible