diff --git a/bootloader/TESTING.md b/bootloader/TESTING.md new file mode 100644 index 0000000..b2bb167 --- /dev/null +++ b/bootloader/TESTING.md @@ -0,0 +1,67 @@ +# Bootloader-Testflash -- Anleitung für Hardware-Zugriff + +Der UF2-Bootloader (siehe [README.md](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 upload` in + `doc/08_development.md`) +- PlatformIO Core installiert. Falls nicht: + ```bash + pip install -U platformio + ``` + +## 1. Repo auf diesem Branch auschecken + +```bash +git clone https://git.jappel.io/jappel/VersaMCU.git +cd VersaMCU +git checkout feature/usb-bootloader +``` + +## 2. Bootloader bauen und flashen + +```bash +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.TXT` auf 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.