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

La integración de inversores solares en sistemas de domótica como Home Assistant se ha convertido en una necesidad para los propietarios de instalaciones fotovoltaicas que desean maximizar su autoconsumo y tener un control total sobre su generación energética. Los inversores de la marca SofarSolar, conocidos por su fiabilidad y relación calidad-precio, ofrecen la posibilidad de comunicarse mediante el protocolo Modbus TCP, lo que permite extraer una gran cantidad de datos en tiempo real. En esta guía, exploraremos paso a paso cómo configurar la integración de un inversor SofarSolar en Home Assistant utilizando Modbus TCP, desde la preparación del hardware hasta la creación de paneles de control personalizados.

Requisitos previos y preparación del inversor

Antes de comenzar con la configuración en Home Assistant, es fundamental asegurarse de que el inversor SofarSolar esté correctamente preparado para la comunicación Modbus TCP. La mayoría de los modelos modernos de SofarSolar, como las series KTL-X, HYD y ME, incluyen un puerto Ethernet o Wi-Fi que permite la conexión a la red local. Sin embargo, es necesario verificar que el firmware del inversor soporte el protocolo Modbus TCP, ya que algunos modelos más antiguos pueden requerir una actualización.

El primer paso es acceder a la interfaz de configuración del inversor, generalmente a través de su dirección IP asignada por el router. Para ello, necesitarás conocer la IP del inversor; puedes encontrarla en la página de administración de tu router o utilizando herramientas de escaneo de red como Advanced IP Scanner. Una vez que tengas la IP, ábrela en un navegador web. Las credenciales por defecto suelen ser 'admin' tanto para usuario como para contraseña, aunque es recomendable cambiarlas por seguridad.

Dentro de la interfaz web del inversor, busca la sección de 'Comunicación' o 'Network Settings'. Allí deberás habilitar el servicio Modbus TCP. En algunos modelos, esta opción se encuentra en 'Advanced Settings' > 'Modbus'. Asegúrate de que el puerto Modbus TCP esté configurado en el valor estándar 502 (aunque algunos inversores usan el puerto 502 por defecto). Si tu red utiliza VLANs o subredes separadas, verifica que el inversor y el servidor de Home Assistant estén en la misma subred para evitar problemas de conectividad.

Además, es importante anotar la dirección IP del inversor, ya que la necesitaremos más adelante. Si tu inversor se conecta mediante Wi-Fi, asegúrate de que la señal sea estable y de que no haya interferencias. Una conexión cableada Ethernet siempre será más fiable para la comunicación Modbus, ya que el protocolo es sensible a pérdidas de paquetes.

Configuración de Home Assistant para Modbus TCP

Una vez que el inversor está listo, el siguiente paso es configurar Home Assistant para que pueda comunicarse con él a través de Modbus TCP. Home Assistant incluye una integración nativa de Modbus que permite leer y escribir registros de forma sencilla. Para empezar, debemos añadir la configuración Modbus en el archivo 'configuration.yaml' de Home Assistant.

Abre el archivo 'configuration.yaml' (generalmente ubicado en la carpeta 'config' de tu instalación de Home Assistant) y añade las siguientes líneas:

modbus:
  - name: sofarsolar
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia AC"
        unit_of_measurement: "W"
        slave: 1
        address: 0
        input_type: holding
        data_type: int32
        scale: 1
        precision: 0
      - name: "Energía total generada"
        unit_of_measurement: "kWh"
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        scale: 0.1
        precision: 1

Reemplaza '192.168.1.100' con la dirección IP real de tu inversor. El parámetro 'slave' generalmente es 1 para inversores SofarSolar, aunque puede variar según el modelo. Los 'address' son los registros Modbus específicos que queremos leer. En este ejemplo, hemos configurado dos sensores: potencia actual en vatios (dirección 0) y energía total generada en kWh (dirección 2). Es importante consultar el manual de tu inversor para conocer el mapa de registros Modbus, ya que las direcciones pueden diferir.

Después de guardar los cambios, reinicia Home Assistant para que la configuración surta efecto. Puedes hacerlo desde la interfaz web en 'Configuración' > 'Reiniciar'. Una vez reiniciado, ve a 'Desarrollador' > 'Estados' y busca 'sensor.potencia_ac' o el nombre que hayas asignado. Si todo está correcto, verás los valores actualizados.

Mapeo de registros Modbus para SofarSolar

Para una integración completa, es necesario conocer el mapa de registros Modbus específico de tu modelo de inversor SofarSolar. Aunque los fabricantes suelen proporcionar un documento técnico con esta información, a continuación presentamos una tabla con los registros más comunes basados en la experiencia con modelos populares como el SofarSolar KTL-X y HYD. Esta tabla te servirá como punto de partida; sin embargo, siempre es recomendable verificar con el manual oficial.

