Web Serial requires Chrome or Edge on localhost. The badge port opens at 1,000,000 baud.
device disconnected
LOCAL BADGE WORKBENCH
Prepare display art, load BIO programs, talk to the badge console, and create Vault provisioning codes. Badge data stays in this browser and serial traffic goes only to the device you select.
DISPLAY CUSTOMIZATION
Screen image
Convert any image to the badge’s 128 × 128 black-and-white display format, then send it in 32 checked chunks.
LIVE PREVIEWNO IMAGE LOADED
BIO + SAO HACKING
I/O co-processor
Load a compiled BIO binary, route its four external I/O lines, set its clock, and exchange values through FIFO 3.
Maximum 3,840 bytes
TRANSFER PLAN
- 01Check device
bio ready - 02Configure I/O and clock
Set a clock or choose I/O - 03Upload and activate
Choose a binary first
Uploads are reversible: clear or replace the BIO program at any time. Failed chunks are retried up to three times.
FIFO 3 · HOST → BIO
Transmit a value
Writes a numeric value to the running BIO program. What it means depends on that program.
FIFO 3 · BIO → HOST
Receive values
Output varies by console build; full responses also appear in the serial console.
OFFICIAL STARTING POINTS
Build something odd
SAO power is 3.0 V and 100 mA total across both ports. Existing badge I²C devices use addresses 0x19 and 0x3C.
USB REPL
Serial console
Send stock console commands, inspect multiline responses, and use command history with the up and down arrow keys.
DC34 serial console ready. Connect a badge, then send a command.
Known stock verbs include echo, ver, test, image, and bio. Diagnostic subcommands depend on the installed firmware build.
VAULT PROVISIONING
QR tools
Create badge-readable clock, password, and TOTP payloads locally. The preview is generated in-browser without a network QR service.
Uses this laptop’s current time in RFC 3339 format. Refresh immediately before scanning.
The required current-time suffix is included automatically.
Clock payloads can be scanned immediately.
SCAN PREVIEWREADY
TOTP codes contain the account secret. This tool keeps it local, but treat screenshots and downloaded QR files as sensitive.
Firmware noteDetach the BaoSec module and open the Password or TOTP token screen before scanning. With the module attached, the normal badge screen routes camera scans to encrypted light-pattern exchange instead.
BUILT-IN LIGHTS
Direct LED control
Set color, brightness, flashing, start delay, and smooth RGB fades for both eyes and all eight ring LEDs independently. Animation runs on the badge after USB is disconnected.
10-PIXEL CHAIN PREVIEWSTEADY
0–1 · eyes2–9 · ringON-BADGE FX
The physical clockwise order of ring pixels is not documented. Use the identify preset once to map Ring 1–8 on this badge.
SEALED-MODE PIXEL ENGINEExperimental shared-pin takeover
The stock firmware runs these LEDs much dimmer for battery and power safety. High-output white scenes can draw substantial current.
Startup saving safely clears and rewrites the complete persistent BIO image, then reloads it. It takes about ten minutes at the badge’s drop-safe serial speed; an interrupted save falls back to the stock light pattern. Normal Apply remains runtime-only.
Installation replaces any existing BIO program, but does not flash firmware or read/write k0. Delay is a one-time start offset with 20 ms resolution; it staggers flash and RGB phases. Full scene transfers hold the LEDs off until the complete scene is ready; later single-pixel changes use an atomic four-word update. Rapid 3–30 Hz flashing can trigger photosensitive reactions.
LIGHT-GENE LAB
Phenotype simulator
Use the signed stock procedural renderer instead of direct pixels: explore its nine-byte phenotype and official badge-type ranges.
ANIMATED PREVIEWNORMALIZED BRIGHTNESS
SEALED-MODE BIO BRIDGE
Drive the stock built-in light renderer from these controls without flashing firmware or changing the saved light-exchange key.
First use replaces any existing BIO program. After reconnecting, use Bridge already installed only when this workbench or the direct repair session installed it. The bridge remains across reboot, while the forced phenotype is RAM-only. Restore clears the bridge and asks Vault to render the saved gene again. It never reads or writes k0.
CAPABILITY MAP
More than a badge
A practical map of the official badge projects and the parts this local workbench can operate.
Exchange light patterns
Start a receive on the target badge, reveal its nonce QR when prompted, scan that nonce with the donor, then scan the donor’s encrypted pattern back on the target.
Customize over USB
Upload a display image, load and clear BIO code, configure external I/O, exchange FIFO values, or use the raw serial console.
Become a security token
The detached BaoSec module can store passwords and TOTPs. Its current QR actions accept time sync, hostname-based password lookup, and standard otpauth TOTP enrollment payloads.
Build custom hardware
Two 3.0 V SAO ports expose power, I²C, and four BIO-routable I/O signals. Public SoC, console, hardware, and compiler sources make deeper experiments possible.
Firmware update reminderHold any button while resetting or power cycling, extract the three update files onto the USB drive, then press a button to commit. Linux users should sync or unmount first.Latest firmware ↗
ACTIVITY LOG
[ready] Choose a tool, then connect the badge when a serial action needs it.