rbAmp
PT
Loja
Docs
Atualizado · Editar no GitHub [Edit on GitHub]

03 · Seleção do sensor de corrente

Instalação da pinça: o TC prende apenas o fio L, com a seta apontada para a carga

Este capítulo responde a duas perguntas:

  1. Que sensor de corrente escolher para uma dada carga.
  2. 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
Nota

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

Escolher uma pinça SCT-013: tome a maior corrente esperada mais uma margem de 30 %, escolha a pinça de calibre nominal mais pequeno acima dela e depois defina o seu código de modelo.

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:

Text
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Nota

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.

Python
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:

Python
dev.set_sensor_class(RbAmpSensorClass.SCT_013)  # explicit enum form
dev.set_sensor_class(1)                          # numeric (equivalent)
Nota

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] (ou dev.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.

Nota

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():

Python
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ável
  • PF ≈ 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):

Python
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)
Nota

✅ 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

Nota

⚙ 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.

Python
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:

Python
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

Duas pinças de classificações diferentes no mesmo fio L, ambas com as setas apontadas para a carga

Nota

⚙ 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:

  1. 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.

  2. 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.

  3. 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.

Releitura ≠ persistência

. 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:

Python
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


Fonte e problemas: rb-amp/rbamp-python · esta página no repositório: docs/03_sensor_selection.md (v1.6.1)