rbAmp
ES
Tienda

Proyecto · · 8 min de lectura

Monitorización de energía trifásica en Home Assistant: 3× rbAmp UI en un ESP32

Monitorización coherente de energía por fase en 3-phase en Home Assistant: tres módulos rbAmp UI en un ESP32 por I²C, con cableado y la configuración completa de ESPHome.

Lo que va a construir

  • Tensión, corriente, potencia activa, energía (kWh) y factor de potencia por fase reales para L1 / L2 / L3.
  • Una potencia activa trifásica total coherente (las tres fases sumadas en un latch sincronizado).
  • Todo en un ESP32 sobre un único bus I²C: sin segundo microcontrolador, sin ADC en round-robin.
  • Todo ello en el panel de Energía de Home Assistant.

Lista de materiales

Elemento Cant. Notas
rbAmp BASIC SCT-UI1 3 una por fase: tensión + corriente + potencia real en el chip · producto
Transformador de corriente SCT-013 3 una por fase, con calibre según la capacidad de servicio de cada fase · producto
Placa de desarrollo ESP32 1 cualquier placa de clase esp32dev
Cables de puente — el bus I²C compartido (SDA/SCL/3V3/GND)
Seguridad

Cada módulo UI1 necesita su propia tensión de fase además de su CT. Cablee la entrada de tensión de cada módulo a la fase que mide (L1→módulo A, L2→módulo B, L3→módulo C): ese emparejamiento de tensión por fase es exactamente lo que hace coherente la medida. Lea la sección de seguridad de abajo antes de cablear nada: las tomas de tensión son conexiones a conductores vivos, no pinzas de contacto.

Seguridad ante todo: las tomas de tensión son trabajo sobre conductores vivos

Seguridad

⚠️ Esta construcción también conecta entradas de tensión a la red. La entrada de tensión de cada módulo se conecta a una fase viva (L) y al neutro, con un fusible en L según indica la documentación del módulo. El lado de corriente sigue sin ser invasivo: la SCT-013 se coloca alrededor de su conductor de fase; nunca corte ni pele un cable vivo. Etiquete cada CT y cada cable de tensión con su fase. Para trabajar dentro de un cuadro eléctrico, llame a un electricista cualificado.

Cablee el bus

Los tres módulos comparten un bus I²C desde el 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
  • Coloque la CT de cada módulo alrededor de un conductor de fase, con la flecha hacia la carga.
  • Pull-ups integradas: manténgalas activas en el primer módulo según el orden físico del cableado y desactívelas en los otros dos: un único par de pull-up por bus, nunca externas. (Vea el documento de hardware del módulo.)

Asigne a cada módulo su propia dirección

Todos los módulos salen de fábrica en la dirección I²C 0x50. Tres en un bus necesitan tres direcciones: 0x50, 0x51, 0x52. Asigne el segundo y el tercero una vez cada uno, un módulo cada vez con los demás desconectados, para que no haya colisión. En el firmware actual esta es una operación de producción: sin modo de fábrica, sin herramientas adicionales:

  1. Conecte solo el módulo al que vaya a cambiar la dirección.
  2. Grabe una configuración de prueba con address: 0x50 y new_address: 0x51 (luego 0x52 para el tercero).
  3. Observe el registro de arranque de ESPHome para confirmar el cambio; luego ponga address: 0x51, borre la línea new_address: y pase al siguiente módulo.

(Mecánica completa: referencia de la API de ESPHome → new_address.)

La configuración de ESPHome

Tres módulos UI1 en 0x50 / 0x51 / 0x52, una flota sincronizada, datos en vivo por fase más el total coherente. Ajuste los tamaños de sus CT y los secretos de Wi-Fi, y grabe:

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;

Dos mandos que conviene entender:

  • fleet_gc_enable: true + group_id: 1 ponen los tres módulos en una misma flota sincronizada. Una vez por minuto, el ESP32 envía una única trama General-Call de «latch ahora» y cada módulo congela su acumulador de periodo en el mismo instante (desfase inferior a 10 µs). Eso es lo que hace coherente el total trifásico, en lugar de tres cifras muestreadas de forma independiente.

  • latch_interval: 60s (rbAmp ESPHome v1.4) desacopla el LATCH sincronizado de la cadencia de lectura en vivo: el panel actualiza tensión / corriente / potencia cada update_interval (10 s), mientras que la ráfaga coherente de latch de energía se ejecuta solo una vez por minuto. Los kWh siguen siendo exactos en cualquier caso: el maestro integra sobre tiempo real de reloj. Elimine la línea para el comportamiento de cadencia única de la v1.3.

Añádalo a Home Assistant

  1. Grabe y espere a que el nodo arranque: Home Assistant lo descubre automáticamente mediante la API de ESPHome. Verá las entidades por fase más Total 3-Phase Active Power [Potencia activa trifásica total].

  2. Ajustes → Dispositivos y servicios → Energía. Añada el sensor de Energía de cada fase (Phase A/B/C Energy) como fuente de consumo de red: el panel las suma para el consumo de toda la casa.

  3. Construya una vista Lovelace rápida con las tres potencias por fase y el total para una imagen en vivo por circuito.

Compruebe que está bien cableado

  • El escaneo I²C del registro de arranque debe listar las tres direcciones:
Text
[i2c] Found i2c device at address 0x50
[i2c] Found i2c device at address 0x51
[i2c] Found i2c device at address 0x52
  • Con una carga monofásica conocida en una fase, solo debe variar la potencia de esa fase.
  • Las tres potencias por fase deben sumar Total 3-Phase Active Power [Potencia activa trifásica total] en cada actualización.
  • Si una fase marca una fracción sospechosamente redonda de lo que espera, compruebe que su toma de tensión está en la misma fase que su CT: el emparejamiento coherente es el punto clave (véase la física).

Por qué es precisa

Cada módulo mide su fase de tensión y corriente a la vez y calcula la potencia activa real en el propio chip; el latch sincronizado congela las tres en un mismo instante. Eso es integración coherente por fase: el nivel de error inferior al 1 %, frente al 15–50 % de error de medir una fase y multiplicar por tres. El razonamiento completo está en el artículo complementario: por qué tres contadores monofásicos no pueden medir su potencia trifásica (3-phase).

¿Prefiere una sola placa? Una variante dedicada de una sola placa (U3I3: las tres fases en una placa, una dirección I²C) está en desarrollo. Está en la hoja de ruta, no en venta todavía; suscríbase abajo y le avisaremos cuando salga. Mientras tanto, esta flota de tres módulos es el camino de cifras honestas que puede construir hoy.


Lea a continuación