Skip to main content
PromptQuorumPromptQuorum
Inicio/Balcony Solar/Conectar solar de balcón a Home Assistant en local: guía por marca
Balcony Solar Foundations

Conectar solar de balcón a Home Assistant en local: guía por marca

·11 min de lectura·Por Hans Kuepper · Fundador de PromptQuorum, herramienta de despacho multi-modelo · PromptQuorum

Tres rutas de protocolo cubren casi todas las marcas de solar de balcón: Modbus TCP (acceso directo a registros por Ethernet, funciona sin conexión), puente MQTT (pub/sub mediante broker local) y API REST local (llamadas HTTP al dispositivo o su pasarela). La ruta disponible depende del modelo exacto, no solo de la marca.

La mayoría de los kits de solar de balcón soportan integración local con Home Assistant, pero el protocolo depende de la marca y la línea de producto. Anker SOLIX usa Modbus TCP oficial en el puerto 502. Hoymiles pasa por una pasarela DTU-Pro con el mismo protocolo. El Zendure SolarFlow 800 Pro tiene una API HTTP/MQTT local; los modelos Zendure más antiguos necesitan un puente MQTT en la nube. EcoFlow PowerStream sigue siendo dependiente de la nube.

Conclusiones clave

  • Tres protocolos locales cubren casi todas las marcas: Modbus TCP, puente MQTT y API REST local. La elección correcta depende del modelo exacto del dispositivo.
  • Modbus TCP es la ruta sin conexión más fiable — funciona sin internet ni broker en la nube, mediante lectura directa de registros por la red local.
  • EcoFlow PowerStream es la excepción principal: ninguna ruta Modbus TCP o MQTT local disponible a fecha de verificación (2026-07-03). Todo pasa por la nube EcoFlow.
  • Victron Cerbo GX ofrece el mejor control local: integración HA oficial (desde HA 2026.5), Modbus TCP documentado y MQTT local completamente sin conexión.
  • El soporte de interfaz local puede cambiar con actualizaciones de firmware — verificar el repositorio de integración actual antes de comprar.

Tres rutas de protocolo para integración local

Modbus TCP lee registros del dispositivo directamente por la red local — sin cuenta en la nube, broker ni software adaptador. El dispositivo escucha en un puerto TCP (normalmente 502 u 8899) y responde a comandos de lectura de registros. Funciona incluso si la conexión a internet cae.

Las integraciones de puente MQTT se sitúan entre el dispositivo y Home Assistant. El dispositivo publica datos en un topic — en el broker en la nube del fabricante o en una instancia Mosquitto local. Apuntando a un broker local, funciona completamente sin conexión.

Las rutas de API REST local usan llamadas HTTP GET/POST al dispositivo o su pasarela en la red local. Zendure SolarFlow 800 Pro lo expone de forma nativa. Marstek lo ofrece mediante Marstek Local API (HACS). Kostal Plenticore usa la misma API REST que su interfaz web integrada.

📍 En una frase

Modbus TCP lee registros directamente por la red local, el puente MQTT usa un broker pub/sub y la API REST local responde peticiones HTTP directamente en el dispositivo.

💬 En términos simples

Modbus TCP = conexión directa en la red local; MQTT = sistema de mensajería con broker intermediario; API REST = el dispositivo responde como un sitio web.

Matriz de compatibilidad por marca

Todas las celdas se verificaron el 2026-07-03 contra repositorios de integración GitHub activos y documentación del fabricante. El soporte de interfaz local cambia con versiones de firmware — usar esta tabla como punto de partida y verificar el estado actual antes de comprar.

Marca / ProductoModbus TCPMQTT localAPI REST local¿Sin conexión?Integración HA
Anker SOLIX (almacenamiento)✅ puerto 502, oficial⚠️ solo puente nube✅ vía Modbusha-anker-solix-official (HACS)
Zendure SolarFlow 800 Pro✅ HTTP+MQTT local✅ HTTP localZendure/Zendure-HA (oficial)
Zendure Hub 1200/2000, Hyper 2000⚠️ solo MQTT nubez-master42/solarflow (comunidad)
Hoymiles HMS/HMT (vía DTU-Pro)✅ vía DTU-Pro✅ OpenDTU / hoymiles-mqtthoymiles-mqtt-integration (HACS)
Marstek B2500 / Jupiter / Venus⚠️ RS485 solo en Venus✅ hame-relay+hm2mqtt✅ Marstek Local APIMarstek Local API v1.0.0 (HACS)
Growatt NOAH 2000 / inversores✅ Modbus TCP local✅ noah-mqtt / growatt2mqttHomeassistant-Growatt-Local-Modbus (HACS)
Deye SUN600G3 (microinversor)✅ puerto 8899 (no documentado)✅ SolarmanV5 / deye-inverter-mqttIntegración Solarman HACS
Victron Cerbo GX✅ oficial, documentado✅ oficial (HA 2026.5+)Integración HA oficial
Sungrow serie SH-RT✅ comunidad✅ ModbusTCP2MQTTSungrow-SHx-Inverter-Modbus (HACS)
Kostal Plenticore (G3+)✅ HACS✅ API REST oficialIntegración HA oficial (REST)
EcoFlow PowerStream❌ solo MQTT nubetolwi/hassio-ecoflow-cloud (solo nube)

Verificado el 2026-07-03. Las actualizaciones de firmware pueden añadir o eliminar acceso local — verificar antes de comprar.

Ruta A: Configuración Modbus TCP

