Solução · Home Assistant
O seu painel de energia precisa de sensores por circuito — o medidor da casa inteira é uma só linha
O rbAmp dá ao Home Assistant tensão, corrente, potência e energia de cada circuito como sensores normais — algumas linhas de YAML com o componente ESPHome, ou um Raspberry Pi por MQTT. Funciona com o Painel de energia [Energy Dashboard] do HA.
O que obtém no Home Assistant
Sensores normais do HA
Tensão · Corrente · Potência · PF · Frequência · Energia aparecem como sensores normais do HA — gráficos, histórico, automações.
Painel de energia do HA
A energia flui para o Painel de energia [Energy Dashboard] incorporado: totais diários/tarifários, estatísticas de longo prazo, custo. (BASIC: apenas consumo. STD: importação e exportação como sensores de energia separados, para Consumo da rede e Devolução à rede.)
Por circuito / vários módulos
Vários módulos no barramento → cargas separadas (termoacumulador, cozinha, rede geral) como entidades separadas.
Automações e alertas
Limiares, notificações, cenas — sobrecarga, «deixou o ferro ligado», exportação para a rede (STD).
Escolha o seu caminho
A — ESPHome (ESP32)
Módulo no I²C do ESP32 → componente ESPHome → API própria do ESPHome para o HA. Um bloco YAML curto, sem código. O caminho mais curto para a maioria das instalações.
B — SBC direto (Raspberry Pi)
Módulo no I²C do Pi → biblioteca Python → autodiscovery MQTT → HA. Para configurações sem interface / centradas no Pi / de integradores, sem ESP32.
| ESPHome (ESP32) | SBC direto (Raspberry Pi) | |
|---|---|---|
| Hardware | ESP32 | Raspberry Pi |
| Esforço | YAML, sem código | Python + MQTT |
| Ideal para | Todos | Integradores · sem interface |
Caminho A — componente ESPHome
ESPHome no ESP32 → um bloco YAML curto → sensores no HA.
- Gravar o ESP32. Firmware ESPHome no ESP32; módulo em I²C (SDA/SCL; a linha DRDY é opcional), alimentado a 5 V.
- Acrescente o componente.
external_components, um blocorbamp(endereço, modelo de pinça) e sensoresplatform: rbamp. - As entidades aparecem. U / I / P / PF / Hz / energia surgem no HA automaticamente; coloque-as num painel.
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz
external_components:
- source: github://rb-amp/rbamp-esphome@main
rbamp:
id: meter1
address: 0x50 # factory default
ct_model: SCT_013_030 # your clamp model
sensor:
- platform: rbamp
rbamp_id: meter1
voltage: { name: "Mains Voltage" }
power: { name: "Mains Power" }
energy: { name: "Mains Energy" }
- Sem código — apenas YAML
- Multi-módulo num barramento
- O total de energia sobrevive a reinícios — guardado no ESP32 e restaurado antes da primeira atualização, para que o HA não veja nenhuma reposição
- API própria do ESPHome para o HA (não MQTT)
Caminho B — SBC direto (Raspberry Pi)
Módulo no I²C do Pi → pip install rbamp smbus2 → autodiscovery MQTT → entidades no HA.
- Ligue ao Pi. Módulo no I²C do Pi (SDA/SCL, lógica de 3.3 V), alimentado a 5 V; ative o I²C no raspi-config.
- pip install rbamp smbus2. Leia U / I / P / PF / Wh em Python.
- Ponte para o HA. Publique em MQTT com autodiscovery → o HA cria as entidades por si.
from smbus2 import SMBus
from rbamp import RbAmp
with SMBus(1) as bus, RbAmp(bus, 0x50) as dev:
print(dev.voltage, dev.read_current(0), dev.read_power(0)) # V, A, W
- Para configurações sem interface / centradas no Pi / de integradores
- Não é necessário ESP32
- Lógica de 3.3 V — sem conversor de nível
- Exemplo completo de autodiscovery MQTT na documentação
Leve o rbAmp para o Home Assistant.
Siga o guia do seu caminho: ESPHome num ESP32, ou Python num Raspberry Pi.