03 · Seleção do sensor de corrente
Este capítulo responde a duas perguntas:
- Que sensor de corrente escolher para uma dada carga.
- Como indicar ao módulo rbAmp a sua escolha para que a calibração de fábrica dessa combinação seja carregada automaticamente.
A cablagem física do sensor (orientação da pinça, verificação da polaridade L/N) está em 04_hardware.md. Este capítulo trata de escolher o modelo e das chamadas da API.
Classe do sensor
Os módulos rbAmp funcionam com pinças TC da família SCT-013. A classe do sensor é determinada pela revisão de hardware do módulo e definida de fábrica — o utilizador indica a sua escolha via dev.set_sensor_class() antes de selecionar um modelo específico de pinça TC.
Escolher um modelo SCT-013
Dentro da família SCT-013 há sete modelos suportados (códigos {1, 2, 3, 4, 5, 6, 7}).
code |
Modelo | Gama de corrente | Estado | Utilização típica |
|---|---|---|---|---|
| 1 | SCT-013-005 | 0…5 A | ✅ caracterizado | Cargas pequenas — candeeiros, eletrónica de baixa potência, um interruptor simples |
| 2 | SCT-013-010 | 0…10 A | ✅ caracterizado | Um aparelho de potência média — frigorífico, máquina de lavar roupa, ar condicionado até 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ caracterizado | Entrada de serviço doméstica de média dimensão — até ~7 kW |
| 4 | SCT-013-050 | 0…50 A | ✅ caracterizado | Entrada de serviço grande — aquecimento elétrico, carregador de VE, moradia unifamiliar com cargas de pico |
| 5 | SCT-013-100 | 0…100 A | ✅ caracterizado | Entrada de serviço principal |
| 6 | SCT-013-020 | 0…20 A | ✅ caracterizado | Entrada de serviço média — eletrodomésticos de 3–4 kW, equipamento doméstico pesado |
| 7 | SCT-013-060 | 0…60 A | ✅ caracterizado | Subcontador industrial |
Códigos aceites — {1, 2, 3, 4, 5, 6, 7}. Chamar dev.set_ct_model_ch(ch, code) com um código fora deste conjunto, por exemplo 0 ou 8 (ou passar esse código a dev.configure_channels(...)), levanta RbAmpParamError — a biblioteca não envia a escrita para o dispositivo (guarda do lado cliente _validate_ct_code; REG_ERROR no dispositivo mantém-se em 0x00).
Conjuntos aceites por classe: - RbAmpSensorClass.SCT_013 → {1, 2, 3, 4, 5, 6, 7} - RbAmpSensorClass.WIRED_CT → {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12} (série de pinças de fábrica emparelhadas; os códigos 11 e 13 não estão disponíveis) - RbAmpSensorClass.BUILTIN_CT → ∅ (TC integrado, sem códigos)
Os códigos 0x06 e 0x07 não são monótonos por classificação (acrescentados depois de 0x01..0x05). Escolha pela classificação de que precisa.
Como escolher o modelo certo
A regra única: escolha a pinça de calibre nominal mais pequeno acima da sua maior corrente esperada mais uma margem de 30 %. Uma pinça sobredimensionada (por exemplo, uma de 100 A num circuito que nunca passa de 5 A) continua a funcionar, mas dá baixa resolução e um erro grande nos valores típicos.
Margem
Uma pinça SCT-013 funciona sem saturação dentro da sua faixa nominal. Picos de curta duração (arranque de compressor, carga indutiva) podem exceder o calibre — a pinça aguenta, mas a medição torna-se não linear acima do calibre.
Conte um arranque regular como parte da sua "maior corrente esperada". Por exemplo, para uma máquina de lavar com corrente de arranque de 12 A (e 2–3 A em funcionamento): 12 A × 1.3 = 15.6 A, pelo que a pinça de classificação mais pequena acima disso é a SCT-013-020 (código 6).
Como indicar a sua escolha ao módulo
Duas chamadas na ordem correta são obrigatórias — primeiro dev.set_sensor_class(), depois dev.set_ct_model(). Se chamar dev.set_ct_model() antes de dev.set_sensor_class(), o pacote levanta RbAmpModeError:
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Modelo TC — uma predefinição funcional, não um rótulo. Escrever o modelo TC aplica de imediato a linha de base NF, o ganho e o fator de forma — as leituras de corrente mudam. Mudar sensor_class repõe CT_MODEL na predefinição e obriga a defini-lo de novo.
from rbamp import RbAmp, RbAmpSensorClass, RbAmpModeError
with RbAmp(bus, 0x50) as dev:
# Step 1: sensor class. MANDATORY before set_ct_model().
try:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
except RbAmpModeError as e:
# Possible causes: communication failure (see 10 · Troubleshooting),
# invalid argument (cls outside the known values)
print("set_sensor_class failed:", e)
raise SystemExit(1)
# Step 2: model within the family.
# 1 = SCT-013-005, 2 = SCT-013-010, 3 = SCT-013-030,
# 4 = SCT-013-050, 5 = SCT-013-100, 6 = SCT-013-020, 7 = SCT-013-060.
try:
dev.set_ct_model(3) # e.g. SCT-013-030
except RbAmpModeError:
print("Sensor class must be set first")
except ValueError:
print("Code not in per-class accept-set (SCT_013: {1,2,3,4,5,6,7})")
set_sensor_class() aceita um enum ou um int simples — as duas formas são equivalentes:
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
O pacote NÃO chama deliberadamente set_sensor_class() em seu nome. Se este passo for saltado, set_ct_model() lança RbAmpModeError sem escrever na flash. Isto é intencional, para que o comportamento seja previsível e explícito — sem "magia" na API pública.
Após estas duas chamadas:
-
O módulo guarda ambos os valores na flash — a definição sobrevive a um reinício, a um corte de energia e a uma nova gravação do firmware.
-
Os coeficientes de calibração para essa combinação específica (classe do sensor + modelo) são carregados a partir da tabela de predefinições de fábrica. Não precisa de tocar em nenhum registo de calibração manual.
-
A próxima leitura de
dev.current[0](oudev.read_current(0)) já devolve um valor em amperes com a escala correta.
Tempo total das duas chamadas é cerca de 1.4 segundos (duas operações de escrita na flash × ~700 ms cada, limitado pelo tempo de apagamento da página da flash). É feito uma vez na primeira instalação; a configuração fica guardada na flash e não se repete.
Se já escolheu o sensor na primeira execução e está apenas a reiniciar o script, não precisa de repetir as chamadas set_sensor_class() e set_ct_model() — o módulo lembra-se da escolha anterior. Mas também não há mal nenhum: chamar de novo com o mesmo valor apenas reescreve o mesmo byte.
Alteração de modelo e reinício. No firmware do módulo até 1.4.19 uma alteração de modelo reinicia o módulo uma vez (cerca de um segundo); a partir da 1.4.20 o módulo corrige-se sozinho. A correção de calibre SCT escala corrente, potência e energia, nunca tensão ou fator de potência.
Verificar a configuração
Uma verificação de sanidade simples após set_ct_model():
import time
from rbamp import RbAmp, RbAmpSensorClass
def sanity_check(dev):
print("Ready. Connect a purely resistive load",
"(e.g. an incandescent lamp).")
print("Expect a stable PF ~= 1.0 and a positive P.")
while True:
u = dev.voltage # property — one I²C transaction
i = dev.read_current(0)
p = dev.read_power(0)
pf = dev.read_power_factor(0)
print(f"U={u:.1f} V I={i:.2f} A P={p:.1f} W PF={pf:.2f}")
time.sleep(2)
with RbAmp(bus, 0x50) as dev:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
dev.set_ct_model(3)
sanity_check(dev)
Em MicroPython, substitua time.sleep(2) por time.sleep_ms(2000).
Numa carga puramente resistiva (lâmpada incandescente, chaleira elétrica, elemento de aquecimento) deve esperar:
U≈ 220–240 V (para uma rede de 230 V)I≈ corresponde à potência da carga (P / U)P> 0 e estávelPF≈ 1.0 (claramente positivo)
Se algo não bater certo, veja 10_troubleshooting.md.
Módulos com vários canais de corrente
Gama de SKUs — o que serve a tarefa
| SKU | Canais I | Canal U | Utilização típica |
|---|---|---|---|
| UI1 | 1 | sim | Uma carga com cálculo de potência completo (P, PF) |
| UI2 | 2 | sim | Duas cargas independentes na mesma fase (entrada de serviço + um consumidor grande) |
| UI3 | 3 | sim | Três cargas independentes na mesma fase |
| I1 | 1 | não | Sub-contador sem cálculo de potência (apenas corrente) |
| I2 | 2 | não | Dois sub-contadores, ou uma topologia de dois TC numa única linha |
| I3 | 3 | não | Três sub-contadores, ou dual-CT + um terceiro canal de corrente |
O que mede cada canal
- Canal U (apenas UI): U_rms, U_pico, frequência. Um* por módulo.
- Canais I (todos os SKUs): cada canal de forma independente — I_rms, I_peak, P (potência ativa), PF, avg_p por período.
- Variantes I: I1/I2/I3 não têm canal U — o cálculo de P/PF não é possível no dispositivo (apenas I_rms por canal).
- Módulo monofásico: as correntes UI2/I2/I3 são monofásicas. Todos os canais I têm de estar na mesma fase (ou, nas variantes I, também na mesma fase se quiser calcular P corretamente do lado do mestre).
Modelo TC por canal — calibração independente
Nos módulos UI2, I2 e I3, cada canal de corrente tem uma seleção de modelo SCT-013 independente. Pode ligar, por exemplo, um SCT-013-005 no canal 0 (uma tomada), um SCT-013-030 no canal 1 (uma linha de fogão) e um SCT-013-020 no canal 2 (uma alimentação média — apenas I3).
A API para seleção por canal é dev.set_ct_model_ch(channel, code):
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once for all channels
# Binding order does NOT matter.
dev.set_ct_model_ch(0, 1) # channel 0: SCT-013-005
dev.set_ct_model_ch(1, 3) # channel 1: SCT-013-030
dev.set_ct_model_ch(2, 6) # channel 2: SCT-013-020 (I3 only)
✅ A ordem de associação dos canais não importa. Escrever REG_CT_MODEL (0x05) prepara o valor mas já não o aplica automaticamente ao canal 0. A aplicação acontece apenas via CMD_SET_CT_MODEL_CHn. Isto significa que pode configurar os canais em qualquer ordem — sem sobreposição.
A forma de argumento único dev.set_ct_model(code) é uma forma de conveniência para SKUs de canal único (aplicada ao canal 0). Em módulos multicanal é equivalente a dev.set_ct_model_ch(0, code).
Configuração avançada: duas pinças de calibres diferentes num só fio
⚙ Um padrão adicional, não o básico. Esta secção descreve uma técnica opcional para melhorar a resolução a correntes baixas. Para a maioria das instalações, uma única pinça adequada à gama de carga é suficiente. Use dual-CT apenas se tiver um requisito de precisão específico a correntes < 1 A.
Quando se aplica
- Módulos multicanal UI2 / I2 / I3 (pelo menos 2 canais I).
-
O mesmo fio tem de ser medido tanto para cargas pequenas (≤ 1 A) como para eventos de pico (≥ 5 A) com a mesma qualidade.
-
Um exemplo típico: uma entrada de serviço de apartamento em que durante o dia há 50–100 W de stand-by e à noite — uma chaleira ou um fogão com arranque de 3+ kW.
A ideia
Duas pinças SCT-013 de classificações diferentes instaladas no mesmo fio:
-
Canal 0 — a pinça pequena (p. ex. SCT-013-005, 5 A): vê correntes pequenas com melhor resolução e um patamar de ruído mais baixo.
-
Canal 1 — a pinça grande (p. ex. SCT-013-030 ou superior): suporta correntes acima do ponto de sobrecarga da pinça pequena sem saturar.
O próprio mestre escolhe o canal a usar consoante o valor da corrente — enquanto a pinça pequena está na sua gama linear, a leitura é mais exata; quando é ultrapassada, passa para a grande.
Configuração (independente da ordem)
Primeiro a classe do sensor uma vez, depois os modelos por canal em qualquer ordem. No firmware atual, escrever REG_CT_MODEL (0x05) apenas põe em fila o valor; a ligação a um canal específico faz-se exclusivamente através do opcode por canal CMD_SET_CT_MODEL_CHn. O antigo workaround de "ordem descendente", exigido no firmware v1.2, já não é necessário.
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once
# Any order is valid — each call binds its own channel.
dev.set_ct_model_ch(0, 1) # ch0 = SCT-013-005 (0..5 A)
dev.set_ct_model_ch(1, 3) # ch1 = SCT-013-030 (0..30 A)
Estado final: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Lógica de agregação do lado do mestre
O padrão mais simples é ativar um limiar:
import math
def read_combined_current(dev):
"""Read the combined current — picks low-CT when in its linear range,
otherwise falls back to the high-CT.
"""
i_low = dev.read_current(0) # the small clamp
i_high = dev.read_current(1) # the large clamp
# While the small clamp is far from saturation, it gives better
# accuracy at low currents. Switch to the large one when
# approaching the overload point.
#
# The 4.5 A threshold for SCT-013-005 is an example value;
# pick the switch-over point for your own installation.
if not math.isnan(i_low) and i_low < 4.5:
return i_low
return i_high
⚙ Figuras de duplo-CT. As figuras para utilização de duplo-CT com baixa corrente não são publicadas (comportamento perto do limiar, deriva térmica, divergência das duas pinças na faixa de sobreposição). Trate o duplo-CT como um padrão piloto; para aplicações críticas, é preferível uma única pinça ajustada ao limite superior da faixa de carga.
Abordagens para melhorar a sensibilidade com correntes baixas
Se a sua carga tiver uma grande gama dinâmica (por exemplo, 1 W de stand-by de um router contra um termoacumulador de 2000 W na mesma tomada), uma única pinça dimensionada para o limite superior perde as correntes baixas no ruído.
Três estratégias por ordem crescente de complexidade:
-
Dimensione o TC para a maior corrente esperada (a regra acima). O erro mais comum é pôr um SCT-013-100 (100 A) numa tomada doméstica com consumo típico de 0.5–10 A. O sinal fica nos 1–10% inferiores da gama de entrada — onde o ruído se torna comparável ao sinal. Para um cenário doméstico (tomada de 16 A) o SCT-013-030 é o ideal; para ligar um único aparelho (≤ 5 A) — SCT-013-005.
-
Topologia dual-CT (requer um SKU UI2/UI3): uma pinça pequena na gama baixa + uma grande na gama alta, com o mestre a escolher por limiar. Veja a secção "Topologia dual-CT" acima — o padrão é de piloto; não se publicam valores de dual-CT a correntes baixas.
-
O piso de ruído é tratado do lado da fábrica. Do lado do utilizador não há nada a fazer além de
set_sensor_class()+set_ct_model(). Os valores para utilização de dual-CT a correntes baixas não são publicados.
Modo de produção vs. modo de fábrica (referência de persistência)
O módulo rbAmp funciona em dois modos, que diferem em exatamente o que é guardado na flash.
| Comando (opcode) | Produção | Persiste |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / TC por canal / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, armado por magic) |
✅ OK | Endereço I²C (commit de endereço em duas fases, ver 04 · Ligação) |
CMD_RESET (0x01) |
✅ OK | — (reinício por software) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (instantâneo de período) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS (0x26) |
❌ BLOQUEADO em produção (devolve DEV_ERR_PARAM; o reboot reverte) — apenas de fábrica |
ganhos / NF / fase (calibração de fábrica) |
CMD_FACTORY_RESET |
❌ BLOQUEADO em produção | — |
Em modo de produção, as escritas da calibração de fábrica são rejeitadas pelo firmware — proteção contra apagar acidentalmente os coeficientes de fábrica.
. A guarda de produção aceita a escrita em RAM (uma leitura posterior devolve o que foi escrito), mas a gravação na flash pode ser rejeitada. A única forma válida de confirmar a persistência é reiniciar o módulo via CMD_RESET e voltar a ler:
dev.set_ct_model(code)
dev.reset() # CMD_RESET 0x01, works in production
time.sleep(0.3) # boot complete (300 ms)
check = dev.read_reg(0x05)
assert check == code # ONLY now is persistence confirmed
O endereço é uma exceção: REG_I2C_ADDRESS lê o endereço ativo no arranque. Depois de o pôr em fila, devolve o candidato até CMD_COMMIT_ADDR + reinício.
Referência cruzada: 09 · Referência da API — detalhes sobre opcodes específicos; 10 · Resolução de problemas — o que fazer se a persistência não for confirmada.
O que vem a seguir
-
04 · Ligação — ligação física da pinça, orientação da seta, polaridade L/N
-
05 · Início rápido — o script completo de primeira luz para ambos os backends
-
06 · Exemplos — cenários de trabalho para diferentes consumidores
-
10 · Resolução de problemas — o que fazer se as leituras parecerem estranhas (PF negativo, I instável, etc.)
Fonte e problemas: rb-amp/rbamp-python · esta página no repositório: docs/03_sensor_selection.md (v1.6.1)