rbAmp
PT
Loja
Docs
Atualizado

01 · Ligação de hardware

Este capítulo descreve a ligação física do rbAmp a um dispositivo mestre e os requisitos de alimentação. O módulo chega pronto a funcionar. O utilizador trabalha apenas com o lado de baixa tensão (BT) — quatro fios para I²C, uma linha DRDY opcional e (para os SKU com TC externo) uma ficha jack de 3.5 mm para a pinça.

Segurança

⚠ Lado da rede. Para trabalhos dentro de um quadro elétrico, chame um eletricista qualificado.

A pinça vai em um só condutor (L) — nunca no cabo inteiro. É sem contacto, mas precisa de um condutor com isolamento intacto. A derivação L precisa de um fusível (ver Fio e fusível abaixo).

Pinout do lado LV

O módulo funciona com lógica de 3.3 V e é tolerante a lógica de 5 V nas linhas I²C. Todos os pinos do lado de baixa tensão estão totalmente isolados galvanicamente da rede.

pino rbAmp Sinal Função
VCC +4.5 … +5.5 V (alimentação) Alimentação do módulo; mínimo de 4.5 V necessário para o funcionamento correto
GND Terra Massa comum com o mestre — obrigatória
SDA SDA I²C Dados I²C
SCL SCL I²C Relógio I²C
DRDY Data-ready (opcional) Pulso LOW em dreno aberto de ~10 µs a cada janela de medição (~100 ms, v1.2 e posteriores)
Pinagem do lado de baixa tensão do rbAmp: VCC, GND, SDA, SCL e a linha DRDY opcional.

Pull-ups I²C — instalados na placa

Importante: cada módulo rbAmp tem resistências pull-up de 4.7 kΩ incorporadas em SDA e SCL para 3.3 V. Para um barramento de módulo único não são necessárias pull-ups externas — ligue o mestre diretamente.

Quando desativar os pull-ups integrados

Com quatro ou mais módulos rbAmp (ou outros dispositivos I²C com os seus próprios pull-ups) no barramento, ou num barramento mais longo, a sua combinação em paralelo dá uma resistência efetiva demasiado baixa, o que:

  • Aumenta o consumo de energia do barramento
  • Pode exceder a corrente máxima de sumidouro do andar de saída do mestre I²C (tipicamente ≤ 3 mA em lógica de 3.3 V)
  • Acrescenta carga capacitiva em barramentos longos, contribuindo pouco para a imunidade ao ruído

Com dois ou três módulos num barramento até 15 cm, não mexa nas resistências pull-up incorporadas (ver a tabela abaixo). Caso contrário: cada módulo tem cortes de solda (solder-jumper) na face inferior da placa, junto às resistências pull-up. A serigrafia lê Pull-Up. Corte a pista com uma lâmina afiada para desligar a pull-up:

  • Com quatro ou mais módulos, ou num barramento mais longo, mantenha as pull-ups ativas em apenas um módulo do barramento (ou transfira-as para um único ponto junto ao mestre).
  • Corte as pontes de solda nos restantes módulos.
  • Se a placa do mestre já fornecer pull-ups de barramento e o barramento tiver quatro ou mais módulos (ou for mais longo), corte os jumpers em todos os módulos rbAmp. Com dois ou três módulos, meça primeiro (ver Em dúvida abaixo) e corte apenas se a leitura for inferior a ~1 kΩ.

Regra prática

Módulos rbAmp no barramento Pull-ups
1 Não mexer (trabalho interno de 4.7 kΩ)
2 Não mexer em nenhuma (barramento até 15 cm)
3 Não mexer em nenhuma das três (barramento até 15 cm)
4…6 Corte em todos os módulos; par externo 2.2…2.7 kΩ junto ao mestre
7…16 Corte em todos os módulos, par externo 1.5…2.2 kΩ junto ao mestre; verifique a capacidade total do barramento (≤ 400 pF) e reduza a velocidade do barramento se necessário
Nota

São valores recomendados calculados a partir da especificação I²C (corrente de sumidouro do pull-up ≤ 3 mA a 3.3 V, capacidade do barramento ≤ 400 pF) — não é uma garantia medida para todos os cabos e mestres. Ligue os pull-ups externos a 3.3 V (o nível lógico do barramento), e não à alimentação de 5 V VCC. Mestre de 5 V: veja Compatibilidade de tensão I²C abaixo.

A linha de 3 módulos é medida (fios de 15 cm, 50 kHz); as outras linhas são calculadas a partir da especificação I²C.

