rbAmp
ES
Tienda

Proyecto · · 13 min de lectura

Energía por circuito en el panel de Energía de Home Assistant, en una tarde, con ESPHome y rbAmp

Añada energía real y calibrada por aparato al panel de Energía de Home Assistant: un ESP32, ESPHome y un módulo rbAmp sobre dos cables I²C. Sin UART, sin PZEM.

El problema que resuelve

Hay un camino más corto. Un módulo rbAmp Basic habla I²C (dos hilos de señal) y se distribuye como componente nativo de ESPHome. Coloca una CT alrededor de un conductor, pega una docena de líneas de YAML y Home Assistant adopta un dispositivo con tensión, corriente, potencia y energía acumulada reales, sin ocupar un puerto serie. Este recorrido va desde una caja sin abrir hasta un mosaico en vivo en el panel de Energía. Y cuando después quiera un segundo circuito, añade otro pequeño módulo sobre los mismos dos hilos, no otro ESP32.

Lo que tendrá al final

La entidad de energía de rbAmp que alimenta el panel de Energía de Home Assistant
Consumo por aparato en el panel de Energía de HA, directamente desde un módulo rbAmp por ESPHome.

Por qué esto supera a un PZEM

La puesta en marcha rápida es cómoda, pero unas pocas diferencias de arquitectura son la verdadera razón para construirlo así, y ganan valor cuanto más tiempo funcione el módulo y más circuitos añada.

  • Ventanas de periodo que se cierran de forma atómica. Más allá del total de por vida, rbAmp puede cerrar una ventana de medida y abrir la siguiente: por segundo, por hora, por día, o un periodo de tarifa por demanda, de forma atómica, en una sola escritura I²C. Al recibirla, el módulo congela los acumuladores de ese periodo y empieza el siguiente en el mismo instante del cable: sin bucle de lectura, sin hueco. Para obtener la misma energía por ventanas de un PZEM tendría que leer y poner a cero su acumulador por UART en cada intervalo: tiempo de CPU y de serie en un enlace que ya lucha con el Wi-Fi del ESP, con la fracción entre la lectura y el reinicio cayendo en ninguna de las dos ventanas. Latch por hardware frente a solución por software. (Difundido a muchos módulos a la vez, ese mismo latch mantiene todo un cuadro sincronizado: el siguiente proyecto de esta serie.)

  • La energía se mide en el dispositivo, no se adivina en Home Assistant. El módulo rbAmp hace la medición de potencia y entrega al ESP una cifra coherente de potencia media en cada periodo; el componente de ESPHome la integra en vatios-hora y los guarda en la NVS, así que HA recibe un total ya integrado. Eso le saca de la mayor fuente de malos datos de energía en HA: dejar que ella integre la potencia en energía con una suma de Riemann entre muestras, lo que hay detrás de los picos de −200 kWh y los días un 10× demasiado altos que se ven por todos los foros.

  • El módulo hace la parte difícil, así que su host puede ser barato. Todo el muestreo, el RMS verdadero, la corrección de fase y la calibración se ejecutan en el procesador propio del rbAmp; el ESP solo lee números terminados por I²C. Un host modesto basta: un ESP8266 o un ESP32-C2/C3 tienen margen de sobra, dejando sus placas más grandes para trabajos más pesados.

  • Es un bus, no un cable punto a punto. I²C significa que varios módulos rbAmp comparten los mismos dos hilos de señal, y los módulos vienen hoy en variantes de 1, 2 y 3 canales (con módulos de 5 y 7 canales en la hoja de ruta), así que un módulo puede medir varios circuitos desde un único punto de instalación. Un ESP32 puede leer todo un cuadro (red, calentador de agua, aire acondicionado, VE, iluminación), y cuando los módulos cuelgan de un maestro común pueden fijarse en el mismo instante para que sus subtotales sumen la alimentación. Un PZEM es un dispositivo por UART: se acaban los puertos serie (y la paciencia) tras dos. Añadir un circuito aquí cuesta un pequeño módulo en el bus, no otro microcontrolador. (Ese es el siguiente proyecto de esta serie.)

Lista de materiales

Elemento Por qué Precio Dónde
rbAmp BASIC SCT-UI1 (V + I, 1 canal) el medidor: lee tensión, corriente, potencia y energía vea la página del producto BASIC SCT-UI1
Transformador de corriente SCT-013 (se recomienda 30 A) CT de núcleo partido alrededor del conductor vea la página del producto CT SCT-013
Cualquier placa de desarrollo ESP32 host Wi-Fi que habla con Home Assistant probablemente ya tenga uno —
4 cables de puente (F–F) el bus I²C: SDA, SCL, 3V3, GND — —
¿Qué CT?

