01 · Collegamento hardware
Questo capitolo descrive il collegamento fisico di rbAmp a un dispositivo master e i requisiti di alimentazione. Il modulo arriva pronto all'uso. L'utente lavora solo sul lato a bassa tensione (LV) — quattro fili per I²C, una linea DRDY opzionale e (per le SKU con CT esterno) un jack da 3.5 mm per la pinza.
⚠ Lato rete. Per lavori dentro un quadro elettrico, chiami un elettricista qualificato.
La pinza va su un solo conduttore (L) — mai sull'intero cavo. È senza contatto, ma serve un conduttore con isolamento integro. La derivazione L richiede un fusibile (vedi Cavo e fusibile più sotto).
Pinout lato LV
Il modulo funziona con logica a 3.3 V ed è tollerante alla logica a 5 V sulle linee I²C. Tutti i piedini del lato LV sono completamente isolati galvanicamente dalla rete.
| Pin rbAmp | Segnale | Funzione |
|---|---|---|
VCC |
da +4.5 a +5.5 V (alimentazione) | Alimentazione del modulo; minimo 4.5 V richiesti per il corretto funzionamento |
GND |
Terra | Massa comune con il master — obbligatoria |
SDA |
SDA I²C | dati I²C |
SCL |
SCL I²C | Clock I²C |
DRDY |
Dati pronti (opzionale) | Impulso LOW open-drain di ~10 µs ogni finestra di misura (~100 ms, v1.2 e successive) |
Pull-up I²C — installati sulla scheda
Importante: ogni modulo rbAmp ha resistenze di pull-up integrate da 4.7 kΩ su SDA e SCL verso 3.3 V. Per un bus a modulo singolo non servono pull-up esterne — colleghi il master direttamente.
Quando disattivare i pull-up integrati
Con quattro o più moduli rbAmp (o altri dispositivi I²C con i propri pull-up) sul bus, o su un bus più lungo, la loro combinazione in parallelo dà una resistenza effettiva troppo bassa, che:
- Aumenta il consumo di potenza del bus
- Può superare la corrente massima di sink dello stadio di uscita del master I²C (tipicamente ≤ 3 mA su logica a 3.3 V)
- Aggiunge carico capacitivo sui bus lunghi, contribuendo poco all'immunità al rumore
Con due o tre moduli su un bus fino a 15 cm, lasci invariate le pull-up integrate (vedi la tabella sotto). Altrimenti: ogni modulo ha tagli dei ponticelli di saldatura sul lato inferiore della PCB, accanto alle resistenze di pull-up. La serigrafia riporta Pull-Up. Tagli la pista con una lama affilata per scollegare la pull-up:
- Con quattro o più moduli, oppure su un bus più lungo, lasci le pull-up attive su un solo modulo del bus (oppure le sposti in un unico punto vicino al master).
- Tagli i ponticelli sugli altri moduli.
- Se la scheda master fornisce già le pull-up di bus e il bus ha quattro o più moduli (o è più lungo), tagli i ponticelli su tutti i moduli rbAmp. Con due o tre moduli, misuri prima (vedi Dubbi più sotto) e tagli solo se la lettura è sotto ~1 kΩ.
Regola pratica
| moduli rbAmp sul bus | Pull-up |
|---|---|
| 1 | Lasciare com'è (lavora con il 4.7 kΩ integrato) |
| 2 | Lasci invariate entrambe (bus fino a 15 cm) |
| 3 | Lasci invariate tutte e tre (bus fino a 15 cm) |
| 4…6 | Taglio su tutti i moduli, coppia esterna da 2.2 a 2.7 kΩ vicino al master |
| 7…16 | Taglio su tutti i moduli, coppia esterna 1.5…2.2 kΩ vicino al master; verifichi la capacità totale del bus (≤ 400 pF) e riduca la velocità del bus se necessario |
Questi sono valori consigliati calcolati dalla specifica I²C (corrente di assorbimento del pull-up ≤ 3 mA a 3.3 V, capacità del bus ≤ 400 pF) — non una garanzia misurata per ogni cavo e ogni master. Colleghi i pull-up esterni a 3.3 V (il livello logico del bus), non all'alimentazione VCC a 5 V. Per un master a 5 V: vedi Compatibilità della tensione I²C più sotto.
La riga a 3 moduli è misurata (cavi da 15 cm, 50 kHz); le altre righe sono calcolate dalla specifica I²C.
: misuri la resistenza tra SDA e VCC con tutti i dispositivi non alimentati. Per un bus a modulo singolo il valore tipico è ~4.7 kΩ (una pull-up integrata); su un bus multi-modulo la combinazione in parallelo scende nell'intervallo 1.5–4.7 kΩ a seconda di quante pull-up integrate restano attive. Sotto ~1 kΩ significa troppe pull-up attive in parallelo — vedi la tabella sopra.
Potenza
Parametri VCC
- Tensione nominale: 5 V DC
- Intervallo accettabile: da 4.5 a 5.5 V
- Assorbimento di corrente: ~15 mA tipici, ~25 mA di picco durante la scrittura in flash
- Ripple: < 50 mV picco-picco (per la precisione di misura)
⚠ Rispetti la polarità dell'alimentazione. L'inversione di polarità sull'ingresso a 5 V non è supportata — controlli il cablaggio VCC/GND prima dell'accensione. Verifichi la convenzione di colori del suo cablaggio prima della prima accensione, soprattutto quando realizza da sé i cavi con crimpatura.
Compatibilità delle tensioni I²C
- SDA/SCL funzionano con logica a 3.3 V (i pull-up integrati li portano a 3.3 V).
- Le linee sono tolleranti a 5 V, quindi un master a 5 V (Arduino UNO / Nano) legge correttamente HIGH (~3.3 V) e può pilotare il bus.
- Configurazione standard: pull-up verso 3.3 V. Solo se vuole deliberatamente livelli di bus a 5 V, disattivi le pull-up integrate e aggiunga pull-up esterne a +5 V sul lato master.
Comportamento all'accensione
- Avvio a freddo: ~250 ms fino al primo risultato di misura valido.
- Dopo RESET (software o brown-out): ~250 ms per il ripristino.
- Prima del primo risultato valido i registri leggono 0 e
DATA_VALID(0xCE) è 0.
Isolamento
Il modulo stesso è interamente a bassa tensione — non vi è alcun circuito di misura ad alta tensione. La corrente è letta da una pinza CT che si accoppia magneticamente dall'esterno del conduttore isolato, senza alcun contatto elettrico con il filo di rete. Sulle varianti che misurano la tensione (UI) l'unico riferimento di rete è il terminale L–N, che alimenta un partitore di misura isolato galvanicamente*; le varianti solo amperometriche non hanno alcun collegamento alla rete. Di conseguenza:
- La massa del modulo non è collegata alla fase o al neutro della rete.
- Collegare il lato LV a un master a 5 V è sicuro — non c'è rischio di corto circuito attraverso la massa.
Non apra il contenitore — invaliderebbe la calibrazione di fabbrica.
Bus I²C
Parametri
- Indirizzo predefinito:
0x50(7 bit) - Intervallo di indirizzi:
0x08..0x77(riconfigurabile tramite commit a due fasi, vedi initialization.md) - Velocità (raccomandazione; la sceglie l'utente): 50 kHz su host ESP32 ed ESP8266 (un limite del driver I²C ESP-IDF, non del modulo); 100 kHz su altri host; non usi 400 kHz. 100 kHz è utilizzabile anche su ESP32/ESP8266 con retry a livello applicativo.
- Incremento automatico in lettura: SÌ — lettura a raffica supportata (registri multi-byte, blocco RT V03, finestra DIGEST).
- Incremento automatico in SCRITTURA: NO — ogni byte scritto richiede un indirizzo di registro esplicito, inclusi i campi multi-byte (scriva prima il byte basso, poi quello alto, separatamente).
- Clock-stretching: non usato dal modulo come controllo di flusso. Il master deve osservare un intervallo tra le transazioni (
tBUF) di ≥ 100 µs.
Lunghezza del bus
I²C è, per impostazione predefinita, un bus corto (~15 cm). Molti utenti collegano i moduli con fili di ponticello di bassa qualità, che captano molto rumore e perdono molti trasferimenti — da qui il limite corto. Topologie consigliate per rbAmp:
| Topologia dei cavi | Lunghezza massima | Velocità |
|---|---|---|
| Cavo piatto JST standard / a 4 fili | fino a 0.15 m | 100 kHz |
| Doppino intrecciato UTP (cat-5/5e/6) — SDA+GND e SCL+GND in coppie separate | fino a 1 m | 100 kHz |
| Doppino intrecciato UTP + buffer I²C (PCA9515 / TCA9617) | fino a 3 m | 100 kHz |
| Bus differenziale (PCA9615 / LTC4332) | fino a 100 m | 100 kHz |
Le lunghezze sopra sono riferite a 100 kHz; la raccomandazione di 50 kHz per i master ESP32/ESP8266 (§Parametri) vale per ogni topologia — la velocità più bassa aggiunge solo margine.
Per tratte più lunghe di 0.15 m, il doppino intrecciato è obbligatorio: SDA e SCL devono stare in coppie separate, ciascuna con la propria massa (per esempio blu + blu-bianco per SDA, verde + verde-bianco per SCL). Mettere SDA e SCL nella stessa coppia provoca un accoppiamento incrociato che deforma i fronti.
⚠ All'interno di un quadro elettrico, schermi il cavo I2C. Campi magnetici intensi vicino ai conduttori di rete, ai contattori e ai trasformatori inducono rumore in un cavo non schermato. Tenga il cavo il più corto possibile e lontano dai cablaggi di rete.
Bus multimodulo
Più moduli rbAmp possono condividere un unico bus I²C:
- Numero di moduli: fino a ~16 (limitato dalla capacità totale del bus — ≤ 400 pF a 100 kHz)
- Indirizzi: ogni modulo ha un proprio indirizzo a 7 bit. Tutti i moduli escono di fabbrica su
0x50; li riassegni uno alla volta prima di collegarli in parallelo (vedi initialization.md → Modifica dell'indirizzo). - Pull-up: segua la tabella del numero di moduli sopra (valori consigliati) — con 2–3 moduli su un bus fino a 15 cm lasci invariate le pull-up integrate; con 4+ moduli le tagli su tutti e usi una coppia esterna dimensionata per il numero di moduli.
- Rimozione di un modulo: per rimuovere un modulo da un bus condiviso, scolleghi i suoi fili di bus (o l'intero modulo), non solo l'alimentazione: un modulo non alimentato carica SDA e SCL e può bloccare il bus per gli altri moduli.
Collegamenti dei sensori (lato rete)
Sensore di tensione (varianti UI*)
La PCB espone i morsetti L (linea / fase) e N (neutro). La polarità conta per il segno della potenza attiva:
- Collegamento corretto (L → L, N → N):
P > 0significa consumo (corrente che entra nel carico dalla rete),P < 0significa esportazione verso la rete (produzione). - Cablaggio invertito (L e N scambiati): il segno di P è invertito — l'assorbimento è riportato come potenza negativa.
Filo e fusibile. Non serve un filo spesso per il collegamento di tensione: AWG26–22 è sufficiente, perché il sensore di tensione assorbe pochissima corrente. Un fusibile sulla linea L è obbligatorio, con portata fino a 0.1 A.
La corretta polarità è fondamentale per:
- Contabilità accurata a livello BASIC (BASIC conta solo
max(P, 0); una polarità invertita azzera il totale energetico). - Separazione corretta di consumo e produzione sulla linea STD.
: con un carico puramente resistivo (bollitore elettrico, stufa, lampadina a incandescenza), P > 0 e PF ≈ 1.0. Se P è negativa mentre il carico assorbe, scambi L e N sul PCB.
Sensore di corrente — SCT-013 (per i SKU con CT esterno)
Le pinze SCT-013 si collegano al modulo tramite un jack da 3.5 mm. Il connettore è codificato per la polarità corretta già di fabbrica; non serve alcuna decisione di cablaggio. Caratteristiche di ogni portata SCT-013 (soglie, classe, tolleranza, clipping): vedi la tabella SCT-013.
Rules:
- Fissi la pinza attorno al conduttore di linea (L) che va al consumatore.
- La freccia sulla pinza deve puntare nella direzione della corrente verso il carico (dal quadro di distribuzione al carico).
- La pinza deve chiudersi completamente — nessuno spazio tra le due metà del nucleo magnetico. Un intervallo superiore a 0.1 mm aumenta bruscamente la riluttanza magnetica e degrada la precisione.
⚠️ Attenzione: non faccia passare sia L sia N attraverso la stessa pinza. I loro flussi magnetici sono uguali e opposti, quindi si annullano — il sensore legge una corrente vicina allo zero anche con un carico reale.
Contrassegni dei canali sul PCB
Ogni jack sulla PCB è etichettato con il nome del canale (I0, I1, I2, …) e con un marcatore colorato. I cavi SCT-013 sono elettricamente simmetrici — l'orientamento è dato da la freccia sulla pinza e dal suo posizionamento sul conduttore, non da quale estremità del cavo entra nel jack.
Polarità e segno di P
- Freccia nella direzione corretta + polarità L/N corretta →
P > 0per il consumo,P < 0per l'esportazione. - Pinza montata al contrario (freccia contro la direzione della corrente) → il segno di P è invertito.
Pinze di corrente — serie CT
Ogni canale di un modulo serie CT ha la propria pinza su un cavo da 1 m. Il cavo arriva già collegato al modulo ed è marcato con il numero del canale; lo colleghi al connettore a innesto di quel canale. Tenga ogni pinza sul proprio canale, anche quando in seguito riscabla il quadro: una pinza su un altro canale dà letture errate, e il modulo non lo segnala.
- Non sposti una pinza su un altro canale e non colleghi un'altra pinza: la calibrazione appartiene alla coppia.
- Montare la pinza sul conduttore L con la freccia rivolta verso il carico (il consumatore); il conduttore deve passare nella finestra e la pinza deve chiudersi completamente.
- La dimensione della finestra segue la portata: 6 mm per 1–10 A, 10 mm per 20–50 A, 16 mm per 100 A. Il conduttore con il suo isolamento deve entrare nella finestra.
- Alimentazione e bus, pull-up, velocità del bus, filo di tensione e fusibile: come per ogni modulo BASIC (vedi le sezioni sopra). L'ingresso di tensione è lo stesso dei moduli SCT-UI: filo AWG26–22, un fusibile sulla linea L fino a 0.1 A.
DATA_READY (DRDY)
Pin opzionale per un polling ottimizzato. Se la sua applicazione va bene con un polling a intervallo fisso (100 ms o più lento), può lasciare DRDY scollegato.
Parametri elettrici
- Tipo di uscita: drain aperto (nessuna pull-up attiva verso VCC)
- Livello di riposo: HIGH (richiede un pull-up lato master — un pull-up interno del MCU oppure una resistenza esterna; consigliati 10 kΩ verso 3.3 V)
- Impulso di pronto: LOW per ~10 µs, dopo che i registri RT (
0x86..0xCF) sono stati aggiornati - Frequenza degli impulsi: ~10 Hz (un impulso per finestra RT da ~100 ms; ~5 Hz sulle immagini precedenti alla v1.2)
Semantica
Il fronte di discesa di DRDY garantisce che tutti i registri RT siano coerenti e appena pubblicati (il firmware li aggiorna atomicamente dentro un ISR prima di abbassare il pin). Il master può leggere 0x86..0xCD subito sul fronte di discesa senza rischio di campione spezzato.
Uso lato master
- Interruzione EXTI / GPIO sul fronte di discesa — sveglia il master e avvia una lettura.
- Usi qualsiasi GPIO in grado di ricevere ingressi — i numeri di pin negli esempi (per es. GPIO 15) sono illustrativi, non un requisito.
- Pull-up da 10 kΩ verso 3.3 V sul lato master.
- Più DRDY dei moduli possono essere combinati in un wired-OR (vedi realtime-polling.md → DRDY multi-modulo).
Applicabilità
- DRDY scatta solo sugli aggiornamenti RT (ogni finestra di misura, ~100 ms dalla v1.2).
- DRDY non scatta sugli snapshot di periodo (gli snapshot di periodo vengono aggiornati dal comando di snapshot che invia il master — quindi il master sa già quando leggere).
- Per master con polling lento (ogni 1 s o 60 s), DRDY può essere ignorato.
— lo stesso compito senza accesso ai registri:
| Libreria | Chiamata | Cosa fa |
|---|---|---|
| Arduino | RbAmp::setDrdyPin(pin) / RbAmp::waitDataReady(timeout_ms, ev) |
colleghi il pin DRDY; attenda la finestra successiva pubblicata |
| ESP-IDF | rbamp_set_drdy_gpio() / rbamp_wait_data_ready() |
colleghi il pin DRDY; attenda la finestra successiva pubblicata |
| Python | — | la libreria non usa il pin DRDY |
| ESPHome | drdy_pin: |
ingresso DRDY facoltativo; solo registrato, non usato come trigger di lettura |
Esempio di cablaggio di riferimento (ESP32, un modulo)
Altre varianti di modulo
Le altre varianti di modulo usano la stessa piedinatura lato LV (VCC / GND / SDA / SCL / DRDY); cambia solo il lato di rete.
Avanti
- initialization.md — prima connessione, test di funzionamento, cambio indirizzo
- troubleshooting.md → pinza CT e polarità — cosa fare se il segno di P è errato o I_rms è instabile