Início rápido
No fim deste guia, terá um módulo rbAmp a ler tensão e corrente no seu microcontrolador, com os valores a fluir para o Home Assistant (através do ESPHome) ou para o seu próprio sketch Arduino.
O que vai conseguir em 15 minutos
O que precisa
- 1× módulo rbAmp (por exemplo Basic UI1 com pinça CT SCT-013)
- 1× placa de desenvolvimento ESP32 (ou Arduino Uno, ou Raspberry Pi)
- 4× fios de jumper (VCC, GND, SDA, SCL)
- 1× pinça de corrente SCT-013 — no BASIC traz a sua própria e seleciona o valor nominal em software; os módulos STD saem de fábrica emparelhados com os seus sensores
- Cabo USB para programação
Trabalhar com tensão da rede é perigoso. Desligue sempre a alimentação AC antes de instalar derivações de tensão. Se tiver dúvidas, contrate um eletricista qualificado.
Ligação
A pinagem, a regra das pull-ups e os limites de comprimento do cabo estão num só lugar: Ligação de hardware. Ligue VCC, GND, SDA e SCL conforme indicado ali e depois volte ao caminho de que precisa abaixo.
Escolha o seu caminho
:::choose-your-path
- ESPHome (Home Assistant): Ir para a configuração do ESPHome ↓
- IDE Arduino: Ir para a configuração Arduino ↓
- Raspberry Pi (Python): Ir para a configuração RPi ↓ :::
Configuração do ESPHome
O componente ESPHome tem o seu próprio início rápido com um YAML mínimo, o comando de teste e a saída esperada: Início rápido ESPHome. Para o lado do Home Assistant, veja Home Assistant.
Configuração do Arduino
Instalação da biblioteca, o primeiro esboço e o que o monitor série deve imprimir: Arranque rápido Arduino. Detalhes de placa e cablagem para anfitriões Arduino: Hardware Arduino.
Configuração do Raspberry Pi
Instalação, o primeiro script e a saída esperada: Biblioteca Python — Visão geral, e depois Exemplos.
Verificar
Após a configuração, deverá ver:
- Tensão: ~230 V (ou ~120 V conforme a região)
- Corrente: 0 A inicialmente (sem carga na pinça CT)
- Ao ligar um aparelho conhecido (p. ex., lâmpada de 100 W): a corrente sobe para ~0.4 A
Próximos passos
- Consulte o guia de Ligação de hardware para instalação permanente
- Leia a Referência da API para detalhes ao nível de registo
- Explore exemplos de plataforma para configurações reais de integração
Soluções rápidas de resolução de problemas
Se vir apenas zeros ou erros NAK:
- Verifique a cablagem I²C (SDA/SCL não trocados)
- Verifique as resistências pull-up (4.7 kΩ em SDA e SCL)
- Execute o scanner I²C para confirmar o endereço
0x50
Para uma resolução de problemas mais profunda, veja a Resolução de problemas.