rbAmp
ES
Tienda

Proyecto · · 7 min de lectura

Una alternativa al PZEM-004T para Home Assistant: migre a rbAmp y conserve todo su historial

¿Se le ha quedado pequeño su PZEM-004T? Cambie a rbAmp por I²C sin perder ni una gráfica: los mismos ID de entidad, historial intacto, UART liberado, espacio para añadir más circuitos. Una migración de un solo YAML.

¿Por qué abandonar un PZEM que funciona?

  • Ocupa un UART. El PZEM se comunica por un enlace serie: un UART de hardware que preferiría usar para otra cosa, o SoftwareSerial, cuya temporización se vuelve inestable con la carga de Wi-Fi. Un medidor, un puerto serie.

  • No escala. ¿Quiere un segundo circuito? Eso es un segundo UART (tiene uno o dos) o un segundo ESP. No hay un «añadir otro» limpio, que es exactamente el muro con el que tropiezan quienes intentan medir más de uno o dos circuitos.

rbAmp habla I²C, un bus: así que libera el UART, gana medición calibrada en fábrica y compensada en fase, y puede añadir más módulos sobre los mismos dos cables más adelante (ese es el proyecto de todo el cuadro). Lo único que frena a la gente a la hora de actualizar es el miedo a perder su historial de Home Assistant: años de gráficos, el panel de Energía, todo. No tiene por qué. Bien hecho, HA nunca nota que el hardware ha cambiado.

Lo que conserva, lo que gana

Conserva: sus ID de entidad, cada gráfica de historial, sus paneles y la configuración de su panel de Energía, sin tocar. Gana:

  • Un UART liberado: los GPIO que usaba el PZEM vuelven a ser suyos.
  • Espacio para crecer: añada módulos al bus I²C sin otro ESP (todo el cuadro en un ESP32).
  • Potencia activa real calibrada en fábrica y compensada en fase: medida, no estimada (véase cómo funciona realmente la medición).

  • Vatios-hora en el dispositivo: acumulados en el módulo y entregados a HA como total, de modo que no depende de que HA integre la potencia entre muestras (el origen de los clásicos picos del panel de Energía).

Lista de materiales

Elemento Por qué Dónde
rbAmp BASIC SCT-UI1 sustituye el cabezal del PZEM, por I²C BASIC SCT-UI1
Una CT SCT-013 nueva (calibre según el circuito) la pinza CT SCT-013
su ESP32 existente reutilizado: está liberando su UART —
4 cables de puente el bus I²C —
Seguridad

No reutilice la pinza del PZEM. La CT de un PZEM-004T suele ser de 100 A (fuera de los preajustes de calibración de rbAmp), usa un jack mono de 2.5 mm (rbAmp espera 3.5 mm), y su tipo de salida no está garantizado que coincida. Una SCT-013 nueva cuesta unos pocos euros y elimina los tres problemas; y como ya está cambiando el cabezal del módulo, el trabajo sigue siendo un «cambie, no adapte» limpio.

⚠️ Volver a colocar una CT implica trabajo en el cuadro. Una CT se coloca alrededor de un cable aislado: nunca lo corte ni lo pele. Para trabajar dentro de un cuadro eléctrico, llame a un electricista cualificado.

El cambio: una edición de YAML

El truco para conservar el historial es sencillo: Home Assistant identifica las entidades por su entity_id, y ESPHome lo deriva del nombre del nodo más el name: del sensor. Mantenga ambos idénticos a su configuración antigua de PZEM y HA verá las mismas entidades, alimentadas por mejor hardware. Aquí está la configuración «después» (el bloque UART de su PZEM desaparece; I²C ocupa su lugar):

YAML
esphome:
  name: energy-monitor          # ← MUST match your PZEM node name, byte-for-byte

esp32:
  board: esp32dev
  framework:
    type: arduino

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

api:
ota:
  - platform: esphome
logger:

# The rbAmp side of the swap — I²C replaces the old UART pins.
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]

rbamp:
  id: meter
  address: 0x50
  update_interval: 60s
  ct_model: SCT_013_030         # match to YOUR fitted CT

sensor:
  - platform: rbamp
    rbamp_id: meter
    # ⚠ Each name: MUST match your old PZEM sensor names byte-for-byte → same entity_id → history preserved.
    voltage: { name: "PZEM Voltage" }
    current: { name: "PZEM Current" }
    power:   { name: "PZEM Power" }
    energy:  { name: "PZEM Energy" }   # ← the Energy Dashboard entity — preserved

(Mantener los nombres literales "PZEM Voltage", etc., solo importa si eso es lo que usaba su configuración antigua; haga coincidir los suyos. Lo importante es que sean idénticos byte a byte.)