Ajuste el calibre de la SCT-013 a lo que mide, y tenga en cuenta que las cargas individuales son más pequeñas de lo que parecen: un aire acondicionado de habitación consume solo ~2–3 A, un hervidor eléctrico hasta ~10 A. Una pinza de 5 A o 10 A resuelve esas con finura; 30 A cubre un circuito de pared muy cargado; 50 A, una acometida de piso entero. (Dimensionar una acometida mayor, unos 30 A para una planta y 100 A para una casa con taller y garaje, es trabajo de cuadro completo: el rango SCT-013 de rbAmp llega hasta 50 A, así que las acometidas mayores usan la CT de rango superior y la instalación de cuadro completo.) Para un único aparato, 10–30 A es el valor por defecto seguro. El módulo rbAmp conoce los preajustes de SCT-013, así que la calibración es un valor de configuración único (ct_model:, abajo): sin recortes, sin cálculo de resistencia de carga. Vea selección de CT / sensor. (La pinza se compra por separado, así que el módulo no puede conocerla de antemano: una línea de configuración de abajo es toda la puesta a punto.)

Seguridad ante todo: lea esto antes de tocar un cuadro

Seguridad

⚠️ El lado de medida se conecta a la red. Una CT de núcleo partido se coloca alrededor del exterior de un conductor aislado: nunca corte, pele ni empalme un cable vivo para instalarla. Para trabajar dentro de un cuadro eléctrico, llame a un electricista cualificado.

Conéctelo

Cuatro puentes entre el ESP32 y el módulo rbAmp Basic:

Pin del ESP32 pin del módulo rbAmp
3V3 3V3
GND GND
GPIO21 (SDA) SDA
GPIO22 (SCL) SCL

Después, coloque la CT de núcleo partido alrededor de un conductor aislado del aparato que quiera medir (la línea o el neutro: elija uno, no ambos) y conéctela a la toma de 3.5 mm del módulo. El módulo hace el resto.

Nota

En un ESP32-S3 use GPIO8 (SDA) / GPIO9 (SCL); en un ESP32-C3, GPIO4 / GPIO5. Ajuste el bloque i2c: del YAML de abajo a su placa.

[diagrama de cableado: espacio multimedia: ESP32-DevKitC ↔ módulo rbAmp Basic, 4 cables, CT colocada sobre un conductor]

Grabe el ESP32 con ESPHome

Todo es un único archivo: una docena de líneas sustanciales. Cópielo, edite sus credenciales de Wi-Fi y listo.

YAML
esphome:
  name: rbamp-energy

esp32:
  board: esp32dev
  framework:
    type: arduino

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

api:
ota:
  - platform: esphome
logger:

# I²C bus to the rbAmp module. GPIO21/22 are the default pins on a classic ESP32-DevKitC.
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.

# Pull the rbAmp component from GitHub, pinned to the v1.3.0 release.
external_components:
  - source: github://rb-amp/rbamp-esphome@v1.4.0
    components: [rbamp]

# The module itself — 0x50 is the factory-default I²C address.
rbamp:
  id: meter
  address: 0x50
  update_interval: 60s
  # One-time CT setup for the SCT-013 module: tell it which clamp is fitted. This pins the
  # 30 A SCT-013 preset and is written ONCE to the module's flash (idempotent — safe to leave
  # in the config; it only re-writes when the value changes). Match it to YOUR clamp:
  # SCT_013_005 / _010 / _020 / _030 / _050.
  ct_model: SCT_013_030

# Voltage · current · active power · cumulative energy → Home Assistant entities.
# The energy sensor is auto-tagged device_class=energy + state_class=total_increasing,
# and its Wh counter is checkpointed to the ESP's NVS on every publish — so it survives
# reboots and power cycles instead of restarting from zero.
sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage:
      name: "rbAmp Voltage"
    current:
      name: "rbAmp Current"
    power:
      name: "rbAmp Power"
    energy:
      name: "rbAmp Energy"
Nota

