00 · Panoramica
rbAmp è un modulo hardware compatto per la misura dei parametri della rete AC tramite interfaccia I²C. Viene fornito con una calibrazione memorizzata in fabbrica.
Cos'è rbAmp
Dal punto di vista dell'integratore, rbAmp si comporta come uno slave I²C standard: si alimenta, legge i registri e riceve valori pronti in unità fisiche (volt, ampere, watt). Non serve alcuna elaborazione del segnale lato master.
Cosa misura
BASIC riporta le grandezze seguenti come valori in virgola mobile nelle unità base. La linea STD riporta le proprie grandezze, con contatori di energia sul modulo, nella documentazione STD.
| Grandezza | BASIC |
|---|---|
| Tensione RMS, U_rms | float32, V |
| Tensione di picco, U_peak | float32, V |
| Corrente RMS, I_rms | float32, A |
| Corrente di picco, I_peak | float32, A |
| Potenza attiva, P | float32, W, con segno |
| Potenza reattiva, Q | float32, var, senza segno (≥ 0) |
| Fattore di potenza, PF | float32, da −1 a +1 |
| Frequenza di linea | u8, Hz: 50 o 60 (rilevato, non misurato) |
| Potenza media su un periodo | float32, W; uno snapshot (potenza media e di picco) |
| Energia | non conservata sul modulo — l'host (libreria) la integra |
L'accuratezza non fa parte di questa tabella: per BASIC con sensore SCT-013 vedi la tabella delle caratteristiche SCT-013 più sotto; le specifiche dei singoli moduli sono riportate nelle descrizioni dei modelli. La mappa dei registri BASIC è in realtime-polling.md, period-metering.md e api-reference.md.
Precisione del canale di corrente con sensori SCT-013
Moduli BASIC (serie SCT-UI) con il suo sensore SCT-013 — carico resistivo, misurato a 50 Hz. (I moduli con pinza CT accoppiata in fabbrica e i moduli STD sono specificati separatamente — questa tabella non si applica a essi.)
| Caratteristica | SCT-013-005 | SCT-013-010 | SCT-013-020 | SCT-013-030 | SCT-013-050 | SCT-013-060 | SCT-013-100 |
|---|---|---|---|---|---|---|---|
| Soglia rilevabile (la lettura senza carico) | ~3 mA | 6–9 mA | ~10 mA | ~13 mA | ~25 mA | ~30 mA | ~60 mA |
| Fondo scala leggibile (errore ≤ 10 %; 0.5 % del valore nominale) | 25 mA | 50 mA | 0.10 A | 0.15 A | 0.25 A | 0.30 A | 0.50 A |
| Classe vicina al fondo scala, UI1 / UI2 / UI3 (±1 % della media, da ~0.7 % del valore nominale) | da 35 mA | da 70 mA | da 0.14 A | da 0.21 A | da 0.35 A | da 0.42 A | da 0.70 A |
| Classe vicina al fondo scala, UI5 / UI7 (±0.5 %, da 2 % del valore nominale) | da 0.10 A | da 0.20 A | da 0.40 A | da 0.60 A | da 1.0 A | da 1.2 A | da 2.0 A |
| Classe nel campo di lavoro (5–100 % del valore nominale, della media) | ≤ 0.5 % | 0.16–0.35 % | ≤ 0.5 % | 0.53 % | ≤ 0.5 % | ≤ 0.5 % | 0.47 % |
| Tolleranza dell'unità sensore (si somma alla classe) | ≤ 0.8 % | 0.5–1.0 % | 0.8 % | 1.2 % | 0.7 % | 0.3–0.4 % | 0.45 % |
| Passo di un valore istantaneo | 4.1 mA | 8.1 mA | 16 mA | 24 mA | 41 mA | 49 mA | 83 mA |
| Fascia alta (saturazione, onda sinusoidale) | ~6.0 A | 11.9 A | ~24 A | 35 A | ~60 A | ~72 A | ~117 A |
Fonte: verificato in più prove di laboratorio. Notare che i sensori SCT-013 reali hanno un errore effettivo di circa 1 %, che può crescere nel tempo o con la temperatura. Se serve una buona qualità di misura con piccole correnti, scelga un sensore con portata inferiore.
- Passo di un valore istantaneo è circa lo 0.08 % della portata. La lettura RMS è calcolata sull'intera finestra da 100 ms e restituita come numero frazionario, quindi è più fine del passo: per esempio, con il sensore da 5 A la lettura a vuoto è ~3 mA sebbene il passo sia 4.1 mA. La risoluzione reale è limitata dal rumore, non dal passo.
- Vicino al limite inferiore: una singola lettura (una finestra da 100 ms) all'1 % della portata nominale è rumorosa del 0.6–2 %. La media su un periodo e l'energia restano entro la classe indicata nella tabella.
- UI5 / UI7 sotto il 2 % della portata: la dispersione tra moduli arriva a ±5 %, quindi per questi moduli la classe vicino al limite inferiore parte dal 2 % della portata.
- «Media» = la media di diverse finestre di misura da 100 ms, come quella usata per energia e potenza media.
- La saturazione è una proprietà del sensore SCT-013 (il suo livello di uscita alla corrente nominale); resti al di sotto del valore nominale per letture affidabili.
- Cambiare il modello del sensore significa scrivere il codice modello nel modulo — nessun passaggio di ricalibrazione.
Applicazioni
- Misura tariffaria — contabilità energetica con intervalli da 1 minuto, 15 minuti, 1 ora, giornalieri, mensili o annuali
- Casa intelligente — monitoraggio dei consumi dell'intera abitazione, sotto-contatori per carico, monitoraggio della produzione
- Controllo del carico — segnale di retroazione per dispositivi che regolano la potenza (scaldabagni, carichi resistivi, inverter)
- Bilanciamento energetico — contabilizzazione separata di consumo e produzione nelle abitazioni con solare
- Monitoraggio della qualità della rete — sia dal lato consumatore sia dal lato gestore
Varianti del modulo
Linea di prodotti BASIC attuale: SCT-UI1, SCT-UI2, SCT-UI3, SCT-UI5, SCT-UI7, SCT-I1, SCT-I2, SCT-I3. Nel codice, UIn significa un ingresso di tensione e n canali di corrente; In significa solo n canali di corrente. I moduli sono forniti senza sensore; le caratteristiche per ogni portata SCT-013 sono nella tabella SCT-013. Le altre linee di moduli hanno una composizione diversa; una tabella per ciascuna linea sarà aggiunta qui man mano che entra in vendita.
BASIC — per sensori tipo SCT-013
| Modulo | U | canali I | P | Quando scegliere |
|---|---|---|---|---|
| SCT-UI1 | sì | 1 | sì | unico punto di contabilità — contatore generale dell'abitazione, caldaia, inverter singolo |
| SCT-UI2 | sì | 2 | sì | due sotto-contatori su una fase (luci + prese, produzione + consumo) |
| SCT-UI3 | sì | 3 | sì | tre flussi su una fase |
| SCT-UI5 / SCT-UI7 | sì | 5 / 7 | sì | monitoraggio delle fasi con molti canali (quadri di grandi dimensioni, banchi di laboratorio) |
| SCT-I1 | no | 1 | no | monitor solo-corrente (il master calcola P con la propria sorgente U) |
| SCT-I2 | no | 2 | no | monitor di corrente a due canali |
| SCT-I3 | no | 3 | no | monitor di corrente a tre canali |
BASIC — con pinze CT accoppiate in fabbrica (serie CT)
| Modulo | U | canali I | P | Quando scegliere |
|---|---|---|---|---|
| CT-UI1 | sì | 1 | sì | un punto di misura con una pinza calibrata e pronta |
| CT-UI2 | sì | 2 | sì | due sub-contatori su una fase |
| CT-UI3 | sì | 3 | sì | tre flussi su una fase |
| CT-UI5 / CT-UI7 | sì | 5 / 7 | sì | misura per fase con molti canali |
Un modulo serie CT viene fornito con una pinza di corrente su ogni canale. Pinza e canale sono calibrati insieme in fabbrica e marcati con il numero del canale: non c'è nulla da selezionare o configurare. Le portate delle pinze sono 1, 5, 10, 20, 30, 50 o 100 A. L'ingresso di tensione è lo stesso della serie SCT. Vedi Moduli serie CT: avvio senza configurazione.
Sui moduli solo corrente la potenza attiva non è calcolata (P_real = 0), e PERIOD_AVG_P_W restituisce 0. Il master deve fornire una propria sorgente di tensione per il calcolo della potenza, oppure usare i soli dati di corrente.
Livelli di prodotto
rbAmp è offerto in due livelli di prodotto. Ciascun livello è una combinazione completa di revisione hardware e firmware — non un semplice flag del firmware. Passare da un livello all'altro richiede un cambio fisico di SKU, non un aggiornamento del firmware.
BASIC — linea di prodotti di ingresso
- Hardware: front-end analogico a basso costo, adatto ai carichi residenziali tipici.
- Firmware: misura del consumo unidirezionale. L'accumulatore per periodo azzera ogni campione di potenza attiva per finestra prima di integrare: viene contato solo l'energia positiva (consumata), come un contatore elettromeccanico a disco che gira solo in avanti.
PERIOD_AVG_P_Wè sempre ≥ 0; gli eventi di flusso inverso sono scartati dall'accumulatore del periodo.- Casi d'uso: famiglie senza generazione in loco; sotto-contatori di puri consumatori (stufe, motori, elettrodomestici).
STD — una linea di prodotti separata
STD è una linea di prodotti separata: moduli monofase e trifase con contatori di energia sul modulo e Modbus RTU. Ha una propria mappa dei registri e una propria documentazione — vedi la documentazione STD.
Dove compare il livello in questa documentazione
Questa documentazione descrive la mappa dei registri a 8 bit BASIC (0x00..0xCF). I moduli STD usano una mappa dei registri diversa a 16 bit e sono documentati nella documentazione STD; su STD queste funzioni si comportano in modo diverso.
Caratteristiche principali
- Slave I²C: 50 kHz sugli host ESP32 ed ESP8266 (limite del driver ESP-IDF), 100 kHz sugli altri host; 400 kHz non è consigliato.
- Indirizzo: 7 bit
0x50di default, riassegnabile nell'intervallo0x08..0x77tramite commit a due fasi (vedi initialization.md). - DATA_READY (DRDY): pin open-drain opzionale, impulso LOW di ~10 µs ogni finestra di misura (~100 ms dalla v1.2; 200 ms prima), segnala il momento in cui i registri RT sono coerenti.
- Snapshot atomico del periodo: il comando
0x27congela la potenza media per periodo; una sola scrittura chiude e apre — nessun campione perso o duplicato al confine. - Snapshot broadcast General-Call: indirizzo
0x00riservato per lo snapshot simultaneo su tutti i moduli che condividono un bus. Attivazione per modulo tramiteFLEET_CONFIG.bit0(predefinito OFF). Quando è OFF, i frame GC ricevono NACK a livello di bus — i master se ne accorgono e ripiegano su snapshot sequenziali per modulo (lo sfasamento su un bus a 50 kHz è ~1 ms × N, ≪ 0.03% di un periodo di 60 s). Vedi period-metering.md per la sequenza di abilitazione e il formato dei frame. - Tempo di parete lato master: l'energia è calcolata lato master come
avg_P × dt_master; il registro del timestamp del periodo lato chip (0xEC) è solo diagnostico (può sottostimare fino a ~30% sotto carico — per progetto). Elimina la deriva dei quarzi dei singoli moduli nei sistemi multi-modulo. - Calibrazione in flash: la calibrazione di fabbrica è memorizzata sul modulo; non serve alcuna calibrazione utente. Sui moduli BASIC serie SCT il master scrive solo
SENSOR_CLASSeCT_MODELper canale per il sensore SCT-013 collegato. Sui moduli serie CT l'host non scrive nulla — vedi avvio senza configurazione. - Configurazione automatica: il modulo inizia a misurare subito dopo l'accensione (~250 ms al primo risultato valido, ~700 ms aggiuntivi per la prima scrittura persistente).
Cosa rbAmp non fa
- Non integra internamente l'energia (Wh) — l'accumulo di energia è compito del master (vedi period-metering.md)
- Non pilota carichi, non contiene logica di automazione e non esegue regole programmabili
- Non ha display integrato
Avanti
- hardware-connection.md — collegamento, alimentazione, cablaggio
- initialization.md — prima accensione