2.4 KiB
Bootloader-Testflash -- Anleitung für Hardware-Zugriff
Der UF2-Bootloader (siehe README.md) ist fertig gebaut, aber noch nie auf echter Hardware gelaufen. Diese Anleitung ist für jemanden mit Atmel-ICE-Zugriff aufs VersaPad-v2-Board, um das einmal zu testen.
Wichtig zur Sicherheit: Dieser Flash schreibt nur 0x0000..0x1FFF
(8 KiB). Die App-Firmware liegt ab 0x2000 und bleibt unangetastet. Falls
etwas schiefgeht, ist das jederzeit per SWD neu beschreibbar, das Board kann
dabei nicht dauerhaft "gebrickt" werden, solange der Atmel-ICE-Zugriff
funktioniert.
Voraussetzungen
- Board per Atmel-ICE/SWD angeschlossen, genau wie beim normalen
App-Firmware-Flashen (
pio run -e versapad --target uploadindoc/08_development.md) - PlatformIO Core installiert. Falls nicht:
pip install -U platformio
1. Repo auf diesem Branch auschecken
git clone https://git.jappel.io/jappel/VersaMCU.git
cd VersaMCU
git checkout feature/usb-bootloader
2. Bootloader bauen und flashen
cd bootloader
pio run -e versapad_bootloader --target upload
Der erste Aufruf lädt automatisch den ARM-Toolchain und OpenOCD herunter (einmalig, braucht Internet). Der Build sollte ohne Fehler durchlaufen (erwartete Größe: ~7,3 von 8 KB Flash).
3. Prüfen, ob der Bootloader läuft
Nach dem Flash: Board kurz vom USB trennen und wieder anstecken, dann Reset-Taste zweimal kurz hintereinander drücken (Doppel-Tap, wie bei Arduino-Zero-artigen Boards üblich).
Erwartung: Das Board sollte sich als USB-Massenspeicher-Laufwerk namens
VERSABOOT melden (in Windows z. B. im Explorer als neues Laufwerk).
4. Ergebnis zurückmelden
Bitte notieren und zurückgeben:
- Ist der Flash-Befehl ohne Fehler durchgelaufen? (ggf. komplette Fehlermeldung kopieren)
- Erscheint nach dem Doppel-Tap-Reset ein Laufwerk
VERSABOOT? - Falls ja: was steht in der Datei
INFO_UF2.TXTauf dem Laufwerk? - Falls nein: reagiert das Board überhaupt noch normal als App-Firmware (Tasten/LEDs), wenn man es normal per USB ansteckt ohne Doppel-Tap?
- Alles, was ungewöhnlich aussieht (USB-Gerät mit falschem Namen, Windows fragt nach Treiber, Laufwerk lässt sich nicht öffnen, etc.)
Noch NICHT testen: Firmware tatsächlich über das VERSABOOT-Laufwerk
flashen. Der Firmware-Build erzeugt noch keine .uf2-Datei (nur .bin
für den bisherigen SWD-Weg), das ist der nächste Schritt, nachdem der
Bootloader selbst bestätigt läuft.