Fold bootloader documentation into the main doc/ index

Adds doc/10_usb_bootloader.md as the primary reference for the UF2
bootloader (memory layout, key-based boot entry, build/flash steps,
hardware test findings, known limitations), following the existing
numbered-doc convention. Updates doc/INDEX.md, doc/09_known_limitations.md
(bootloader is no longer "not supported", just scoped), and
doc/08_development.md accordingly.

Removes bootloader/TESTING.md (its findings now live in
doc/10_usb_bootloader.md) and trims bootloader/README.md down to what
belongs with that subproject specifically: upstream attribution/license
and local build/flash commands, plus the OpenOCD manual-flashing
warning since that's implementation-specific detail that would clutter
the higher-level doc.

Updates the top-level README.md (feature table, hardware table,
quickstart, project tree, doc links) to reflect USB flashing as a
supported path alongside SWD.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

bootloader/README.md

@@ -2,18 +2,11 @@
 
 USB-Bootloader für das VersaPad-v2-Makropad. Wird per Atmel-ICE/SWD einmalig
 auf den ATSAMD21G17D geflasht und belegt `0x0000..0x1FFF` (8 KiB). Danach
-lässt sich die App-Firmware ohne SWD über USB aktualisieren: Bootloader-Modus
-aktivieren, Board erscheint als USB-Laufwerk `VERSABOOT`, `.uf2`-Datei drauf
-kopieren.
+lässt sich die App-Firmware ohne SWD über USB aktualisieren.
 
