# 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.