CDC Badge OS

Web Firmware Flasher

Checking latest version...
CDC Badge v1.0 / v1.1

This flasher targets the TROPIC01-enhanced CDC Badge v1.0 / v1.1 (ESP32-S3 + TROPIC01 secure element). Do not flash it on any other device.

Hardware details on GitHub

1. Put the badge into bootloader mode

Software (recommended, if already running CDC OS)

  1. Open Tools → Expert → Bootloader on the badge UI (newer firmware versions only),
  2. or send AUTH <pin> followed by BOOTLOADER over the serial console.

Hardware (always works)

  1. Press and hold FLASH.
  2. Press RESET briefly while still holding FLASH.
  3. Release FLASH.
i In bootloader mode the e-paper display will not react and the device looks turned off. That is expected.

2. Flash

Firmware Update
Replaces only the firmware. Installed plugins, language overlay, settings and PINs stay intact. Use this for normal version upgrades.
! Web Serial is not supported by this browser. Use Chrome or Edge (desktop).
! Serial access was denied. Grant permission and try again.
Factory Setup
Wipes all installed plugins and re-installs the language overlay. Use this on a fresh badge or when a Firmware Update leaves things broken.
! Web Serial is not supported by this browser. Use Chrome or Edge (desktop).
i Firmware Update shows an "Erase device" checkbox — it is unchecked by default, so a normal update keeps your plugins, settings and PINs without doing anything. Only check it to wipe the device; note that checking it does not re-install the language overlay — use Factory Setup for a clean device instead.
! Pre-1.0 software, breaking changes are expected. If a Firmware Update boots into a corrupted state, or modules misbehave after an upgrade, run Factory Setup to wipe the plugin partition and re-install the language overlay.
i The first boot after Factory Setup takes noticeably longer (typically 10-20 s). The firmware wipes every used TROPIC01 secure-element slot and re-initialises NVS — do not unplug while the display is still updating.

3. Install plugins (optional)

After flashing, reset the badge and continue with the CDC Badge Plugin Installer to add WebAssembly plugins (Home Assistant, GPIO demos, hello-world, etc.) via WebSerial.

Plugins live in a separate 2 MB FAT-FS partition and are sandboxed via the WAMR runtime — no firmware rebuild required to add or remove them.

Requirements