La línea que la gente olvida: ct_model. Un módulo SCT-013 sale en blanco: hay que indicarle qué pinza ha instalado, o sus lecturas salen mal escaladas. Poner ct_model: SCT_013_030 lo hace una vez; el módulo lo guarda en su propia flash y nunca lo vuelve a necesitar (la línea es idempotente, así que dejarla en la configuración no molesta). Cambie la pinza, cambie el valor. La pinza se vende aparte, así que el módulo no puede conocerla de antemano: esta línea es toda la puesta a punto.

Steps:

  1. Instale la CLI de ESPHome(omítalo si ya lo ejecuta), o use el complemento de ESPHome dentro de Home Assistant; el mismo YAML se aplica:

    Bash
    pip install esphome
    

  2. Ponga sus credenciales de Wi-Fi en secrets.yamljunto a la configuración, para que nunca acaben en un repositorio Git por accidente:

    YAML
    wifi_ssid: "YOUR_SSID"
    wifi_password: "YOUR_PASSWORD"
    

  3. Primera carga por USB (replace /dev/ttyUSB0con su puerto:COM3 / COM4en Windows):

    Bash
    esphome run rbamp-basic-ui1.yaml --device /dev/ttyUSB0
    

ESPHome descarga el componente rbAmp, compila, sube el firmware y muestra el registro de arranque. Debe ver un escaneo I²C que liste la dirección 0x50, luego rbAmp v1.3.0 initialised y publicaciones periódicas de sensores.

A partir de entonces, las actualizaciones llegan por aire: ya no hace falta desenchufar nada:

Bash
esphome run rbamp-basic-ui1.yaml
Nota

¿Con qué frecuencia debe consultar? (update_interval) La configuración usa 60s, que es lo adecuado para el panel de Energía. Puede ir más rápido o más lento: el mínimo aceptado es 1s (cualquier valor inferior se rechaza, porque el módulo solo actualiza sus muestras unas 5 veces por segundo, así que consultar por debajo de un segundo solo satura el bus), y 300s (5 min) es un techo cómodo para un sensor tranquilo y de poco tráfico. No supere 3600s (1 hora): el panel de Energía necesita al menos una actualización por hora para dibujar barras horarias limpias. ¿Quiere en cambio una lectura de potencia en vivo y nerviosa? Baje a 2s; vea Más allá del panel más abajo.

Véalo en Home Assistant

Home Assistant descubre automáticamente los dispositivos ESPHome mediante mDNS.

Las entidades de rbAmp viven en Home Assistant tras la adopción

  1. Abra Ajustes → Dispositivos y servicios [Settings → Devices & Services]. Aparece un aviso: «ESPHome: Descubierto: rbamp-energy». Pulse Configurar [Configure], confirme la petición de clave de cifrado (déjela en blanco si no configuró el cifrado de api:), y el dispositivo queda adoptado.

  2. Abra el nuevo dispositivo rbamp-energy: le esperan cuatro entidades:

Entidad Unidad device_class de HA Notas
sensor.rbamp_voltage V voltage Tensión RMS de red
sensor.rbamp_current A current Corriente RMS a través de la CT
sensor.rbamp_power W power Potencia activa (P)
sensor.rbamp_energy Wh energy Acumulada: nunca se reinicia

Las cuatro entidades de rbAmp con valores en vivo en Home Assistant

La entidad de energía ya incluye state_class: total_increasing, y su contador se guarda en la NVS del ESP en cada publicación. Desconecte la alimentación y vuelva a conectarla: el valor en Wh continúa desde donde se detuvo. Eso es exactamente lo que espera el panel de Energía.

  1. Nada que configurar por sensor: el componente incluye cada device_class, state_class y unidad a nivel de plataforma, así que HA los recoge al descubrir el dispositivo.

Añádalo al panel de Energía [Energy Dashboard]

Añadir sensor.rbamp_energy como dispositivo individual en los ajustes de Energía de HA

  1. Abra Ajustes → Paneles → Energía (o Ajustes → Energía en las versiones nuevas de HA). [Settings → Dashboards → Energy]
  2. En Dispositivos individuales [Individual devices], pulse Añadir dispositivo [Add device] y elija sensor.rbamp_energy. Home Assistant filtra la lista a entidades con device_class: energy + state_class: total_increasing; el sensor de energía de rbAmp cumple ambos, así que aparece de inmediato, sin indicadores extra.

  3. Guarde. El panel necesita aproximadamente una hora para dibujar su primera barra legible; los totales por hora y por día se acumulan a partir de ahí.

Basic frente a Standard.

