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

La monitorización de una instalación solar fotovoltaica es esencial para maximizar el rendimiento, detectar fallos y amortizar la inversión. Si posees un inversor SofarSolar, sabrás que su aplicación propietaria ofrece datos, pero limitados. La verdadera potencia surge al integrarlo en Home Assistant, el sistema de domótica de código abierto más versátil. En esta guía exhaustiva te mostraremos cómo lograr la integración de un inversor SofarSolar en Home Assistant mediante el protocolo Modbus RTU, paso a paso y con todo lujo de detalles técnicos. Analizaremos los fundamentos de la comunicación serie, la configuración del hardware, la instalación de integraciones personalizadas, la creación de sensores y automatizaciones, y los errores más frecuentes. Al finalizar, dispondrás de un panel de control avanzado con datos en tiempo real, históricos y alertas personalizadas. Prepárate para exprimir al máximo tu inversor SofarSolar.

1. Fundamentos de la comunicación Modbus RTU en inversores SofarSolar

Antes de sumergirnos en la configuración, es crucial comprender qué es Modbus RTU y por qué es el estándar de facto en la industria solar. Modbus es un protocolo de comunicación industrial desarrollado en 1979 por Modicon (ahora Schneider Electric). Su variante RTU (Remote Terminal Unit) utiliza una transmisión serie binaria sobre RS-485, lo que permite conectar múltiples dispositivos en un mismo bus mediante un par trenzado. Los inversores SofarSolar, al igual que muchas marcas, exponen sus registros internos a través de Modbus, lo que posibilita la lectura de variables como potencia generada, tensión de string, temperatura, energía acumulada y estados de fallo.

El protocolo Modbus RTU se basa en una arquitectura maestro-esclavo. Home Assistant actuará como maestro, enviando peticiones de lectura a la dirección esclava configurada en el inversor (normalmente 1). Cada registro Modbus tiene una dirección de 16 bits y un tamaño específico. SofarSolar documenta estos mapas de registros en manuales técnicos que, aunque no siempre son fáciles de encontrar, son la piedra angular para una integración exitosa. En esta guía nos centraremos en los modelos más comunes: SOFAR HYD 3000-6000-ES, SOFAR 3000-6000TL-G3 y SOFAR 5K-10KTL.

1.1. Diferencias entre Modbus RTU y Modbus TCP

Modbus RTU se transmite sobre RS-485, mientras que Modbus TCP lo hace sobre Ethernet. Muchos inversores SofarSolar incorporan un puerto RS-485, pero no todos tienen conexión Ethernet. Si tu inversor solo dispone de RS-485, necesitarás un convertidor USB a RS-485 para conectarlo a Home Assistant. Si tu inversor tiene Wi-Fi o Ethernet, podrías usar Modbus TCP, pero en esta guía nos enfocamos en RTU por ser el método más universal y económico. Además, Modbus RTU es más robusto en entornos industriales con ruido electromagnético, algo común en instalaciones solares.

1.2. Mapa de registros del inversor SofarSolar

Cada modelo de inversor tiene un mapa de registros específico. Por ejemplo, en la serie HYD, los registros de energía generada se encuentran en las direcciones 0x0000 a 0x000F. Es fundamental consultar el manual de tu modelo exacto. A continuación, mostramos una tabla resumen de los registros más útiles para monitorizar. Esta tabla es orientativa y puede variar según la versión de firmware.

2. Preparación del hardware y conexión física

Para conectar tu inversor SofarSolar a Home Assistant necesitarás una serie de componentes hardware. La elección dependerá de la distancia entre el inversor y el servidor donde corre Home Assistant, así como del tipo de puerto disponible en tu inversor. La mayoría de los inversores SofarSolar incluyen un puerto RS-485 (a veces etiquetado como COM o Meter) que puede usarse para comunicación Modbus. Es importante no confundir este puerto con el destinado al medidor de energía (CT).

2.1. Componentes necesarios

• Convertidor USB a RS-485: Puede ser un adaptador genérico con chip CH340, FTDI o similar. Recomendamos los basados en FTDI por su estabilidad. También existen convertidores RS-485 a Ethernet (por ejemplo, USR-TCP232-410s) si prefieres una conexión de red.
• Cable de par trenzado apantallado: Para distancias superiores a 2 metros, usa cable apantallado con dos conductores (A y B) más malla de tierra. La sección recomendada es de 0.5 mm².
• Resistencia de terminación de 120 ohmios: Solo necesaria si el bus es largo (más de 50 metros) o si hay problemas de reflexión. En instalaciones domésticas no suele ser necesaria.
• Servidor Home Assistant: Puede ser una Raspberry Pi, un mini PC, o incluso un contenedor Docker en un NAS. Asegúrate de que tiene un puerto USB libre.

2.2. Conexión física paso a paso

