rbAmp
EN
Shop

BASIC measurement modules

Per-circuit power in your ESP32 / Arduino project, without a board per circuit

One metering board and one serial port per circuit turns into a nest of wires. One BASIC module watches up to seven circuits on a two-wire bus, and several modules share the same bus.

BASIC SCT-UI module with an SCT-013 clamp
Bus
I²C, about 16 modules per bus
Controller
Your ESP32, Arduino or Pi
Sensors
Your SCT-013 or a calibrated clamp
Supply
5 V

01 / Series

Two ways to measure. One open platform.

SCT series · flexible and affordable

Use your own SCT-013 clamp and select its rated current in software. The module is calibrated for the SCT-013 family; the accuracy you get depends on the individual sensor (see

the table

).

Choose SCT if:

  • you already own SCT-013 sensors
  • you want to reuse or mix sensors of different ratings
  • you want the lowest-cost way to measure a circuit

CT series · calibrated as a pair

A through-core sensor ships with every channel and is calibrated together with it at the factory; the sensor is labelled with its channel. Nothing to configure, no sensor-to-sensor variation.

Choose CT if:

  • you want a sensor matched to the module out of the box
  • you want no sensor-to-sensor variation
  • you prefer a fixed installation with a plug-in sensor cable

Both series use the same register map, the same libraries and the same API. Choosing one never locks you out of the other — they share one bus.

02 / Which model

Which model

SCT series

For your own SCT-013 sensor: 3.5 mm jack, clip-on without power-down. Sensor not included — use your SCT-013 (5…100 A).

CT series

A clamp on every channel, calibrated with the channel at the factory and marked with its number: nothing to select or configure.

03 / Models

Available models — SCT series

04 / CT series

CT series

Notify me

CT Wattmeter — CT-UI1 / UI2 / UI3 / UI5 / UI7

One voltage input and 1/2/3/5/7 channels. Clamp ratings 1, 5, 10, 20, 30, 50 or 100 A, the same on all channels of a module; window 6 mm (1–10 A), 10 mm (20–50 A), 16 mm (100 A); 1 m cable with a plug-in connector. No price until release · Sensor included, calibrated with its channel.

05 / Accuracy

Accuracy — module and sensor as one system

Accuracy depends on the complete measuring system. A reading is the module plus the sensor — and there is a floor below which a current is seen but not measured accurately.

  • Module + your SCT-013. The module is factory-calibrated for the SCT-013 family; you select the sensor's rated current in software. Overall accuracy depends on the individual sensor and its rating — the table below gives the floor and the class for each rating.
  • Module + matched CT (CT series, in validation). The actual sensor is calibrated with its channel at the factory, which removes sensor-to-sensor variation. Its figures are published when it ships.

BASIC modules (SCT-UI series) with your own SCT-013 sensor — resistive load, measured at 50 Hz. Modules with a factory-paired CT sensor, and STD modules, are specified separately — this table does not apply to them.

CharacteristicSCT-013-005SCT-013-010SCT-013-020SCT-013-030SCT-013-050SCT-013-060SCT-013-100
Detectable floor (the reading with no load)~3 mA6–9 mA~10 mA~13 mA~25 mA~30 mA~60 mA
Readable floor (error ≤ 10 %; 0.5 % of rating)25 mA50 mA0.10 A0.15 A0.25 A0.30 A0.50 A
Class near the floor, UI1 / UI2 / UI3 (±1 % of the average, from ~0.7 % of rating)from 35 mAfrom 70 mAfrom 0.14 Afrom 0.21 Afrom 0.35 Afrom 0.42 Afrom 0.70 A
Class near the floor, UI5 / UI7 (±0.5 %, from 2 % of rating)from 0.10 Afrom 0.20 Afrom 0.40 Afrom 0.60 Afrom 1.0 Afrom 1.2 Afrom 2.0 A
Class in the working range (5–100 % of rating, of the average)≤ 0.5 %0.16–0.35 %≤ 0.5 %0.53 %≤ 0.5 %≤ 0.5 %0.47 %
Tolerance of the sensor unit (added on top of the class)≤ 0.8 %0.5–1.0 %0.8 %1.2 %0.7 %0.3–0.4 %0.45 %
Step of one instantaneous value4.1 mA8.1 mA16 mA24 mA41 mA49 mA83 mA
Top of the range (clipping, sine wave)~6.0 A11.9 A~24 A35 A~60 A~72 A~117 A
  • Step of one instantaneous value is about 0.08 % of the rating. The RMS reading is computed over the whole 100 ms window and returned as a fractional number, so it is finer than the step: for example, with the 5 A sensor the no-load reading is ~3 mA although the step is 4.1 mA. The real resolution is limited by noise, not by the step.
  • Near the floor: a single reading (one 100 ms window) at 1 % of the rating is noisy by 0.6–2 %. The average over a period and the energy stay within the class shown in the table.
  • UI5 / UI7 below 2 % of the rating: the spread between modules is up to ±5 %, so for these modules the class near the floor starts at 2 % of the rating.
  • "Average" = the average of several 100 ms measurement windows, as used for energy and average power.
  • Clipping is a property of the SCT-013 sensor (its output level at rated current); stay below the rating for reliable readings.
  • Changing the sensor model is writing the model code to the module — no recalibration step.
  • Real SCT-013 sensors have an actual error of about 1 %, and it can grow with time or with temperature. If you need good measurement quality at small currents, choose a sensor with a smaller rating.

