rbAmp
PT
Loja

Projeto · · 7 min de leitura

Uma alternativa ao PZEM-004T para o Home Assistant: migre para o rbAmp e mantenha todo o histórico

Já ultrapassou o seu PZEM-004T? Mude para o rbAmp por I²C sem perder um único gráfico — mesmas IDs de entidade, histórico intacto, UART libertada, espaço para mais circuitos. Uma migração de um YAML.

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

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

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

(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

  1. Anote os seus IDs de entidade atuais. Definições → Dispositivos e serviços (Settings → Devices & Services) → o seu nó PZEM → anote os entity_id dos sensores (ex.: sensor.pzem_voltage, sensor.pzem_energy) e confirme qual alimenta o Painel de Energia (Definições → Energia).

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

  3. Substitua o seu YAML antigo pela configuração acima, editando apenas: o esphome: name: para o nome antigo do seu nó, cada name: de sensor para os nomes antigos dos sensores byte a byte, e o ct_model: para a sua pinça.

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

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

Uma ressalva honesta.

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:

As entidades PZEM antes da troca

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

As mesmas IDs de entidade após a troca, agora a partir do rbAmp

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

Potência contínua através da troca PZEM → rbAmp — sem falha, sem reposição

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:

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" }

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.


Leia a seguir