Cómo Integrar un Inversor Solar Solis en Home Assistant con Modbus TCP y Optimizar tu Producción

La monitorización en tiempo real de tu instalación fotovoltaica es clave para maximizar el retorno de tu inversión. Si posees un inversor Solis y utilizas Home Assistant como centro de automatización del hogar, integrar ambos sistemas mediante Modbus TCP te permitirá acceder a datos precisos de generación, consumo y estado del equipo, todo desde un panel unificado. En esta guía exhaustiva, exploraremos cada paso necesario para lograr esta integración, desde los conceptos fundamentales del protocolo Modbus hasta la configuración avanzada en Home Assistant, incluyendo estrategias para optimizar tu producción solar basándote en los datos obtenidos.

Fundamentos de la Integración: Modbus TCP y Solis

Antes de sumergirnos en la configuración técnica, es esencial comprender qué es Modbus TCP y por qué es el método preferido para comunicarse con inversores Solis. Modbus es un protocolo de comunicación industrial ampliamente adoptado, creado originalmente por Modicon (hoy Schneider Electric) en 1979. Con el tiempo, se ha convertido en el estándar de facto para la interconexión de dispositivos electrónicos en entornos de automatización y energía. La variante TCP/IP, conocida como Modbus TCP, permite que los dispositivos se comuniquen a través de redes Ethernet, lo que facilita su integración en sistemas domésticos inteligentes como Home Assistant.

Los inversores Solis, fabricados por Ginlong Technologies, incorporan un puerto de comunicación que soporta Modbus RTU sobre RS485 y, en muchos modelos, también Modbus TCP a través de su puerto Ethernet integrado o mediante un adaptador opcional. Esta capacidad es una ventaja significativa, ya que permite extraer una gran cantidad de registros de datos (holding registers) que contienen información sobre voltajes, corrientes, potencias, energía acumulada, temperaturas y estados de funcionamiento. Al acceder a estos registros, podemos integrar los datos directamente en Home Assistant, evitando depender de la nube del fabricante o de plataformas de terceros.

La integración vía Modbus TCP ofrece varias ventajas sobre otros métodos, como la API en la nube de Solis. En primer lugar, la comunicación es local y directa, lo que reduce la latencia y aumenta la privacidad, ya que los datos no salen de tu red doméstica. En segundo lugar, no dependes de la disponibilidad de los servidores de Solis ni de tu conexión a internet para obtener lecturas en tiempo real. Esto es crucial para aplicaciones críticas como la gestión de baterías o la automatización de cargas según la producción. Además, al tener acceso a los registros internos, puedes obtener datos más detallados que los que ofrece la aplicación oficial, como tensiones por string o estados de error específicos.

Sin embargo, esta integración requiere ciertos conocimientos técnicos. Deberás conocer la dirección IP de tu inversor, el puerto Modbus (generalmente 502), y la tabla de registros específica de tu modelo. Afortunadamente, Solis proporciona documentación detallada de los registros, y la comunidad ha recopilado mucha información útil. A lo largo de este artículo, te guiaremos para que puedas realizar la integración incluso si eres nuevo en el mundo de Modbus.

Preparación Previa: Requisitos y Configuración de Red

Antes de comenzar con la configuración en Home Assistant, debemos asegurarnos de que el inversor esté correctamente preparado para la comunicación Modbus TCP. El primer paso es verificar que tu modelo de inversor Solis soporte esta funcionalidad. La mayoría de los inversores modernos de la serie Solis-1P, Solis-3P, y Solis-5G incluyen un puerto Ethernet o un puerto RS485 que puede conectarse a un adaptador Ethernet. Consulta el manual de tu equipo o el sitio web del fabricante para confirmar las capacidades específicas de tu modelo.

Si tu inversor solo tiene RS485, necesitarás un adaptador RS485 a Ethernet, como el USR-TCP232-306 o un convertidor similar. Estos dispositivos actúan como un puente entre el protocolo serie y TCP/IP, permitiendo que Home Assistant se comunique con el inversor a través de la red. En este caso, deberás configurar el adaptador con una dirección IP estática y el puerto deseado, y conectar los cables RS485 a los terminales correspondientes del inversor (A+, B-). Asegúrate de respetar la polaridad y de utilizar cable blindado si es posible para evitar interferencias.

Una vez que tengas acceso por red al inversor, es recomendable asignar una dirección IP fija en tu router para evitar que cambie con el tiempo. Puedes hacerlo mediante una reserva DHCP en la configuración del router, o configurando una IP estática directamente en el inversor si su interfaz lo permite. Esta IP será la que usaremos en la configuración de Home Assistant. Además, asegúrate de que el puerto Modbus (por defecto 502) esté abierto y no bloqueado por el firewall de tu red. En algunos casos, puede ser necesario configurar el inversor para habilitar el modo Modbus TCP, ya que algunos modelos vienen desactivados por defecto.

