Transporte Modbus RTU
Na definição Modbus do comutador de modo de interface, o módulo é um escravo Modbus RTU nas suas linhas UART (um transcetor externo adapta-as a RS-485). A camada Modbus é uma tradução sobre o mesmo ficheiro de registos do I²C: as mesmas grandezas, os mesmos comandos, uma só fila de comandos; só o formato no fio é diferente.
Série (Serial)
-
Enquadramento: RTU padrão
[endereço][função][dados][CRC16], polinómio CRC16 0xA001 (refletido), LSB primeiro. Uma trama com CRC errado não tem resposta (comportamento RTU padrão). -
ID de unidade: 1..247, predefinido 1 (
CFG_MODBUS_ADDR). 0 = broadcast (apenas escritas na lista de permitidas, ver abaixo). Os IDs 248..255 são rejeitados na configuração. -
Baud: por defeito 9600. Códigos em
CFG_MB_BAUD: 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1 000 000. O módulo aceita os códigos 0–10; a velocidade da linha em RS-485 é definida pelo transcetor externo. Se o código guardado for inválido, o módulo arranca a 9600. -
Formato de trama:
CFG_MB_FRAME0=8N1 · 1=8E1 · 2=8O1 · 3=8N2. -
Retenção de resposta:
CFG_TX_DELAY0..100 ms — para adaptadores RS-485 de direção automática que precisam de tempo para libertar a linha. -
As definições de série são validadas na escrita (exceção 03). Uma escrita apenas põe o valor em RAM — para o tornar efetivo: guardar (
COMMAND0x04) e depois reiniciar (COMMAND0x02, condicionado a UNLOCK); o módulo arranca com os valores guardados. Passo a passo: Sequências D4. -
Latência de resposta: o intervalo pedido é copiado de forma atómica da imagem publicada, pelo que mesmo uma leitura de 125 registos é internamente coerente; o dispositivo responde em < 20 ms a qualquer baud (adequado a consultas de inversores a 3–5 Hz).
-
Respostas a comandos que causam reinício (RESET, ACTIVATE do firmware, alteração de endereço por UID) podem ser truncadas ou não existir — o dispositivo pode reiniciar antes de concluir a resposta, e um atraso de TX configurado pode suprimi-la por completo. Confirme consultando de novo após o reinício, não pela resposta.
Códigos de função
FC03 ler holding · FC04 ler input · FC06 escrever um · FC16 escrever vários. Qualquer outro código de função → exceção 01.
Limites: FC03/FC04 quantidade 1..125, FC16 1..123 — fora disso → exceção 03. FC16 é tudo ou nada: a trama inteira é validada primeiro; um registo inválido → nada aplicado. COMMAND (holding 0x8113) é apenas de escrita — lê-lo → exceção 02.
Espaços de registos
Os endereços Modbus são um espaço próprio — independente dos endereços I²C. Layout:
| Espaço | Gama | Conteúdo |
|---|---|---|
| Entrada | 0x0000–0x03FF | Perfil float32 (13 pontos ativos, abaixo) |
| Entrada | 0x6000–0x6FFF | perfil nativo de escala inteira (descoberta, canais, energia, totais) |
| Holding | 0x8000–0x83FF | configuração nativa · hora/comandos · atualização de firmware |
| Holding | 0x8400–0x847F | janela de segurança (certificado do dispositivo / certificação; fluxo de bytes) |
| Holding | 0xA000–0xAFFF | espelho só de leitura da entrada nativa (= endereço de entrada + 0x4000) para mestres apenas com FC03 |
| — | tudo o resto | não mapeado → exceção 02 |
Os endereços nativos e holding de cada bloco estão listados com o mapa I²C no mapa de registos.
Perfil nativo (input 0x6000+)
Inteiros de escala fixa, as mesmas unidades do I²C. Ordem de palavras ABCD (palavra alta primeiro) por predefinição; CFG_WORD_ORDER = 1 troca para palavra baixa primeiro em todos os números de vários registos no perfil de entrada nativo (i64 = as quatro palavras invertidas), e os sentinelas de canal ausente trocam da mesma forma. As janelas holding (0x81xx/0x83xx) são sempre palavra alta primeiro, independentemente de CFG_WORD_ORDER. i32 = 2 registos, i64 = 4 registos. Os totais P/Q/S são publicados como i64 por Modbus (com extensão de sinal a partir dos valores do dispositivo).
Perfil float32 (entrada 0x0000)
Modbus RTU com um perfil de registos float32 de 13 valores. Os endereços dos registos e a ordem de palavras ABCD seguem o mapa de registos SDM publicamente documentado. Não testámos o módulo com nenhum dispositivo SDM, nem com software SDM de terceiros, inversor, PLC ou sistema SCADA.
IEEE-754 float32, sempre ABCD, unidades físicas (V/A/W/kWh), exportação como magnitude positiva. Pontos em tempo real (13):
| Endereço de entrada | Ponto |
|---|---|
| 0x0000 / 0x0002 / 0x0004 | tensão L1 / L2 / L3, V |
| 0x0006 / 0x0008 / 0x000A | corrente L1 / L2 / L3, A |
| 0x000C / 0x000E / 0x0010 | potência ativa L1 / L2 / L3, W |
| 0x0034 | potência ativa total, W |
| 0x0046 | frequência, Hz |
| 0x0048 / 0x004A | energia importada / exportada, kWh |
Qualquer outro endereço em 0x0000–0x03FF lê 0; um inversor ou SCADA que precise de registos fora da lista acima não os obtém deste perfil. As fases que o módulo não tem leem 0.0 (o STD-UI1 publica o seu canal como L1; os endereços L1 dele trazem tensão, corrente, potência, frequência, energia importada e exportada). Os pontos S, Q, PF e energia total leem 0. Os membros monofásicos publicam o seu canal como L1. Este perfil não tem alias de configuração — a configuração faz-se pelos registos holding nativos.
IDs de unidade virtuais
Com CFG_VIRTUAL_IDS = 1 (guardado + reinício; entra em vigor no arranque), um módulo com mais de um canal de corrente também responde nos IDs de unidade base+1 … base+N_CURRENT (limitado a 247): cada ID é uma vista float32 só de leitura de um canal de corrente — a sua tensão, corrente, potência, potência total = potência desse canal, frequência; os pontos de energia leem 0. Qualquer escrita num ID virtual → exceção 02. Escolha o ID de unidade base de modo que os IDs derivados não colidam com outros medidores do barramento.
(A tabela de configuração METER_GROUP do mapa é reservada — a composição dos grupos não é configurável.)
Broadcast (ID de unidade 0)
Só estas escritas são aceites em broadcast; tudo o resto é silenciosamente recusado (sem resposta de exceção em broadcast, conforme a norma Modbus):
-
definição da hora — duas tramas: FC16 para 0x8100–0x8101 (época, palavra alta primeiro), depois FC06
COMMAND0x8113 = 0x0006 — sincronização do relógio em todo o barramento; -
LATCH_BANK/PERIOD_ARM0x8110–11 eCOMMAND0x03 — instantâneo sincronizado entre módulos (bit 8 de capacidade); -
preparação de endereço por UID 0x8118–0x811E +
COMMAND0x16 — comissionamento num barramento partilhado.
Um FC16 em broadcast tem de ficar dentro dos registos da lista de permissões — uma trama que toque em qualquer outra coisa é recusada na totalidade.
UNLOCK (comandos protegidos)
Os comandos que alteram o estado do dispositivo têm de ser precedidos da escrita da chave de desbloqueio 0xA5C3 em holding 0x8112:
- A chave é válida durante 10 s e é consumida por um comando protegido.
- Escrever um valor errado desativa um desbloqueio ativo.
- Um comando condicionado sem desbloqueio válido → exceção 03.
- Ler 0x8112 devolve o flag de desbloqueio (0/1) tal como foi definido — trate-o apenas como informativo.
- Desbloqueio e comando podem ir num único frame FC16 em 0x8112–0x8113 (chave primeiro, opcode depois).
Conjunto protegido: 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (onde implementado) · 0x10/0x12/0x13/0x14 (atualização de firmware) · 0x15 (assistência). Não protegidos: 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 escrita de página · 0x16 endereço por UID. Em módulos que não implementam um opcode, a recusa é a exceção 03 antes mesmo de o condicionamento ser verificado. Os comandos de energia de vida útil usam um mecanismo de chave de uso único diferente (LT_KEY), não UNLOCK — ver Comandos.
Regras de comportamento (contrato da família)
-
Valores de
COMMAND,LATCH_BANK,PERIOD_ARM> 0xFF → exceção 03 (sem truncagem silenciosa do byte baixo). -
Uma escrita em
COMMANDenquanto um comando ainda está a ser executado → exceção 06 (dispositivo ocupado). -
Janelas de pares de bytes (segurança 0x8400+, carga do firmware 0x8380+, registo de histórico 0x8180+): o registo k contém os bytes 2k (alto) e 2k+1 (baixo). Escritas que tocam bytes só de leitura → exceção
-
A janela de segurança é um fluxo de bytes little-endian — os campos numéricos dentro dela descodificam-se em LE a partir dos bytes, não como registos big-endian.
-
Uma tabela de valores de configuração legais serve os dois transportes: um valor ilegal por Modbus → exceção 03; o mesmo valor por I²C é recusado em SAVE_CONFIG com
ERROR0xFD — em ambos os casos nada é persistido. -
Os campos que a compilação não oferece (canais ausentes; grandezas de THD e de desfasagem com o bit 2 de CAPABILITIES = 0) leem o valor sentinela no perfil nativo (
0xFFFF/0x8000…); no perfil float32 leem 0.
Exceções
| Código | Significado |
|---|---|
| 01 | função ilegal (qualquer uma exceto FC03/04/06/16) |
| 02 | endereço fora do mapa · escrita num registo de entrada, holding só de leitura ou ID de unidade virtual · leitura de um registo só de escrita |
| 03 | valor ilegal (ID de unidade / código de baud / valor de configuração inválido · opcode de comando inválido · valor COMMAND/LATCH demasiado grande · quantidade fora do intervalo · comando condicionado sem desbloqueio) |
| 04 | falha interna do dispositivo |
| 06 | dispositivo ocupado (comando ou operação de firmware em curso) |
A última exceção fica guardada para diagnóstico em LAST_EXCEPTION (FC<<24 | código<<16 | endereço), legível em ambos os transportes: I²C 0x0158, Modbus holding 0x830A–0B.