rbAmp
PT
Loja
Docs
Atualizado

rbAmp STD — referência técnica

Referência técnica completa da linha de módulos rbAmp STD: mapa de registos, transportes, comandos, modelo de medição e energia, atualização de firmware, diagnóstico e integração com o anfitrião.

Nota

Versão do mapa de registos 0x36.

Esta referência descreve o núcleo de firmware comum a todos os módulos STD. Membros: STD-UI1 (1 canal de tensão + 1 de corrente) e STD-U3I3 (3 canais de tensão + 3 de corrente, trifásico). Partilham o mesmo mapa e diferem apenas em N_VOLTAGE / N_CURRENT e no código de variante, por isso tudo aqui está escrito de forma genérica pelo número de canais.

Índice

# Ficheiro Abrange
1 Identidade e descoberta magia, versões, funcionalidades, códigos de variante, contagens de canais, UID, id da placa
2 Transporte I²C apontador de 16 bits, sequências de leitura/escrita, alongamento de relógio, alteração de endereço
3 Transporte Modbus RTU enquadramento, perfis, espaços de registos, exceções, UNLOCK, regras de comportamento
4 Mapa de registos cada bloco com endereço, tipo, unidades, escala, acesso
5 Comandos registo de comandos, semântica de ocupado/resultado, códigos de erro, condicionamento
6 Saída de dados prontos e eventos contrato DRDY, WIN_SEQ, sinalizadores de evento, limiares, alarme
7 Modelo de medição e energia janelas, unidades, contadores de energia, histórico, registo de eventos, hora
8 Configuração, persistência e calibração o que sobrevive a reset/desligar, como guardar, calibração visível para o utilizador
9 Atualização de firmware protocolo OTA do lado do anfitrião por I²C e Modbus
10 Diagnóstico bits de estado, causa do reinício, contadores, lista de verificação de saúde, LEDs
11 Interface de hardware sinais, ligação, comutador do modo de interface, DRDY, reset
12 Integração com o anfitrião sequências de registos em bruto sem as nossas bibliotecas; apontadores para as bibliotecas
13 Sequências fluxos canónicos passo a passo: inicialização, comandos, configuração, alteração de endereço, energia, histórico, OTA, desbloqueio

Convenções usadas ao longo do documento

  • Endereços. Os endereços de registo I²C são de 16 bits, escritos 0xNNNN. Os endereços de registo Modbus são um espaço separado (veja Transporte Modbus); um endereço Modbus nunca equivale a "o endereço I²C do mesmo valor" — as tabelas de correspondência são indicadas explicitamente.

  • Ordem dos bytes. Os valores de vários bytes em I²C são little-endian. No Modbus, o perfil nativo usa ordem de palavras big-endian ABCD (configurável); o perfil float32 é sempre ABCD.

  • Unidades (inteiros de escala fixa, nunca float, em I²C e no perfil nativo Modbus):

Grandeza Unidade Para SI
Tensão mV ÷1000 → V
Corrente µA ÷1 000 000 → A
Potência ativa mW (com sinal) ÷1000 → W
Potência reativa mvar (com sinal) ÷1000 → var
Potência aparente mVA ÷1000 → VA
Fator de potência Q10 (com sinal) ÷1024 → PF
Frequência cHz ÷100 → Hz
Energia acumulada Wh / varh (i64, com sinal) e mWh (i64); contadores µWh (i64) e µvarh (i64) —
Ângulo de fase da tensão centi-grau (i16, com sinal) ÷100 → °
Energia por janela mW·amostras (i64, com sinal) veja o modelo de medição
THD centi-percentagem ÷100 → %
  • Sinais. P > 0 = importação (consumo); a exportação é negativa. Q segue a IEC 62053-23 (Q > 0 indutivo). PF tem o sinal de P. A energia de importação e de exportação é mantida em contadores separados.

  • Sentinelas — por transporte. Um campo que uma determinada compilação não oferece lê, no perfil nativo Modbus, um valor sentinela: 0x8000 (i16), 0x80000000 (i32), 0xFFFF (u16); no perfil float32 lê 0; em I²C esses campos simplesmente leem 0, e endereços I²C não mapeados leem 0xFF.

  • Regra de condicionamento. O mestre deve condicionar o acesso aos canais por N_VOLTAGE / N_CURRENT e o acesso às funcionalidades por CAPABILITIES — os registos dos canais ≥ N e das funcionalidades ausentes não são dados.