rbAmp
IT
Negozio

Progetto · · 8 min di lettura

Monitoraggio dell'energia trifase in Home Assistant: 3× rbAmp UI su un ESP32

Monitoraggio dell'energia trifase (3 fasi) coerente per fase in Home Assistant: tre moduli rbAmp UI su un ESP32 via I²C, con cablaggio e la configurazione ESPHome completa.

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

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

Sicurezza

⚠️ 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:

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

  1. Colleghi solo il modulo di cui sta modificando l'indirizzo.
  2. Carichi una configurazione di prova con address: 0x50 e new_address: 0x51 (poi 0x52 per il terzo).
  3. Guardi il log di avvio di ESPHome confermare la modifica, poi imposti address: 0x51, elimini la riga new_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:

YAML
# 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: 1 mettono 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 ogni update_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

  1. 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).

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

  3. 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:
Text
[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.


Leggi anche