Otro aspecto importante es conocer la tabla de registros de tu inversor. Solis publica documentos con las direcciones de los registros (por ejemplo, 30000, 30001, etc.) y su significado. Estos registros pueden ser de solo lectura (input registers) o de lectura/escritura (holding registers). Para la monitorización, nos centraremos principalmente en los registros de solo lectura. Puedes descargar la tabla de registros desde el sitio web de Solis o buscar en foros especializados. Te recomendamos tener esta tabla a mano durante la configuración, ya que te permitirá interpretar los valores que recibimos.

Configuración del Inversor Solis para Modbus TCP

Acceder a la configuración del inversor puede variar según el modelo, pero generalmente se realiza a través de una interfaz web o una aplicación móvil. Para los modelos con pantalla LCD, es posible configurar la red directamente desde el panel. Los pasos típicos son los siguientes:

Paso 1: Conectar el inversor a tu red

Asegúrate de que el inversor esté encendido y conectado a tu router mediante un cable Ethernet. Si estás utilizando un adaptador RS485, conéctalo al inversor y al router. Espera unos minutos para que el inversor obtenga una dirección IP automáticamente (DHCP) o configura una IP estática según las instrucciones del fabricante. Para descubrir la IP asignada, puedes revisar la lista de dispositivos conectados en tu router o utilizar una herramienta de escaneo de red como Advanced IP Scanner.

Paso 2: Acceder a la interfaz de configuración del inversor

Una vez que conozcas la IP, abre un navegador web e ingresa la dirección IP del inversor. Es posible que se te solicite un nombre de usuario y contraseña. Por defecto, muchos inversores Solis usan 'admin' como usuario y la contraseña puede ser la parte final de la dirección MAC o una contraseña predeterminada como 'admin' o '123456'. Consulta el manual para obtener las credenciales correctas. Si no puedes acceder, intenta restablecer el inversor a los valores de fábrica (ten en cuenta que esto borrará toda la configuración).

Paso 3: Habilitar Modbus TCP y configurar parámetros

Dentro de la interfaz, busca la sección de 'Comunicación' o 'Modbus'. Deberías encontrar opciones para habilitar Modbus TCP, establecer el puerto (por defecto 502) y posiblemente definir una dirección de unidad (slave ID). La dirección de unidad suele ser 1 para inversores Solis, pero verifica en la documentación. Si tu inversor tiene múltiples unidades (por ejemplo, en un sistema trifásico con varios inversores), cada uno debe tener una dirección única. Guarda los cambios y reinicia el inversor si es necesario.

Configuración de Home Assistant: Integración Modbus

Home Assistant ofrece una integración nativa de Modbus que nos permite conectarnos a dispositivos Modbus TCP y leer registros. La configuración se realiza a través del archivo 'configuration.yaml'. A continuación, te mostramos los pasos detallados para configurar la conexión y los sensores.

Paso 1: Añadir la configuración Modbus en configuration.yaml

Accede a tu instancia de Home Assistant y edita el archivo 'configuration.yaml'. Puedes hacerlo a través del complemento 'File editor' o mediante SSH. Añade el siguiente bloque para configurar el cliente Modbus:

modbus:
  - name: "solis"
    type: tcp
    host: "IP_DE_TU_INVERSOR"
    port: 502
    sensors:
      - name: "Potencia actual"
        unit_of_measurement: "W"
        slave: 1
        address: 30000
        data_type: int32
        scale: 1
        precision: 0
        input_type: holding

Reemplaza 'IP_DE_TU_INVERSOR' con la dirección IP real de tu inversor. El parámetro 'slave' debe coincidir con la dirección de unidad configurada en el inversor (normalmente 1). El 'address' es el registro Modbus que queremos leer; en este ejemplo, 30000 suele ser la potencia activa total en vatios, pero debes consultar la tabla de registros de tu modelo específico. 'data_type' puede ser 'int16', 'int32', 'uint16', etc., dependiendo del formato del valor. 'scale' es un factor multiplicador para ajustar las unidades (a menudo 1 o 0.1). 'input_type' puede ser 'holding' o 'input', según el tipo de registro.

Para obtener una monitorización completa, necesitarás añadir múltiples sensores para diferentes registros, como energía total, voltaje de red, corriente, etc. Te recomendamos comenzar con un sensor de prueba para verificar la comunicación antes de añadir todos.

Paso 2: Verificar la comunicación

Después de guardar el archivo, reinicia Home Assistant. Ve a 'Configuración' > 'Dispositivos y servicios' y busca la integración 'Modbus'. Deberías ver tu dispositivo 'solis' y los sensores definidos. Si los sensores muestran valores, la comunicación es exitosa. Si no, revisa los logs en 'Configuración' > 'Registros' para ver errores como 'Connection refused' o 'Timeout'. Asegúrate de que el inversor esté accesible desde Home Assistant (prueba con un ping) y que el puerto 502 esté abierto.

Paso 3: Añadir más sensores relevantes

Una vez que la comunicación funcione, puedes ampliar la lista de sensores. Aquí tienes una tabla de registros comunes para inversores Solis (verifica con tu documentación):

