Il problema che risolve
C'è una strada più breve. Un modulo rbAmp Basic comunica via I²C — due fili di segnale — e arriva come componente ESPHome nativo. Stringe un TA attorno a un conduttore, incolla una dozzina di righe di YAML, e Home Assistant adotta un dispositivo con tensione, corrente, potenza ed energia cumulativa reali — senza occupare una porta seriale. Questa guida va da una scatola chiusa a una scheda live nella dashboard energia (Energy Dashboard). E quando in seguito vorrà un secondo circuito, aggiunge un altro piccolo modulo sugli stessi due fili — non un altro ESP32.
Cosa avrà alla fine

Perché questo batte un PZEM
La configurazione rapida è comoda, ma alcune differenze architetturali sono il vero motivo per costruirlo così — e diventano più preziose quanto più a lungo il modulo lavora e quanti più circuiti aggiunge.
-
Finestre di periodo che si chiudono in modo atomico. Oltre al totale cumulativo, rbAmp può chiudere una finestra di misura e aprire la successiva — al secondo, all'ora, al giorno, a un periodo tariffario a domanda — in modo atomico, con una sola scrittura I²C. Alla ricezione il modulo congela gli accumulatori di quel periodo e avvia il successivo nello stesso istante del cavo: nessun ciclo di lettura, nessun vuoto. Per ottenere la stessa energia a finestre da un PZEM bisognerebbe leggere e azzerare il suo accumulatore via UART a ogni intervallo — tempo di CPU e seriale su un collegamento che già lotta con il Wi-Fi dell'ESP, con la frazione tra lettura e azzeramento che finisce in nessuna delle due finestre. Latch hardware contro soluzione software. (Trasmesso a molti moduli insieme, quello stesso latch mantiene in sincronia l'intero quadro — il prossimo progetto di questa serie.)
-
L'energia è misurata sul dispositivo, non stimata in Home Assistant. Il modulo rbAmp fa la misura della potenza e consegna all'ESP una cifra di potenza media coerente per ogni periodo; il componente ESPHome la integra in wattora e li salva nella NVS, così HA riceve un totale già integrato. Questo la tiene lontana dalla più grande fonte di dati energetici errati in HA — lasciare che lui integri la potenza in energia con una somma di Riemann tra un campione e l'altro, la causa dei picchi di −200 kWh e dei giorni 10 volte troppo alti che si vedono ovunque sui forum.
-
Il modulo fa la parte difficile — quindi il suo host può essere economico. Tutto il campionamento, l'RMS vero, la correzione di fase e la calibrazione girano sul processore dell'rbAmp; l'ESP si limita a leggere numeri già pronti via I²C. Un host modesto basta — un ESP8266 o un ESP32-C2/C3 hanno ampio margine — lasciando le schede più grandi per lavori più pesanti.
-
È un bus, non un cavo punto a punto. I²C significa che più moduli rbAmp condividono gli stessi due fili di segnale — e i moduli oggi sono disponibili in varianti a 1, 2 e 3 canali (con moduli a 5 e 7 canali in programma), quindi un modulo può misurare più circuiti da un unico punto di installazione. Un ESP32 può leggere un intero quadro — rete, scaldabagno, condizionatore, auto elettrica, illuminazione — e quando i moduli lavorano con un master possono essere agganciati nello stesso istante così che i loro sottototali si sommino all'alimentazione. Un PZEM è un dispositivo per UART; si esauriscono le porte seriali (e la pazienza) dopo due. Aggiungere un circuito qui costa un piccolo modulo sul bus, non un altro microcontrollore. (È il prossimo progetto di questa serie.)
Distinta dei materiali
| Voce | Perché | Prezzo | Dove |
|---|---|---|---|
| rbAmp BASIC SCT-UI1 (V + I, 1 canale) | il contatore — legge tensione, corrente, potenza, energia | veda la pagina del prodotto | BASIC SCT-UI1 |
| Trasformatore di corrente SCT-013 (consigliato 30 A) | TA split-core attorno al conduttore | veda la pagina del prodotto | TA SCT-013 |
| Qualsiasi scheda di sviluppo ESP32 | host Wi-Fi che parla con Home Assistant | probabilmente ne possiede già uno | — |
| 4 cavetti jumper (F–F) | il bus I²C: SDA, SCL, 3V3, GND | — | — |
Abbini il valore del TA SCT-013 a ciò che sta misurando — e tenga presente che i carichi singoli sono più piccoli di quanto sembrino: un condizionatore da stanza assorbe solo ~2–3 A, un bollitore elettrico fino a ~10 A. Un TA da 5 A o 10 A li risolve con finezza; 30 A copre una linea domestica impegnata; 50 A l'intera alimentazione di un appartamento. (Dimensionare una dorsale più grande — circa 30 A per un piano, 100 A per una casa con officina e garage — è un lavoro sull'intero quadro: la gamma rbAmp SCT-013 arriva fino a 50 A, quindi alimentazioni più grandi usano il TA a gamma superiore e la configurazione dell'intero quadro.) Per un singolo apparecchio, 10–30 A è il valore predefinito sicuro. Il modulo rbAmp conosce i preset SCT-013, quindi la calibrazione è un valore di configurazione una tantum (ct_model:, più sotto) — nessuna regolazione, nessun calcolo di resistenza di carico. Veda Scelta di TA / sensore. (Il TA si acquista separatamente, quindi il modulo non può conoscerlo in anticipo — una riga di configurazione qui sotto è l'intera impostazione.)
Prima di tutto la sicurezza — legga questo prima di toccare un quadro
⚠️ Il lato di misura si collega alla rete. Un TA split-core si stringe attorno all'esterno di un conduttore isolato — non tagli, spelli o giunti mai un filo sotto tensione per installarlo. Per lavori all'interno di un quadro elettrico, si rivolga a un elettricista qualificato.
Lo cabli
Quattro jumper tra l'ESP32 e il modulo rbAmp Basic:
| pin ESP32 | pin del modulo rbAmp |
|---|---|
3V3 |
3V3 |
GND |
GND |
GPIO21 (SDA) |
SDA |
GPIO22 (SCL) |
SCL |
Poi stringa il TA split-core attorno a un conduttore isolato dell'apparecchio che vuole misurare — la linea o il neutro, ne scelga uno, non entrambi — e lo inserisca nella presa jack da 3.5 mm del modulo. Il modulo fa il resto.
Su un ESP32-S3 usi GPIO8 (SDA) / GPIO9 (SCL); su un ESP32-C3 usi GPIO4 / GPIO5. Faccia corrispondere il blocco i2c: dello YAML qui sotto alla sua scheda.
[schema di cablaggio — slot media: ESP32-DevKitC ↔ modulo rbAmp Basic, 4 fili, TA agganciato a un conduttore]
Faccia il flash dell'ESP32 con ESPHome
L'intero progetto è un unico file — circa una dozzina di righe sostanziali. Lo copi, inserisca le sue credenziali Wi-Fi, fatto.
esphome:
name: rbamp-energy
esp32:
board: esp32dev
framework:
type: arduino
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
api:
ota:
- platform: esphome
logger:
# I²C bus to the rbAmp module. GPIO21/22 are the default pins on a classic ESP32-DevKitC.
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz # ESP-IDF i2c_master driver + the module's I²C recovery window interact at
# 100 kHz → intermittent read NACKs on ESP32. 50 kHz is the robust setting.
# STM32 / RP2040 / Linux-SBC masters run this module at 100 kHz fine.
# Pull the rbAmp component from GitHub, pinned to the v1.3.0 release.
external_components:
- source: github://rb-amp/rbamp-esphome@v1.4.0
components: [rbamp]
# The module itself — 0x50 is the factory-default I²C address.
rbamp:
id: meter
address: 0x50
update_interval: 60s
# One-time CT setup for the SCT-013 module: tell it which clamp is fitted. This pins the
# 30 A SCT-013 preset and is written ONCE to the module's flash (idempotent — safe to leave
# in the config; it only re-writes when the value changes). Match it to YOUR clamp:
# SCT_013_005 / _010 / _020 / _030 / _050.
ct_model: SCT_013_030
# Voltage · current · active power · cumulative energy → Home Assistant entities.
# The energy sensor is auto-tagged device_class=energy + state_class=total_increasing,
# and its Wh counter is checkpointed to the ESP's NVS on every publish — so it survives
# reboots and power cycles instead of restarting from zero.
sensor:
- platform: rbamp
rbamp_id: meter
voltage:
name: "rbAmp Voltage"
current:
name: "rbAmp Current"
power:
name: "rbAmp Power"
energy:
name: "rbAmp Energy"
La riga che tutti dimenticano: ct_model. Un modulo SCT-013 esce senza preset — va istruito su quale TA è stato montato, altrimenti le sue letture sono scalate male. Impostare ct_model: SCT_013_030 lo fa una volta; il modulo lo salva nella sua flash e non ne ha più bisogno (la riga è idempotente, quindi lasciarla nella configurazione è innocuo). Cambi il TA, cambi il valore. Il TA si vende a parte, quindi il modulo non può conoscerlo in anticipo — questa riga è l'intera impostazione.
Steps:
-
Installi la CLI di ESPHome(salti se lo esegue già) — oppure usi l'add-on ESPHome dentro Home Assistant; vale lo stesso YAML:
Bashpip install esphome -
Inserisca le sue credenziali Wi-Fi in
secrets.yamlaccanto alla configurazione, così non finiscono mai in un repo Git per errore:YAMLwifi_ssid: "YOUR_SSID" wifi_password: "YOUR_PASSWORD" -
Primo flash via USB (replace
/dev/ttyUSB0con la sua porta —COM3/COM4su Windows):Bashesphome run rbamp-basic-ui1.yaml --device /dev/ttyUSB0
ESPHome scarica il componente rbAmp, compila, carica e trasmette il log di avvio. Dovrebbe vedere una scansione I²C che elenca l'indirizzo 0x50, poi rbAmp v1.3.0 initialised e pubblicazioni periodiche dei sensori.
Da quel momento in poi gli aggiornamenti arrivano via etere — nessun bisogno di scollegare nulla di nuovo:
esphome run rbamp-basic-ui1.yaml
Con che frequenza deve interrogare? (update_interval) La configurazione usa 60s, che è corretto per la dashboard energia (Energy Dashboard). Può andare più veloce o più lento: il minimo accettato è 1s (valori inferiori vengono rifiutati — il modulo aggiorna i campioni circa 5 volte al secondo, quindi un polling sotto il secondo intasa solo il bus), e 300s (5 min) è un limite superiore comodo per un sensore tranquillo a basso traffico. Non superi 3600s (1 ora) — la dashboard energia richiede almeno un aggiornamento all'ora per disegnare barre orarie pulite. Preferisce una lettura di potenza live e nervosa? Scenda a 2s — veda Oltre la dashboard più sotto.
Lo veda in Home Assistant
Home Assistant rileva automaticamente i dispositivi ESPHome tramite mDNS.

