rbAmp
EN
Shop
Docs
Updated

Quick Start

By the end of this guide, you'll have an rbAmp module reading voltage and current on your microcontroller, with values flowing into Home Assistant (via ESPHome) or your own Arduino sketch.

What you'll achieve in 15 minutes

What you need

  • 1× rbAmp module (e.g., Basic UI1 with SCT-013 CT clamp)
  • 1× ESP32 dev board (or Arduino Uno, or Raspberry Pi)
  • 4× jumper wires (VCC, GND, SDA, SCL)
  • 1× SCT-013 current clamp — for BASIC you bring your own and select its rating in software; STD modules ship factory-paired with their sensors
  • USB cable for programming
Caution

Working with mains voltage is dangerous. Always disconnect AC power before installing voltage taps. If unsure, hire a qualified electrician.

Wiring

The pinout, the pull-up rule and the cable-length limits live in one place: Hardware Connection. Wire VCC, GND, SDA and SCL as shown there, then come back to the path you need below.

Choose your path

:::choose-your-path

ESPHome setup

The ESPHome component has its own quick start with a minimal YAML, the test command and the expected output: ESPHome Quick Start. For the Home Assistant side, see Home Assistant.

Arduino setup

Library install, the first sketch and what the serial monitor should print: Arduino Quick Start. Board and wiring specifics for Arduino hosts: Arduino Hardware.

Raspberry Pi setup

Install, the first script and the expected output: Python library — Overview, then Examples.

Verify

After setup, you should see:

  • Voltage: ~230 V (or ~120 V depending on region)
  • Current: 0 A initially (no load on CT clamp)
  • When you turn on a known appliance (e.g., 100W lamp): current spikes to ~0.4 A

Next steps

Troubleshooting quick fixes

If you see all zeros or NAK errors:

  1. Check I²C wiring (SDA/SCL not swapped)
  2. Verify pull-ups (4.7 kΩ on SDA and SCL)
  3. Run I²C scanner to confirm address 0x50

For deeper troubleshooting see Troubleshooting.