Quais as pull-ups I²C a manter ou cortar conforme o número de módulos rbAmp que partilham o barramento.

Em dúvida

: meça a resistência entre SDA e VCC com todos os dispositivos sem alimentação. Para um barramento de módulo único o valor típico é ~4.7 kΩ (uma pull-up incorporada); num barramento com vários módulos o paralelo baixa para a faixa 1.5–4.7 kΩ, conforme quantas pull-ups incorporadas continuam ativas. Abaixo de ~1 kΩ significa demasiadas pull-ups ativas em paralelo — ver a tabela acima.

Potência

Parâmetros de VCC

  • Tensão nominal: 5 V DC
  • Gama aceitável: 4.5 … 5.5 V
  • Consumo de corrente: ~15 mA típico, ~25 mA de pico durante a escrita em flash
  • Ripple: < 50 mV pico a pico (para a precisão da medição)
Segurança

⚠ Respeite a polaridade da alimentação. A polaridade inversa na entrada de 5 V não é suportada — verifique a ligação VCC/GND antes de ligar. Confirme a convenção de cores da sua cablagem antes da primeira ligação, sobretudo ao crimpar os seus próprios cabos.

Compatibilidade de tensão I²C

  • SDA/SCL funcionam com lógica de 3.3 V (os pull-ups integrados ligam-nas a 3.3 V).
  • As linhas são tolerantes a 5 V, por isso um mestre de 5 V (Arduino UNO / Nano) lê HIGH (~3.3 V) corretamente e pode comandar o barramento.
  • Configuração padrão: pull-ups para 3.3 V. Só se quiser deliberadamente níveis de barramento de 5 V, desative as pull-ups incorporadas e acrescente pull-ups externas para +5 V do lado do mestre.

Comportamento no arranque

  • Arranque a frio: ~250 ms até ao primeiro resultado de medição válido.
  • Após RESET (por software ou por queda de tensão): ~250 ms para recuperar.
  • Antes do primeiro resultado válido, os registos lêem 0 e DATA_VALID (0xCE) está a 0.

Isolamento

O módulo em si é totalmente de baixa tensão — não tem qualquer circuito de medição de alta tensão. A corrente é lida por uma pinça CT que se acopla magneticamente do exterior do condutor isolado, sem contacto elétrico com o fio da rede. Nas variantes com deteção de tensão (UI) a única referência à rede é o terminal L–N, que alimenta um divisor de deteção isolado galvanicamente*; as variantes só de amperes não têm qualquer ligação à rede. Consequentemente:

  • A massa do módulo não está ligada à fase nem ao neutro da rede.
  • Ligar o lado BT a um mestre de 5 V é seguro — não há risco de curto-circuito através da massa.
Nota

Não abra a caixa — isso anula a calibração de fábrica.

Barramento I²C

Parâmetros

  • Endereço predefinido: 0x50 (7 bits)
  • Gama de endereços: 0x08..0x77 (reprovisionável por confirmação em duas fases, veja initialization.md)
  • Velocidade (recomendação; a escolha é do utilizador): 50 kHz em mestres ESP32 e ESP8266 (uma limitação do driver I²C do ESP-IDF, não do módulo); 100 kHz noutros mestres; não use 400 kHz. 100 kHz também é viável em ESP32/ESP8266 com repetição ao nível da aplicação.
  • Auto-incremento na leitura: SIM — leitura em rajada suportada (registos multi-byte, bloco RT V03, janela DIGEST).
  • Incremento automático na ESCRITA: NÃO — cada byte escrito precisa de um endereço de registo explícito, incluindo os campos de vários bytes (escreva primeiro o byte baixo e depois o alto, separadamente).
  • Clock-stretching: não é usado pelo módulo como mecanismo de controlo de fluxo. O mestre deve observar uma pausa entre transações (tBUF) de ≥ 100 µs.

Comprimento do barramento

O I²C é, por defeito, um barramento curto (~15 cm). Muitos utilizadores ligam os módulos com fios de jumper de baixa qualidade, que apanham muito ruído e perdem muitas transferências — daí o limite curto. Topologias recomendadas para o rbAmp:

Topologia de cabos Comprimento máximo Velocidade
JST padrão / cabo plano de 4 fios até 0.15 m 100 kHz
Par entrançado UTP (cat-5/5e/6) — SDA+GND e SCL+GND em pares separados até 1 m 100 kHz
Par entrançado UTP + buffer I²C (PCA9515 / TCA9617) até 3 m 100 kHz
Barramento diferencial (PCA9615 / LTC4332) até 100 m 100 kHz
Segurança

