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 collegamento fisico del sensore (orientamento della pinza, verifica della polarità L/N) è trattato in 04_hardware.md. Questo capitolo riguarda la scelta del modello e la chiamata API.
Classe del sensore
I moduli rbAmp funzionano con le pinze TA della famiglia SCT-013. La classe del sensore per una pinza SCT-013 a innesto che monta lei stesso si imposta una volta sola con setSensorClass(Sct013), prima di scegliere il modello. Se il modulo è arrivato con il suo TA già collegato, salti le chiamate di configurazione di questo capitolo.
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 apparecchio di media potenza — frigorifero, lavatrice, condizionatore fino a 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ caratterizzato | Ingresso di servizio domestico di media potenza — fino a ~7 kW |
| 4 | SCT-013-050 | 0…50 A | ✅ caratterizzato | Ingresso di servizio di grandi dimensioni — riscaldamento elettrico, caricatore per veicoli elettrici, abitazione unifamiliare con carichi di picco |
| 5 | SCT-013-100 | 0…100 A | ✅ caratterizzato | Ingresso principale del servizio di un'abitazione o di un piccolo ufficio |
| 6 | SCT-013-020 | 0…20 A | ✅ caratterizzato | Servizio intermedio — elettrodomestici 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}. Un codice fuori da questo insieme (ad esempio 0 o 8) passato a dev.setCTModel(...) (o a configureChannels(...)) restituisce false con lastError() == RB_ERR_PARAM — la libreria non invia la scrittura al dispositivo (guardia lato client).
I codici 0x06 e 0x07 non sono monotoni rispetto alla portata — sono stati aggiunti dopo l'insieme originale 0x01..0x05. Scelga sempre in base alla portata che le serve, non all'ordine dei codici.
Come scegliere il modello giusto
La regola di base:
-
Determini la corrente massima che può passare nel circuito (carico più grande + margine del 30 %).
-
Leggere il modello dall'etichetta stampata sulla pinza.
- Una regola: scelga la pinza di portata più piccola sopra la sua corrente massima attesa. Una pinza di portata troppo piccola va in saturazione sui picchi e legge troppo basso; una di portata molto più grande legge in modo rumoroso alle correnti piccole (un SCT-013-100 su un circuito da 5 A funziona, ma con scarsa risoluzione).
Margine
Una pinza SCT-013 lavora senza saturazione entro la sua portata nominale. I picchi brevi (avviamento del compressore, carico induttivo) possono superare la portata di 5-7× — questo è normale, la pinza lo sopporta fisicamente, ma la misura diventa non lineare sopra la portata.
Se il carico ha una corrente di picco superiore alla portata della pinza, scegliere la misura immediatamente superiore: la pinza nominale più piccola sopra il picco più un margine del 30 %. Ad esempio, per una lavatrice con corrente di spunto di 12 A (e 2-3 A in funzionamento), 12 A × 1.3 = 15.6 A, quindi scegliere un SCT-013-020 (non un SCT-013-005, che andrebbe in saturazione al picco).
Comunicare la propria scelta al modulo
Sono necessarie due chiamate nell'ordine corretto — prima setSensorClass(), poi setCTModel(). Se chiama setCTModel() prima di setSensorClass(), il modulo restituisce un errore RB_ERR_PARAM e il preset NON viene caricato.
Il modello TA è un preset funzionale, non un'etichetta. Scrivere il modello TA applica subito la calibrazione di fabbrica di quel modello di pinza alla pipeline di misura del modulo; le letture di corrente cambiano. Cambiare sensor_class riporta il modello TA a quello predefinito (0) e va reimpostato.
#include
#include
RbAmp dev(Wire, 0x50);
void setup() {
Wire.begin();
while (!dev.begin()) { delay(500); }
// Step 1: select the sensor family. REQUIRED before setCTModel().
if (!dev.setSensorClass(RbAmpSensorClass::Sct013)) {
// setSensorClass failed — check the connection, power, and address.
return;
}
// Step 2: select the model within the family.
if (!dev.setCTModel(RbAmpCTModel::Sct013_030)) {
// Possible causes (any → RB_ERR_PARAM):
// 1. setSensorClass() was not called before setCTModel()
// 2. code not in the per-class accept-set (for Sct013: {1,2,3,4,5,6,7})
// 3. no factory preset for the selected class
// (applies to WiredCT / BuiltinCT in the current firmware)
// 4. communication error (RB_ERR_IO, not RB_ERR_PARAM — a separate code)
return;
}
}
La libreria NON chiama intenzionalmente setSensorClass() per conto dell'utente. Se questo passo viene saltato, setCTModel() restituisce false con RB_ERR_PARAM senza scrivere in flash. Questo mantiene il comportamento prevedibile ed esplicito — nessuna "magia" nell'API pubblica.
Dopo queste due chiamate:
-
Il modulo salva entrambi i valori nella flash — l'impostazione sopravvive a un reset, a un ciclo di alimentazione e a un nuovo flash 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 chiamata successiva a
dev.readCurrent(0)restituisce già un valore in ampere con la scala corretta.
Tempo totale per entrambe le chiamate è di 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 è memorizzata in flash e non viene ripetuta.
Se ha già scelto il sensore alla prima accensione e sta solo riavviando il controllore, non deve ripetere le chiamate setSensorClass() e setCTModel() — il modulo ricorda la scelta precedente. Non fa però danno ripeterle: richiamarle con lo stesso valore riscrive semplicemente lo stesso byte.
Verifica della configurazione
Un semplice controllo di coerenza dopo setCTModel():
void setup() {
Wire.begin();
while (!dev.begin()) { delay(500); }
dev.setSensorClass(RbAmpSensorClass::Sct013);
dev.setCTModel(RbAmpCTModel::Sct013_030);
Serial.print(F("Ready. Connect a purely resistive load "));
Serial.println(F("(for example, an incandescent lamp)."));
Serial.println(F("Expect a steady PF ≈ 1.0 and positive P."));
}
void loop() {
Serial.print(F("U=")); Serial.print(dev.readVoltage(), 1);
Serial.print(F("V I=")); Serial.print(dev.readCurrent(0), 2);
Serial.print(F("A P=")); Serial.print(dev.readPower(0), 1);
Serial.print(F("W PF=")); Serial.println(dev.readPowerFactor(0), 2);
delay(2000);
}
Su un carico puramente resistivo (lampada a incandescenza, bollitore elettrico, elemento riscaldante), si attenda:
U≈ 220–240 V (per una rete a 230 V)I≈ corrispondente alla potenza del carico (P / U)P> 0 e stabilePF≈ 1.0 (decisamente positivo)
Se qualcosa non torna, vedere 10_troubleshooting.md.
Moduli con più canali di corrente
La gamma di SKU — cosa si adatta al lavoro
| SKU | canali I | Canale U | Uso tipico |
|---|---|---|---|
| UI1 | 1 | sì | Un singolo carico con calcolo completo della potenza (P, PF, Q, Wh) — un tipico contatore di rete |
| UI2 | 2 | sì | Due carichi indipendenti su una fase con potenza per canale |
| UI3 | 3 | sì | 1 U + 3 I — tre carichi su una fase con potenza per canale (P, PF, Q, Wh) |
| I1 | 1 | no | Sotto-contatore senza calcolo della potenza (solo corrente) — quando un UI1 separato gestisce la misura di rete |
| I2 | 2 | no | Sotto-contatore di corrente a due canali — ripartizione per circuito |
| I3 | 3 | no | Sotto-contatore di corrente a tre canali — ripartizione per circuito / topologia a doppio TA |
Cosa misura ciascun canale
- Canale U (solo UI): U_rms, U_peak, frequenza. Uno* per modulo.
- Canali I:
- sulle varianti UI — ogni canale fornisce I_rms, I_peak, P (potenza attiva), PF, avg_p sul periodo.
- su varianti I — solo corrente (I_rms, I_peak). La potenza attiva e il PF non sono calcolati — richiedono la tensione, che la variante I non ha. I registri
power[]/powerFactor[]sulle varianti I restituiscono 0. - Modulo monofase: tutti i canali I devono trovarsi sulla stessa fase a cui è collegato il canale U.
Modello CT per canale — calibrazione indipendente dei canali
Sui moduli multicanale (I2, I3) ogni canale di corrente ha una selezione del modello SCT-013 indipendente. Può, ad esempio, collegare un SCT-013-005 al canale 0 (una sola presa), un SCT-013-030 al canale 1 (un circuito della cucina) e un SCT-013-020 al canale 2 (l'ingresso di servizio).
Metodo 1: configureChannels() — una chiamata, un ciclo di flash (consigliato)
uint8_t models[3] = {1, 3, 6}; // ch0=SCT-013-005, ch1=SCT-013-030, ch2=SCT-013-020
dev.configureChannels(RbAmpSensorClass::Sct013, models, 3);
Una singola chiamata configura la classe del sensore + tutti i canali in un'unica operazione con un solo SAVE_USER_CONFIG finale. Misurato sul banco: ~1.4 secondi per 1 SAVE unico contro ~3.5 secondi per 3 cicli SAVE separati (setCTModel() + salvataggio manuale). Il punto chiave — l'usura del ciclo di flash è 3× inferiore sulla stessa pagina di flash.
Metodo 2: setCTModel(channel, code) per canale — in qualsiasi ordine
L'API per la selezione per canale è setCTModel(channel, code):
dev.setSensorClass(RbAmpSensorClass::Sct013); // once for all channels
// v1.3: binding order is arbitrary.
dev.setCTModel(0, 1); // SCT-013-005
dev.setCTModel(1, 3); // SCT-013-030
dev.setCTModel(2, 6); // SCT-013-020
dev.saveUserConfig(); // explicit save at the end (3-SAVE alternative, slower)
✅ L'ordine di associazione è arbitrario (v1.3). Scrivere REG_CT_MODEL (0x05) predispone il valore ma non lo applica automaticamente a nessun canale. L'applicazione avviene solo tramite il CMD_SET_CT_MODEL_CHn per canale, che prende il valore predisposto corrente e lo scrive sul proprio canale. I canali possono essere configurati in qualsiasi ordine (setCTModel(0, ...) per primo, per ultimo o intercalato — non fa differenza); non si verifica alcuna sovrascrittura. Qualsiasi riferimento a "crescente / decrescente / associare ch0 per ultimo" nei documenti e nel codice più vecchi si riferisce al comportamento pre-v1.3 — può essere rimosso.
Detto questo, l'associazione di ciascun canale resta a due passi a livello di protocollo sul filo (staging di REG_CT_MODEL → associazione CMD_SET_CT_MODEL_CHn); la chiamata della libreria setCTModel(channel, code) incapsula entrambi i passi.
Se tutti i canali ricevono lo stesso modello, l'ordine non conta (l'effetto collaterale è idempotente):
dev.setSensorClass(RbAmpSensorClass::Sct013);
dev.setCTModel(0, RbAmpCTModel::Sct013_005);
dev.setCTModel(1, RbAmpCTModel::Sct013_005); // ch0 is rewritten with the same value — no effect
dev.setCTModel(2, RbAmpCTModel::Sct013_005);
: l'overload intero setCTModel(uint8_t code) è mantenuto. Mappatura v1.3: 1=Sct013_005, 2=Sct013_010, 3=Sct013_030, 4=Sct013_050, 5=Sct013_100, 6=Sct013_020, 7=Sct013_060. Il tipo enum tipizzato RbAmpCTModel::Sct013_NNN è la forma consigliata (il compilatore intercetta i valori non validi prima della chiamata sul bus). Sui moduli multi-canale, l'argomento singolo setCTModel(code) si applica al canale 0 — equivalente a setCTModel(0, code).
Moduli multicanale — I2 e I3 (solo corrente)
L'hardware attuale per la topologia multi-canale è I2 (due canali di corrente) e I3 (tre canali di corrente). Entrambi i moduli non hanno canale U, quindi il calcolo di P / PF / Q sul modulo non è possibile — forniscono la corrente per canale (I_rms, I_peak su ogni canale) e nient'altro.
UI2 (1 U + 2 I) e UI3 (1 U + 3 I) aggiungono il canale di tensione alla stessa disposizione multicanale, così la potenza per canale viene calcolata sul modulo stesso. Quando la potenza lato modulo non serve, usi I2/I3 come sotto-contatori di corrente abbinati a un UI1 separato all'ingresso di servizio, che fornisce energia di rete + tensione.
Lettura dei canali (I2 / I3)
float i0 = dev.readCurrent(0); // ch0
float i1 = dev.readCurrent(1); // ch1
float i2 = dev.readCurrent(2); // ch2 — I3 only
// On an I variant readPower(...) returns 0.0 — this is by design.
float p_dummy = dev.readPower(0); // = 0.0f
Se ha bisogno della potenza attiva su ogni sotto-linea, installi un UI1 all'ingresso di servizio e ripartisca la potenza totale proporzionalmente alla corrente per canale I[k] dagli I2/I3. Questa è una tipica installazione domestica (vedere il capitolo 06 · Esempi, scenario 1).
Si tratta di una approssimazione: la ripartizione per corrente funziona quando il PF è più o meno lo stesso su tutti i carichi. Per una misura di potenza accurata per carico, usi una variante UI su ogni linea (quando saranno disponibili UI2/UI3).
Applicazioni I2 / I3
-
Sotto-misura della corrente: ripartizione della corrente per circuito, un unico punto di installazione sul quadro invece di un modulo separato per linea.
-
Disaggregazione abbinata a UI1: UI1 fornisce energia / potenza di rete, I2/I3 ripartiscono il consumo per derivazione (vedi capitolo 06, scenario 1).
-
Monitoraggio della corrente senza misura della potenza: controllo di sovraccarico, rilevamento di accensione / spegnimento dei carichi, profilo I(t).
-
Doppio TA + un terzo canale (I3): una pinza grande sul canale 0 per un intervallo ampio, una piccola sul canale 1 per la precisione a basse correnti, e il terzo canale per una linea ausiliaria separata. Vedere la sezione "Configurazione avanzata: due pinze di portata diversa" più sotto.
Configurazione avanzata: due pinze di portata diversa su un unico filo
⚙ Uno schema avanzato, non di base. Questa sezione descrive una tecnica facoltativa per migliorare la risoluzione a basse correnti. Per la maggior parte delle installazioni una sola pinza adatta all'intervallo di carico è sufficiente. Usi il doppio TA solo se ha un requisito di precisione specifico a correnti < 1 A.
Quando si applica
- Moduli multicanale I2 / I3 (hardware attuale).
-
Lo stesso filo deve essere misurato sia per carichi piccoli (≤ 1 A) sia per eventi di picco (≥ 5 A) con uguale qualità.
-
Un esempio tipico: un ingresso di servizio di un appartamento con 50-100 W di standby diurno e uno spunto di 3+ kW di bollitore o fornello in serata.
L'idea
Due pinze SCT-013 di portate diverse montate sullo stesso filo:
-
Canale 0 — una pinza piccola (ad esempio SCT-013-005, 5 A): vede le correnti piccole con migliore risoluzione e un fondo di rumore più basso.
-
Canale 1 — una pinza grande (ad esempio SCT-013-030 o superiore): gestisce le correnti sopra il punto di sovraccarico della pinza piccola senza saturare.
Il master stesso sceglie il canale da usare in base al valore di corrente — mentre la piccola pinza è nel suo range lineare la lettura è più accurata; quando viene superato, passa a quella grande.
Configurazione (in qualsiasi ordine — v1.3)
Prima la classe del sensore una volta, poi i modelli per canale in qualsiasi ordine. Sul firmware v1.3 la scrittura di REG_CT_MODEL prepara soltanto (stage) un valore; l'associazione avviene tramite il comando per canale CMD_SET_CT_MODEL_CHn, così i canali non si sovrascrivono a vicenda. (Il workaround "ordine decrescente" si applicava solo al firmware precedente alla v1.3 ed è ormai superfluo.)
dev.setSensorClass(RbAmpSensorClass::Sct013); // once
// Order is arbitrary — staging is decoupled from binding.
dev.setCTModel(0, RbAmpCTModel::Sct013_005); // ch0 (range 0..5 A)
dev.setCTModel(1, RbAmpCTModel::Sct013_030); // ch1 (range 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:
float read_combined_current(RbAmp& dev) {
const float i_low = dev.readCurrent(0); // small clamp
const float i_high = dev.readCurrent(1); // large clamp
// While the small clamp is well clear of saturation, it gives
// better accuracy at low currents. We switch to the large one as
// it approaches the overload point.
//
// The 4.5 A threshold for the SCT-013-005 is PROVISIONAL; the exact
// value will be determined by bench validation (see below).
// Behavior in the vicinity of the threshold is a matter of
// measurement, not estimation.
if (!isnan(i_low) && i_low < 4.5f) {
return i_low;
}
return i_high;
}
⚙ Limitazione. Le cifre per l'uso a doppio TA a bassa corrente (comportamento vicino alla soglia, deriva termica, divergenza delle due pinze nell'intervallo di sovrapposizione) non sono pubblicate. Consideri il doppio TA come uno schema pilota; per applicazioni critiche è preferibile una sola pinza adatta all'estremo superiore dell'intervallo di carico.
Approcci per migliorare la sensibilità a basse correnti
Se il carico ha un ampio intervallo dinamico (ad esempio 1 W di standby per un router contro un boiler a immersione da 2000 W sulla stessa presa), una pinza dimensionata per il limite superiore perde le correnti basse nel rumore.
Tre strategie in ordine crescente di complessità:
-
Dimensioni il TA sul massimo, non "con margine". L'errore più comune è mettere un SCT-013-100 (100 A) su una presa domestica con un consumo tipico di 0.5–10 A. Il segnale sta nel 1–10 % più basso dell'intervallo del sensore — dove il rumore diventa paragonabile al segnale. Per uno scenario domestico (presa da 16 A) un SCT-013-030 è ottimale; per collegare un singolo dispositivo (≤ 5 A) un SCT-013-005.
-
Topologia a doppio CT (richiede uno SKU I2/I3 — due canali di corrente su un modulo): una piccola pinza per l'intervallo basso e una grande per quello alto, con il master che sceglie in base a una soglia. Vedi la sezione "Topologia a doppio CT" sopra — lo schema è un pilota e i relativi valori non sono pubblicati.
-
Rumore di fondo calibrato di fabbrica: la calibrazione del modulo tiene già conto del suo rumore di fondo. Lato utente non serve altro oltre a
setSensorClass()+setCTModel(). Le cifre di accuratezza specifiche a basse correnti non sono pubblicate.
Modalità produzione vs fabbrica (riferimento sulla persistenza)
Il modulo rbAmp opera in due modalità che differiscono per che cosa esattamente viene salvato nella flash. La modalità attuale si legge dal registro di stato corrispondente.
| 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 (vedi 04 · Connessione — modifica dell'indirizzo) |
CMD_RESET (0x01) |
✅ OK | — (reset software) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (snapshot di periodo) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS |
❌ BLOCCATO in produzione (rifiuto silenzioso; REG_ERROR=0xFE; il riavvio annulla) |
guadagni / NF / fase (calibrazione di fabbrica) |
CMD_FACTORY_RESET |
❌ BLOCCATO in produzione | — |
In modalità produzione le scritture della calibrazione di fabbrica (CMD_SAVE_GAINS, CMD_FACTORY_RESET) sono rifiutate dal firmware — questo protegge da sovrascritture accidentali dei coefficienti di fabbrica. Il passaggio alla modalità fabbrica è un'operazione del produttore.
La protezione di produzione accetta una scrittura in RAM (una lettura successiva restituisce ciò che è stato scritto), ma il salvataggio in flash può essere rifiutato. Dopo un riavvio il valore torna indietro. L'unico modo valido per confermare la persistenza è riavviare il modulo tramite CMD_RESET e rileggere:
dev.setCTModel(code);
dev.reset(); // CMD_RESET 0x01, works in production
delay(300); // boot complete
uint8_t check = dev.ctModel(0);
assert(check == code); // ONLY now is persistence confirmed
✅ REG_I2C_ADDRESS (0x30) legge l'indirizzo ATTIVO all'avvio (v1.3). Dopo un riavvio post-commit, leggere 0x30 mostrerà il nuovo indirizzo attivo. L'eco di staging (dopo una scrittura dal host) resta per progetto fino a CMD_COMMIT_ADDR + reset.
Rimando incrociato: 09 · Riferimento API — dettagli su opcode specifici, 10 · Risoluzione dei problemi — cosa fare se la persistenza non è confermata.
Cosa c'è dopo
-
04 · Collegamento — collegamento fisico della pinza, orientamento della freccia, polarità L/N
-
05 · Avvio rapido — lo sketch completo del primo test
-
06 · Esempi — scenari di lavoro per carichi diversi
-
10 · Risoluzione dei problemi — cosa fare se le letture sono strane (PF negativo, I instabile, ecc.)
Sorgente e segnalazioni: rb-amp/rbamp-arduino · questa pagina nel repository: docs/03_sensor_selection.md (v1.6.2)