Porque deixar um PZEM que funciona?
-
Ocupa uma UART. O PZEM comunica por uma ligação série — uma UART de hardware que preferia usar para outra coisa, ou
SoftwareSerial, cuja temporização fica instável sob carga Wi-Fi. Um medidor, uma porta série. -
Não escala. Quer um segundo circuito? Isso é uma segunda UART (tem uma ou duas) ou um segundo ESP. Não há um "acrescentar mais" limpo — é exatamente a parede em que as pessoas batem quando tentam medir mais de um ou dois circuitos.
O rbAmp fala I²C — um barramento — por isso liberta a UART, ganha medição calibrada de fábrica e com compensação de fase, e pode acrescentar mais módulos nos mesmos dois fios mais tarde (é o projeto do quadro inteiro). O que trava as pessoas de atualizar é o medo de perder o histórico do Home Assistant — anos de gráficos, o Painel de Energia, tudo. Não precisa. Bem feito, o HA nunca dá por que o hardware mudou.
O que mantém, o que ganha
Mantém: as suas IDs de entidade, todos os gráficos de histórico, os seus painéis e a configuração do Painel de Energia — intactos. Ganha:
- Uma UART libertada — os GPIO que o PZEM usava são novamente seus.
- Espaço para crescer — acrescente módulos no barramento I²C sem outro ESP (o quadro inteiro num ESP32).
-
Potência real, calibrada de fábrica e com compensação de fase — medida, não estimada (veja como a medição funciona na prática).
-
Watt-hora no dispositivo — acumulados no módulo e entregues ao HA como total, para não depender de o HA integrar a potência entre amostras (a origem dos clássicos picos do Painel de Energia).
Lista de materiais
| Item | Porquê | Onde |
|---|---|---|
| rbAmp BASIC SCT-UI1 | substitui a cabeça do PZEM, em I²C | BASIC SCT-UI1 |
| Uma TC SCT-013 nova (classificação adequada ao circuito) | a pinça | TC SCT-013 |
| o seu ESP32 existente | reutilizado — está a libertar a sua UART | — |
| 4 fios de ligação | o barramento I²C | — |
Não reutilize a pinça do PZEM. A TC de um PZEM-004T tem tipicamente 100 A nominais (fora das predefinições de calibração do rbAmp), usa uma ficha mono de 2.5 mm (o rbAmp espera 3.5 mm), e o seu tipo de saída não está garantido. Uma SCT-013 nova custa uns euros e elimina os três problemas — e como já está a trocar a cabeça do módulo, mantém o trabalho numa troca limpa, não numa adaptação.
⚠️ Reapertar uma TC implica trabalho no quadro. Uma TC envolve à volta um fio isolado — nunca o corte nem descasque. Para trabalhos dentro de um quadro elétrico, chame um eletricista qualificado.
A troca: uma alteração de YAML
O segredo para manter o histórico é simples: o Home Assistant identifica entidades pelo entity_id, e o ESPHome deriva esse id do nome do nó + do name: do sensor. Mantenha ambos idênticos à sua configuração PZEM antiga e o HA vê as mesmas entidades — apenas alimentadas por melhor hardware. Aqui está a configuração "depois" (o seu bloco UART do PZEM desaparece; o I²C toma o seu lugar):
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
(Manter os nomes literais "PZEM Voltage" etc. só importa se era isso que a sua configuração antiga usava — corresponda ao que tinha. O essencial é a igualdade byte a byte.)
Preserve o histórico — os passos exatos
-
Anote os seus IDs de entidade atuais. Definições → Dispositivos e serviços (Settings → Devices & Services) → o seu nó PZEM → anote os
entity_iddos sensores (ex.:sensor.pzem_voltage,sensor.pzem_energy) e confirme qual alimenta o Painel de Energia (Definições → Energia). -
Instale o rbAmp ao lado do PZEM; prenda a nova TC SCT-013 ao mesmo condutor; ligue o barramento I²C ao ESP32. (Pode deixar o PZEM fisicamente ligado — a troca é feita por software.)
-
Substitua o seu YAML antigo pela configuração acima, editando apenas: o
esphome: name:para o nome antigo do seu nó, cadaname:de sensor para os nomes antigos dos sensores byte a byte, e oct_model:para a sua pinça. -
Carregue o firmware —
esphome run energy-monitor.yaml. O HA vê o mesmo nó/API voltar com dados; sem banner de "novo dispositivo encontrado", sem nova adoção. -
Verifique em 60 s — as entidades devem ter as mesmas IDs (não
..._2). Se vir um sufixo_2, algum nome não coincide byte a byte; corrija e volte a carregar o firmware.
Depois de a troca estar assente, as etiquetas PZEM … servem apenas para corresponder ao antigo entity_id. Pode renomear os nomes amigáveis na interface do Home Assistant quando quiser (abra a entidade → renomeie) — o entity_id e o respetivo histórico mantêm-se exatamente como estão.
Após a troca, os gráficos de histórico e o Painel de Energia mantêm-se intactos — as estatísticas de longo prazo transitam e as novas leituras acrescentam-se à mesma série. Mas o cartão de Wh em valor atual vai mostrar 0 e contar a partir daí: é o contador novo do rbAmp a começar, não dados perdidos. O tratamento total_increasing do HA cose-o ao seu acumulado existente nos bastidores. Espere que o cartão ao vivo reinicie; o seu histórico não.
O que verá no Home Assistant:
Antes da troca — as suas entidades PZEM, exatamente como estão hoje:

Após a carga do firmware — as mesmas IDs de entidade, agora alimentadas pelo rbAmp (o cartão de energia lê uma contagem nova, conforme a nota acima):

E o ponto central — a potência passa diretamente pela troca, sem falha e sem queda para zero. O seu histórico está intacto:

Confie primeiro: meça os dois lado a lado (opcional)
Sem coragem para avançar às cegas? Ligue os dois medidores no mesmo ESP32 durante um dia e veja-os concordar; depois apague o bloco PZEM. Esta configuração mantém o PZEM na sua UART e acrescenta o rbAmp em I²C, com nomes distintos para o HA desenhar ambos:
# 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" }
Sobreponha as duas séries de potência num cartão de histórico; no mesmo condutor acompanham-se dentro de um ou dois por cento. Satisfeito? Carregue a configuração de medidor único de cima (com os seus nomes antigos) e está migrado — com histórico e tudo.
O que ganhou
- Uma UART de volta — reutilize o GPIO16/17 para outro periférico, ou um segundo barramento I²C para mais módulos rbAmp.
- Um barramento para crescer — o quadro inteiro num ESP32 está agora a poucos módulos de distância.
- Medição em que pode confiar — potência ativa real, calibrada de fábrica e com compensação de fase; veja como a medição por TC funciona na prática.
Reversão
Se algo parecer errado, volte a carregar o seu YAML PZEM original no mesmo ESP32 — as mesmas IDs de entidade retomam e o contador EEPROM do PZEM continua de onde ficou. Nada fica queimado.