Os prazos acima são dados para 100 kHz; a recomendação de 50 kHz para mestres ESP32/ESP8266 (§Parâmetros) aplica-se a todas as topologias — a velocidade mais baixa acrescenta apenas margem.

Para trajetos com mais de 0.15 m, é necessário par entrançado: SDA e SCL têm de estar em pares separados, cada um com a sua própria massa (por exemplo, azul + azul-branco para SDA, verde + verde-branco para SCL). Pôr SDA e SCL no mesmo par causa acoplamento cruzado que distorce as transições.

⚠ Dentro de um armário elétrico, blinde o cabo I2C. Campos magnéticos fortes perto de condutores da rede, contactores e transformadores induzem ruído num cabo sem blindagem. Mantenha o cabo o mais curto possível e afastado da cablagem da rede.

Barramento multimódulo

Vários módulos rbAmp podem partilhar um único barramento I²C:

Vários módulos rbAmp a partilhar um barramento I²C com um único mestre.

  • Número de módulos: até ~16 (limitado pela capacidade total do barramento — ≤ 400 pF a 100 kHz)
  • Endereços: cada módulo tem o seu próprio endereço de 7 bits. Todos os módulos saem de fábrica em 0x50; reatribua-lhes o endereço um a um antes de os ligar em paralelo (veja initialization.md → Alteração de endereço).
  • Pull-ups: siga a tabela de número de módulos acima (valores recomendados) — com 2–3 módulos num barramento até 15 cm, não mexa nas pull-ups incorporadas; com 4+ módulos corte-as em todos e use um par externo dimensionado para o número de módulos.
  • Remover um módulo: para retirar um módulo de um barramento partilhado, desligue os seus fios de barramento (ou o módulo inteiro), não apenas a alimentação: um módulo sem alimentação carrega SDA e SCL e pode parar o barramento para os restantes módulos.

Ligações dos sensores (lado da rede)

Ligação do lado da rede de um módulo rbAmp dentro de um quadro: a derivação L e N e a pinça de corrente no condutor L.

Sensor de tensão (variantes UI*)

A placa expõe os terminais L (linha / fase) e N (neutro). A polaridade importa para o sinal da potência ativa:

  • Ligação correta (L → L, N → N): P > 0 significa consumo (corrente a entrar na carga vinda da rede), P < 0 significa exportação para a rede (geração).
  • Ligação trocada (L e N invertidos): o sinal de P fica invertido — o consumo é apresentado como potência negativa.

Fio e fusível. Não é necessário um fio grosso para a ligação de tensão: AWG26–22 chega, porque o sensor de tensão consome muito pouca corrente. Um fusível na linha L é obrigatório, de calibre até 0.1 A.

A polaridade correta é crítica para:

  • Contabilização BASIC rigorosa (o BASIC conta apenas max(P, 0); uma polaridade trocada anula o total de energia).
  • Separação correta de consumo e geração na linha STD.
Verificação rápida

: com uma carga puramente resistiva (chaleira elétrica, aquecedor, lâmpada incandescente), P > 0 e PF ≈ 1.0. Se P for negativo enquanto a carga consome, troque L e N na placa.

Sensor de corrente — SCT-013 (para SKUs com CT externa)

As pinças SCT-013 ligam-se ao módulo através de uma ficha jack de 3.5 mm. O conector tem chaveamento para polaridade correta de origem; não são necessárias decisões de ligação. Características de cada calibre SCT-013 (limiares, classe, tolerância, corte): ver a tabela SCT-013.

Como a pinça de corrente se liga ao módulo rbAmp através da ficha jack de 3.5 mm.
O corpo da pinça tem umasetaindicando o sentido do fluxo de energia para a orientação "normal":

A pinça de corrente fechou em torno do fio L com a seta apontada para a carga.

Rules:

  • Prenda a pinça do sensor em torno do fio da linha (L) que vai para o consumidor.
  • A seta na pinça tem de apontar no sentido da corrente em direção à carga (do quadro de disjuntores para a carga).
  • A pinça tem de fechar completamente — sem folga entre as duas metades do núcleo magnético. Uma folga > 0.1 mm aumenta bruscamente a relutância magnética e degrada a precisão.
Segurança

⚠️ Aviso: não passe L e N na mesma pinça. Os fluxos magnéticos são iguais e opostos, por isso anulam-se — o sensor lê corrente próxima de zero mesmo com carga real.

