VersaMCU/doc
Julian Appel d325297063 Add end-to-end USB flashing for the app firmware via UF2
Adds uf2conv.py (minimal, dependency-free .bin -> .uf2 converter
matching bootloader/inc/uf2format.h's block layout) and upload_uf2.py,
a PlatformIO upload hook for env:versapad_usb that finds the mounted
VERSABOOT volume and copies the converted firmware onto it.

env:versapad_usb previously used upload_protocol=sam-ba, the classic
Arduino/Atmel protocol -- the actual bootloader speaks UF2/mass
storage, not SAM-BA, so that upload path never worked. Switched to
upload_protocol=custom with the new hook, and cleaned the now-unused
SAM-BA-specific fields out of boards/versapad.json.

Verified end to end on real hardware: pio run -e versapad_usb
--target upload builds, converts, copies to the VERSABOOT drive, and
the bootloader jumps into the freshly written app on its own.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-05 21:35:19 +02:00
..
00_architecture.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
01_matrix.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
02_encoder.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
03_action_engine.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
04_macro_system.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
05_led_system.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
06_nvm_config.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
07_serial_protocol.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
08_development.md Harden firmware state and transfer handling 2026-07-24 09:49:21 +02:00
09_known_limitations.md Add end-to-end USB flashing for the app firmware via UF2 2026-08-05 21:35:19 +02:00
INDEX.md Update firmware documentation and agent guidance 2026-07-24 09:27:07 +02:00