VersaMCU/bootloader/TESTING.md

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 upload in doc/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.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.