Un módulo Basic mide consumo, es decir, la potencia que entra en el aparato. No separa importación de exportación, así que pertenece a las ranuras de dispositivo / consumo del panel de Energía, no a «Devolver a la red» [Return to grid]. Para medición bidireccional de red (vertido de un inversor solar, exportación de batería) necesita un módulo de la serie Standard con su detección de tensión aislada por hardware; vea la descripción de niveles. Basic es de grado de monitorización y calibrado, pero no es un contador de facturación certificado.

Más allá del panel: medición en tiempo real

El panel de Energía quiere vatios-hora lentos y acumulados, pero el módulo mide mucho más y se actualiza internamente unas cinco veces por segundo. Si quiere un medidor de potencia en vivo, una lectura de tensión o el factor de potencia para automatizaciones, añada los sensores extra y consulte con más frecuencia. Baje update_interval a 2s (nervioso: verá que un hervidor se conecta en menos de un segundo) o a 5s (tendencia suave), y exponga el conjunto completo:

YAML
rbamp:
  id: meter
  address: 0x50
  update_interval: 2s     # live real-time — override the 60s Energy-Dashboard default
  ct_model: SCT_013_030

sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage:        { name: "rbAmp Voltage" }
    current:        { name: "rbAmp Current" }
    power:          { name: "rbAmp Active Power" }
    power_factor:   { name: "rbAmp Power Factor" }
    apparent_power: { name: "rbAmp Apparent Power" }
    reactive_power: { name: "rbAmp Reactive Power" }
    frequency:      { name: "rbAmp Frequency" }
    energy:         { name: "rbAmp Energy" }

Ahora puede construir una tarjeta de potencia en vivo, avisar de una caída de tensión o vigilar cómo se hunde el factor de potencia cuando arranca un motor. Dos cosas que conviene saber para que sus automatizaciones se comporten bien:

  • La frecuencia lee 0 durante un corte (el detector necesita una forma de onda en vivo), así que proteja cualquier automatización de «frecuencia caída» frente a 0 / unavailable.

  • El factor de potencia está brevemente unavailable sin carga: sin corriente significativa no hay fase que calcular. Deje que las automatizaciones toleren unavailable durante los primeros segundos tras el arranque.

(Importación/exportación, separar el consumo de red del vertido solar, requiere unStandardmódulo con detección bidireccional de tensión; no es una capacidad de Basic, así que se omite aquí.)

Desglósela por tarifa (punta frente a valle)

Con un plan de tarifa horaria querrá saber cuántos vatios-hora caen en la franja de punta frente a la de valle, sin comprar nada extra. Home Assistant lo hace de forma nativa: apunte su utility_meter integrado a la única entidad de energía de rbAmp y deje que HA la divida en submedidores tarifarios. Esto va en el configuration.yaml de HA, no en el YAML de ESPHome:

YAML
utility_meter:
  rbamp_energy_tou:
    source: sensor.rbamp_energy
    tariffs: [peak, off_peak]
    cycle: monthly

Después añada una pequeña automatización que cambie la tarifa activa en los límites de su franja horaria, por ejemplo peak a las 07:00 y off_peak a las 22:00, llamando a utility_meter.select_tariff. HA mantiene un total corriente aparte para cada tarifa, por encima del único contador de Wh que aporta el módulo. Un solo medidor, tantos tramos tarifarios como necesite su plan, y funciona con cualquier sensor de energía de ESPHome.

Lo que viene después

Ahora tiene un circuito honesto en Home Assistant. Hacia dónde va esto a partir de aquí:

  • Todo el cuadro en un ESP32. Coloque un módulo multicanal (o varios módulos monocanal) sobre los mismos dos cables I²C: red, cocina, calentador de agua, aire acondicionado, luces. Un ESP32, un YAML. Añadir una derivación cuesta un pequeño módulo, no otro microcontrolador. (Próximo en esta serie.)

  • ¿Migra desde un PZEM? Conserve su historial de Home Assistant, libere el UART y gane vatios-hora que sobreviven a los reinicios. (Próximo en esta serie.)

  • Caza de vampiros. Una vez medido cada circuito, el suelo de consumo en reposo (los ~35 W que nunca duermen) se vuelve visible y pagable. (Próximo en esta serie.)

Para la teoría que hay detrás de todo esto (cómo una CT convierte un campo magnético en kilovatios-hora), vea la guía rápida de ESPHome y la guía completa de integración con Home Assistant.


Lea a continuación