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

La monitorización en tiempo real de un sistema solar fotovoltaico es esencial para optimizar el rendimiento y detectar incidencias de forma temprana. Home Assistant, como plataforma de automatización del hogar, permite integrar prácticamente cualquier dispositivo, incluyendo inversores solares. En esta guía completa, aprenderás a integrar tu inversor solar FoxESS en Home Assistant utilizando el protocolo Modbus TCP, una solución fiable y de bajo coste que te dará control total sobre tu producción energética.

Introducción a la Integración FoxESS con Home Assistant

FoxESS es uno de los fabricantes de inversores solares más populares en el mercado residencial, ofreciendo modelos como la serie T, H1 y AC1. Aunque FoxESS proporciona su propia plataforma de monitorización en la nube, muchos usuarios prefieren integrar sus inversores en Home Assistant para centralizar el control y crear automatizaciones avanzadas. La integración vía Modbus TCP es la opción más directa y no requiere hardware adicional si el inversor ya está conectado a la red local. Modbus es un protocolo de comunicación industrial ampliamente utilizado en el sector de la energía, y la mayoría de los inversores FoxESS lo soportan de forma nativa. En esta guía, asumiremos que tu inversor FoxESS está conectado a tu red mediante Ethernet o Wi-Fi (a través de un datalogger) y que tienes acceso a su dirección IP.

Antes de comenzar, es importante verificar la compatibilidad de tu modelo. Los inversores FoxESS con datalogger COM1000 o COM2000 suelen soportar Modbus TCP. También es recomendable tener conocimientos básicos de Home Assistant, incluyendo la edición de archivos de configuración YAML y el uso de la terminal. A lo largo de este artículo, te guiaremos paso a paso, desde la obtención de la dirección IP del inversor hasta la creación de sensores personalizados y paneles de control en el dashboard de Home Assistant.

Requisitos Previos y Preparación del Entorno

Para llevar a cabo esta integración, necesitarás los siguientes elementos:

• Inversor FoxESS compatible: Modelos como H1-3.7, H1-5.0, AC1-3.0, T-10, etc., con datalogger COM1000/COM2000 y firmware actualizado.
• Home Assistant instalado: Preferiblemente Home Assistant OS o Core en una Raspberry Pi, NUC o servidor. Asegúrate de tener acceso a la configuración YAML.
• Red local con DHCP: El inversor debe tener una IP fija o reservada en el router para evitar cambios de dirección.
• Herramientas de red: Un escáner de IP como Advanced IP Scanner o Fing para localizar el inversor.

Paso 1: Localizar la Dirección IP del Inversor FoxESS

El primer paso es conocer la dirección IP de tu inversor en la red local. Normalmente, el datalogger FoxESS se conecta vía DHCP, por lo que su IP puede cambiar con el tiempo. Para evitar problemas, es recomendable asignarle una IP fija desde el router o configurar una reserva DHCP. Existen varias formas de encontrar la IP:

• Usar la aplicación FoxESS Cloud: En la app oficial, ve a Dispositivos > Datalogger y anota la dirección IP que aparece. A veces la app muestra la IP local.
• Escáner de red: Herramientas como Advanced IP Scanner (Windows) o Fing (móvil) pueden detectar dispositivos FoxESS. Busca por el fabricante o por el puerto 502 (Modbus).
• Consola del router: Accede a la interfaz de administración de tu router y busca la lista de clientes DHCP. Identifica el dispositivo por su nombre (p.ej., 'foxess' o 'datalogger').

Una vez que tengas la IP, verifica que el puerto Modbus (502) esté abierto. Puedes usar una herramienta como 'netcat' o 'telnet' desde la terminal de Home Assistant: nc -zv 192.168.1.100 502. Si el puerto está accesible, verás un mensaje de conexión exitosa.

Paso 2: Instalar y Configurar la Integración Modbus en Home Assistant

Home Assistant incluye una integración nativa para Modbus, que permite leer y escribir registros. Para usarla con FoxESS, necesitamos configurar un 'cliente Modbus' y luego definir los sensores que leerán los registros específicos del inversor.

2.1 Instalación de la Integración Modbus

En Home Assistant, ve a Configuración > Dispositivos y Servicios > Añadir Integración. Busca 'Modbus' y selecciona la opción 'Modbus TCP'. Introduce los siguientes parámetros:

• Host: Dirección IP del inversor (ej. 192.168.1.100).
• Puerto: 502 (por defecto).
• ID de unidad (Slave): Generalmente 1 para inversores FoxESS. Consulta el manual para confirmar.

Tras guardar, Home Assistant creará un sensor de estado 'Modbus TCP' que indica si la conexión está activa. Si ves un error, revisa la IP y el puerto, y asegúrate de que no haya un firewall bloqueando.

2.2 Configuración Manual de Sensores Modbus (YAML)

