forked from jappel/VersaMCU
67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# 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.
|