-
Apra Impostazioni → Dispositivi e servizi [Settings → Devices & Services]. Compare un banner: "ESPHome — Scoperto — rbamp-energy." Clicchi Configura, confermi la richiesta della chiave di cifratura (la lasci vuota se non ha impostato la cifratura di
api:), e il dispositivo viene adottato. -
Apra il nuovo dispositivo rbamp-energy — quattro entità l'attendono:
| Entità | Unità | device_class HA |
Note |
|---|---|---|---|
sensor.rbamp_voltage |
V | voltage |
Tensione di rete RMS |
sensor.rbamp_current |
A | current |
Corrente RMS attraverso il TA |
sensor.rbamp_power |
W | power |
Potenza attiva (P) |
sensor.rbamp_energy |
Wh | energy |
Cumulativo — non si azzera mai |

L'entità energia porta già state_class: total_increasing, e il suo contatore viene salvato nella NVS dell'ESP a ogni pubblicazione. Stacchi la spina e la ricolleghi — il valore in Wh riprende da dove si era fermato. È esattamente ciò che vuole la dashboard energia (Energy Dashboard).
- Nessuna configurazione per sensore — il componente fornisce ogni
device_class,state_classe unità a livello di piattaforma, quindi HA li riprende alla scoperta.
Lo aggiunga alla dashboard energia (Energy Dashboard)