-Der komplette Weg — Bootloader-Einstieg, `.uf2`-Erzeugung, Kopieren aufs
-Laufwerk, automatischer Rücksprung in die neu geschriebene App — ist auf
-echter Hardware verifiziert, siehe [Hardwaretest](#hardwaretest-2026-08-05).
-
-Diese Platine hat keinen dedizierten Reset-/Boot-Taster. Bootloader-Modus
-aktivieren heißt hier: unterste rechte Cherry-MX-Taste (key_id 24) beim
-Einstecken/Reset gedrückt halten. Siehe
-[Hardware-Bootloader-Einstieg](#hardware-bootloader-einstieg-ohne-reset-taster).
+Speicherlayout, Bootloader-Aktivierung, Bedienung und Hardwaretest-Ergebnisse
+stehen in [`../doc/10_usb_bootloader.md`](../doc/10_usb_bootloader.md). Diese
+Datei beschreibt nur das Bootloader-Unterprojekt selbst.
 
 ## Herkunft
 
@@ -52,42 +45,6 @@ da nur `0x0000..0x1FFF` beschrieben wird)
 pio run -e versapad_bootloader --target upload
 ```
 
-## Hardware-Bootloader-Einstieg ohne Reset-Taster
-
-Die Platine hat keinen dedizierten Reset-/Boot-Taster (Custom-PCB-Design).
-Der klassische UF2-"Doppel-Tap-Reset" braucht aber gar keinen physischen Pin —
-`check_start_application()` in `src/main.c` prüft ein RAM-Flag
-(`DBL_TAP_PTR`/`DBL_TAP_MAGIC`), das bei jedem Reset gesetzt wird, unabhängig
-von der Reset-Quelle.
-
-Statt eines eigenen Tasters wird die unterste rechte Cherry-MX-Taste
-(`key_id 24` in der App-Firmware, siehe `../src/config/pins.h`) missbraucht:
-
-- `key_id 24` liegt auf COL4 (`PA08`) × ROW4 (`PA15`)
-- `boot_key_pressed()` in `src/main.c` treibt ROW4 kurz auf LOW und liest
-  COL4 zurück — kein voller Matrixscan nötig, nur ein Drei-Pin-Check
-- der Check läuft ganz am Anfang von `check_start_application()`, noch vor
-  der App-Adress-Validierung und vor der RCAUSE-/DBL-TAP-Logik: funktioniert
-  also auch bei kaputter/gelöschter App-Firmware und bei normalem Power-On
-  (Stecker ziehen/reinstecken), kein Software-Trigger in der App nötig
-- Pin-Konstanten stehen in `include/board_config.h`
-  (`BOOT_KEY_ROW_PIN`/`BOOT_KEY_COL_PIN`)
-
-Bedienung: USB-Kabel ziehen, unterste rechte Taste gedrückt halten, Kabel
-wieder einstecken (Taste dabei weiter halten) → Board bootet direkt in
-`VERSABOOT`. Ohne gehaltene Taste startet die App normal.
-
-## App-Firmware per USB flashen (nach dem einmaligen Bootloader-Flash)
-
-```bash
-# Board zuerst in den Bootloader-Modus versetzen: USB ziehen, unterste
-# rechte Taste halten, wieder einstecken (siehe oben)
-pio run -e versapad_usb --target upload
-```
-
-Baut die App-Firmware (Repo-Root, nicht `bootloader/`), erzeugt `firmware.uf2`
-und kopiert es aufs `VERSABOOT`-Laufwerk. Kein Atmel-ICE mehr nötig.
-
 ## Achtung bei manuellem SWD-Flashen von Bootloader UND App
 
 `upload_openocd.py` (App, `env:versapad`) und der Bootloader-Upload (oben)
@@ -111,61 +68,3 @@ verwenden (nie `.elf`) und die Zieladresse **immer explizit angeben**
 App-Schreibvorgang **in getrennten OpenOCD-Aufrufen**, nicht in einer
 gemeinsamen `-c`-Kommandokette. Im Zweifel danach mit `dump_image` in einer
 frischen, unabhängigen Sitzung verifizieren.
-
-## Hardwaretest (2026-08-05)
-
-Erster vollständiger Hardwaretest auf einem echten VersaPad-v2-Board über
-Atmel-ICE/SWD. Ergebnisse:
-
-- Bootloader-Build/-Flash/-Verify laufen sauber (89,9 % Flash, 7364/8192 Byte).
-- USB-Enumeration und `VERSABOOT`-Massenspeicher-Modus funktionieren nach dem
-  PID-Fix (siehe unten) korrekt, inklusive korrektem `INFO_UF2.TXT`.
-- Der Tastencheck (oben) funktioniert wie vorgesehen: gehaltene Taste beim
-  Boot → `VERSABOOT`, sonst normaler App-Start.
-- **Kritischer Bug gefunden und behoben:** Der Sprung vom Bootloader in die
-  App (`__set_MSP` → `SCB->VTOR` → `bx`) führte bei jedem echten,
-  eigenständigen Boot (auch bei komplett getrenntem Debugger) zu einem
-  Hard-Fault/Lockup der CPU. Identische Register-/VTOR-Werte, vom Debugger
-  bei angehaltener CPU direkt injiziert, liefen dagegen einwandfrei — das
-  grenzte den Fehler auf die *Ausführung* der Sprungsequenz selbst ein, nicht
-  auf falsche Werte. Fix: `__DSB(); __ISB();` zwischen dem `SCB->VTOR`-Schreib-
-  zugriff und dem `bx` in `check_start_application()` (`src/main.c`) — von ARM
-  für genau dieses Bootloader-Pattern vorgeschrieben, hat im vendorten Code
-  gefehlt. Nach dem Fix bootet die App-Firmware zuverlässig, mit und ohne
-  angeschlossenen Debugger.
-- **Zweiter Bug beim manuellen Debuggen gefunden:** Beim anschließenden
-  manuellen SWD-Debugging (Suche nach der Ursache des Tastencheck-Problems,
-  siehe oben) hat `openocd -c "program app.elf verify"` ohne explizite
-  Zieladresse wiederholt den Bootloader mit rohen ELF-Datei-Bytes
-  überschrieben, sobald Bootloader- und App-Flash im selben OpenOCD-Aufruf
-  kombiniert wurden — siehe "Achtung bei manuellem SWD-Flashen" oben. Nach
-  einem vollständigen Chip-Erase und getrennten `.bin`-Flashes mit expliziten
-  Adressen liefen beide Bereiche wieder zuverlässig, Tastencheck und
-  App-Start bestätigt funktionsfähig.
-- **Kompletter USB-Flashweg getestet:** `pio run -e versapad_usb --target
-  upload` (App-Firmware, Repo-Root) baut `firmware.bin`, wandelt es über
-  [`../uf2conv.py`](../uf2conv.py) in `firmware.uf2` und kopiert es über
-  [`../upload_uf2.py`](../upload_uf2.py) automatisch aufs erkannte
-  `VERSABOOT`-Laufwerk. Der Bootloader erkennt den Schreibzugriff und
-  springt danach selbständig in die neue App — kein manuelles Auswerfen
-  oder Reset nötig. Voraussetzung: Board zuvor per gehaltener Taste (siehe
-  oben) in den Bootloader-Modus versetzt.
-
-## Bekannte Einschränkungen
-
-- Flash-Auslastung ~90 % (7364 von 8192 Byte). Wenig Puffer für Änderungen.
-- Kein Status-LED-Feedback im Bootloader-Modus, da die Platine nur eine
-  WS2812-Kette (kein einfaches GPIO-LED oder DotStar) hat und der
-  Original-Code dafür nicht ausgelegt ist.
-- USB_PID war ursprünglich `0x0011` (Adafruit Gemma M0s eigene
-  Bootloader-PID, unverändert aus der Vorlage übernommen) — kollidierte auf
-  Rechnern mit installiertem Adafruit-Treiber, wurde als `Adafruit Circuit
-  Playground`-COM-Port statt als Massenspeicher gebunden. Verifiziert am
-  2026-08-05, seither `0x0043`. Bleibt ein Wert ohne echte Registrierung
-  (kein offiziell zugeteilter PID unter Adafruits VID); ein sauber eigener
-  VID (z. B. über pid.codes) wäre die langfristig korrekte Lösung, ist aber
-  nicht Teil dieses Branches.
-- [`../upload_uf2.py`](../upload_uf2.py) sucht das `VERSABOOT`-Laufwerk aktuell
-  nur über die Windows-API (`GetVolumeInformationW`) — passend zur bisherigen
-  Dev-Umgebung dieses Projekts, aber nicht plattformübergreifend. Für
-  macOS/Linux müsste die Laufwerkssuche noch ergänzt werden.

bootloader/TESTING.md

@@ -1,65 +0,0 @@
-# Bootloader-Testflash -- Ergebnis
-
-Der UF2-Bootloader (siehe [README.md](README.md)) wurde am 2026-08-05 auf
-einem echten VersaPad-v2-Board über Atmel-ICE/SWD getestet. Zusammenfassung
-der Ergebnisse steht im [Hardwaretest-Abschnitt der README](README.md#hardwaretest-2026-08-05).
-Dieses Dokument hält den Testablauf und die Antworten auf die ursprünglichen
-Prüffragen fest.
-
-**Sicherheitsrahmen, der eingehalten wurde:** Der Bootloader-Flash schreibt
-nur `0x0000..0x1FFF` (8 KiB). Die App-Firmware ab `0x2000` blieb dabei
-unangetastet. Über SWD war der Chip jederzeit neu beschreibbar; ein Brick war
-zu keinem Zeitpunkt möglich, solange der Atmel-ICE-Zugriff funktionierte.
-
-## Voraussetzungen
-
-- Board per Atmel-ICE/SWD angeschlossen, wie beim normalen
-  App-Firmware-Flashen (`pio run -e versapad --target upload`,
-  siehe `../doc/08_development.md`)
-- PlatformIO Core (hier: PlatformIO-IDE-penv unter
-  `%USERPROFILE%\.platformio\penv\Scripts\pio.exe`)
-
-## Ablauf
-
-1. `git checkout feature/usb-bootloader`
-2. `cd bootloader && pio run -e versapad_bootloader` — Build sauber
-   (89,9 % Flash, 7364/8192 Byte)
-3. `pio run -e versapad_bootloader --target upload` — Flash + Verify über
-   Atmel-ICE/SWD
-
-## Ursprüngliche Prüffragen und Antworten
-
-- **Ist der Flash-Befehl ohne Fehler durchgelaufen?** Ja, `** Verified OK **`
-  bei jedem Flash.
-- **Erscheint nach dem Bootloader-Einstieg ein Laufwerk `VERSABOOT`?** Ja.
-  Getestete Board-Revision hat **keinen physischen Reset-/Boot-Taster**
-  (Custom-PCB) — der ursprünglich geplante Doppel-Tap-Reset-Test war damit
-  nicht durchführbar. Stattdessen wurde ein Hardware-Bootloader-Einstieg über
-  eine gehaltene Cherry-MX-Taste ergänzt, siehe
-  [README.md](README.md#hardware-bootloader-einstieg-ohne-reset-taster).
-  Mit dieser Ergänzung: gehaltene Taste beim Power-On → `VERSABOOT`.
-- **Was steht in `INFO_UF2.TXT`?**
-  ```
-  UF2 Bootloader versapad-1 SFHWRO
-  Model: VersaPad v2
-  Board-ID: SAMD21G17D-VersaPad-v2
-  ```
-- **Reagiert das Board normal als App-Firmware, wenn man es ohne gehaltene
-  Taste ansteckt?** Ja, nach dem in der README beschriebenen DSB/ISB-Fix.
-  Vor dem Fix: nein, siehe unten.
-- **Ungewöhnliches?** Ja, ein echter Bug: siehe
-  [Hardwaretest-Abschnitt der README](README.md#hardwaretest-2026-08-05) für
-  die Fehlersuche (Bootloader-eigener Sprung faultete zuverlässig, obwohl vom
-  Debugger injizierte identische Register-/VTOR-Werte einwandfrei liefen) und
-  den Fix (fehlende `__DSB()`/`__ISB()` vor dem `bx` in
-  `check_start_application()`).
-- **USB-Identität korrekt, kein Fremdtreiber-Konflikt?** Nach PID-Wechsel von
-  `0x0011` auf `0x0043` ja (siehe README, "Bekannte Einschränkungen" zum
-  ursprünglichen Adafruit-PID-Konflikt).
-
-## Noch NICHT getestet
-
-Firmware tatsächlich über das `VERSABOOT`-Laufwerk flashen. Der
-Firmware-Build der App erzeugt noch keine `.uf2`-Datei (nur `.bin`/`.elf` für
-den SWD-Weg) — das ist der nächste Schritt, siehe README, "Bekannte
-Einschränkungen".