Conserve su historial: los pasos exactos

  1. Anote sus ID de entidad actuales. Ajustes → Dispositivos y servicios → su nodo PZEM → anote los entity_id de los sensores (p. ej. sensor.pzem_voltage, sensor.pzem_energy) y confirme cuál alimenta el panel de Energía (Ajustes → Energía).

  2. Instale el rbAmp junto al PZEM; coloque la nueva SCT-013 alrededor del mismo conductor; cablee el bus I²C al ESP32. (Puede dejar el PZEM conectado físicamente: el cambio es por software.)

  3. Sobrescriba su YAML antiguo con la configuración de arriba, editando solo: el esphome: name: con el nombre de su nodo antiguo, cada name: de sensor con los nombres antiguos de sus sensores byte a byte, y ct_model: con su CT.

  4. Grábelo: esphome run energy-monitor.yaml. HA ve que el mismo nodo/API vuelve con datos; ningún aviso de «nuevo dispositivo encontrado», ninguna nueva adopción.

  5. Compruebe en 60 s: las entidades deben tener los mismos ID (no ..._2). Si ve el sufijo _2, un nombre no coincide byte a byte; corríjalo y vuelva a grabar.

Una vez asentado el cambio, las etiquetas PZEM … solo están para coincidir con el antiguo entity_id. Puede renombrar los nombres amigables en la interfaz de Home Assistant cuando quiera (abra la entidad → renombrar); el entity_id y su historial siguen exactamente igual.

Una advertencia honesta.

Tras el cambio, sus gráficos de historial y el panel de Energía siguen intactos: las estadísticas a largo plazo se conservan y las nuevas lecturas se añaden a la misma serie. Pero la tarjeta de Wh con el valor actual mostrará 0 y contará desde ahí: es que arranca el nuevo contador de rbAmp, no que se hayan perdido datos. El tratamiento de total_increasing de HA lo engancha tras bambalinas a su acumulado existente. Espere que la tarjeta en vivo se reinicie; su historial no.

Lo que verá en Home Assistant:

Antes del cambio: sus entidades PZEM, tal como están hoy:

Las entidades del PZEM antes del cambio

Tras grabar, las mismas ID de entidad, ahora alimentadas por rbAmp (la tarjeta de energía lee un recuento nuevo, según la advertencia de arriba):

Las mismas ID de entidad tras el cambio, ahora desde rbAmp

Y el punto clave: la potencia pasa a través del cambio sin hueco y sin caída a cero. Su historial está intacto:

Potencia continua durante el cambio de PZEM a rbAmp: sin hueco ni reinicio

Compruebe primero: mida ambos lado a lado (opcional)

¿No se atreve a confiar a ciegas? Ponga ambos medidores en el mismo ESP32 durante un día, compruebe que coinciden y luego borre el bloque del PZEM. Esta configuración mantiene el PZEM en su UART y añade rbAmp en I²C, con nombres distintos para que HA grafique ambos:

YAML
# PZEM (reference) on the existing UART
uart:
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
sensor:
  - platform: pzemac
    voltage: { name: "PZEM Ref Voltage" }
    current: { name: "PZEM Ref Current" }
    power:   { name: "PZEM Ref Power" }
    energy:  { name: "PZEM Ref Energy" }
# rbAmp (new) on I²C
i2c:
  sda: GPIO21
  scl: GPIO22
  frequency: 50kHz   # 50 kHz on ESP32 — see the note in the single-meter config above (ESP-IDF i2c_master driver).
external_components:
  - source: github://rb-amp/rbamp-esphome@v1.4.0
    components: [rbamp]
rbamp:
  id: meter
  address: 0x50
  ct_model: SCT_013_030
sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage: { name: "rbAmp New Voltage" }
    current: { name: "rbAmp New Current" }
    power:   { name: "rbAmp New Power" }
    energy:  { name: "rbAmp New Energy" }

Superponga las dos series de potencia en una tarjeta de historial; sobre el mismo conductor coinciden con una diferencia de uno o dos por ciento. ¿Contento? Grabe la configuración de un solo medidor de arriba (con los nombres antiguos) y ya ha migrado, con historial incluido.

Lo que ha ganado

  • Un UART de vuelta: reutilice GPIO16/17 para otro periférico, o un segundo bus I²C para más módulos rbAmp.
  • Un bus al que crecer: todo el cuadro en un ESP32 está ahora a unos pocos módulos de distancia.
  • Medición en la que puede confiar: potencia activa real calibrada en fábrica y compensada en fase; vea cómo funciona realmente la medición con CT.

Vuelta atrás

Si algo no encaja, vuelva a grabar la configuración YAML original del PZEM en el mismo ESP32: los mismos ID de entidad se reanudan y el contador de la EEPROM del PZEM continúa donde se quedó. Nada se quema.


Lea a continuación