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.
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 leem0xFF. -
Regra de condicionamento. O mestre deve condicionar o acesso aos canais por
N_VOLTAGE/N_CURRENTe o acesso às funcionalidades porCAPABILITIES— os registos dos canais ≥ N e das funcionalidades ausentes não são dados.