Perguntas e respostas
A maioria das dúvidas sobre um módulo de energia surge antes de o módulo chegar: é seguro tão perto da rede, vai ler a carga que eu realmente tenho, o que promete a classe de precisão. Cada resposta aqui ocupa uma página e começa pela resposta, e não pelo contexto — e onde toca na ligação ou na segurança, remete para o capítulo da documentação que a mostra.
Energia e hardware
O módulo rbAmp está isolado da rede elétrica?
Sim — e a razão é a arquitetura, não uma barreira acrescentada: o próprio módulo é todo de baixa tensão. A corrente é medida com uma pinça que fecha à volta do exterior do condutor isolado — só acoplamento magnético, por isso nada a potencial de rede entra no módulo. As variantes UI têm exatamente uma referência à rede, a deteção de tensão L – N, e passa por um divisor isolado galvanicamente; as variantes só de amperes não têm qualquer ligação à rede. O seu GND é a massa do anfitrião, não o neutro da rede, por isso ligar o lado I2C a um Arduino ou a um ESP32 é seguro. Não abra a caixa — anula a calibração de fábrica. Leia a resposta completa
Porque é que o rbAmp é alimentado a 5 V mas o barramento I²C é de 3.3 V?
O módulo tem o seu próprio microcontrolador a fazer a medição, e precisa de alimentação limpa e estável para manter as leituras do ADC exatas. Por isso o módulo recebe 5 V no VCC e passa-os por um regulador de baixo ruído integrado que gera os 3.3 V em que o seu MCU realmente trabalha. Como o MCU é um componente de 3.3 V, as linhas I²C (SDA/SCL) funcionam em lógica de 3.3 V — são tolerantes a 5 V, mas ficam em repouso no nível de 3.3 V do anfitrião. Em resumo: alimente o módulo a 5 V (4.5–5.5 V; abaixo de 4.5 V o ADC perde precisão) e ligue o barramento I²C em lógica de 3.3 V. Num ESP32 ou Arduino clássico isso é automático — o barramento segue a linha de 3.3 V do anfitrião, independentemente da alimentação de 5 V. Leia a resposta completa
Preciso de resistências pull-up I²C externas para o rbAmp?
Para um só módulo, não — a PCB do rbAmp tem resistências pull-up de 4.7 kΩ integradas em SDA/SCL para 3.3 V. Com 2 ou 3 módulos num barramento até 15 cm, deixe as pull-ups integradas em todos os módulos — não há nada a cortar (3 módulos medidos: cabos de 15 cm, 50 kHz). A partir de 4 módulos, ou num barramento mais longo, desative-as em todos os módulos (um jumper de solda) e instale um par externo perto do mestre; os valores estão na montagem multimódulo . Leia a resposta completa
Exatidão
Qual é a precisão do rbAmp?
Depende do sensor de corrente, por isso o valor tem duas partes: a classe do módulo com a classificação SCT-013 que usa, e a tolerância da própria pinça somada por cima. Ambas são indicadas por classificação — juntamente com o limiar abaixo do qual uma corrente é detetada mas não medida dentro dessa classe — na tabela de precisão SCT-013 . Na faixa de funcionamento (5–100 % da classificação) a classe é ≤ 0.5 % para a maioria das classificações. Leia a resposta completa
O rbAmp mede potência real ou apenas corrente?
Potência real (ativa), em watts, calculada no módulo por canal — além de tensão, corrente, fator de potência e frequência. Como tem tensão e corrente em cada canal, as cargas reativas e de baixo fator de potência são lidas com rigor; não se multiplica corrente por uma tensão assumida. Ler a resposta completa
I²C e placas
Que placas e frameworks posso usar com o rbAmp?
Qualquer coisa que fale I²C: ESPHome / Home Assistant , Arduino / C++ (ESP32, Uno, Nano, STM32, RP2040…), Python num Raspberry Pi ou noutro SBC Linux, e ESP-IDF . As quatro bibliotecas cliente são abertas e locais — sem nuvem, sem dependência de fornecedor — sobre um protocolo I²C documentado. Ler a resposta completa
Que velocidade de barramento I²C devo usar, e porquê 50 kHz no ESP32?
Depende do driver do anfitrião , não da marca da placa: Ler a resposta completa
Endereçamento e multi-módulo
Posso ligar vários módulos rbAmp num só barramento I²C?
Sim — é uma funcionalidade central. Os módulos partilham um barramento I²C e diferem só pelo endereço. Acrescente circuitos juntando módulos aos mesmos dois fios, atrás de um só anfitrião — sem microcontrolador extra, sem andar a trocar portas série. Para energia coerente entre módulos, um único broadcast latch (disparo de captura em difusão) fotografa todos ao mesmo instante. Veja as montagens: painel inteiro num ESP32 e barramento Arduino multimódulo . Leia a resposta completa
Como altero o endereço I²C de um módulo rbAmp?
Na firmware atual é uma operação simples, pronta para produção — sem modo especial, jumper nem ferramentas de fábrica . Prepara o novo endereço, arma a alteração e confirma-a (uma sequência de duas fases, armada por valor mágico (magic-armed), para que um endereço não mude por acidente); o módulo reinicia no novo endereço. Faça-o um módulo de cada vez, com os outros desligados , para não haver conflito de endereços. A sua biblioteca expõe isto diretamente (p. ex. prepareAddressChange() / commitAddressChange(), ou um auxiliar de provisionamento em frota). Ler a resposta completa
Energia
Como trata o rbAmp a energia (Wh), e sobrevive a um reinício?
A energia é integrada em intervalos exatos de relógio: o módulo fixa uma janela de medição de forma atómica e o anfitrião integra a potência ativa real ao longo do tempo decorrido, pelo que não há contador no dispositivo que sofra quantização ou deriva. No componente ESPHome, a energia acumulada é gravada na NVS do ESP32, pelo que um total de energia sobrevive a um reinício ou a uma queda de tensão, sem lacuna nem reposição no Home Assistant. Num esboço Arduino simples, o anfitrião mantém o total corrente — grave-o você mesmo (p. ex. num cartão SD) se precisar dele entre ciclos de alimentação. Ler a resposta completa
Integração
O rbAmp funciona com o Painel de Energia do Home Assistant?
Sim — através do ESPHome, o sensor de energia do módulo entra no Painel de Energia (Energy Dashboard) logo de início. Veja a configuração do Home Assistant . Leia a resposta completa
O rbAmp precisa de nuvem ou de subscrição?
Não. É totalmente local e aberto — um protocolo I²C documentado, com bibliotecas abertas para ESPHome, Arduino, Python e ESP-IDF. Nada contacta servidores externos; os dados são seus. Ler a resposta completa