O que vai construir
- Tensão, corrente, potência ativa, energia (kWh) e fator de potência por fase reais para L1 / L2 / L3.
- Uma potência ativa total trifásica coerente (as três fases somadas num único latch sincronizado).
- Tudo num ESP32 por um único barramento I²C — sem um segundo microcontrolador, sem ADC em rotação.
- Tudo isto no Painel de Energia do Home Assistant (Energy Dashboard).
Lista de materiais
| Item | Qtd. | Notas |
|---|---|---|
| rbAmp BASIC SCT-UI1 | 3 | uma por fase — tensão + corrente + potência ativa calculada no módulo · produto |
| Transformador de corrente SCT-013 | 3 | uma por fase, classificação de acordo com a capacidade de serviço de cada fase · produto |
| Placa de desenvolvimento ESP32 | 1 | qualquer placa da classe esp32dev |
| Fios de ligação (jumper) | — | o barramento I²C partilhado (SDA/SCL/3V3/GND) |
Cada módulo UI1 precisa da sua própria tensão de fase, além da sua TC. Ligue a entrada de tensão de cada módulo à fase que está a medir (L1→módulo A, L2→módulo B, L3→módulo C) — esse emparelhamento de tensão por fase é exatamente o que torna a medição coerente. Leia a secção de segurança abaixo antes de ligar seja o que for — as tomadas de tensão são ligações a condutores sob tensão, não pinças de encaixe.
Segurança em primeiro lugar — as tomadas de tensão são trabalho em condutores sob tensão
⚠️ Esta montagem também liga entradas de tensão à rede. A entrada de tensão de cada módulo liga-se a uma fase viva (L) e ao neutro, com um fusível em L conforme indicado na documentação do módulo. O lado da corrente continua não invasivo: a TC SCT-013 envolve à volta o seu condutor de fase — nunca corte nem descasque um fio sob tensão. Identifique cada TC e cada condutor de tensão com a sua fase. Para trabalhos dentro de um quadro elétrico, chame um eletricista qualificado.
Ligue o barramento
Os três módulos partilham um barramento I²C vindo do 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
- Prenda a TC de cada módulo a um condutor de fase, com a seta virada para a carga.
- Pull-ups integradas: mantenha-as ativas no primeiro módulo na ordem física dos fios e desative-as nos outros dois — um par de pull-ups por barramento, nunca externas. (Veja o guia de hardware do módulo.)
Dê a cada módulo o seu próprio endereço
Todos os módulos saem de fábrica no endereço I²C 0x50. Três num barramento precisam de três endereços — 0x50, 0x51, 0x52. Atribua o segundo e o terceiro uma vez cada, um módulo de cada vez com os outros desligados, para não haver colisão. Na firmware atual isto é uma operação de modo de produção — sem modo de fábrica, sem ferramentas extra:
- Ligue apenas o módulo que está a reendereçar.
- Carregue uma configuração de teste com
address: 0x50enew_address: 0x51(depois0x52para o terceiro). - Veja o log de arranque do ESPHome a confirmar a alteração e depois defina
address: 0x51, apague a linhanew_address:e avance para o módulo seguinte.
(Mecânica completa: referência da API ESPHome → new_address.)
A configuração ESPHome
Três módulos UI1 em 0x50 / 0x51 / 0x52, uma frota sincronizada, dados por fase em tempo real mais o total coerente. Defina os tamanhos das TC e as credenciais Wi-Fi, e carregue o firmware:
# 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;
Dois botões que vale a pena perceber:
-
fleet_gc_enable: true+group_id: 1põem os três módulos numa só frota sincronizada. Uma vez por minuto o ESP32 envia uma única trama General-Call de "latch já" e cada módulo congela o seu acumulador de período no mesmo instante (desvio inferior a 10 µs) — é isso que torna o total trifásico coerente em vez de três números amostrados independentemente. -
latch_interval: 60s(rbAmp ESPHome v1.4) separa o latch sincronizado da cadência de leitura em tempo real: o painel atualiza tensão / corrente / potência a cadaupdate_interval(10 s), enquanto a rajada de latch de energia coerente corre uma vez por minuto. O kWh mantém-se exato de qualquer forma — o mestre integra em tempo real de relógio. Remova a linha para o comportamento de cadência única da v1.3.
Adicione ao Home Assistant
-
Carregue e deixe o nó arrancar — o Home Assistant descobre-o automaticamente pela API ESPHome. Verá as entidades por fase mais Total 3-Phase Active Power.
-
Definições → Dispositivos e serviços → Energia. Adicione o sensor de Energia de cada fase (
Phase A/B/C Energy) como fonte de consumo da rede — o painel soma-as para o consumo da casa inteira. -
Crie uma vista Lovelace rápida com as três potências por fase e o total, para uma imagem em tempo real por circuito.
Verifique se está bem ligado
- O varrimento I²C do log de arranque deve listar os três endereços:
[i2c] Found i2c device at address 0x50
[i2c] Found i2c device at address 0x51
[i2c] Found i2c device at address 0x52
- Com uma carga monofásica conhecida numa fase, só a potência dessa fase deve mexer.
- As três potências por fase devem somar-se a Total 3-Phase Active Power em cada atualização.
- Se uma fase indicar uma fração suspeitamente redonda do que espera, verifique se a sua tomada de tensão está na mesma fase que a sua TC — o emparelhamento coerente é o ponto central (veja a física).
Porque é que isto é exato
Cada módulo mede a sua fase de tensão e corrente em simultâneo e calcula a potência ativa real no chip; o latch sincronizado congela os três num mesmo instante. Isto é integração coerente por fase — o nível abaixo de 1%, face ao erro de 15–50% de medir uma fase e multiplicar por três. O raciocínio completo está no artigo complementar: porque é que três medidores monofásicos não conseguem medir a potência de 3 fases.
Prefere uma só placa? Uma variante dedicada de placa única (U3I3 — as três fases numa só placa, um só endereço I²C) está em desenvolvimento. Está no roteiro, ainda não é distribuída; subscreva abaixo e avisamos quando chegar. Até lá, esta frota de três módulos é o caminho de números honestos que pode construir hoje.