rbAmp
EN
Shop

Your meter gives one number. See which circuit makes the bill.

Start with one rbAmp module on your own controller, and grow to a whole-panel system without replacing what you bought. Each module measures voltage, current, power and energy on individual circuits.

Docs · GitHub

A three-phase rbAmp installation on a DIN rail inside a consumer unit, with clamp sensors on the outgoing circuits.

01 / Start here

What do you want to know?

02 / How it fits

Measure it. Meter it. Connect it.

Start with one module and add a meter. Nothing you bought is replaced.

03 / STD meters

Metering lives on the device, not in your software

A utility meter gives one number per building. rbAmp gives one per circuit, per tenant, per charger.

STD meters
STD-U3I3 three-phase meter with three clamp sensors

Counters on the device (STD)

Kept and saved every second on the meter.

Import and export (STD)

Two counters, not a balance.

Small loads do not hide (STD)

Current in microamperes, energy in microwatt-hours.

Updates that roll back (STD)

Signed image; metering continues during the update.

Source: Docs › STD › Energy and periods

Safe by design, stated per model
The side you connect to your controller is low-voltage and isolated from the mains inputs; current is measured through a clamp. Safety, per line
Factory calibrated
Accuracy is stated per sensor rating, as module plus sensor, never as one number. Accuracy by rating

04 / Equipment

Built to sit in a panel

Full catalogue

05 / Your first project

Your first measured circuit

A BASIC SCT-UI3 module, and what else you need:

  • an SCT-013 clamp sensor
  • an ESP32 board
  • a 5 V supply
  • four bus wires (I²C)
  • the library for your stack
Reference projects

06 / Your stack

Works with the tools you already use

ESPHome · BASIC SCT-UI1 + SCT-013 · ESP32 · I²C

YAMLmeter.yaml
rbamp:
  id: meter1
  address: 0x50
  ct_model: SCT_013_030

sensor:
  - platform: rbamp
    rbamp_id: meter1
    voltage:
      name: "Mains Voltage"
    current:
      name: "Mains Current"
    power:
      name: "Mains Power"
    energy:
      name: "Mains Energy"

Source: rbamp-esphome README · Quick start

ESP-IDF · BASIC SCT-UI1 + SCT-013 · ESP32 · I²C

C
rbamp_handle_t dev;
ESP_ERROR_CHECK(rbamp_new(bus, 0x50, &dev));
ESP_ERROR_CHECK(rbamp_begin(dev));
ESP_ERROR_CHECK(rbamp_set_sensor_class(dev,
                RBAMP_SENSOR_SCT013));
ESP_ERROR_CHECK(rbamp_set_ct_model(dev, 3));

rbamp_snapshot_t s;
if (rbamp_read_all(dev, &s) == ESP_OK) {
    ESP_LOGI("app", "P=%.1f W", (double)s.power[0]);
}

Source: rbamp-esp-idf README · Quick start

Arduino · BASIC SCT-UI1 + SCT-013 · ESP32 · I²C

C++
#include <Wire.h>
#include <RbAmp.h>

RbAmp dev(Wire, 0x50);

dev.setSensorClass(RbAmpSensorClass::Sct013);
dev.setCTModel(RbAmpCTModel::Sct013_030);

RbAmpPeriodSnapshot snap;
if (dev.readPeriodSnapshot(snap)) {
    Serial.println(snap.avg_p[0]);
}

Source: rbamp-arduino README · Quick start

Python · BASIC SCT-UI1 + SCT-013 · Raspberry Pi · I²C

Python
from smbus2 import SMBus
from rbamp import RbAmp, RbAmpSensorClass

with SMBus(1) as bus:
    with RbAmp(bus, 0x50) as dev:
        dev.set_sensor_class(RbAmpSensorClass.SCT_013)
        dev.set_ct_model(3)
        print(f"P[0] = {dev.power[0]:.2f} W")

Source: rbamp-python README · Quick start

STD over Modbus RTU · UART TTL, RS-485 through an external transceiver

Shell
# float32 profile: total P (float)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 \
  -t 3:float -B -r 52 -c 1 <port>

# float32 profile: frequency, import kWh, export kWh (float)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 \
  -t 3:float -B -r 70 -c 3 <port>

Source: STD docs · Examples

07 / Platform

What stays the same as you grow

One bus

Two wires from one circuit to a whole panel.

One library

begin() detects the line and the channel count.

One contract

Published, versioned register maps.

One snapshot

The whole panel frozen at one instant over the bus.

Wiring diagram: an STD-U3I3 meter and three Basic modules share one four-wire I²C bus with an ESP32 hub. A tap from the bus goes to each module. The hub's header shows SDA on GPIO25, SCL on GPIO26, GND and 5 V VIN.
One bus, whatever you add: four wires (SDA, SCL, GND and power) run from your controller to every module.

08 / Growth

One installation that grows

  1. Modules on your controller.

    BASIC or STD on your own ESP32, Arduino or Raspberry Pi.

  2. BASIC and STD on one bus.

    STD also standalone over Modbus RTU.

  3. Your system reads the panel.

    Home Assistant, your SCADA, or your own code.

09 / RBgrid

See your electricity as money

Put an ESP32 hub next to your rbAmp modules and RBgrid shows what every measured circuit costs — right now, today and this month — on your own tariff zones. It runs on the hub: no account, no cloud, no subscription. If you run Home Assistant, it stays as it is: the hub plugs into it over MQTT. The hub firmware is source-available, free for personal and non-commercial use.

RBgrid Overview in the live demo: cost per hour, today and month to date, and where the money goes by circuit.
RBgrid Overview in the live demo. Illustrative demo data, not your readings.

10 / Support

Documented before it ships

Support portal