A unified flasher for LAB5 firmware, dedicated ESP devices, and companion app packages.
The repository also contains a native ARM64 application for M5Stack Cardputer Zero. See
CardputerZero/README.md for its APPLaunch package, USB Host workflow,
managed firmware cache, keyboard controls, ESP compatibility checks, and Flipper Zero RPC backend.
The source firmware repositories remain the source of truth. This project keeps:
- a central target registry in
registry/firmware.json, - a local firmware cache in
firmware/, - a shared sync and flashing engine,
- a static web flasher in
web/.
Before every CLI flash, the tool checks GitHub by default:
- finds the latest commit for the firmware directory,
- reads the file list from the source repository,
- compares GitHub blob SHA values with the local cache,
- downloads only missing or changed files,
- runs
esptoolafter the cache is up to date.
If the update check fails, flashing stops unless you explicitly use --allow-stale
to flash from the local cache.
python ultimate.py list
python ultimate.py sync --dry-run
python ultimate.py sync projectzero-c5
python ultimate.py flash projectzero-c5 --port /dev/ttyACM0The first ultimate.py run creates a local .venv and installs esptool and
pyserial.
The web UI lives in web/. Generate web assets from the current firmware cache:
python ultimate.py export-web --sync
python -m http.server 8088 --directory webThen open:
http://localhost:8088/
The page loads web/generated/targets.json, sets the selected firmware
manifest, and uses esp-web-install-button for the browser flashing flow. The
Detect device button uses WebSerial to read USB VID/PID and tries to match a
target using web.usb rules from registry/firmware.json.
Current web export includes:
projectzero-c5cardputer-advtab5flipper-lightas a downloadable.fappackagemonsterrf/ JanosRF from elpadrino26 with its original source and confirmed flash map
ESP Web Tools handles chip-family matching during installation. Exact product
matching, such as CoreS3 versus another ESP32-S3 board, needs web.usb rules or
a deeper future fingerprint step through esptool-js.
List targets:
python ultimate.py list --include-disabledSync all enabled targets:
python ultimate.py syncFlash with automatic new-port detection:
python ultimate.py flash cardputer-advFlash with erase and serial monitor:
python ultimate.py flash projectzero-c5 --erase --monitorFlash without optional entries:
python ultimate.py flash projectzero-c5 --skip-optionalShow local cache status:
python ultimate.py statusPublic repositories work without configuration, but anonymous GitHub API limits
are low. For reliable automation, set a token with contents:read access:
export GITHUB_TOKEN=ghp_...
python ultimate.py syncThe same token is required for private repositories:
export GITHUB_TOKEN=ghp_...
python ultimate.py sync cores3 --include-disabledIf the cache is already current and GitHub temporarily rate-limits requests, you can export the web UI from cached assets:
python ultimate.py export-web --sync --allow-stalecores3 and mate are currently disabled templates because their source
repositories are private or not ready yet. Enable them after file names and
offsets are confirmed.
Add a target to registry/firmware.json:
{
"enabled": true,
"name": "Device Name",
"chip": "esp32s3",
"baud": 460800,
"source": {
"type": "github",
"repo": "C5Lab/repo",
"branch": "main",
"path": "path/to/binaries"
},
"flash": [
{ "offset": "0x0", "file": "bootloader.bin" },
{ "offset": "0x8000", "file": "partition-table.bin" },
{ "offset": "0x10000", "file": "firmware.bin" }
]
}Use extras for files that should be cached but not flashed.
sync.pyexists as a compatibility shortcut.- The main launcher is
python ultimate.py .... firmware/andweb/generated/are generated cache/output directories and are intentionally ignored by git.