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.
⚠ 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) |
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 |
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.
: 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)
⚠ 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.
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 |
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:
- 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)
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 > 0significa consumo (corrente a entrar na carga vinda da rede),P < 0significa 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.
: 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.
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.
⚠️ 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 > 0para consumo,P < 0para 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.
— 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
- initialization.md — primeira ligação, teste de funcionamento, alteração de endereço
- troubleshooting.md → pinça de TC e polaridade — o que fazer se o sinal de P estiver errado ou se I_rms for instável