Guides
Run and add bench programs
Build a bench program, flash it onto a board and watch its output, and add a new one. What each program does is in the reference.
Build
With nothing installed but a container runtime, from the repo’s top folder:
scripts/bench build # every program
scripts/bench list # what's here
The same pinned toolchain as the firmware (espressif32 6.5.0, Arduino core 2.0.14), in the same container image.
Flash and watch
A container can’t reach the USB port, so this needs PlatformIO on this machine,
as for flashing the firmware, installed as Install says
for your OS. Plug the board in,
then from bench/:
pio run -e ps-pwm -t upload # build + flash
pio device monitor # its output, 115200 baud; Ctrl-C to stop
The firmware README’s notes on a missing port and an upload stuck at “Connecting…” hold here too.
Add one
- A folder under
src/with amain.cpp, its header comment saying what it tests, how it’s wired, and what it prints. - An
[env:<name>]inplatformio.ini:extends = benchandbuild_src_filter = +<name/>, and its ownlib_depsat exact versions if it needs a library. - A row in the table in docs/reference/bench.md.