Black Cherry logo

Initializing Systems

Firmware Updates

Cuelist firmware updates are delivered through the Cuelist Flasher — a browser-based tool that requires no software installation.

Requirements

  • Chrome 89+ or Edge 89+ (Web Serial API support required)
  • USB-C cable
  • Internet connection (for automatic firmware download)

Automatic Update (Recommended)

Firmware packages will be published to the project's GitHub Releases. The web flasher/editor fetches available releases and presents a dropdown of versions to choose from.

  1. Put the pedal in Edit mode or connect via USB-C
  2. Open the Cuelist Flasher at /tools/flasher
  3. Click Connect Device (if using Web Serial) or use the editor UI to select a version
  4. Choose the release/version from the dropdown and click Flash Firmware
  5. Wait for the UPDATE COMPLETE message — this takes approximately 30–60 seconds
CAUTION

Do not disconnect the pedal or close the browser tab during a firmware update. The pedal's LED will flash rapidly during this process.

Manual Update

If automatic download fails (often due to CORS or network restrictions), you can download the release asset manually from the project's GitHub Releases and select it in the flasher.

  1. Download the .bin file from GitHub releases
  2. Open the Cuelist Flasher
  3. Click Select .BIN File and choose your downloaded file
  4. Click Flash Firmware

Update Protocol

The Cuelist uses a chunked binary update protocol over USB Serial:

  1. Flasher sends GET_VER — pedal responds with current version
  2. Flasher sends TRIGGER_UPDATE_MODE — pedal enters bootloader
  3. Pedal confirms READY_FOR_CHUNKS
  4. Flasher sends firmware in 1024-byte chunks, pedal acknowledges each with CH_OK
  5. Pedal confirms UPDATE_DONE

Troubleshooting

Device not appearing in picker: Ensure you're using Chrome or Edge. Firefox and Safari do not support Web Serial.

Flash fails mid-way: The pedal has a built-in recovery mode. Disconnect, hold the DOWN footswitch while reconnecting USB, and try again.

"CORS" or download error: Use the manual download method described above.