During upload: Keep the badge still and on the same screen. Moving it or pressing badge buttons can interrupt the transfer. The first upload takes about 35 seconds.
Web: use desktop Chrome or Edge. Android: use a USB-C OTG data cable.
device disconnected
DC34 BADGE WORKBENCH
Choose a tool. Make it yours.
Connect when needed. Files stay on this device.
ANDROID USB HOST
Connect with a USB-C OTG data cable. Keep the phone awake during transfers.
DISPLAY CUSTOMIZATION
Screen image
Choose an image, preview it, then send it to the badge.
LIVE PREVIEWNO IMAGE LOADED
BIO + SAO
Load a small badge program
Choose a .bin file, set its SAO pins and clock, then load it.
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
You can clear or replace the BIO program later. A bad reply stops the transfer.
FIFO 3 · HOST → BIO
Transmit a value
Sends a number to the running BIO program.
FIFO 3 · BIO → HOST
Receive values
Replies also appear in the Serial console.
OFFICIAL STARTING POINTS
Examples and source
SAO limit: 3.0 V and 100 mA total. Badge I²C uses 0x19 and 0x3C.
BADGE ACTIVITY
Serial console
Send a command and read the reply. Use ↑/↓ for command history.
DC34 serial console ready. Connect a badge, then send a command.
Try echo, ver xous, test, image, or bio.
BADGE QR CODES
QR tools
Create clock, password, TOTP, or custom QR codes. Everything stays on this device.
Uses this device’s current time. Refresh before scanning.
The current time is added automatically.
Scan the code while it is current.
SCAN PREVIEWREADY
TOTP QR codes contain your secret. Do not share screenshots or downloads.
Before scanningRemove BaoSec and open Password or TOTP on the badge.
BUILT-IN LIGHTS
Direct LED control
Choose a pattern, tune it, then apply it to the eyes and ring LEDs.
BADGE LED PREVIEWSTEADY
0–1 · eyes2–9 · ringON-BADGE FX
Use Identify pixels once to label Ring 1–8.
COLORKERNEL CONTROLLERRuns direct colors and patterns
PATTERNSPreview now · Apply to badge
WLED catalog ↗
Choose a pattern. The preview updates now; Apply sends it to the badge.
Twenty-four badge-ready patterns are included.
The stock firmware runs these LEDs much dimmer for battery and power safety. High-output white scenes can draw substantial current.
Startup save takes about six minutes.
Keep the badge connected. After reboot, wait two seconds. To edit later, check ColorKernel installed.
Before you install
- ColorKernel and BadgeMu share one BIO slot.
- Installing replaces the current BIO program.
- Bright scenes use more power.
- Rapid flashing can trigger photosensitive reactions.
SAVED LIGHT PATTERN
Light pattern simulator
Preview and change the badge’s nine saved light settings.
ANIMATED PREVIEWNORMALIZED BRIGHTNESS
BADGEMU LIGHT BRIDGE
Control the badge’s built-in light pattern from these sliders.
Choose the installed controller
Installing replaces the current BIO program. After reconnecting, check BadgeMu installed. Restore returns to the saved badge pattern.
BADGE GUIDE
What the badge can do
Quick links to the main features and official tools.
Exchange light patterns
Use the badges’ QR exchange flow to share encrypted patterns.
Customize over USB
Change the screen, BIO program, console, QR codes, and lights.
Use BaoSec
Store passwords and TOTP accounts on the detachable module.
Build custom hardware
Use the two SAO ports, I²C, and four BIO I/O signals.
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. Connect when asked.