insight-profiler

High-precision Open Source Power Profiler & Programmable Power Supply for IoT Development.

→ Full feature plan · Hardware block diagram

Planned Architecture

graph TD
    USBC[USB-C PD Input] --> PD[PD Negotiation\n5–20 V]
    PD --> BUCK[Buck-Boost\n1.8–5.0 V programmable]
    BUCK --> SW[Output Switch\nGPIO-controlled]
    SW --> MEAS[Auto-Ranging Shunts\n3 nA – 3 A]
    MEAS --> DUT[Device Under Test]
    MEAS --> INA228[INA228\n20-bit Power Monitor]
    INA228 -->|I2C| ESP[ESP32-S3]
    ESP -->|USB CDC| SDK[Python SDK / CLI]
    ESP -->|Wi-Fi| WEB[Web Dashboard / MCP]

Loading

See hardware/block-diagram.md for the full diagram with current ranges and signal flow.

Current Implementation (v0.1)

graph TD
    USBC[USB-C Input] -->|VBUS| DUT[Device Under Test]
    DUT --> SHUNT[Shunt 10 mΩ]
    SHUNT --> INA228[INA228 20-bit]
    INA228 -->|I2C 400 kHz| ESP[ESP32-S3]
    ESP -->|USB CDC| HOST[Python SDK / WebUSB JS SDK]

Loading

Stack

Layer	Technology
Firmware	ESP-IDF (C++), TinyUSB CDC
Power sensor	TI INA228 — voltage, current, power
Host SDK	Python (pyserial), TypeScript/WebUSB
AI integration	MCP server (planned)

Data Stream

The device streams 16-byte binary frames over USB CDC at ~1 kHz:

[0:4]   uint32  timestamp_us
[4:8]   float32 bus_voltage_v
[8:12]  float32 current_ma
[12:16] float32 power_mw

Quick Start

Python SDK

from insight_profiler import InsightClient

client = InsightClient()
client.on_sample = lambda s: print(f"{s.current_ma:.3f} mA  {s.power_mw:.1f} mW")
client.connect()

Firmware

cd firmware
idf.py build flash monitor

Repository Structure

firmware/          ESP32-S3 firmware (ESP-IDF)
  components/
    ina228/        INA228 I2C driver
  main/            Application entry point
sdk-python/        Python host SDK
sdk-js/            TypeScript/WebUSB SDK
hardware/          Block diagram, schematics, PCB layout, BOM
docs/              Feature specs and design docs