Sigue estos pasos con precisión para evitar daños en el inversor:

1. Apaga el inversor completamente (tanto DC como AC) antes de manipular las conexiones. La seguridad es primordial.
2. Localiza el puerto RS-485 en el inversor. Normalmente es un conector de 2 o 3 pines (A, B y GND). Consulta el manual para identificarlos correctamente.
3. Conecta el cable de par trenzado: el hilo A del inversor al terminal A del convertidor USB-RS485, y el hilo B al terminal B. Si tu convertidor tiene terminal GND, conéctalo a la tierra del inversor (opcional pero recomendado para evitar diferencias de potencial).
4. Si usas cable apantallado, conecta la malla a tierra solo en un extremo para evitar bucles de tierra.
5. Conecta el convertidor USB a tu servidor Home Assistant.
6. Enciende el inversor y verifica que el convertidor tiene alimentación (algunos modelos tienen LED).

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

Home Assistant ofrece una integración nativa para Modbus, que permite definir sensores, switches y otros elementos a partir de registros. Para inversores SofarSolar, la comunidad ha desarrollado integraciones personalizadas que simplifican enormemente el proceso. Aquí exploraremos ambas vías: la integración nativa y la personalizada (HACS).

3.1. Instalación de la integración personalizada vía HACS

HACS (Home Assistant Community Store) es un gestor de paquetes que permite instalar integraciones de la comunidad. Para SofarSolar, existe una integración llamada 'sofar' o 'sofar_solar' que puedes encontrar en el repositorio de HACS. Sigue estos pasos:

1. Asegúrate de tener HACS instalado en tu Home Assistant. Si no, sigue la guía oficial.
2. Ve a HACS > Integraciones > Explora y busca 'SofarSolar'.
3. Instala la integración y reinicia Home Assistant.
4. Una vez reiniciado, ve a Configuración > Dispositivos y Servicios > Añadir integración y busca 'SofarSolar'.
5. Introduce los parámetros: puerto serie (ej. /dev/ttyUSB0), velocidad (9600 o 19200 según modelo), dirección esclava (1 por defecto), y el modelo de inversor.
6. La integración creará automáticamente los sensores correspondientes.

Si prefieres no usar HACS, puedes configurar manualmente los sensores en el archivo configuration.yaml. A continuación, mostramos un ejemplo para un inversor SofarSolar HYD 5000.

modbus:
  - name: SofarSolar
    type: serial
    port: /dev/ttyUSB0
    baudrate: 9600
    bytesize: 8
    method: rtu
    parity: N
    stopbits: 1
    timeout: 2
    sensors:
      - name: Potencia Solar
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        unit_of_measurement: W
        scale: 1
        precision: 0
      - name: Energía Hoy
        slave: 1
        address: 1
        input_type: holding
        data_type: uint32
        unit_of_measurement: kWh
        scale: 0.1
        precision: 1

3.2. Verificación de la comunicación

Tras configurar, reinicia Home Assistant y verifica los logs. Si todo va bien, verás los sensores con datos actualizados. Si hay errores, revisa el puerto serie (puede ser /dev/ttyUSB1), la velocidad en baudios y la dirección esclava. Puedes usar la herramienta 'modbus' en la línea de comandos para probar la comunicación antes de integrar.

4. Creación de un panel de control avanzado

Una vez que los sensores están disponibles, es hora de crear un panel de control atractivo y funcional. Home Assistant permite personalizar el dashboard con tarjetas. Recomendamos usar tarjetas como 'entities', 'gauge' y 'history-graph' para visualizar la potencia instantánea, la energía diaria y mensual, así como la temperatura del inversor. También puedes crear automatizaciones para notificar cuando la producción caiga por debajo de un umbral o cuando haya un fallo.

Un ejemplo de automatización para alertar de sobretemperatura:

alias: Alerta Temperatura Inversor
 trigger:
   - platform: numeric_state
     entity_id: sensor.sofarsolar_temperatura
     above: 65
 action:
   - service: notify.mobile_app
     data:
       message: 'Temperatura del inversor supera 65°C'

Además, puedes integrar los datos en InfluxDB y Grafana para un análisis histórico más potente. Home Assistant tiene una integración nativa con InfluxDB que exporta los estados de los sensores.

5. Errores comunes y solución de problemas

A pesar de seguir la guía, pueden surgir problemas. Aquí listamos los más frecuentes y sus soluciones.

6. Comparativa de métodos de integración

Existen varias formas de integrar SofarSolar en Home Assistant. La siguiente tabla compara las opciones más comunes.

La integración vía HACS es la más sencilla y recomendada para la mayoría de usuarios, ya que abstrae la complejidad de los registros. Sin embargo, si prefieres un control total o tu modelo no está soportado, la configuración manual con Modbus RTU es la mejor opción.

7. Preguntas frecuentes