Cosa costruirà
- Tensione, corrente, potenza attiva, energia (kWh) e fattore di potenza per fase reali per L1 / L2 / L3.
- Una potenza attiva trifase totale coerente (le tre fasi sommate su un unico latch sincronizzato).
- Tutto su un ESP32 su un singolo bus I²C — nessun secondo microcontrollore, nessun ADC a rotazione.
- Tutto nella dashboard energia di Home Assistant (Energy Dashboard).
Distinta dei materiali
| Voce | Q.tà | Note |
|---|---|---|
| rbAmp BASIC SCT-UI1 | 3 | uno per fase — tensione + corrente + potenza reale a bordo · prodotto |
| Trasformatore di corrente SCT-013 | 3 | uno per fase, portata da adattare alla capacità di servizio di ciascuna fase · prodotto |
| Scheda di sviluppo ESP32 | 1 | qualsiasi scheda di classe esp32dev |
| Cavetti jumper | — | il bus I²C condiviso (SDA/SCL/3V3/GND) |
Ogni modulo UI1 richiede la propria tensione di fase oltre al suo TA. Cabli l'ingresso di tensione di ogni modulo alla fase che sta misurando (L1→modulo A, L2→modulo B, L3→modulo C) — quell'abbinamento di tensione per fase è esattamente ciò che rende coerente la misura. Legga la sezione sicurezza qui sotto prima di cablare qualsiasi cosa — le prese di tensione sono connessioni a conduttori sotto tensione, non morsetti a pinza.
Prima di tutto la sicurezza — le prese di tensione sono lavoro su conduttori sotto tensione
⚠️ Questa build collega anche gli ingressi di tensione alla rete. L'ingresso di tensione di ogni modulo si collega a una fase viva (L) e al neutro, con un fusibile in L come indicato nella documentazione del modulo. Il lato corrente resta non invasivo: il TA SCT-013 si stringe attorno al suo conduttore di fase — non tagli né spelli mai un filo sotto tensione. Etichetti ogni TA e ogni cavo di tensione in base alla fase. Per lavori all'interno di un quadro elettrico, si rivolga a un elettricista qualificato.
Cablaggio del bus
Tutti e tre i moduli condividono un bus I²C dall'ESP32:
ESP32 GPIO21 (SDA) ─┬── UI1 phase-A (CT on L1, voltage tap on L1)
├── UI1 phase-B (CT on L2, voltage tap on L2)
└── UI1 phase-C (CT on L3, voltage tap on L3)
ESP32 GPIO22 (SCL) ─┘ + shared 3V3 and GND to all three
- Stringa il TA di ogni modulo attorno a un conduttore di fase, con la freccia verso il carico.
- Pull-up a bordo: li mantenga attivi sul primo modulo nell'ordine fisico dei cavi e li disattivi sugli altri due — una coppia di pull-up per bus, mai esterna. (Vedi la documentazione hardware del modulo.)
Assegni a ciascun modulo un proprio indirizzo
Tutti i moduli escono con indirizzo I²C 0x50. Tre su un bus richiedono tre indirizzi — 0x50, 0x51, 0x52. Assegni il secondo e il terzo una volta ciascuno, un modulo alla volta con gli altri scollegati, così non c'è conflitto. Sul firmware attuale è un'operazione in modalità produzione — nessuna modalità di fabbrica, nessuno strumento extra:
- Colleghi solo il modulo di cui sta modificando l'indirizzo.
- Carichi una configurazione di prova con
address: 0x50enew_address: 0x51(poi0x52per il terzo). - Guardi il log di avvio di ESPHome confermare la modifica, poi imposti
address: 0x51, elimini la riganew_address:e passi al modulo successivo.
(Meccanica completa: riferimento API ESPHome → new_address.)
La configurazione ESPHome
Tre moduli UI1 su 0x50 / 0x51 / 0x52, un fleet sincronizzato, dati live per fase più il totale coerente. Imposti le dimensioni dei TA e i segreti Wi-Fi, poi faccia il flash:
# Three-phase energy monitoring: 3× rbAmp UI1 on one ESP32, one I²C bus.
# GPIO21 SDA ─┬─ UI1 @0x50 (phase A: V+I on L1)
# ├─ UI1 @0x51 (phase B: V+I on L2)
# └─ UI1 @0x52 (phase C: V+I on L3)
# Each module computes its phase's real power on-chip; fleet_gc_enable + group_id
# latch all three on one broadcast instant (<10 µs skew).
# Compile-verified: ESPHome 2026.5.3, github://rb-amp/rbamp-esphome@v1.4.0.
esphome:
name: rbamp-3phase
esp32:
board: esp32dev
framework:
type: arduino
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
api:
ota:
- platform: esphome
logger:
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.
scan: true
external_components:
- source: github://rb-amp/rbamp-esphome@v1.4.0
components: [rbamp]
# ─── Three UI1 modules in the same GC-LATCH fleet ────────────────────────────
rbamp:
- id: phase_a
address: 0x50
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050 # mains phase — pick to match your service capacity
fleet_gc_enable: true
group_id: 1
- id: phase_b
address: 0x51
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050
fleet_gc_enable: true
group_id: 1
- id: phase_c
address: 0x52
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050
fleet_gc_enable: true
group_id: 1
# ─── HA entities — per-phase real V/I/P/Wh/PF + 3-phase total ────────────────
sensor:
# ══ Phase A (L1) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_a
voltage:
name: "Phase A Voltage"
current:
name: "Phase A Current"
power:
name: "Phase A Power"
id: p_phase_a
energy:
name: "Phase A Energy" # ← per-phase kWh accumulator
power_factor:
name: "Phase A Power Factor"
frequency:
name: "Phase A Frequency" # publish freq from phase A only
# ══ Phase B (L2) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_b
voltage:
name: "Phase B Voltage"
current:
name: "Phase B Current"
power:
name: "Phase B Power"
id: p_phase_b
energy:
name: "Phase B Energy"
power_factor:
name: "Phase B Power Factor"
# ══ Phase C (L3) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_c
voltage:
name: "Phase C Voltage"
current:
name: "Phase C Current"
power:
name: "Phase C Power"
id: p_phase_c
energy:
name: "Phase C Energy"
power_factor:
name: "Phase C Power Factor"
# ── 3-phase total active power (Σ per-phase real P) ───────────────────────
# All three modules latch on the same broadcast instant (fleet_gc_enable),
# so the summed instantaneous P values are coherent. Reads happen
# sequentially after the latch, but the frozen P values reflect the same
# wire moment. Skew: <10 µs chip-side; negligible for any real load.
- platform: template
name: "Total 3-Phase Active Power"
device_class: power
state_class: measurement
unit_of_measurement: W
accuracy_decimals: 1
update_interval: 10s
lambda: |-
float total = 0;
if (id(p_phase_a).has_state()) total += id(p_phase_a).state;
if (id(p_phase_b).has_state()) total += id(p_phase_b).state;
if (id(p_phase_c).has_state()) total += id(p_phase_c).state;
return total;
Due manopole che vale la pena capire:
-
fleet_gc_enable: true+group_id: 1mettono tutti e tre i moduli in un unico fleet sincronizzato. Una volta al minuto l'ESP32 invia un singolo frame General-Call "latch ora" e ogni modulo congela l'accumulatore del periodo nello stesso istante (scarto sotto i 10 µs) — ed è ciò che rende il totale trifase coerente invece di tre numeri campionati in modo indipendente. -
latch_interval: 60s(rbAmp ESPHome v1.4) disaccoppia il LATCH sincronizzato dalla cadenza di lettura live: la dashboard aggiorna tensione / corrente / potenza ogniupdate_interval(10 s), mentre la raffica coerente del latch di energia viene eseguita una volta al minuto. I kWh restano esatti in entrambi i casi — il master integra sul tempo reale dell'orologio. Rimuova la riga per il comportamento a cadenza singola della v1.3.
Lo aggiunga a Home Assistant
-
Faccia il flash e lasci avviare il nodo — Home Assistant lo scopre automaticamente tramite l'API ESPHome. Vedrà le entità per fase più Total 3-Phase Active Power (potenza attiva trifase totale).
-
Impostazioni → Dispositivi e servizi → Energia [Settings → Devices & Services → Energy]. Aggiunga il sensore Energia di ogni fase (
Phase A/B/C Energy) come sorgente di consumo di rete — la dashboard le somma per il consumo dell'intera casa. -
Costruisca una rapida vista Lovelace con le tre potenze per fase e il totale per una panoramica live per circuito.
Verifichi che sia cablato correttamente
- La scansione I²C nel log di avvio dovrebbe elencare tutti e tre gli indirizzi:
[i2c] Found i2c device at address 0x50
[i2c] Found i2c device at address 0x51
[i2c] Found i2c device at address 0x52
- Con un carico monofase noto su una fase, solo la potenza di quella fase dovrebbe muoversi.
- Le tre potenze per fase dovrebbero sommarsi a Total 3-Phase Active Power a ogni aggiornamento.
- Se una fase legge una frazione sospettosamente tonda di ciò che si aspetta, verifichi che la sua presa di tensione sia sulla stessa fase del suo TA — l'accoppiamento coerente è il punto centrale (vedi la fisica).
Perché questo è accurato
Ogni modulo misura la sua fase di tensione e corrente insieme e calcola la potenza attiva reale a bordo; il latch sincronizzato congela tutte e tre le grandezze nello stesso istante. È un'integrazione coerente per fase — il livello sotto l'1%, contro l'errore del 15–50% di misurare una fase e triplicarla. Il ragionamento completo è nell'articolo collegato: perché tre contatori monofase non possono misurare la sua potenza a 3 fasi.
Preferisce una sola scheda? Una variante dedicata a scheda singola (U3I3 — tutte e tre le fasi su una scheda, un indirizzo I²C) è in sviluppo. È in roadmap, non ancora in spedizione; si iscriva qui sotto e diremo quando sarà disponibile. Fino ad allora questo fleet di tre moduli è il percorso con numeri onesti che può costruire oggi.