Puedes añadir estos sensores en el bloque 'sensors' de la configuración Modbus. Recuerda ajustar el tipo de datos y el factor de escala según corresponda. Por ejemplo, la energía total puede venir en dos registros de 16 bits (alto y bajo) que deben combinarse en un valor de 32 bits. En ese caso, puedes usar 'data_type: uint32' y 'address: 30004' si el inversor soporta lectura de 32 bits en una sola dirección. Si no, deberás usar 'address: 30004' para la parte alta y 'address: 30005' para la baja, y luego combinar en una plantilla.

Optimización de la Producción Solar con Datos en Tiempo Real

Una vez que tienes los datos de tu inversor en Home Assistant, puedes utilizarlos para optimizar tu producción y consumo. La clave está en automatizar acciones basadas en la generación solar. Por ejemplo, puedes programar el encendido de electrodomésticos de alto consumo, como lavadoras o lavavajillas, durante las horas de mayor producción. Con Home Assistant, puedes crear automatizaciones que activen estos dispositivos cuando la potencia generada supere un umbral.

Además, puedes configurar alertas para detectar anomalías. Si la producción cae repentinamente en un día soleado, podría indicar un problema con los paneles o el inversor. Puedes crear una automatización que te envíe una notificación a tu teléfono si la potencia generada es inferior a un valor esperado durante un período determinado. También puedes monitorear la temperatura del inversor para prevenir sobrecalentamientos.

Uso de Paneles de Energía en Home Assistant

Home Assistant cuenta con una función llamada 'Paneles de energía' que te permite visualizar el flujo de energía en tu hogar. Para ello, necesitas tener sensores de consumo y de producción. Puedes integrar tu inversor Solis como sensor de producción y conectar sensores de consumo mediante dispositivos inteligentes o un medidor de energía. En el panel de energía, podrás ver en tiempo real cuánta energía produces, cuánta consumes y cuánta exportas a la red.

Para configurar el panel de energía, ve a 'Configuración' > 'Paneles de energía' y sigue el asistente. Selecciona el sensor de producción que has creado desde Modbus y los sensores de consumo correspondientes. Una vez configurado, tendrás una visión clara de tu balance energético, lo que te ayudará a tomar decisiones informadas sobre cuándo usar tus electrodomésticos.

Automatizaciones Inteligentes para Maximizar el Autoconsumo

Las automatizaciones son el corazón de la optimización. Por ejemplo, puedes crear una automatización que encienda tu termo eléctrico cuando el excedente de energía supere los 500 W durante más de 10 minutos. Utiliza el sensor de potencia generada y el sensor de consumo para calcular el excedente. En Home Assistant, puedes usar plantillas para calcular el valor y luego activar la automatización.

Otro ejemplo es la gestión de baterías virtuales o cargadores de vehículos eléctricos. Si tienes un cargador inteligente, puedes ajustar la corriente de carga según la producción solar. Con Home Assistant, puedes leer la potencia generada y ajustar la potencia del cargador dinámicamente para usar solo el excedente solar. Esto reduce tu dependencia de la red y maximiza el uso de energía limpia.

Errores Comunes y Solución de Problemas

A pesar de seguir los pasos, es posible encontrar dificultades. Aquí te presentamos los errores más frecuentes y cómo resolverlos.

Error de conexión: 'Connection refused' o 'Timeout'

Este error indica que Home Assistant no puede alcanzar el inversor. Verifica que la IP y el puerto sean correctos. Prueba a hacer un telnet desde la máquina de Home Assistant al puerto 502: `telnet IP 502`. Si no funciona, revisa la configuración de red del inversor y que el servicio Modbus esté habilitado. También asegúrate de que no haya un firewall que bloquee el puerto.

Valores incorrectos o negativos

Si los valores leídos no tienen sentido, es probable que la dirección del registro sea incorrecta o que el tipo de datos no coincida. Consulta la tabla de registros de tu modelo específico. Algunos registros pueden ser de tipo 'int16' con signo, mientras que otros son 'uint16'. Ajusta 'data_type' y 'scale' en consecuencia. También verifica si el registro es de solo lectura (input) o de lectura/escritura (holding).

Sensores que no se actualizan

Por defecto, Home Assistant actualiza los sensores Modbus cada 10 segundos. Si no ves cambios, puede que el inversor no esté actualizando los registros o que la conexión se haya interrumpido. Revisa los logs y verifica que el inversor esté produciendo (si es de noche, la potencia será cero). Puedes aumentar la frecuencia de escaneo configurando 'scan_interval' en el sensor, por ejemplo, 'scan_interval: 5'.

Comparativa: Solis vs Otros Inversores para Integración con Home Assistant

Para darte una perspectiva, compararemos los inversores Solis con otras marcas populares en cuanto a su facilidad de integración con Home Assistant mediante Modbus. Esta tabla te ayudará a entender las ventajas y desventajas.

Como se observa, Solis ofrece una buena relación calidad-precio y una integración sencilla gracias a su soporte Modbus TCP. Aunque Fronius tiene una comunidad más grande, Solis es más asequible y cumple perfectamente con los requisitos de monitorización. Huawei, por otro lado, requiere soluciones alternativas como el uso de la API en la nube, lo que complica la integración local.

Preguntas Frecuentes (FAQ)