O problema que isto resolve
Há um caminho mais curto. Um módulo rbAmp Basic comunica por I²C — dois fios de sinal — e é distribuído como componente ESPHome nativo. Prende uma pinça TC a um condutor, cola cerca de uma dúzia de linhas de YAML, e o Home Assistant adota um dispositivo com tensão, corrente, potência e energia acumulada reais — sem ocupar uma porta série. Este guia vai desde uma caixa fechada até um cartão ao vivo no Painel de Energia (Energy Dashboard). E quando quiser um segundo circuito mais tarde, acrescenta outro pequeno módulo nos mesmos dois fios — não outro ESP32.
O que terá no fim

Porque é que isto é melhor do que um PZEM
A configuração rápida é agradável, mas algumas diferenças arquiteturais são a verdadeira razão para construir desta forma — e tornam-se mais valiosas quanto mais tempo o módulo funcionar e quantos mais circuitos acrescentar.
-
Janelas de período que fecham de forma atómica. Para além do total vitalício, o rbAmp pode fechar uma janela de medição e abrir a seguinte — por segundo, por hora, por dia, ou um período de tarifa de procura — de forma atómica, numa única escrita I²C. Ao recebê-la, o módulo congela os acumuladores desse período e arranca o seguinte no mesmo instante do fio: sem ciclo de leitura, sem falha. Para obter a mesma energia por janela de um PZEM teria de ler e pôr a zero o acumulador pela UART a cada intervalo — tempo de CPU e de série numa ligação que já luta com o Wi-Fi do ESP, com a fração entre a leitura e a reposição a cair em nenhuma das janelas. Latch de hardware contra solução de software. (Em broadcast para muitos módulos ao mesmo tempo, esse mesmo latch mantém um quadro inteiro sincronizado — o próximo projeto desta série.)
-
A energia é medida no dispositivo, não estimada no Home Assistant. O módulo rbAmp faz a medição de potência e entrega ao ESP um valor coerente de potência média por período; o componente ESPHome integra isso em watt-hora e guarda-os na NVS, para que o HA receba um total já integrado. Isso afasta-o da maior fonte de maus dados de energia no HA — deixar o HA integrar a potência em energia com uma soma de Riemann entre amostras, a origem dos picos de −200 kWh e dias 10× demasiado altos que se vêem em todos os fóruns.
-
O módulo faz a parte difícil — por isso o seu anfitrião pode ser barato. Toda a amostragem, RMS verdadeiro, correção de fase e calibração correm no processador do próprio rbAmp; o ESP apenas lê os números finalizados por I²C. Um anfitrião modesto chega — um ESP8266 ou um ESP32-C2/C3 têm folga de sobra — deixando as placas maiores para trabalhos mais pesados.
-
É um barramento, não um fio ponto-a-ponto. I²C significa que vários módulos rbAmp partilham os mesmos dois fios de sinal — e os módulos existem hoje em variantes de 1, 2 e 3 canais (com módulos de 5 e 7 canais no roteiro), por isso um módulo pode medir vários circuitos a partir de um único ponto de instalação. Um ESP32 pode ler um quadro inteiro — rede, termoacumulador, ar condicionado, veículo elétrico (VE), iluminação — e quando os módulos funcionam com um mestre comum podem fazer latch no mesmo instante, para que as suas subtotais somem a alimentação. Um PZEM é um dispositivo por UART; ficam sem portas série (e paciência) após dois. Acrescentar um circuito aqui custa um pequeno módulo no barramento, não outro microcontrolador. (Esse é o próximo projeto desta série.)
Lista de materiais
| Item | Porquê | Preço | Onde |
|---|---|---|---|
| rbAmp BASIC SCT-UI1 (V + I, 1 canal) | o medidor — lê tensão, corrente, potência, energia | veja a página do produto | BASIC SCT-UI1 |
| TC SCT-013 (30 A recomendado) | pinça dividida à volta do condutor | veja a página do produto | TC SCT-013 |
| Qualquer placa de desenvolvimento ESP32 | anfitrião Wi-Fi que fala com o Home Assistant | provavelmente já tem um | — |
| 4 fios de ligação (F–F) | o barramento I²C: SDA, SCL, 3V3, GND | — | — |
Adapte a classificação do SCT-013 ao que está a medir — e note que as cargas individuais são menores do que parecem: um ar condicionado de quarto puxa apenas ~2–3 A, uma chaleira elétrica até ~10 A. Uma pinça de 5 A ou 10 A resolve isso com finura; 30 A cobre um circuito de parede movimentado; 50 A uma alimentação de apartamento inteiro. (Dimensionar uma entrada geral maior — cerca de 30 A para um piso, 100 A para uma casa com oficina e garagem — é trabalho do quadro inteiro: a gama SCT-013 do rbAmp vai até 50 A, por isso alimentações maiores usam a TC de gama superior e a configuração do quadro inteiro.) Para um aparelho único, 10–30 A é o padrão seguro. O módulo rbAmp conhece as predefinições SCT-013, por isso a calibração é um valor de configuração único (ct_model:, abaixo) — sem ajustes, sem cálculos de resistência de carga. Veja Seleção de TC / sensor. (A pinça é comprada à parte, por isso o módulo não a pode conhecer antecipadamente — uma linha de configuração abaixo é toda a instalação.)
Segurança em primeiro lugar — leia isto antes de tocar num quadro elétrico
⚠️ O lado de medição liga-se à rede. Uma TC dividida envolve à volta o exterior de um condutor isolado — nunca corta, descasca nem emenda um fio sob tensão para a instalar. Para trabalhos dentro de um quadro elétrico, chame um eletricista qualificado.
Ligue-o
Quatro jumpers entre o ESP32 e o módulo rbAmp Basic:
| pino do ESP32 | pino do módulo rbAmp |
|---|---|
3V3 |
3V3 |
GND |
GND |
GPIO21 (SDA) |
SDA |
GPIO22 (SCL) |
SCL |
Depois prenda a pinça TC dividida à volta de um condutor isolado do aparelho que quer medir — a fase ou o neutro, escolha um, não ambos — e ligue-a à tomada de 3.5 mm do módulo. O módulo faz o resto.
Num ESP32-S3 use GPIO8 (SDA) / GPIO9 (SCL); num ESP32-C3 use GPIO4 / GPIO5. Faça corresponder o bloco i2c: do YAML abaixo à sua placa.
[diagrama de ligação — espaço para media: ESP32-DevKitC ↔ módulo rbAmp Basic, 4 fios, TC presa a um condutor]
Carregue o firmware do ESP32 com ESPHome
Tudo está num único ficheiro — cerca de uma dúzia de linhas substantivas. Copie-o, edite as suas credenciais Wi-Fi e pronto.
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"
A linha que as pessoas esquecem: ct_model. Um módulo SCT-013 sai em branco — tem de lhe ser dito que pinça montou, ou as leituras saem à escala errada. Definir ct_model: SCT_013_030 faz isso uma vez; o módulo guarda-o na sua própria flash e nunca mais precisa dele (a linha é idempotente, por isso deixá-la na configuração é inofensivo). Mude a pinça, mude o valor. A pinça é vendida à parte, por isso o módulo não a pode conhecer antecipadamente — esta linha é toda a configuração.
Steps:
-
Instale a CLI do ESPHome(saltar se já o tiver) — ou use o add-on ESPHome dentro do Home Assistant; o mesmo YAML aplica-se:
Bashpip install esphome -
Coloque as suas credenciais Wi-Fi em
secrets.yamljunto à configuração, para nunca acabarem num repositório Git por engano:YAMLwifi_ssid: "YOUR_SSID" wifi_password: "YOUR_PASSWORD" -
Primeiro carregamento de firmware por USB (replace
/dev/ttyUSB0com a sua porta —COM3/COM4no Windows):Bashesphome run rbamp-basic-ui1.yaml --device /dev/ttyUSB0
O ESPHome descarrega o componente rbAmp, compila, carrega e transmite o log de arranque. Deverá ver um varrimento I²C a listar o endereço 0x50, depois rbAmp v1.3.0 initialised e publicações periódicas de sensores.
A partir daí, as atualizações chegam pelo ar — sem necessidade de voltar a desligar nada:
esphome run rbamp-basic-ui1.yaml
Com que frequência deve consultar? (update_interval) A configuração usa 60s, que é o adequado para o Painel de Energia (Energy Dashboard). Pode ir mais depressa ou mais devagar: o mínimo aceite é 1s (valores inferiores são rejeitados — o módulo só atualiza as amostras cerca de 5 vezes por segundo, por isso consultar abaixo de um segundo só sobrecarrega o barramento), e 300s (5 min) é um teto confortável para um sensor calmo e de pouco tráfego. Não ultrapasse 3600s (1 hora) — o Painel de Energia precisa de pelo menos uma atualização por hora para desenhar barras horárias limpas. Quer uma leitura de potência ao vivo e nervosa? Passe para 2s — veja Para além do painel abaixo.
Veja-o no Home Assistant
O Home Assistant descobre automaticamente os dispositivos ESPHome através de mDNS.