Marcações dos canais na placa

Cada ficha na placa está identificada com o nome do canal (I0, I1, I2, …) e um marcador de cor. Os cabos SCT-013 são eletricamente simétricos — a orientação é estabelecida pela seta na pinça e pela sua colocação no fio, não pela extremidade do cabo que entra na ficha.

Polaridade e sinal de P

  • Seta no sentido correto + polaridade L/N correta → P > 0 para consumo, P < 0 para exportação.
  • Pinça instalada ao contrário (seta contra o sentido da corrente) → o sinal de P fica invertido.

Pinças de corrente — série CT

Cada canal de um módulo da série CT tem a sua própria pinça num cabo de 1 m. O cabo chega ligado ao módulo e está marcado com o número do canal; ligue-o à ficha do canal correspondente. Mantenha cada pinça no seu próprio canal, também quando voltar a cablar o quadro mais tarde: uma pinça noutro canal dá leituras erradas, e o módulo não o reporta.

  • Não mude uma pinça de canal nem ligue outra pinça: a calibração pertence ao par.
  • Coloque a pinça no condutor L com a seta apontada para a carga (o consumidor); o condutor tem de passar pela janela e a pinça tem de fechar completamente.
  • O tamanho da janela segue o valor nominal: 6 mm para 1–10 A, 10 mm para 20–50 A, 16 mm para 100 A. O condutor com o seu isolamento tem de caber na janela.
  • Alimentação e barramento, pull-ups, velocidade do barramento, fio de tensão e fusível: como para qualquer módulo BASIC (veja as secções acima). A entrada de tensão é a mesma dos módulos SCT-UI: fio AWG26–22, um fusível na linha L até 0.1 A.

DATA_READY (DRDY)

Pino opcional para consulta otimizada. Se a sua aplicação estiver bem com consulta a um intervalo fixo próprio (100 ms ou mais lento), pode deixar o DRDY desligado.

Parâmetros elétricos

  • Tipo de saída: dreno aberto (sem pull-up ativa para VCC)
  • Nível em repouso: HIGH (requer um pull-up no lado do mestre — quer um pull-up interno do MCU quer uma resistência externa; recomendado 10 kΩ para 3.3 V)
  • Pulso de pronto: LOW de ~10 µs, depois de os registos RT (0x86..0xCF) terem sido atualizados
  • Frequência de pulsos: ~10 Hz (um pulso por janela RT de ~100 ms; ~5 Hz nas imagens anteriores à v1.2)

Semântica

A aresta descendente do DRDY garante que todos os registos RT estão coerentes e recém-publicados (o firmware atualiza-os atomicamente dentro de uma ISR antes de baixar o pino). O mestre pode ler 0x86..0xCD imediatamente na aresta descendente sem risco de amostra partida.

Utilização do lado do mestre

  • Interrupção EXTI / GPIO no flanco descendente — acorda o mestre e dispara uma leitura.
  • Use qualquer GPIO com capacidade de entrada — os números de pino dos exemplos (p. ex., GPIO 15) são ilustrativos, não um requisito.
  • Pull-up de 10 kΩ para 3.3 V do lado do mestre.
  • Várias saídas DRDY de módulos podem ser combinadas numa ligação OR por fio (veja realtime-polling.md → DRDY multimódulo).

Aplicabilidade

  • O DRDY dispara apenas nas atualizações em tempo real (em cada janela de medição, ~100 ms a partir da v1.2).
  • O DRDY não dispara nos instantâneos de período (os instantâneos de período são atualizados pelo comando de instantâneo que o mestre emite — por isso o mestre já sabe quando ler).
  • Para mestres de consulta lenta (a cada 1 s ou 60 s), o DRDY pode ser ignorado.
Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino RbAmp::setDrdyPin(pin) / RbAmp::waitDataReady(timeout_ms, ev) ligue o pino DRDY; aguarde a janela seguinte publicada
ESP-IDF rbamp_set_drdy_gpio() / rbamp_wait_data_ready() ligue o pino DRDY; aguarde a janela seguinte publicada
Python — a biblioteca não usa o pino DRDY
ESPHome drdy_pin: entrada DRDY opcional; apenas registada, não usada como disparo de leitura

Exemplo de ligação de referência (ESP32, um módulo)

Outras variantes de módulo

As outras variantes de módulo usam a mesma pinagem do lado de baixa tensão (VCC / GND / SDA / SCL / DRDY); só o lado da rede é diferente.

Seguinte