Para leer datos específicos del inversor, necesitamos definir sensores Modbus en el archivo configuration.yaml. FoxESS utiliza registros de tipo 'holding register' (16 bits) para la mayoría de los parámetros. A continuación, se muestra un ejemplo de configuración para leer la potencia actual, la energía total y la temperatura del inversor. Abre el archivo configuration.yaml (o crea un archivo separado en packages/) y añade lo siguiente:

modbus:
  - name: foxess
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: "Potencia AC Inversor"
        unit_of_measurement: "W"
        slave: 1
        address: 31001
        input_type: holding
        data_type: uint16
        scale: 1
        precision: 0
      - name: "Energía Total Diaria"
        unit_of_measurement: "kWh"
        slave: 1
        address: 31003
        input_type: holding
        data_type: uint16
        scale: 0.1
        precision: 1
      - name: "Temperatura Inversor"
        unit_of_measurement: "°C"
        slave: 1
        address: 31005
        input_type: holding
        data_type: int16
        scale: 0.1
        precision: 1

Las direcciones de registro (31001, 31003, etc.) son ejemplos basados en la documentación de FoxESS. Debes consultar el mapa de registros específico de tu modelo, que suele estar disponible en el portal de desarrolladores de FoxESS o en foros especializados. Tras guardar el archivo, reinicia Home Assistant para que los cambios surtan efecto. Luego, podrás ver los nuevos sensores en 'Estados' y añadirlos a tu dashboard.

Paso 3: Crear un Panel de Control Personalizado

Una vez que los sensores están disponibles, puedes diseñar un dashboard en Home Assistant para visualizar los datos de tu inversor. Utiliza tarjetas como 'Entities', 'Gauge' o 'History Graph' para mostrar la potencia actual, la energía generada y otras métricas. A continuación, te mostramos un ejemplo de configuración para una tarjeta de resumen:

type: vertical-stack
cards:
  - type: entities
    title: Inversor FoxESS
    entities:
      - entity: sensor.potencia_ac_inversor
        name: Potencia AC
      - entity: sensor.energia_total_diaria
        name: Energía Hoy
      - entity: sensor.temperatura_inversor
        name: Temperatura
  - type: gauge
    entity: sensor.potencia_ac_inversor
    name: Potencia Actual
    min: 0
    max: 5000
    severity:
      green: 0
      yellow: 3000
      red: 4500

Puedes añadir más tarjetas para mostrar gráficos históricos, comparativas diarias o alertas personalizadas. La flexibilidad de Home Assistant te permite crear un panel tan detallado como desees.

Paso 4: Automatizaciones Avanzadas con Datos del Inversor

Con los datos del inversor en Home Assistant, puedes crear automatizaciones inteligentes. Por ejemplo, puedes programar que cuando la producción solar supere un umbral, se encienda un calentador de agua o se cargue un vehículo eléctrico. También puedes recibir notificaciones si la temperatura del inversor es demasiado alta o si la potencia cae repentinamente. Aquí tienes un ejemplo de automatización que envía una notificación si la potencia supera los 4000 W:

automation:
  - alias: "Alerta de Alta Potencia"
    trigger:
      - platform: numeric_state
        entity_id: sensor.potencia_ac_inversor
        above: 4000
    action:
      - service: notify.mobile_app
        data:
          title: "Inversor: Alta Potencia"
          message: "La potencia del inversor ha superado los 4000 W."

Las posibilidades son infinitas. Puedes combinar los datos solares con sensores de consumo, precios de la electricidad o condiciones meteorológicas para optimizar el uso de la energía.

Tabla Comparativa: Métodos de Integración FoxESS

Existen varias formas de integrar un inversor FoxESS en Home Assistant. A continuación, comparamos las principales opciones:

Como se observa, Modbus TCP ofrece el mejor equilibrio entre simplicidad, coste y rendimiento. Es la opción recomendada para la mayoría de los usuarios.

Preguntas Frecuentes (FAQ)

Conclusión y Próximos Pasos

Integrar tu inversor FoxESS en Home Assistant mediante Modbus TCP te permite monitorizar y controlar tu producción solar de forma local, rápida y sin costes adicionales. Hemos recorrido todo el proceso: desde localizar la IP del inversor, instalar la integración Modbus, configurar sensores personalizados, hasta crear automatizaciones y paneles de control. Con esta guía, tendrás acceso a datos en tiempo real como potencia, energía y temperatura, lo que te ayudará a tomar decisiones informadas sobre tu consumo energético.

Como próximos pasos, te recomendamos explorar el mapa completo de registros Modbus de tu modelo FoxESS para añadir más sensores, como tensión de paneles, corriente de batería o estado de alarmas. También puedes combinar estos datos con sensores de consumo eléctrico general para calcular el autoconsumo. La comunidad de Home Assistant es muy activa; no dudes en compartir tus configuraciones y descubrimientos en foros especializados.