00 · Visão geral
rbAmp é um módulo de hardware compacto para medição de parâmetros da rede AC através de uma interface I²C. Vem com calibração guardada de fábrica.
O que é o rbAmp
Do ponto de vista do integrador, o rbAmp comporta-se como um escravo I²C padrão: aplique alimentação, leia os registos — receba valores em unidades físicas prontos a usar (volts, amperes, watts). Não é necessário qualquer processamento de sinal do lado do mestre.
O que mede
O BASIC reporta as grandezas abaixo como valores em vírgula flutuante nas unidades base. A linha STD reporta as suas grandezas, com contadores de energia no próprio módulo, na documentação STD.
| Grandeza | BASIC |
|---|---|
| Tensão RMS, U_rms | float32, V |
| Tensão de pico, U_peak | float32, V |
| Corrente RMS, I_rms | float32, A |
| Corrente de pico, I_peak | float32, A |
| Potência ativa, P | float32, W, com sinal |
| Potência reativa, Q | float32, sem sinal (≥ 0) |
| Fator de potência, PF | float32, −1…+1 |
| Frequência da linha | u8, Hz: 50 ou 60 (detetado, não medido) |
| Potência média ao longo de um período | float32, W; um instantâneo (média e P de pico) |
| Energia | não guardado no módulo — o anfitrião (biblioteca) integra-o |
A exatidão não faz parte desta tabela: para o BASIC com um sensor SCT-013 ver a tabela de características SCT-013 abaixo; as especificações de cada módulo são dadas com as descrições dos modelos. O mapa de registos BASIC está em realtime-polling.md, period-metering.md e api-reference.md.
Precisão dos canais de corrente com sensores SCT-013
Módulos BASIC (série SCT-UI) com o seu próprio sensor SCT-013 — carga resistiva, medida a 50 Hz. (Os módulos com pinça CT emparelhada de fábrica, e os módulos STD, são especificados à parte — esta tabela não se lhes aplica.)
| Característica | SCT-013-005 | SCT-013-010 | SCT-013-020 | SCT-013-030 | SCT-013-050 | SCT-013-060 | SCT-013-100 |
|---|---|---|---|---|---|---|---|
| Piso detetável (a leitura sem carga) | ~3 mA | 6–9 mA | ~10 mA | ~13 mA | ~25 mA | ~30 mA | ~60 mA |
| Piso legível (erro ≤ 10 %; 0.5 % do calibre) | 25 mA | 50 mA | 0.10 A | 0.15 A | 0.25 A | 0.30 A | 0.50 A |
| Classe junto ao limiar inferior, UI1 / UI2 / UI3 (±1 % da média, a partir de ~0.7 % do calibre) | a partir de 35 mA | a partir de 70 mA | a partir de 0.14 A | a partir de 0.21 A | a partir de 0.35 A | a partir de 0.42 A | a partir de 0.70 A |
| Classe junto ao limiar inferior, UI5 / UI7 (±0.5 %, a partir de 2 % do calibre) | a partir de 0.10 A | a partir de 0.20 A | a partir de 0.40 A | a partir de 0.60 A | a partir de 1.0 A | a partir de 1.2 A | a partir de 2.0 A |
| Classe na gama de trabalho (5–100 % do calibre, da média) | ≤ 0.5 % | 0.16–0.35 % | ≤ 0.5 % | 0.53 % | ≤ 0.5 % | ≤ 0.5 % | 0.47 % |
| Tolerância da unidade sensora (somada à classe) | ≤ 0.8 % | 0.5–1.0 % | 0.8 % | 1.2 % | 0.7 % | 0.3–0.4 % | 0.45 % |
| Passo de um valor instantâneo | 4.1 mA | 8.1 mA | 16 mA | 24 mA | 41 mA | 49 mA | 83 mA |
| Topo de gama (corte, onda sinusoidal) | ~6.0 A | 11.9 A | ~24 A | 35 A | ~60 A | ~72 A | ~117 A |
Fonte: verificado em vários testes de bancada laboratorial. Note que os sensores SCT-013 reais têm um erro efetivo de cerca de 1 %, que pode crescer com o tempo ou com a temperatura. Se precisar de boa qualidade de medição a correntes pequenas, escolha um sensor de calibre mais baixo.
- Passo de um valor instantâneo é cerca de 0.08 % da potência nominal. A leitura RMS é calculada sobre a janela completa de 100 ms e devolvida como número fracionário, pelo que é mais fina do que o passo: por exemplo, com o sensor de 5 A a leitura sem carga é ~3 mA, embora o passo seja 4.1 mA. A resolução real é limitada pelo ruído, não pelo passo.
- Perto do limite inferior: uma leitura isolada (uma janela de 100 ms) a 1 % da potência nominal tem ruído de 0.6–2 %. A média sobre um período e a energia mantêm-se dentro da classe indicada na tabela.
- UI5 / UI7 abaixo de 2 % do calibre: a dispersão entre módulos é até ±5 %, por isso, nestes módulos, a classe perto do limiar inferior começa em 2 % do calibre.
- «Média» = a média de várias janelas de medição de 100 ms, como usada para a energia e a potência média.
- O corte é uma propriedade do sensor SCT-013 (o seu nível de saída à corrente nominal); fique abaixo do calibre para leituras fiáveis.
- Mudar o modelo do sensor é gravar o código do modelo no módulo — sem passo de recalibração.
Aplicações
- Medição tarifária — contabilização de energia em intervalos de 1 min, 15 min, 1 hora, diário, mensal ou anual
- Casa inteligente — monitorização do consumo da casa inteira, sub-medição por carga, acompanhamento da produção
- Controlo de carga — sinal de realimentação para dispositivos que regulam potência (termoacumuladores, cargas resistivas, inversores)
- Balanço de energia — contabilização separada de consumo e produção em casas com solar
- Monitorização da qualidade da rede — tanto do lado do consumidor como do lado da distribuidora
Variantes do módulo
Linha de produtos BASIC atual: SCT-UI1, SCT-UI2, SCT-UI3, SCT-UI5, SCT-UI7, SCT-I1, SCT-I2, SCT-I3. No código, UIn significa uma entrada de tensão e n canais de corrente; In significa apenas n canais de corrente. Os módulos são fornecidos sem sensor; as características de cada calibre SCT-013 estão na tabela SCT-013. Outras linhas de módulos têm composição diferente; será acrescentada aqui uma tabela para cada linha à medida que entrar à venda.
BASIC — para sensores do tipo SCT-013
| Módulo | U | Canais I | P | Quando escolher |
|---|---|---|---|---|
| SCT-UI1 | sim | 1 | sim | ponto de contabilização único — contador da casa inteira, caldeira, inversor único |
| SCT-UI2 | sim | 2 | sim | dois submedidores numa fase (iluminação + tomadas, produção + consumo) |
| SCT-UI3 | sim | 3 | sim | três fluxos numa fase |
| SCT-UI5 / SCT-UI7 | sim | 5 / 7 | sim | monitorização de fase com muitos canais (quadros grandes, bancadas de laboratório) |
| SCT-I1 | não | 1 | não | monitor só de corrente (o mestre calcula P com a sua própria fonte de U) |
| SCT-I2 | não | 2 | não | monitor de corrente de dois canais |
| SCT-I3 | não | 3 | não | monitor de corrente de três canais |
BASIC — com pinças CT emparelhadas de fábrica (série CT)
| Módulo | U | Canais I | P | Quando escolher |
|---|---|---|---|---|
| CT-UI1 | sim | 1 | sim | um ponto de medição com uma pinça calibrada e pronta |
| CT-UI2 | sim | 2 | sim | dois sub-medidores numa fase |
| CT-UI3 | sim | 3 | sim | três fluxos numa fase |
| CT-UI5 / CT-UI7 | sim | 5 / 7 | sim | medição por fase com muitos canais |
Um módulo da série CT é fornecido com uma pinça de corrente em cada canal. A pinça e o canal são calibrados em conjunto na fábrica e marcados com o número do canal: não há nada a selecionar nem configurar. Os calibres das pinças são 1, 5, 10, 20, 30, 50 ou 100 A. A entrada de tensão é a mesma que na série SCT. Ver módulos da série CT: arranque sem configuração.
Nos variantes só de corrente, a potência ativa não é calculada (P_real = 0), e PERIOD_AVG_P_W devolve 0. O mestre tem de fornecer a sua própria fonte de tensão para o cálculo de potência, ou usar apenas os dados de corrente.
Níveis de produto
O rbAmp é oferecido em dois níveis de produto. Cada nível é uma combinação completa de revisão de hardware e firmware — não é um simples indicador de firmware. Passar de um nível para outro exige uma mudança física de SKU, e não uma atualização de firmware.
BASIC — linha de produtos de entrada
- Hardware: front-end analógico de custo otimizado, adequado a cargas residenciais típicas.
- Firmware: medição de consumo unidirecional. O acumulador do período põe a zero cada amostra de potência ativa por janela antes de integrar: só a energia positiva (consumida) é contada, à semelhança de um contador de disco mecânico que só gira para a frente.
PERIOD_AVG_P_Wé sempre ≥ 0; eventos de fluxo inverso são descartados do acumulador do período.- Casos de uso: lares sem geração no local; sub-medição de consumidores puros (aquecedores, motores, eletrodomésticos).
STD — uma linha de produtos separada
STD é uma linha de produtos separada: módulos monofásicos e trifásicos com contadores de energia no módulo e Modbus RTU. Tem o seu próprio mapa de registos e documentação própria — ver a documentação STD.
Onde o nível aparece nesta documentação
Esta documentação descreve o mapa de registos BASIC de 8 bits (0x00..0xCF). Os módulos STD usam um mapa de registos diferente, de 16 bits e estão documentados na documentação STD; no STD estas funções funcionam de forma diferente.
Principais características
- Escravo I²C: 50 kHz em anfitriões ESP32 e ESP8266 (limitação do driver ESP-IDF), 100 kHz noutros anfitriões; não se recomendam 400 kHz.
- Endereço: 7 bits
0x50por defeito, reaprovisionável para o intervalo0x08..0x77via commit em duas fases (ver initialization.md). - DATA_READY (DRDY): pino opcional em dreno aberto, pulso LOW de ~10 µs a cada janela de medição (~100 ms a partir da v1.2; 200 ms antes), marca o momento em que os registos RT são coerentes.
- Instantâneo atómico do período: o comando
0x27congela a potência média por período; uma única escrita fecha e abre — sem amostras perdidas ou duplicadas na fronteira. - Instantâneo de difusão de Chamada Geral: endereço
0x00reservado para instantâneo simultâneo em todos os módulos que partilham um barramento. Ativação por módulo viaFLEET_CONFIG.bit0(predefinido OFF). Quando OFF, as tramas GC recebem NACK ao nível do barramento — os mestres detetam isto e recorrem a instantâneos sequenciais por módulo (o desvio num barramento a 50 kHz é ~1 ms × N, ≪ 0.03% de um período de 60 s). Ver period-metering.md para a sequência de ativação e o formato da trama. - Relógio de parede do lado do mestre: a energia é calculada do lado do mestre como
avg_P × dt_master; o registo de timestamp do período do circuito integrado (0xEC) é apenas de diagnóstico (pode subcontar até ~30 % sob carga — por desenho). Elimina a deriva do cristal de cada módulo em sistemas com vários módulos. - Calibração na flash: a calibração de fábrica está guardada no módulo; não é necessária calibração do utilizador. Nos módulos BASIC da série SCT o mestre escreve apenas
SENSOR_CLASSeCT_MODELpor canal, para o sensor SCT-013 ligado. Nos módulos da série CT o anfitrião não escreve nada — ver arranque sem configuração. - Configuração automática: o módulo começa a medir imediatamente após ligar (~250 ms até ao primeiro resultado válido, ~700 ms adicionais para a primeira escrita persistente).
O que o rbAmp não faz
- Não integra energia (Wh) internamente — a acumulação de energia é responsabilidade do mestre (veja period-metering.md)
- Não aciona cargas, não contém lógica de automação nem executa regras programáveis
- Não tem ecrã incorporado
Seguinte
- hardware-connection.md — ligação, alimentação, cablagem
- initialization.md — primeira ligação