rbAmp
PT
Loja
Docs
Atualizado

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_FRAME 0=8N1 · 1=8E1 · 2=8O1 · 3=8N2.

  • Retenção de resposta: CFG_TX_DELAY 0..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 (COMMAND 0x04) e depois reiniciar (COMMAND 0x02, 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 COMMAND 0x8113 = 0x0006 — sincronização do relógio em todo o barramento;

  • LATCH_BANK / PERIOD_ARM 0x8110–11 e COMMAND 0x03 — instantâneo sincronizado entre módulos (bit 8 de capacidade);

  • preparação de endereço por UID 0x8118–0x811E + COMMAND 0x16 — 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 COMMAND enquanto 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 ERROR 0xFD — 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.