-
Abra Definições → Dispositivos e serviços (Settings → Devices & Services). Aparece um banner: "ESPHome — Discovered — rbamp-energy." Clique em Configurar, confirme o pedido da chave de encriptação (deixe em branco se não definiu encriptação em
api:), e o dispositivo é adotado. -
Abra o novo dispositivo rbamp-energy — há quatro entidades à espera:
| Entidade | Unidade | HA device_class |
Notas |
|---|---|---|---|
sensor.rbamp_voltage |
V | voltage |
Tensão RMS da rede |
sensor.rbamp_current |
A | current |
Corrente RMS através da TC |
sensor.rbamp_power |
W | power |
Potência ativa (P) |
sensor.rbamp_energy |
Wh | energy |
Acumulada — nunca é reposta a zero |

A entidade de energia já tem state_class: total_increasing, e o seu contador é guardado na NVS do ESP em cada publicação. Desligue da corrente e volte a ligar — o valor em Wh continua de onde parou. É exatamente o que o Painel de Energia (Energy Dashboard) pretende.
- Nada a configurar por sensor — o componente traz todas as
device_class,state_classe unidades ao nível da plataforma, por isso o HA as apanha na descoberta.
Adicione-o ao Painel de Energia (Energy Dashboard)

- Abra Definições → Painéis → Energia (Settings → Dashboards → Energy; ou Definições → Energia nas versões mais recentes do HA)
-
Em Dispositivos individuais, clique em Adicionar dispositivo e escolha
sensor.rbamp_energy. O Home Assistant filtra a lista para entidades comdevice_class: energy+state_class: total_increasing— o sensor de energia do rbAmp cumpre ambos, por isso aparece de imediato, sem flags extra. -
Guarde. O painel precisa de cerca de uma hora para desenhar a sua primeira barra legível; os totais por hora e por dia acumulam-se a partir daí.
Um módulo Basic mede o consumo — a potência que entra no aparelho. Não separa importação de exportação, por isso pertence aos slots de dispositivo / consumo do Painel de Energia, e não a "Devolução à rede" (Return to grid). Para medição bidirecional da rede (injeção de um inversor solar, exportação de bateria) precisa de um módulo da série Standard com a sua deteção de tensão isolada por hardware — veja a visão geral dos níveis. O Basic é de qualidade de monitorização e calibrado, mas não é um contador certificado para faturação.
Para além do painel: medição em tempo real
O Painel de Energia (Energy Dashboard) quer watt-hora lentos e acumulados — mas o módulo mede muito mais, e atualiza internamente cerca de cinco vezes por segundo. Se quiser um medidor de potência em tempo real, uma leitura de tensão ou o fator de potência para automações, acrescente os sensores extra e consulte mais depressa. Baixe update_interval para 2s (nervoso, verá uma chaleira ligar em menos de um segundo) ou 5s (tendência suave), e exponha o conjunto completo:
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" }
Agora pode construir um cartão de potência em tempo real, alertar para uma queda de tensão ou observar o fator de potência cair quando um motor arranca. Duas coisas a saber para que as suas automações se comportem:
-
A frequência lê 0 durante um corte (o detetor precisa de uma forma de onda ativa), por isso proteja qualquer automação de "frequência caiu" contra
0/unavailable. -
O fator de potência fica brevemente
unavailablesem carga — sem corrente significativa não há fase a calcular. Deixe as automações tolerarunavailabledurante os primeiros segundos após o arranque.
(Importação/exportação — separar o consumo da rede da injeção solar — requer umStandardmódulo com deteção bidirecional de tensão; não é uma capacidade do Basic, por isso fica de fora aqui.)
Separe por tarifa (ponta vs. fora de ponta)
Numa tarifa horária vai querer saber quantos watt-hora caíram na janela de ponta versus fora de ponta — sem comprar nada extra. O Home Assistant faz isto nativamente: aponte o seu utility_meter integrado para a única entidade de energia do rbAmp e deixe o HA dividi-la em sub-contadores de tarifa. Isto vai no configuration.yaml do HA, não no YAML do ESPHome:
utility_meter:
rbamp_energy_tou:
source: sensor.rbamp_energy
tariffs: [peak, off_peak]
cycle: monthly
Depois acrescente uma pequena automação que muda a tarifa ativa nas fronteiras das suas janelas — por exemplo peak às 07:00 e off_peak às 22:00 — chamando utility_meter.select_tariff. O HA mantém um total corrente separado para cada tarifa, por cima do contador único de Wh que o módulo fornece. Um contador, tantos baldes de tarifa quantos o seu plano precisar — e funciona com qualquer sensor de energia do ESPHome.
O que vem a seguir
Tem agora um circuito honesto no Home Assistant. Para onde isto segue a partir daqui:
-
O quadro inteiro num único ESP32. Coloque um módulo multicanal (ou vários módulos de um só canal) nos mesmos dois fios I²C — rede, fogão, termoacumulador, ar condicionado, luzes — um ESP32, um YAML. Acrescentar uma derivação custa um pequeno módulo, não outro microcontrolador. (Próximo nesta série.)
-
A migrar de um PZEM? Mantenha o histórico do Home Assistant, liberte a UART e ganhe watt-hora imunes a reinícios. (Próximo nesta série.)
-
Caçar os vampiros. Quando cada circuito está medido, o piso de stand-by — os cerca de 35 W que nunca dormem — torna-se visível e pagável. (Próximo nesta série.)
Para a teoria por trás de tudo isto — como uma TC transforma um campo magnético em quilowatt-hora — veja o guia rápido ESPHome e o guia completo de integração com o Home Assistant.