rbAmp
PT
Loja

Projeto · · 8 min de leitura

Monitorização de energia trifásica no Home Assistant: 3× rbAmp UI num só ESP32

Monitorização de energia coerente por fase, em 3 fases, no Home Assistant: três módulos rbAmp UI num ESP32 por I²C, com ligação e a configuração ESPHome completa.

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)
Segurança

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

Segurança

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

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

  1. Ligue apenas o módulo que está a reendereçar.
  2. Carregue uma configuração de teste com address: 0x50 e new_address: 0x51 (depois 0x52 para o terceiro).
  3. Veja o log de arranque do ESPHome a confirmar a alteração e depois defina address: 0x51, apague a linha new_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:

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;

Dois botões que vale a pena perceber:

  • fleet_gc_enable: true + group_id: 1 põ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 cada update_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

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

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

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


Leia a seguir