- Apra Impostazioni → Dashboard → Energia (oppure Impostazioni → Energia nelle versioni recenti di HA) [Settings → Dashboards → Energy].
-
Sotto Dispositivi individuali, clicchi Aggiungi dispositivo e scelga
sensor.rbamp_energy. Home Assistant filtra l'elenco alle entità condevice_class: energy+state_class: total_increasing— il sensore di energia rbAmp corrisponde a entrambi, quindi compare subito, senza flag extra. -
Salvi. La dashboard impiega circa un'ora per disegnare la prima barra leggibile; i totali orari e giornalieri si costruiscono da lì.
Un modulo Basic misura il consumo — la potenza che fluisce verso l'apparecchio. Non separa prelievo e immissione, quindi va nei slot dispositivo / consumo della dashboard energia, non in "Ritorno in rete". Per la misura bidirezionale della rete (immissione di un inverter solare, esportazione da batteria) serve un modulo della serie Standard con il suo rilevamento di tensione hardware isolato — veda la panoramica delle serie. Basic è di livello monitoraggio e calibrato, ma non è un contatore fiscale certificato.
Oltre la dashboard: misura in tempo reale
La dashboard energia vuole wattora cumulativi e lenti — ma il modulo misura molto di più e si aggiorna internamente circa cinque volte al secondo. Se vuole un indicatore di potenza live, una lettura della tensione o il fattore di potenza per le automazioni, aggiunga i sensori extra e interroghi più spesso. Abbassi update_interval a 2s (nervoso: vedrà un bollitore accendersi entro un secondo) o 5s (andamento fluido), ed esponga l'insieme completo:
rbamp:
id: meter
address: 0x50
update_interval: 2s # live real-time — override the 60s Energy-Dashboard default
ct_model: SCT_013_030
sensor:
- platform: rbamp
rbamp_id: meter
voltage: { name: "rbAmp Voltage" }
current: { name: "rbAmp Current" }
power: { name: "rbAmp Active Power" }
power_factor: { name: "rbAmp Power Factor" }
apparent_power: { name: "rbAmp Apparent Power" }
reactive_power: { name: "rbAmp Reactive Power" }
frequency: { name: "rbAmp Frequency" }
energy: { name: "rbAmp Energy" }
Ora può costruire una scheda di potenza live, avvisare di un calo di tensione, o osservare il calo del fattore di potenza quando parte un motore. Due cose da sapere affinché le sue automazioni si comportino correttamente:
-
La frequenza legge 0 durante un'interruzione (il rilevatore richiede un'onda attiva), quindi protegga da
0/unavailableogni automazione "frequenza scesa". -
Il fattore di potenza è brevemente
unavailablea vuoto — senza una corrente significativa non c'è una fase da calcolare. Faccia tollerare alle automazioniunavailableper i primi due secondi dopo l'avvio.
(Prelievo/immissione — separare il consumo di rete dall'immissione solare — richiede unStandardmodulo con rilevamento di tensione bidirezionale; non è una capacità Basic, quindi qui è omesso.)
Lo suddivida per tariffa (picco e fuori picco)
Con una tariffa a fasce orarie vorrà sapere quanti wattora cadono nella fascia di picco rispetto a fuori picco — senza comprare nulla in più. Home Assistant lo fa in modo nativo: punti il suo utility_meter integrato sull'unica entità energia rbAmp e lasci che HA lo divida in sotto-contatori tariffari. Questo va nel configuration.yaml di HA, non nello YAML di ESPHome:
utility_meter:
rbamp_energy_tou:
source: sensor.rbamp_energy
tariffs: [peak, off_peak]
cycle: monthly
Poi aggiunga una piccola automazione che commuta la tariffa attiva ai confini delle sue fasce — es. peak alle 07:00 e off_peak alle 22:00 — chiamando utility_meter.select_tariff. HA mantiene un totale separato per ogni tariffa oltre al singolo contatore Wh fornito dal modulo. Un contatore, tanti scaglioni tariffari quanti ne richiede il suo piano — e funziona con qualsiasi sensore energia ESPHome.
Cosa c'è dopo
Ora ha un circuito onesto in Home Assistant. Da qui questo va avanti così:
-
L'intero quadro su un ESP32. Metta un modulo multicanale (o diversi moduli monocanale) sugli stessi due fili I²C — rete, piano cottura, scaldabagno, condizionatore, luci — un ESP32, un YAML. Aggiungere una derivazione costa un piccolo modulo, non un altro microcontrollore. (Il prossimo in questa serie.)
-
Migra dal PZEM? Conservi la cronologia di Home Assistant, liberi la UART e ottenga wattora che resistono ai riavvii. (Il prossimo in questa serie.)
-
Caccia ai consumi fantasma. Una volta che ogni circuito è misurato, il consumo minimo in standby — i ~35 W che non dormono mai — diventa visibile e pagabile. (Il prossimo in questa serie.)
Per la teoria alla base di tutto questo — come un TA trasforma davvero un campo magnetico in chilowattora — veda il quickstart ESPHome e la guida completa all'integrazione con Home Assistant.