Solana OS 2.4.0 for the Solana BP26 badge (ESP32-C5)

Built Nov 16 2026 01:23:06 with ESP-IDF v6.1-dev-9359-g4109c8923a5, commit 13a918c.
The /stock page of the badge site flashes these images from the browser.
This folder flashes them from a terminal with esptool, offline.


FILES

  0x2000    bootloader.bin           22,448 bytes
  0x8000    partition-table.bin       3,072 bytes
  0xf000    ota_data_initial.bin      8,192 bytes
  0x20000   solana_os.bin         2,661,584 bytes

  flash_args    The same list in ESP-IDF's format: esptool ... write-flash "@flash_args"
  SHA256SUMS    Their checksums: shasum -a 256 -c SHA256SUMS (macOS),
                sha256sum -c SHA256SUMS (Linux)
  flash-hub.sh  Flashes every badge on a USB hub at once (MANY BADGES below)


FLASH

1. Install esptool 5 while you're online, one of:
     pipx install esptool
     brew install esptool
     python3 -m pip install esptool      (in a virtual environment)
   or a standalone build from https://github.com/espressif/esptool/releases
   An older esptool 4 flashes too: type esptool.py and write_flash
   (the erase commands below need esptool 5).

2. Plug the badge in over USB-C and turn it on. Close any serial monitor:
   only one program can hold the port. The badge's port (a CH340):
     macOS     /dev/cu.usbserial-... (ls /dev/cu.usbserial-*), or
               /dev/cu.wchusbserial... with WCH's CH34x driver installed
     Linux     /dev/ttyUSB0, or /dev/ttyCH341USB0 with WCH's driver
               (you may need to be in the dialout group)
     Windows   COM3 or similar (Device Manager, Ports)

3. In this folder, with PORT replaced by the badge's port:

esptool --chip esp32c5 -p PORT -b 460800 write-flash 0x2000 bootloader.bin 0x8000 partition-table.bin 0xf000 ota_data_initial.bin 0x20000 solana_os.bin

   It takes a minute or two. esptool checks each image after writing it,
   then restarts the badge into Solana OS. Wi-Fi, settings and the badge
   link stay. Keep 460800 baud: 921600 is unreliable on the CH340C.


ERASE (OPTIONAL, BEFORE STEP 3)

Erase settings: forget Wi-Fi, button calibration, theme, server address and
the badge's secret.

esptool --chip esp32c5 -p PORT erase-region 0x9000 0x6000

Erase all data: also wipe the internal storage, like a new badge.

esptool --chip esp32c5 -p PORT erase-region 0x9000 0x6000
esptool --chip esp32c5 -p PORT erase-region 0x11000 0x1000
esptool --chip esp32c5 -p PORT erase-region 0x820000 0x7e0000

The badge keeps its ID either way. Erasing drops its secret: if it's claimed,
release it on your badge page (/profile) first, or it can't sync ("This
badge is linked to an account") until you do. The microSD card isn't touched.


IF IT WON'T CONNECT

Hold BOOT on the back of the badge, press RST, then release BOOT, and run
the command again. If it fails while starting esptool's stub flasher,
add --no-stub before write-flash (or erase-region): the chip's own loader
is slower but writes the same.


MANY BADGES

On macOS or Linux, flash every badge plugged in through a hub at the same
time, one esptool per port, with:

  sh flash-hub.sh

It prints OK or FAIL per port and leaves each port's esptool output in
flash-<port>.log. With WCH's driver, macOS lists a badge twice
(cu.usbserial-110 and cu.wchusbserial110): it flashes it once, on the WCH
port. Run it again for the next set of badges.
