Get started

From a blank ESP32 board to your first live measurement. You flash the firmware once over USB — the ESP32-WROVER and the ESP32-S3 take different images — and after that the hub can be updated over the air - you upload a new image from the web app.

What you need

  • An ESP32 hub with PSRAM and 16 MB flash: an ESP32-WROVER, or an ESP32-S3 on the N16R8 module. Both sizes matter, and on a WROVER 16 MB with PSRAM is the less common variant — check a board you already own before you count on it.
  • At least one rbAmp measurement module. Get the Basic AC wattmeter module
  • A USB cable to the hub for the one-time flash.
  • Your Wi-Fi network name and password.
  • Measuring somewhere the cable will not reach — a garage sub-panel, a workshop — takes a second ESP32 as a wireless node, with its own modules. Set the hub up first; nodes pair from the app afterwards.

Pick your route

  • I just want it to work. Flash the hub, run the setup wizard, read your first costs. Quick start

  • I run Home Assistant. Your setup stays as it is; the hub publishes every point over MQTT. Home Assistant recipes

  • I want to build it myself. Full firmware source, an ESP-IDF build and the APIs. Build and flash

How it goes together

Every rbAmp module talks to the ESP32 board over the same four wires, on one I²C bus — the eighth connects exactly like the first. Wiring and pinout

Wiring of an STD-U3I3 and Basic UI1, UI2 and UI3 modules to the ESP32 hub over one I²C bus: four wires to every module, with module VIN on the board's 5V/VIN pin, GND on GND, SDA on GPIO25 and SCL on GPIO26.
Four modules and the hub on one bus. With four or more modules, the pull-ups are cut on all but one.

For any work inside an electrical panel, call a qualified electrician. The rbAmp modules clip onto existing wiring. rbAmp safety notes