Cómo Integrar un Inversor Solar SolaX con Batería Pylontech en Home Assistant: Monitorización y Automatización Avanzada

La integración de un inversor solar SolaX con baterías Pylontech en Home Assistant se ha convertido en una de las configuraciones más demandadas por los entusiastas del autoconsumo y la domótica. Esta combinación permite no solo visualizar en tiempo real la producción solar, el estado de carga de la batería y los flujos de energía, sino también crear automatizaciones inteligentes que maximizan el ahorro energético y protegen los componentes. En esta guía exhaustiva, exploraremos desde los fundamentos técnicos de la comunicación Modbus hasta la implementación práctica de sensores y automatizaciones avanzadas, pasando por la resolución de errores comunes y una comparativa detallada de alternativas. Si buscas llevar tu instalación fotovoltaica al siguiente nivel, has llegado al lugar correcto.

Introducción al ecosistema SolaX y Pylontech

El inversor SolaX, especialmente la serie X1 (monofásica) y X3 (trifásica), es ampliamente reconocido por su robustez, eficiencia y compatibilidad con una amplia gama de baterías de litio. Por su parte, Pylontech se ha consolidado como uno de los fabricantes de baterías LiFePO4 más fiables del mercado, con modelos como el US2000, US3000 y US5000 que ofrecen una excelente relación calidad-precio y ciclos de vida superiores a 6000. La combinación de ambos forma un tándem perfecto para instalaciones de autoconsumo residencial y comercial.

Home Assistant, la plataforma de domótica de código abierto, actúa como el cerebro central que unifica toda la información. A través de integraciones nativas o personalizadas, podemos extraer datos del inversor mediante el protocolo Modbus TCP o RTU, y de las baterías a través del BMS (Battery Management System) que se comunica con el inversor. El resultado es un panel de control unificado donde se visualizan gráficas históricas, se configuran alertas y se disparan automatizaciones basadas en condiciones como el excedente de producción solar o el nivel de carga de la batería.

Análisis técnico: Comunicación Modbus y registros clave

La piedra angular de la integración es el protocolo Modbus, un estándar de comunicación industrial que permite leer y escribir registros en el inversor. SolaX implementa Modbus TCP sobre el puerto 502 (por defecto) o Modbus RTU a través de RS485. Para Home Assistant, la vía más sencilla es utilizar la integración oficial Solax Modbus (disponible a través de HACS) o bien configurar sensores Modbus manualmente con la integración nativa modbus.

Registros Modbus esenciales

Cada dato que queremos monitorizar corresponde a una dirección de registro específica. A continuación, se muestran los registros más relevantes para un inversor SolaX híbrido con baterías Pylontech. Es fundamental consultar el documento SolaX Modbus Protocol para la versión exacta de tu inversor, ya que las direcciones pueden variar entre generaciones.

Además de estos, existen registros para la energía acumulada (kWh), frecuencia de red, voltaje de strings PV, y muchos más. La integración SolaX Modbus de HACS ya incluye una amplia selección de sensores predefinidos, lo que simplifica enormemente la configuración inicial. Sin embargo, para un control avanzado, es posible que necesitemos crear sensores personalizados.

Comunicación con el BMS de Pylontech

Las baterías Pylontech se comunican con el inversor SolaX a través de un bus CAN o RS485. El inversor actúa como maestro y solicita al BMS datos como el SOC, voltaje, corriente y temperatura de cada módulo. Home Assistant no se conecta directamente al BMS, sino que obtiene esta información del inversor a través de los registros Modbus correspondientes. Por tanto, es crucial que la comunicación entre el inversor y las baterías sea estable. Si el inversor no recibe datos del BMS, los registros de batería aparecerán como no disponibles o con valores erróneos.

Guía de instalación paso a paso en Home Assistant

A continuación, detallamos el proceso completo para integrar tu inversor SolaX y baterías Pylontech en Home Assistant. Asumimos que ya tienes Home Assistant instalado (preferiblemente en un dispositivo dedicado como Raspberry Pi o mini PC) y acceso a la red local donde se encuentra el inversor.