Para añadir más sensores, simplemente repite el bloque 'sensors' en la configuración de Modbus, ajustando la dirección, el tipo de dato y la escala según corresponda. Por ejemplo, para la temperatura, usarías 'data_type: int16' y 'scale: 0.1'. Recuerda que algunos registros pueden ser de solo lectura, mientras que otros permiten escritura (por ejemplo, para ajustar la potencia de salida). En esta guía nos centraremos en la monitorización, por lo que solo usaremos registros de solo lectura.

Creación de un panel de control personalizado

Una vez que los sensores están disponibles en Home Assistant, el siguiente paso es crear un panel de control atractivo y funcional. Utilizando el panel de 'Energía' de Home Assistant, podemos mostrar la producción solar de forma integrada. Sin embargo, para un control más detallado, recomiendo crear un dashboard personalizado con tarjetas.

Ve a 'Panel lateral' > 'Paneles' y crea un nuevo panel llamado 'Solar'. Luego, en modo edición, añade las siguientes tarjetas:

Además, puedes utilizar la integración 'Plantilla' para crear sensores derivados, como la potencia en kW o la energía diaria. Por ejemplo, para calcular la energía diaria, puedes usar un sensor de plantilla que reste el valor de energía al inicio del día. Sin embargo, esto requiere algo de configuración adicional con 'utility_meter'.

Automatizaciones y alertas útiles

Una de las grandes ventajas de tener los datos del inversor en Home Assistant es la posibilidad de crear automatizaciones. Por ejemplo, puedes configurar una automatización que te envíe una notificación si la producción cae por debajo de un umbral durante un período prolongado, lo que podría indicar un problema en los paneles o en el inversor.

Otra automatización interesante es la de 'vertido cero': si tu instalación tiene baterías, puedes programar que cuando la producción supere el consumo, el inversor reduzca su potencia para evitar verter a la red (si la normativa local lo permite). Esto se puede lograr escribiendo en los registros Modbus correspondientes, pero requiere precaución ya que implica modificar parámetros del inversor.

Para crear una automatización básica de alerta, ve a 'Configuración' > 'Automatizaciones' y crea una nueva. Como desencadenante, usa 'Estado' y selecciona el sensor de potencia. Configura 'Por debajo de' 100 W durante 10 minutos. Como acción, elige 'Enviar notificación' y selecciona tu dispositivo móvil. De esta forma, recibirás una alerta si la producción es anormalmente baja.

Solución de problemas comunes

A pesar de seguir los pasos correctamente, pueden surgir problemas. Aquí abordamos los más frecuentes y sus soluciones.

El inversor no responde a las peticiones Modbus

Este es el problema más común. Primero, verifica que el inversor esté encendido y que la conexión de red sea correcta. Desde la terminal de Home Assistant (o usando un cliente Modbus como 'Modbus Poll'), intenta conectarte al inversor manualmente. Si no hay respuesta, revisa la configuración del firewall y asegúrate de que el puerto 502 esté abierto. También prueba a cambiar el número de 'slave' (a veces es 0 o 2).

Valores incorrectos o fuera de rango

Si los valores que aparecen no tienen sentido (por ejemplo, potencia negativa o temperatura de 9999), es probable que el tipo de dato o la escala no sean correctos. Revisa el manual del inversor para confirmar el formato de los registros. Algunos inversores usan 'int16' en lugar de 'int32', o 'float32'. Ajusta 'data_type' y 'scale' en consecuencia.

Los sensores no se actualizan

Home Assistant actualiza los sensores Modbus por defecto cada 10 segundos. Si notas que los valores no se actualizan, puedes reducir el intervalo de escaneo añadiendo 'scan_interval: 5' en la configuración de cada sensor. Sin embargo, ten en cuenta que un intervalo muy bajo puede aumentar la carga en el inversor y en la red.

Preguntas frecuentes

Conclusión y próximos pasos

La integración de un inversor solar SofarSolar en Home Assistant mediante Modbus TCP es un proceso accesible que aporta un valor significativo al permitir un monitoreo detallado y en tiempo real de tu instalación fotovoltaica. Con los pasos descritos en esta guía, podrás tener acceso a datos clave como potencia, energía generada, tensiones y temperaturas, y crear automatizaciones que optimicen tu autoconsumo.

Una vez que tengas la integración básica funcionando, te animamos a explorar posibilidades más avanzadas, como la integración con sistemas de baterías, la predicción de producción basada en el clima, o la creación de paneles de control en Grafana. La comunidad de Home Assistant es muy activa y constantemente se comparten nuevas configuraciones y mejoras.