Modbus TCP tiene tres requisitos: el dispositivo en la misma red local que Home Assistant, la interfaz Modbus habilitada y el mapa de registros del modelo. La mayoría de las integraciones HACS comunitarias incluyen el mapa de registros — solo hay que proporcionar la dirección IP.

  1. 1
    Habilitar Modbus TCP en el dispositivo: Anker SOLIX → app Anker → ajustes → habilitar Modbus. Hoymiles → interfaz web DTU-Pro. Growatt → habilitado por defecto. Deye → sin ajuste necesario, puerto 8899 siempre abierto.
  2. 2
    Asignar dirección IP estática al dispositivo en el router (o reserva DHCP) para que la dirección de integración HA no cambie.
  3. 3
    Instalar la integración HACS correspondiente: ha-anker-solix-official para Anker, hoymiles-mqtt-integration para Hoymiles, Homeassistant-Growatt-Local-Modbus para Growatt, Solarman para Deye, integración Victron GX oficial para Victron.
  4. 4
    Introducir la IP del dispositivo y el puerto en los ajustes de integración. Puerto Modbus estándar: 502; Deye usa 8899.
  5. 5
    Verificar las entidades de sensores en HA — la potencia de salida actual debería actualizarse en 5-10 segundos. Si las entidades muestran "no disponible", comprobar IP, activación Modbus y reglas de firewall.

Ruta B: Configuración del puente MQTT

Las integraciones de puente MQTT funcionan ejecutando un pequeño script adaptador (o add-on HA) que sondea el dispositivo o recibe sus datos push y los republica en el broker Mosquitto local. Home Assistant se suscribe a esos topics mediante la integración MQTT. Completamente sin conexión una vez configurado el adaptador contra un broker local.

  1. 1
    Instalar el broker Mosquitto como add-on HA (Ajustes → Add-ons → Mosquitto Broker) y configurar usuario y contraseña.
  2. 2
    Configurar la integración MQTT en HA (Ajustes → Dispositivos y servicios → Añadir integración → MQTT) y conectarla al broker local.
  3. 3
    Instalar el adaptador específico del dispositivo: noah-mqtt para Growatt NOAH 2000, hame-relay+hm2mqtt para Marstek, hoymiles-mqtt para Hoymiles, deye-inverter-mqtt para Deye o Zendure-HA para Zendure. Ejecutar como contenedor Docker o add-on HA.
  4. 4
    Apuntar el adaptador a la IP del dispositivo y, si es posible, al broker Mosquitto local en lugar del broker en la nube del fabricante.
  5. 5
    Confirmar el flujo de datos: las entidades deben aparecer automáticamente vía MQTT discovery, o comprobar mensajes entrantes en la sección Topics de la integración MQTT de HA.

Ruta C: API REST local

Una API REST local significa que el dispositivo ejecuta un servidor HTTP en la red local — sin adaptador separado. Zendure SolarFlow 800 Pro, Marstek (vía Marstek Local API HACS) y Kostal Plenticore usan esta ruta.

  1. 1
    Confirmar disponibilidad de API local para el modelo: README de integración HACS o portal para desarrolladores del fabricante.
  2. 2
    Instalar la integración desde HACS: buscar "Marstek Local API" o "Kostal Plenticore". Zendure-HA (oficial) gestiona tanto API local como MQTT nube.
  3. 3
    Introducir la IP del dispositivo y, donde sea necesario, la contraseña de administrador (Kostal usa la contraseña de la interfaz web).
  4. 4
    Verificar entidades de sensores y control — para Kostal y Marstek incluye control del límite de carga de batería, no solo monitorización.

Integración EVCC

EVCC (controlador de carga de VE de código abierto) puede consumir datos de producción local del solar de balcón para sincronizar la carga del VE con los picos solares. EVCC soporta Modbus TCP y MQTT de forma nativa. En evcc.yaml, configurar el dispositivo como contador con type: modbus o type: mqtt.

Preguntas frecuentes

¿Habilitar Modbus TCP en Anker SOLIX desactiva la app Anker?

No. La integración Modbus oficial de Anker SOLIX funciona en paralelo con la app y la nube Anker. Habilitar Modbus TCP en los ajustes de la app añade acceso local a registros sin eliminar la funcionalidad en la nube.

¿Por qué la matriz muestra dos filas diferentes para Zendure?

El Zendure SolarFlow 800 Pro tiene una API HTTP/MQTT local que funciona sin conexión a internet. Los modelos Zendure más antiguos (Hub 1200, Hub 2000, Hyper 2000, Ace 1500) solo se comunican con el broker MQTT en la nube de Zendure. La integración oficial Zendure-HA gestiona ambas rutas.

¿EcoFlow PowerStream obtendrá control local?

EcoFlow declaró a mediados de 2025 que las soluciones locales estaban en desarrollo, sin fecha de lanzamiento. No existía ninguna ruta de API local o Modbus TCP verificada para PowerStream a fecha de verificación (2026-07-03). Consultar la comunidad de desarrolladores EcoFlow o el repositorio hassio-ecoflow-cloud para el estado actual.

¿Qué marca tiene el mejor control local en general?

Victron Cerbo GX tiene el mejor soporte local: integración oficial en el núcleo de Home Assistant (desde HA 2026.5), Modbus TCP documentado con mapa de registros publicado y MQTT local completamente sin conexión. Anker SOLIX le sigue con integración HACS comunitaria oficial y Modbus TCP en puerto 502 funcionando en paralelo a la app en la nube.

← Volver a Balcony Solar