ENPLDEPT
Flash
Toda a documentação
Modbus · beta

Seu inversor no node — via RS485, só leitura.

O firmware 1.14 lê um inversor ou um medidor de energia via Modbus RTU e transforma os valores em entidades do node, e também funciona como ponte Modbus TCP para o Home Assistant falar com o mesmo barramento RS485. As duas funções vêm desligadas e funcionam na LAN sem internet.

O que faz

Duas funções independentes, ambas desligadas por padrão:

  • Leitura de registros — o node lê até 16 registros a cada 10 segundos (FC03/FC04; u16, s16, u32, s32, f32; ordem das palavras; escala; unidade) e publica-os como entidades own.mb_<nome> ou como leituras nativas, como potência da rede e carga da bateria. Aparecem no cartão do node no app, no Home Assistant pela integração HACS e na API local do node.
  • Ponte Modbus TCP na porta 502 — Home Assistant (integração Modbus nativa), Node-RED ou SCADA ligam-se ao node por TCP e falam com qualquer aparelho no barramento RS485: inversor, medidor, bomba de calor, recuperador. Funções de leitura FC1–4 passam sempre, escrita só depois de ligada.

O firmware 1.14 já foi distribuído na rede (placas LoRa: 1.14-lora2); o que mudou em cada versão está no CHANGELOG.

Ligação

É preciso um módulo RS485 (por exemplo MAX485, ou um módulo com direção automática) entre o node e a porta RS485/Modbus do inversor (A com A, B com B, terra comum se a porta tiver).

ajustepadrãocampo
pino RX16rx
pino TX17tx
pino DE/REnenhum (módulo com direção automática)de
velocidade9600 baud, 8N1baud, parity (N/E/O)
endereço Modbus do aparelho1slave

Velocidade 1200–115200, paridade nenhuma, par ou ímpar. Mude os pinos se a sua placa usa 16/17 para outra coisa.

Como ligar

No app beta (1.6.6 ou mais novo) abra a configuração do node e escolha Modbus RS485: escolha um preset, defina os pinos e salve. O app fala com o node na LAN com o PIN do node.

O mesmo pela API local do node (troque o IP e o PIN):

curl http://192.168.1.50/node/modbus
curl -X POST -H "Authorization: Bearer 123456" \
     -d '{"on":true,"preset":"deye1"}' http://192.168.1.50/node/modbus

GET /node/modbus devolve a configuração, a lista de presets, os últimos valores e contadores. POST /node/modbus (exige PIN) aceita os campos da tabela acima mais on (leitura), bridge (TCP 502), write (permitir escrita pela ponte) e preset ou a sua própria lista regs.

Presets

presetaparelhovalores
deye1híbrido Deye/Sunsynk monofásicopotência PV1 e PV2, potência da rede, da carga e da bateria, SoC e tensão da bateria, tensão e frequência da rede, PV hoje e total, temperatura do inversor, códigos de aviso e de falha
deye3híbrido Deye/Sunsynk trifásico LVo mesmo conjunto para os modelos trifásicos de baixa tensão
sdmmedidor Eastron SDM120 (monofásico)tensão, corrente, potência, frequência, energia importada e exportada

Um preset é só uma lista de registros pronta: depois de carregada pode editá-la ou trocá-la pelos seus registros (até 16).

Home Assistant pela ponte

Ligue a ponte ("bridge":true) e adicione no Home Assistant um hub Modbus apontando para o node:

modbus:
  - name: inverter
    type: tcp
    host: 192.168.1.50
    port: 502

O node encaminha cada pedido TCP para o barramento RS485 e devolve a resposta. A ponte tem prioridade sobre a leitura própria do node, por isso as duas podem funcionar ao mesmo tempo.

Estado da beta

  • A leitura só lê; o node nunca altera configurações do inversor, a não ser que ligue a escrita na ponte.
  • Os mapas Deye/Sunsynk ainda não foram verificados num inversor real — compare com o visor, sobretudo o sinal da potência da bateria.
  • Quer ajudar? O programa de testadores tem um cenário Deye: testadores.

Perguntas, respostas diretas

Isto está pronto?

Não, é uma beta. Os mapas de registros Deye/Sunsynk vêm da documentação do fabricante e ainda não foram verificados num inversor real. Compare os valores com o visor do inversor antes de confiar neles e conte o resultado no programa de testadores.

O node pode alterar configurações do inversor?

Não ao ler: a leitura usa só funções de leitura (FC03/FC04). A ponte TCP deixa passar funções de escrita (FC5/6/15/16) apenas se você ligar "write"; por padrão ela também só lê.

Precisa de internet?

Não. A configuração passa pela LAN com o PIN do node, a leitura e a ponte rodam no node. A internet só é necessária para ver os valores remotamente no app ou no mapa.

Que firmware preciso?

1.14 ou mais novo (nas placas LoRa 1.14-lora2). Os nodes se atualizam sozinhos por OTA; a versão aparece no cartão do node no app.

Atualizado: 2026-11-18