rbAmp
PT
Loja

Projeto · · 13 min de leitura

Energia por circuito no Painel de Energia (Energy Dashboard) do Home Assistant, numa tarde — com ESPHome e rbAmp

Acrescente energia real e calibrada por eletrodoméstico ao Painel de Energia (Energy Dashboard) do Home Assistant — um ESP32, ESPHome e um módulo rbAmp em dois fios I²C. Sem UART, sem PZEM.

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

A entidade de energia do rbAmp que alimenta o Painel de Energia (Energy Dashboard) do Home Assistant
Consumo por aparelho no Painel de Energia do HA, diretamente de um módulo rbAmp por ESPHome.

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 — —
Qual TC?

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

Segurança

⚠️ 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.

Nota

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.

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

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:

  1. 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:

    Bash
    pip install esphome
    

  2. Coloque as suas credenciais Wi-Fi em secrets.yamljunto à configuração, para nunca acabarem num repositório Git por engano:

    YAML
    wifi_ssid: "YOUR_SSID"
    wifi_password: "YOUR_PASSWORD"
    

  3. Primeiro carregamento de firmware por USB (replace /dev/ttyUSB0com a sua porta —COM3 / COM4no Windows):

    Bash
    esphome 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:

Bash
esphome run rbamp-basic-ui1.yaml
Nota

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.

As entidades rbAmp ficam no Home Assistant após a adoção

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

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

As quatro entidades rbAmp com valores em tempo real no Home Assistant

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.

  1. Nada a configurar por sensor — o componente traz todas as device_class, state_class e unidades ao nível da plataforma, por isso o HA as apanha na descoberta.

Adicione-o ao Painel de Energia (Energy Dashboard)

A adicionar o sensor.rbamp_energy como dispositivo individual nas definições de Energia do HA

  1. Abra Definições → Painéis → Energia (Settings → Dashboards → Energy; ou Definições → Energia nas versões mais recentes do HA)
  2. Em Dispositivos individuais, clique em Adicionar dispositivo e escolha sensor.rbamp_energy. O Home Assistant filtra a lista para entidades com device_class: energy + state_class: total_increasing — o sensor de energia do rbAmp cumpre ambos, por isso aparece de imediato, sem flags extra.

  3. 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í.

Basic vs Standard.

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:

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

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 unavailable sem carga — sem corrente significativa não há fase a calcular. Deixe as automações tolerar unavailable durante 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:

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


Leia a seguir