Aparência
Modbus e Solarman: duas camadas diferentes
Você vai aprender: por que uma conexão de rede não basta para interpretar uma leitura.
Registradores: endereços, não colunas SQL
Um registrador Modbus contém 16 bits. O mapa do fabricante explica quais endereços representam grandezas, quantos registradores ocupam e como interpretar escala e sinal.
Exemplo fictício: um registrador com valor 2310 e escala 0,1 representa 231,0 na unidade indicada pelo mapa. Não basta adivinhar uma grandeza porque o número parece plausível.
O transporte muda entre fabricantes
| Caminho implementado | Solis | SAJ R6 |
|---|---|---|
| Protocolo acessado pela aplicação | Solarman V5 | Modbus TCP |
| Intermediário | Datalogger compatível com Solarman | eSolar |
| Leitura periódica | Input Registers, função de leitura 0x04 | Holding Registers, função de leitura 0x03 |
| Implementação | Biblioteca solarmanv5 | Cliente TCP do adapter |
| Resultado para o runtime | UnifiedTelemetry | UnifiedTelemetry |
Holding não significa que o projeto escreve: a função 0x03 apenas lê. Modbus é estritamente somente leitura neste sistema.
No Modbus TCP, o cabeçalho MBAP identifica e delimita a mensagem. No caminho Solis, a biblioteca trata o envelope Solarman e o Modbus encapsulado. Não trate o identificador do datalogger como senha ou garantia de criptografia.
Por que não ler tudo?
As funções de leitura de registradores têm limite de 125 registradores por pedido na especificação. Esse teto não prova que qualquer bloco menor seja seguro ou suportado: pode conter endereços inválidos, pertencer a outro modelo ou exigir interpretação diferente.
O projeto usa blocos selecionados: um bloco de 50 no Solis e dois blocos periódicos de 22 e 42 no SAJ. Ampliar uma leitura exige nova evidência e validação controlada, não varredura indiscriminada.
Como estudar sem tocar no equipamento
Leia os adapters e compare endereço, posição no vetor e escala. Use valores inventados e testes com respostas em memória. Nenhuma leitura contra hardware é necessária para compreender essas transformações.
Veja os adapters explicados e a referência dos inversores.
Fontes de protocolo: especificação Modbus, seções 6.3 e 6.4 e guia TCP.
Revisão técnica: 06/10/2026. Fontes: SolisAdapter.ts, SajR6Adapter.ts e especificações Modbus citadas.