Add hardware bring-up instructions for bootloader testflash

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.