Source: Docs › BASIC › Overview › Current-channel accuracy

06 / Rating

Which rating should I pick? Let’s walk through a 60 A clamp.

A × 230 V = W (at 120 V: A × 120 V)

Sizing the clamp. Say you want to see the whole house. Your main breaker is 40 A, so you reach for an SCT-013-060 — the next rating above the breaker, with room to spare: the clamp's range tops out at about 72 A, so a 40 A main never gets near the top.

What you will see. Now look down the 60 A column. Anything from about 0.3 A upwards is a reading you can use — roughly 70 W at 230 V. From about 0.42 A (around 100 W) the module holds ±1 % of the average on UI1, UI2 and UI3. From 3 A (5 % of the rating, about 700 W) up to the full 60 A it reads within half a percent, plus the sensor's own 0.3–0.4 %. A 2 kW boiler draws about 8.7 A — comfortably inside. A 7 kW charger at 30 A — inside. The oven, the heat pump, the whole evening peak — all inside. For a house input, this clamp is the right tool.

What you will not see. Below 0.3 A the module still sees current — the detectable floor is about 30 mA — but the reading is noisy and you should not trust the number. A phone charger drawing 10 W is about 43 mA: you will see that something is on, you will not get a figure you can rely on. The house's night baseline — the router, the TV on standby, the fridge electronics — might be 40 W, or 0.17 A. On the 60 A clamp that is above detectable, below readable: the graph shows a floor, the number is a guess. If "what draws power when everything is off" is the question you want answered, a 60 A clamp on the input will not answer it.

What does. A smaller rating, closer to the load. The same table says a 5 A clamp reads usable values from 25 mA — about 6 W — and holds its class from 35 mA, about 8 W. Put it on the circuit that feeds the living room and the night baseline becomes a number. On UI5 and UI7 modules the near-floor class starts higher (from 2 % of the rating), so for small loads prefer UI1–UI3 or keep the rating small.

The rule is simpler than the table looks

Pick the smallest rating that still clears the circuit's maximum current. House input on a 40 A main → 60 A. A 63 A main → 100 A. A floor or sub-panel on a 25 A breaker → 30 A. A boiler, an oven, a charger on a 16–32 A breaker → 20–50 A. A single appliance, a lamp circuit, the "what is on at night" question → 5 or 10 A.

The floor scales with the rating: a 60 A clamp holds its class from about 100 W, a 5 A clamp from about 8 W.

You can mix: one 60 A clamp on the input for the total, 5–20 A clamps on the branches you care about — all on the same bus, each channel with its own rating set in software.

And if the point is microamperes — standby, vampires, export that has to be counted — that is what STD is built for.

One more thing the table says quietly: these are SCT-013 figures. A real clamp's own error is about 1 %, and it can drift with age and temperature. That is why the CT series exists — each sensor is calibrated with the channel it ships with, so sensor-to-sensor variation is out of the question.

07 / Clamp

Choosing and fitting a clamp

Already have SCT-013 sensors?

  1. Keep your sensor — any of the seven SCT-013 ratings from 5 A to 100 A.
  2. Plug it into the module's 3.5 mm input.
  3. Select the rating in software: SCT-013-005, -010, -020, -030, -050, -060 or -100 — a one-line setting in ESPHome or one call in the library. This selects the family calibration for that rating; it is not an individual calibration of your sensor.

CT series: don't choose a sensor — get a calibrated pair. Pick the number of channels and the rating; the sensors arrive labelled per channel, already calibrated with the module. Connect each sensor to the channel it is labelled for — the calibration belongs to that pair.

One conductor. The clamp goes around ONE conductor — a single live wire, or a single neutral. Around a two-wire cord the two currents cancel and the reading stays at zero.

Sensors · Clamp installation

Right: the clamp closed around one conductor.
Wrong: the clamp around a two-wire cord reads zero.

08 / Data

What you get from a module

Ready physical units every measurement window (~100 ms on current firmware), per channel. No signal processing on your side.

Full register map
U_rmsRMS voltage · V
U_peakpeak voltage · V
In_rmsRMS current, per channel · A
In_peakpeak current, per channel · A
Pn_realactive power, per channel, signed (+ consumption, − export) · W
Qn_reacreactive power, per channel · var (≥ 0)
PFnpower factor · −1…+1
AC_FREQline frequency · Hz (50 or 60, detected)
PERIOD_AVG_P_Waverage power over a period · W
PERIOD_MAX_P_Wpeak power over a period · W

UI5 and UI7 read channels 3 and up through the channel access window; the libraries handle it. Energy (Wh) is integrated by your controller from period snapshots — the libraries do it for you. The module does not keep an energy counter.