Paso 1: Preparar el inversor SolaX

Lo primero es asegurar que el inversor tenga habilitado el protocolo Modbus TCP. Algunos modelos requieren la instalación de un módulo de comunicación adicional (como el SolaX Pocket WiFi o el SolaX LAN Box). Si tu inversor ya tiene conexión Ethernet, es probable que Modbus TCP esté activo por defecto en el puerto 502. Para verificarlo, puedes usar una herramienta como mbpoll o QModMaster desde un ordenador en la misma red. Si no obtienes respuesta, consulta el manual del inversor para habilitar Modbus TCP.

Paso 2: Instalar la integración SolaX Modbus

La forma más rápida es utilizar la integración personalizada Solax Modbus disponible en HACS. Para ello:

• Abre HACS: Ve a la sección de integraciones y busca "Solax Modbus".
• Instala y reinicia: Tras la instalación, reinicia Home Assistant.
• Añade la integración: Ve a Configuración > Dispositivos y Servicios > Añadir integración y busca "Solax Modbus".

Durante la configuración, se te pedirá la dirección IP del inversor, el puerto (502 por defecto) y el número de serie o modelo. La integración creará automáticamente decenas de sensores. Si prefieres no usar HACS, puedes configurar los sensores manualmente en configuration.yaml usando la integración Modbus nativa. Aquí tienes un ejemplo básico:

modbus:
  - name: solax
    type: tcp
    host: 192.168.1.100
    port: 502
    sensors:
      - name: Produccion Solar
        slave: 1
        address: 0
        input_type: input
        unit_of_measurement: W
        scale: 1
        precision: 0
        data_type: uint16

Este código define un sensor que lee la producción solar total. Deberás repetir la estructura para cada registro que quieras monitorizar. La integración de HACS simplifica esto al predefinir los sensores más comunes.

Paso 3: Verificar la comunicación con las baterías Pylontech

Una vez integrado el inversor, comprueba que los sensores relacionados con la batería (SOC, voltaje, corriente, temperatura) muestran valores coherentes. Si aparecen como "no disponible" o "desconocido", revisa la conexión física entre el inversor y el BMS de Pylontech. Asegúrate de que el cable de comunicación (CAN o RS485) esté correctamente conectado y que el protocolo de batería seleccionado en el inversor sea el correcto (por ejemplo, "Pylontech" en el menú de configuración).

Paso 4: Crear un panel de control personalizado

Con los sensores ya disponibles, el siguiente paso es diseñar un dashboard atractivo y funcional. Home Assistant ofrece tarjetas como Mini Graph Card, ApexCharts Card o Power Flow Card para visualizar los flujos de energía. Un panel típico incluiría:

Automatizaciones avanzadas para maximizar el ahorro

La verdadera potencia de Home Assistant reside en la capacidad de crear automatizaciones que aprovechen los datos en tiempo real. A continuación, presentamos varios ejemplos prácticos que puedes adaptar a tu instalación.

Automatización 1: Encender cargas cuando hay excedente solar

Si tu inversor está configurado para verter excedentes a la red, es posible que no estés aprovechando al máximo la energía solar. Con esta automatización, cuando la producción solar supere el consumo de la casa y el SOC de la batería esté por encima del 90%, se activarán cargas como el termo eléctrico, la bomba de la piscina o un cargador de vehículo eléctrico. El siguiente código YAML muestra un ejemplo:

alias: Excedente solar a termo
trigger:
  - platform: numeric_state
    entity_id: sensor.solax_pv_power
    above: 2000
condition:
  - condition: numeric_state
    entity_id: sensor.pylontech_soc
    above: 90
action:
  - service: switch.turn_on
    target:
      entity_id: switch.termo_electrico
mode: single

Esta automatización enciende el termo cuando la producción solar supera los 2000 W y la batería está casi llena. Puedes añadir condiciones adicionales, como que sea de día o que el precio de la luz sea bajo, para optimizar aún más.

Automatización 2: Forzar carga de batería en horas valle

