03 · Selezione del sensore di corrente
Questo capitolo risponde a due domande:
- Quale sensore di corrente scegliere per un dato carico.
- Come comunicare al modulo rbAmp la sua scelta, in modo che la calibrazione di fabbrica per quella combinazione si carichi automaticamente.
Il cablaggio fisico del sensore (orientamento della pinza, verifica della polarità L/N) è trattato in 04_hardware.md. Questo capitolo riguarda la scelta del modello e le chiamate API.
Classe del sensore
I moduli rbAmp funzionano con pinze TA della famiglia SCT-013. La classe del sensore è determinata dalla revisione hardware del modulo ed è impostata in fabbrica — l'utente comunica la propria scelta tramite dev.set_sensor_class() prima di selezionare un modello di pinza specifico.
Scelta di un modello SCT-013
Nella famiglia SCT-013 sono supportati sette modelli (codici {1, 2, 3, 4, 5, 6, 7}).
code |
Modello | Intervallo di corrente | Stato | Uso tipico |
|---|---|---|---|---|
| 1 | SCT-013-005 | 0…5 A | ✅ caratterizzato | Carichi piccoli — lampade, elettronica a bassa potenza, un singolo interruttore |
| 2 | SCT-013-010 | 0…10 A | ✅ caratterizzato | Un elettrodomestico di media potenza — frigorifero, lavatrice, condizionatore fino a 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ caratterizzato | Ingresso di servizio domestico di media taglia — fino a ~7 kW |
| 4 | SCT-013-050 | 0…50 A | ✅ caratterizzato | Grande ingresso di servizio — riscaldamento elettrico, caricatore per auto elettriche, casa unifamiliare con carichi di picco |
| 5 | SCT-013-100 | 0…100 A | ✅ caratterizzato | Ingresso di servizio principale |
| 6 | SCT-013-020 | 0…20 A | ✅ caratterizzato | Ingresso di servizio medio — apparecchi da 3–4 kW, grandi elettrodomestici domestici |
| 7 | SCT-013-060 | 0…60 A | ✅ caratterizzato | Sotto-contatore industriale |
Codici accettati — {1, 2, 3, 4, 5, 6, 7}. Chiamare dev.set_ct_model_ch(ch, code) con un codice fuori da questo insieme, per esempio 0 o 8 (oppure passare un codice simile a dev.configure_channels(...)) solleva RbAmpParamError — la libreria non invia la scrittura al dispositivo (controllo lato client _validate_ct_code, REG_ERROR sul dispositivo resta 0x00).
Insiemi accettati per 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} (serie di pinze accoppiate in fabbrica; i codici 11 e 13 non sono disponibili) - RbAmpSensorClass.BUILTIN_CT → ∅ (TA di bordo, nessun codice)
I codici 0x06 e 0x07 non sono monotoni per classe di portata (aggiunti dopo i 0x01..0x05 originali). Scegliere in base alla portata necessaria.
Come scegliere il modello giusto
La regola unica: scelga la pinza di portata nominale più piccola superiore alla sua corrente massima prevista più un margine del 30 %. Una pinza sovradimensionata (per esempio una pinza da 100 A su un circuito che non supera mai 5 A) funziona comunque, ma dà bassa risoluzione e un grande errore ai valori tipici.
Margine
Una pinza SCT-013 lavora senza saturazione entro la sua portata nominale. I picchi di breve durata (spunto di un compressore, carico induttivo) possono superare la portata — la pinza lo sopporta, ma sopra la portata la misura diventa non lineare.
Conteggiare la corrente di spunto regolare come parte della «corrente massima attesa». Per esempio, per una lavatrice con spunto di 12 A (e 2–3 A in funzione): 12 A × 1.3 = 15.6 A, quindi la pinza nominale più piccola sopra questo valore è SCT-013-020 (codice 6).
Come comunicare al modulo la sua scelta
Due chiamate nell'ordine corretto sono obbligatorie — prima dev.set_sensor_class(), poi dev.set_ct_model(). Se chiama dev.set_ct_model() prima di dev.set_sensor_class(), il pacchetto solleva RbAmpModeError:
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Modello TA — un'impostazione funzionale, non un'etichetta. Scrivere il modello TA applica subito la linea di base NF, il guadagno e il fattore di forma — le letture di corrente cambiano. Cambiare sensor_class riporta CT_MODEL al valore predefinito e richiede di reimpostarlo.
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() accetta sia un enum sia un intero semplice — le due forme sono equivalenti:
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
Il pacchetto NON chiama deliberatamente set_sensor_class() per conto dell'utente. Se questo passo viene saltato, set_ct_model() solleva RbAmpModeError senza scrivere in flash. È una scelta di progetto, perché il comportamento sia prevedibile ed esplicito — nessuna «magia» nell'API pubblica.
Dopo queste due chiamate:
-
Il modulo salva entrambi i valori in flash — l'impostazione sopravvive a un reset, a un ciclo di alimentazione e a un nuovo flashing del firmware.
-
I coefficienti di calibrazione per quella specifica combinazione (classe del sensore + modello) sono caricati dalla tabella di preset di fabbrica. Non è necessario toccare alcun registro di calibrazione manuale.
-
La lettura successiva di
dev.current[0](odev.read_current(0)) restituisce già un valore in ampere con la scala corretta.
Tempo totale per le due chiamate è circa 1.4 secondi (due operazioni di scrittura in flash × ~700 ms ciascuna, limitate dal tempo di cancellazione della pagina flash). Si esegue una sola volta alla prima installazione; l'impostazione viene salvata in flash e non va ripetuta.
Se ha già scelto il sensore alla prima esecuzione e sta semplicemente riavviando lo script, non deve ripetere le chiamate set_sensor_class() e set_ct_model() — il modulo ricorda la scelta precedente. Ma non c'è danno a ripeterle: richiamarle con lo stesso valore riscrive semplicemente lo stesso byte.
Cambio di modello e riavvio. Sul firmware del modulo fino alla 1.4.19 un cambio di modello riavvia il modulo una volta (circa un secondo); dalla 1.4.20 il modulo si corregge da solo. La correzione del rating SCT scala corrente, potenza ed energia, mai tensione o fattore di potenza.
Verifica della configurazione
Un semplice controllo di coerenza dopo 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)
Su MicroPython sostituisca time.sleep(2) con time.sleep_ms(2000).
Su un carico puramente resistivo (lampada a incandescenza, bollitore elettrico, elemento riscaldante) ci si deve aspettare:
U≈ 220–240 V (per una rete a 230 V)I≈ corrisponde alla potenza del carico (P / U)P> 0 e stabilePF≈ 1.0 (decisamente positivo)
Se qualcosa non torna, vedi 10_troubleshooting.md.
Moduli con più canali di corrente
Gamma di SKU — cosa si adatta all'attività
| SKU | canali I | Canale U | Uso tipico |
|---|---|---|---|
| UI1 | 1 | sì | Un carico con calcolo di potenza completo (P, PF) |
| UI2 | 2 | sì | Due carichi indipendenti sulla stessa fase (ingresso di servizio + un grande consumatore) |
| UI3 | 3 | sì | Tre carichi indipendenti sulla stessa fase |
| I1 | 1 | no | Sotto-contatore senza calcolo di potenza (solo corrente) |
| I2 | 2 | no | Due sotto-contatori, o una topologia a doppio TA su una sola linea |
| I3 | 3 | no | Tre sotto-contatori, oppure doppio TA + un terzo canale di corrente |
Cosa misura ciascun canale
- Canale U (solo UI): U_rms, U_peak, frequenza. Uno* per modulo.
- Canali I (tutti gli SKU): ciascun canale in modo indipendente — I_rms, I_peak, P (potenza attiva), PF, avg_p per periodo.
- Varianti I: I1/I2/I3 non hanno il canale U — il calcolo di P/PF non è possibile sul dispositivo (solo I_rms per canale).
- Modulo monofase: le correnti UI2/I2/I3 sono monofase. Tutti i canali I devono stare sulla stessa fase (oppure, per le varianti I, anche sulla stessa fase se si vuole calcolare correttamente P lato master).
Modello TA per canale — taratura indipendente
Sui moduli UI2, I2 e I3 ogni canale di corrente ha una scelta del modello SCT-013 indipendente. Può collegare, per esempio, un SCT-013-005 sul canale 0 (una sola presa), un SCT-013-030 sul canale 1 (la linea di un fornello) e un SCT-013-020 sul canale 2 (una linea intermedia — solo I3).
L'API per la selezione per canale è 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)
✅ L'ordine di collegamento dei canali non conta. La scrittura di REG_CT_MODEL (0x05) prepara il valore ma non lo applica più automaticamente a ch0. L'applicazione avviene solo tramite CMD_SET_CT_MODEL_CHn. Quindi può configurare i canali in qualsiasi ordine — senza sovrascritture.
La forma a singolo argomento dev.set_ct_model(code) è una forma di comodo per i SKU a canale singolo (applicata al canale 0). Sui moduli multi-canale equivale a dev.set_ct_model_ch(0, code).
Configurazione avanzata: due pinze di portata diversa su un unico filo
⚙ Uno schema aggiuntivo, non quello di base. Questa sezione descrive una tecnica opzionale per migliorare la risoluzione a correnti basse. Per la maggior parte delle installazioni basta una pinza sola adatta al campo dei carichi. Usare il doppio TA solo se si ha un requisito di precisione specifico sotto 1 A.
Quando si applica
- Moduli multi-canale UI2 / I2 / I3 (almeno 2 canali I).
-
Lo stesso filo va misurato sia per carichi piccoli (≤ 1 A) sia per eventi di picco (≥ 5 A), con la stessa qualità.
-
Un esempio tipico: un ingresso di servizio di un appartamento dove di giorno ci sono 50–100 W di standby e la sera un bollitore o un fornello con uno spunto di 3+ kW.
L'idea
Due pinze SCT-013 di portate diverse montate sullo stesso filo:
-
Canale 0 — la piccola pinza (es. SCT-013-005, 5 A): vede correnti piccole con migliore risoluzione e un rumore di fondo più basso.
-
Canale 1 — la pinza grande (es. SCT-013-030 o superiore): gestisce correnti superiori al punto di sovraccarico della pinza piccola senza saturazione.
Il master sceglie da sé quale canale usare in base al valore di corrente — finché la piccola pinza è nel suo campo lineare la sua lettura è più precisa; quando viene superato, passa a quella grande.
Configurazione (indipendente dall'ordine)
Prima la classe del sensore una volta, poi i modelli per canale in qualsiasi ordine. Sul firmware attuale, scrivere REG_CT_MODEL (0x05) solo predispone il valore; il collegamento a un canale specifico avviene esclusivamente tramite l'opcode per canale CMD_SET_CT_MODEL_CHn. L'espediente «ordine decrescente» richiesto sul firmware v1.2 non serve più.
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)
Stato finale: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Logica di aggregazione lato master
Il pattern più semplice è attivare una soglia:
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
⚙ Figure dual-CT. Le figure per l'uso dual-CT a bassa corrente non sono pubblicate (comportamento vicino alla soglia, deriva termica, divergenza delle due pinze nell'intervallo di sovrapposizione). Consideri il dual-CT come uno schema pilota; per applicazioni critiche è preferibile una pinza singola dimensionata sull'estremo superiore del campo di carico.
Approcci per migliorare la sensibilità a basse correnti
Se il carico ha un ampio intervallo dinamico (per esempio 1 W di standby per un router contro un scaldabagno da 2000 W sulla stessa presa), una sola pinza dimensionata per il limite superiore perde le correnti basse nel rumore.
Tre strategie in ordine crescente di complessità:
-
Dimensionare il TA sulla corrente massima attesa (la regola sopra). L'errore più comune è mettere un SCT-013-100 (100 A) su una presa domestica con consumo tipico di 0.5–10 A. Il segnale sta nel 1–10% inferiore dell'intervallo di ingresso — dove il rumore diventa paragonabile al segnale. Per uno scenario domestico (presa da 16 A) SCT-013-030 è ottimale; per collegare un singolo apparecchio (≤ 5 A) — SCT-013-005.
-
Topologia a doppio TA (richiede una SKU UI2/UI3): una pinza piccola sulla gamma bassa + una grande sulla gamma alta, con il master che sceglie per soglia. Vedi la sezione «Topologia a doppio TA» sopra — lo schema è in fase pilota; i dati di doppio TA a bassa corrente non sono pubblicati.
-
Il rumore di fondo è gestito dal lato fabbrica. Dal lato utente non c'è nulla da fare oltre a
set_sensor_class()+set_ct_model(). I dati per l'uso del doppio TA a bassa corrente non sono pubblicati.
Modalità produzione vs fabbrica (riferimento sulla persistenza)
Il modulo rbAmp funziona in due modalità, che differiscono per che cosa viene esattamente salvato in flash.
| Comando (opcode) | Produzione | Persiste |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / TA per canale / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, armato con magic) |
✅ OK | Indirizzo I²C (commit dell'indirizzo in due fasi, vedere 04 · Cablaggio) |
CMD_RESET (0x01) |
✅ OK | — (reset software) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (snapshot di periodo) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS (0x26) |
❌ BLOCCATO in produzione (restituisce DEV_ERR_PARAM; il reboot ripristina) — solo per la fabbrica |
guadagni / NF / fase (calibrazione di fabbrica) |
CMD_FACTORY_RESET |
❌ BLOCCATO in produzione | — |
In modalità produzione, le scritture della taratura di fabbrica sono rifiutate dal firmware — protezione contro la cancellazione accidentale dei coefficienti di fabbrica.
. La guardia di produzione accetta la scrittura in RAM (una lettura successiva restituisce quanto scritto), ma il salvataggio in flash può essere rifiutato. L'unico modo valido per confermare la persistenza è riavviare il modulo con CMD_RESET e rileggere:
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
L'indirizzo fa eccezione: REG_I2C_ADDRESS legge l'indirizzo attivo all'avvio. Dopo la predisposizione ripete il candidato finché non arriva CMD_COMMIT_ADDR + reset.
Rimando: 09 · Riferimento API — dettagli su specifici opcode; 10 · Risoluzione dei problemi — cosa fare se la persistenza non è confermata.
Cosa c'è dopo
-
04 · Cablaggio — collegamento fisico della pinza, orientamento della freccia, polarità L/N
-
05 · Avvio rapido — lo script completo di primo avvio per entrambi i backend
-
06 · Esempi — scenari funzionanti per diversi utilizzi
-
10 · Risoluzione dei problemi — cosa fare se le letture sembrano strane (PF negativo, I instabile, ecc.)
Sorgente e segnalazioni: rb-amp/rbamp-python · questa pagina nel repository: docs/03_sensor_selection.md (v1.6.1)