Principais conclusões
- Três protocolos locais cobrem quase todas as marcas: Modbus TCP, ponte MQTT e API REST local. A escolha certa depende do modelo exato do dispositivo.
- Modbus TCP é a rota offline mais fiável — funciona sem internet nem broker na nuvem, através de leitura direta de registros pela rede local.
- EcoFlow PowerStream é a exceção principal: nenhuma rota Modbus TCP ou MQTT local disponível na data de verificação (2026-07-03). Tudo passa pela nuvem EcoFlow.
- Victron Cerbo GX oferece o melhor controlo local: integração HA oficial (desde HA 2026.5), Modbus TCP documentado e MQTT local completamente offline.
- O suporte de interface local pode mudar com atualizações de firmware — verificar o repositório de integração atual antes de comprar.
Três rotas de protocolo para integração local
Modbus TCP lê registros do dispositivo diretamente pela rede local — sem conta na nuvem, broker ou software adaptador. O dispositivo escuta numa porta TCP (normalmente 502 ou 8899) e responde a comandos de leitura de registros. Funciona mesmo que a ligação à internet caia.
As integrações de ponte MQTT situam-se entre o dispositivo e o Home Assistant. O dispositivo publica dados num tópico — no broker na nuvem do fabricante ou numa instância Mosquitto local. Apontando para um broker local, funciona completamente offline.
As rotas de API REST local usam chamadas HTTP GET/POST ao dispositivo ou ao seu gateway na rede local. O Zendure SolarFlow 800 Pro expõe isto nativamente. O Marstek oferece-o via Marstek Local API (HACS). O Kostal Plenticore usa a mesma API REST que a sua interface web integrada.
📍 Em uma frase
Modbus TCP lê registros diretamente pela rede local, a ponte MQTT usa um broker pub/sub e a API REST local responde a pedidos HTTP diretamente no dispositivo.
💬 Em termos simples
Modbus TCP = ligação direta na rede local; MQTT = sistema de mensagens com broker intermediário; API REST = o dispositivo responde como um website.
Matriz de compatibilidade por marca
Todas as células foram verificadas em 2026-07-03 contra repositórios de integração GitHub ativos e documentação do fabricante. O suporte de interface local muda com versões de firmware — usar esta tabela como ponto de partida e verificar o estado atual antes de comprar.
| Marca / Produto | Modbus TCP | MQTT local | API REST local | Offline? | Integração HA |
|---|---|---|---|---|---|
| Anker SOLIX (armazenamento) | ✅ porta 502, oficial | ⚠️ apenas ponte nuvem | — | ✅ via Modbus | ha-anker-solix-official (HACS) |
| Zendure SolarFlow 800 Pro | — | ✅ HTTP+MQTT local | ✅ HTTP local | ✅ | Zendure/Zendure-HA (oficial) |
| Zendure Hub 1200/2000, Hyper 2000 | — | ⚠️ apenas MQTT nuvem | — | ❌ | z-master42/solarflow (comunidade) |
| Hoymiles HMS/HMT (via DTU-Pro) | ✅ via DTU-Pro | ✅ OpenDTU / hoymiles-mqtt | — | ✅ | hoymiles-mqtt-integration (HACS) |
| Marstek B2500 / Jupiter / Venus | ⚠️ RS485 apenas no Venus | ✅ hame-relay+hm2mqtt | ✅ Marstek Local API | ✅ | Marstek Local API v1.0.0 (HACS) |
| Growatt NOAH 2000 / inversores | ✅ Modbus TCP local | ✅ noah-mqtt / growatt2mqtt | — | ✅ | Homeassistant-Growatt-Local-Modbus (HACS) |
| Deye SUN600G3 (microinversor) | ✅ porta 8899 (não documentada) | ✅ SolarmanV5 / deye-inverter-mqtt | — | ✅ | Integração Solarman HACS |
| Victron Cerbo GX | ✅ oficial, documentado | ✅ oficial (HA 2026.5+) | — | ✅ | Integração HA oficial |
| Sungrow série SH-RT | ✅ comunidade | ✅ ModbusTCP2MQTT | — | ✅ | Sungrow-SHx-Inverter-Modbus (HACS) |
| Kostal Plenticore (G3+) | ✅ HACS | — | ✅ API REST oficial | ✅ | Integração HA oficial (REST) |
| EcoFlow PowerStream | ❌ | ❌ apenas MQTT nuvem | ❌ | ❌ | tolwi/hassio-ecoflow-cloud (apenas nuvem) |
Verificado em 2026-07-03. Atualizações de firmware podem adicionar ou remover acesso local — verificar antes de comprar.
Rota A: Configuração Modbus TCP
Modbus TCP tem três requisitos: dispositivo na mesma rede local que o Home Assistant, interface Modbus ativada e mapa de registros do modelo. A maioria das integrações HACS da comunidade inclui o mapa de registros — basta fornecer o endereço IP.
- 1Ativar Modbus TCP no dispositivo: Anker SOLIX → app Anker → definições → ativar Modbus. Hoymiles → interface web DTU-Pro. Growatt → ativo por defeito. Deye → sem configuração necessária, porta 8899 sempre aberta.
- 2Atribuir endereço IP estático ao dispositivo no router (ou reserva DHCP) para que o endereço de integração HA não mude.
- 3Instalar a integração HACS correspondente: ha-anker-solix-official para Anker, hoymiles-mqtt-integration para Hoymiles, Homeassistant-Growatt-Local-Modbus para Growatt, Solarman para Deye, integração Victron GX oficial para Victron.
- 4Inserir o IP do dispositivo e a porta nas definições de integração. Porta Modbus padrão: 502; Deye usa 8899.
- 5Verificar entidades de sensores no HA — a potência de saída atual deve atualizar em 5-10 segundos. Se as entidades mostrarem "indisponível", verificar IP, ativação Modbus e regras de firewall.
Rota B: Configuração da ponte MQTT
As integrações de ponte MQTT funcionam executando um pequeno script adaptador (ou add-on HA) que consulta o dispositivo ou recebe os seus dados push e os republica no broker Mosquitto local. O Home Assistant subscreve esses tópicos via integração MQTT. Completamente offline com o adaptador configurado contra um broker local.
- 1Instalar o broker Mosquitto como add-on HA (Definições → Add-ons → Mosquitto Broker) e configurar utilizador e palavra-passe.
- 2Configurar a integração MQTT no HA (Definições → Dispositivos e serviços → Adicionar integração → MQTT) e ligá-la ao broker local.
- 3Instalar o adaptador específico do dispositivo: noah-mqtt para Growatt NOAH 2000, hame-relay+hm2mqtt para Marstek, hoymiles-mqtt para Hoymiles, deye-inverter-mqtt para Deye ou Zendure-HA para Zendure.
- 4Apontar o adaptador para o IP do dispositivo e, se possível, para o broker Mosquitto local em vez do broker na nuvem do fabricante.
- 5Confirmar o fluxo de dados: entidades devem aparecer automaticamente via MQTT discovery.
Rota C: API REST local
Uma API REST local significa que o dispositivo executa um servidor HTTP na rede local — sem adaptador separado. Zendure SolarFlow 800 Pro, Marstek e Kostal Plenticore usam esta rota.
- 1Confirmar disponibilidade de API local para o modelo: README de integração HACS ou portal de developers do fabricante.
- 2Instalar a integração do HACS: pesquisar "Marstek Local API" ou "Kostal Plenticore". Zendure-HA (oficial) gere ambas as rotas.
- 3Inserir o IP do dispositivo e, onde necessário, a palavra-passe de administrador.
- 4Verificar entidades de sensores e controlo — para Kostal e Marstek inclui controlo do limite de carga da bateria.
Integração EVCC
O EVCC (controlador de carga VE open-source) pode consumir dados de produção local do solar de varanda para sincronizar a carga do VE com os picos solares. Suporta Modbus TCP e MQTT nativamente. Em evcc.yaml, configurar o dispositivo como medidor com type: modbus ou type: mqtt.
Perguntas frequentes
Ativar Modbus TCP no Anker SOLIX desativa a app Anker?
Não. A integração Modbus oficial do Anker SOLIX funciona em paralelo com a app e a nuvem Anker. Ativar Modbus TCP nas definições da app adiciona acesso local a registros sem remover a funcionalidade na nuvem.
Por que a matriz mostra duas linhas diferentes para o Zendure?
O Zendure SolarFlow 800 Pro tem uma API HTTP/MQTT local que funciona sem ligação à internet. Os modelos Zendure mais antigos (Hub 1200, Hub 2000, Hyper 2000, Ace 1500) comunicam apenas com o broker MQTT na nuvem da Zendure. A integração oficial Zendure-HA gere ambas as rotas.
O EcoFlow PowerStream vai ter controlo local?
A EcoFlow declarou em meados de 2025 que soluções locais estavam em desenvolvimento, sem data de lançamento. Não existia nenhuma rota de API local ou Modbus TCP verificada para o PowerStream na data de verificação (2026-07-03). Consultar a comunidade de developers da EcoFlow para o estado atual.
Qual marca tem o melhor controlo local no geral?
Victron Cerbo GX tem o melhor suporte local: integração oficial no núcleo do Home Assistant (desde HA 2026.5), Modbus TCP documentado com mapa de registros publicado e MQTT local completamente offline. Anker SOLIX segue-se com integração HACS comunitária oficial e Modbus TCP na porta 502.