rbAmp
IT
Negozio
Docs
Aggiornato

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.

Sicurezza

⚠ 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)
Piedinatura del lato a bassa tensione di rbAmp: VCC, GND, SDA, SCL e la linea DRDY opzionale.

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
Nota

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.

Quali pull-up I²C mantenere o tagliare a seconda di quanti moduli rbAmp condividono il bus.

Dubbi

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

⚠ 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.
Nota

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
Sicurezza

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:

Più moduli rbAmp che condividono un bus I²C con un unico master.

  • 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)

Collegamento lato rete di un modulo rbAmp dentro un quadro: la derivazione L e N e la pinza di corrente sul conduttore L.

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 > 0 significa consumo (corrente che entra nel carico dalla rete), P < 0 significa 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.
Controllo rapido

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

Come la pinza di corrente si collega al modulo rbAmp tramite il jack da 3.5 mm.
Il corpo della pinza riporta unafrecciache indica la direzione del flusso di energia per l'orientamento "normale":

La pinza di corrente era chiusa attorno al filo L con la freccia rivolta verso il carico.

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

⚠️ 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 > 0 per il consumo, P < 0 per 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.
Nelle librerie client

— 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