Si tu tarifa eléctrica tiene discriminación horaria, puedes programar el inversor para que cargue la batería Pylontech durante las horas valle (cuando la electricidad es más barata) y así tener energía almacenada para las horas punta. Esto se logra escribiendo en el registro Modbus correspondiente al modo de carga forzada. La integración SolaX Modbus expone servicios para cambiar el modo de trabajo. Un ejemplo de automatización sería:

alias: Carga batería en valle
trigger:
  - platform: time
    at: "02:00:00"
action:
  - service: solax_modbus.set_work_mode
    data:
      device_id: tu_device_id
      work_mode: "Force Charge"
  - delay: "04:00:00"
  - service: solax_modbus.set_work_mode
    data:
      device_id: tu_device_id
      work_mode: "Self Use"

Esta automatización cambia el modo a "Force Charge" a las 2:00 y lo devuelve a "Self Use" a las 6:00. Asegúrate de que la potencia de carga forzada esté configurada adecuadamente para no sobrecargar el sistema.

Automatización 3: Alertas de fallo o rendimiento bajo

Home Assistant puede enviarte notificaciones a tu móvil si detecta anomalías, como una caída repentina de la producción solar, una temperatura excesiva de la batería o un SOC que no sube a pesar de estar cargando. Estas alertas tempranas pueden ayudarte a prevenir fallos mayores. Por ejemplo:

alias: Alerta temperatura batería alta
trigger:
  - platform: numeric_state
    entity_id: sensor.pylontech_temperature
    above: 45
    for: "00:05:00"
action:
  - service: notify.mobile_app_tu_movil
    data:
      title: "Temperatura alta en batería"
      message: "La batería Pylontech ha superado los 45°C. Revisa la ventilación."

Esta automatización envía una notificación push si la temperatura de la batería supera los 45°C durante 5 minutos. Puedes crear alertas similares para el voltaje de los strings PV, la frecuencia de red, etc.

Errores comunes, limitaciones y seguridad eléctrica

A pesar de la robustez de la integración, existen varios errores que los usuarios principiantes suelen cometer. Conocerlos de antemano te ahorrará tiempo y frustraciones.

Error 1: Direcciones Modbus incorrectas

Cada modelo de inversor SolaX tiene su propio mapa de registros. Usar direcciones de un modelo diferente puede devolver valores erróneos o provocar excepciones. Siempre verifica el documento oficial para tu modelo exacto. Además, algunos registros son de solo lectura y otros de lectura/escritura; intentar escribir en un registro de solo lectura puede generar un error de comunicación.

Error 2: Problemas de conectividad de red

Si el inversor está conectado por WiFi, la conexión puede ser inestable, provocando timeouts en las lecturas Modbus. Se recomienda encarecidamente utilizar una conexión Ethernet por cable para garantizar la fiabilidad. Si no es posible, asegúrate de que la señal WiFi sea fuerte y considera usar un repetidor o un punto de acceso cercano.

Error 3: Ignorar los límites de la batería

Las baterías Pylontech tienen límites de corriente de carga y descarga, así como un SOC mínimo y máximo recomendados (normalmente 10% y 90% para prolongar su vida útil). Forzar la carga o descarga más allá de estos límites puede dañar las celdas y anular la garantía. Asegúrate de que las automatizaciones respeten estos límites. Por ejemplo, no configures una carga forzada a máxima potencia si la temperatura de la batería es elevada.

Limitaciones de la integración

La integración SolaX Modbus no es oficial y puede dejar de funcionar tras actualizaciones de firmware del inversor. Además, la frecuencia de actualización de los sensores está limitada por el tiempo de respuesta del inversor (típicamente 1-5 segundos). Para aplicaciones que requieran datos en tiempo real (por ejemplo, control de frecuencia), se necesitarían soluciones más avanzadas como un PLC o un microcontrolador dedicado.

Comparativa de métodos de integración

Existen varias vías para integrar SolaX y Pylontech en Home Assistant. A continuación, comparamos las tres más habituales: la integración HACS Solax Modbus, la integración Modbus nativa y el uso de un gateway externo como SolarAssistant.