09 / Start

From wire to data in 3 steps

  1. 1 · Connect.

    VCC, GND, SDA, SCL — a standard I²C slave — and clip the sensor.

  2. 2 · Add the library.

    ESPHome component, Arduino library, ESP-IDF component or pip install rbamp

  3. 3 · Read.

    Volts, amperes, watts and energy in your dashboard.

10 / Why a bus

Why a module on a bus, not a UART meter

Your UART stays free.

Most controllers have one UART, usually taken by the console. rbAmp talks I²C: many modules on two shared pins.

Physical units, no DSP on your side.

The module does the sampling and true-RMS maths and returns float values. No interrupts, no sine-catching, no filter code.

Periods close atomically.

One command closes and opens a measurement period with no read-reset gap — no dropped or double-counted samples at the boundary. Energy per minute, 15 minutes, hour, or per event (a contactor, a charging session).

Open API, open libraries.

Documented register and command map; MIT libraries for ESPHome, Arduino, ESP-IDF and Python. Any stack, or your own code.

Galvanically isolated.

An isolation barrier separates the measurement side (clamp, voltage input) from the side you wire (I²C). The module's GND is not connected to phase or neutral, so connecting it to a 5 V controller is safe.

Safety

3.3 V logic, 5 V-tolerant.

SDA, SCL and the data-ready pin connect straight to ESP32 or Raspberry Pi GPIO; power the module at 5 V (4.5–5.5 V).

11 / Periods

Energy that matches your tariff intervals

BASIC reports period snapshots; the energy total lives on your controller, where the library integrates and persists it (ESPHome: in NVS, survives a reboot). The module itself keeps no counter — that is what

STD

adds.

CMD_LATCH_PERIODOne command freezes the period's average and peak power; the next period opens in the same moment.
General CallEnable it per module and every module on the bus freezes at the same instant — a whole-house balance from one moment. Masters detect modules that opted out and snapshot them one by one.
master clockOne clock — your controller's — for all modules removes per-module drift.

Live power is signed, but period energy on BASIC is consumption only. For import and export counters kept on the device, see

STD

.

Source: Docs › BASIC › Period metering

12 / One bus

One bus, a whole panel

Wires and addressTwo wires. Address 0x50 by default, changeable to 0x08…0x77 with a two-phase commit; identify modules by their ID, not by address.
Speed50 kHz on ESP32 / ESP8266 hosts (a driver limitation), 100 kHz on other hosts; 400 kHz is not recommended.
Supply and logicSupply 5 V (4.5–5.5 V); logic 3.3 V, 5 V-tolerant; optional data-ready pin, one ~10 µs pulse per window.
Modules per busUp to about 16 modules on one bus — the limit is bus capacitance (≤ 400 pF at 100 kHz), not the address range.
Bus lengthWe recommend up to 0.15 m between the module and the controller: keep the controller next to the module. Longer runs (twisted pair, an I²C buffer, a differential bus) are your own design. In a cabinet, shield the cable.

13 / Safety

Where the isolation boundary is

The side you wire to your controller — VCC, GND and the I²C bus to an ESP32, Arduino or Raspberry Pi — is low-voltage and galvanically isolated from the measurement side; the module's GND is not connected to phase or neutral. The measurement side connects to mains: current through a clamp around one insulated conductor, voltage (UI models) through the L and N terminals, with a fuse in L. For work inside an electrical panel, call a qualified electrician. Do not open the module's enclosure.

Safety · Source: Docs › BASIC › Hardware connection

14 / BASIC vs STD

Where BASIC ends and STD begins

BASIC

Watch circuits and appliances; consumption only; energy on your controller.

STD

Counters on the device, import and export, Modbus RTU as a standalone meter, microampere resolution — on the same bus. Measuring the input or an inverter? You need STD.

RBgrid hub

A pre-flashed ESP32 and a shield with connectors for the modules. Reads BASIC modules too.

15 / Questions

FAQ

Is the sensor included?

SCT series: no — use your SCT-013. CT series: yes, calibrated with its channel.

Is my own SCT-013 individually calibrated?

No. The module carries the calibration for the SCT-013 family; you select the rating. For a sensor calibrated with its channel, take the CT series.

Which SCT-013 rating?

The smallest rating above your maximum current; the guide under the accuracy table walks through it.

5 V or 3.3 V?

Power the module at 5 V (4.5–5.5 V). The bus runs on 3.3 V logic and is 5 V-tolerant, so ESP32, Raspberry Pi and 5 V Arduino boards connect directly.

How many modules on one bus?

Up to about 16, limited by bus capacitance; give each module its own address before connecting them in parallel.

Does BASIC measure export?

Live power is signed; period energy on BASIC is consumption only. For export counters, take STD.

Do I need rbgrid?

No. Use ESPHome, your own code or any I²C master; rbgrid is one ready master firmware.

Ready to measure?

Pick the channel count and the clamp rating; the module does the measuring and your controller just reads it.