name: ucflash description: | Flasht die STM32G431KB-Firmware auf das NUCLEO-G431KB Board via OpenOCD und ST-LINK V3. Programmiert, verifiziert und setzt das Target zurück. Verwende diesen Skill, wenn die Firmware auf das Board übertragen werden soll. Triggers: "flashen", "flash", "programmieren", "auf Board laden", "ucflash". allowed-tools: Bash, Read
ucflash — Firmware flashen
Flasht die kompilierte Firmware auf das NUCLEO-G431KB Board.
Voraussetzungen
- OpenOCD installiert (
brew install openocd) - NUCLEO-G431KB per USB angeschlossen (ST-LINK V3)
- Firmware wurde zuvor gebaut (ELF-Datei vorhanden)
Flash-Befehl
openocd -f board/st_nucleo_g4.cfg \
-c "program build/Debug/blinky.elf verify reset exit"
Für Release-Build:
openocd -f board/st_nucleo_g4.cfg \
-c "program build/Release/blinky.elf verify reset exit"
Ablauf im Skill
- Prüfen, ob die ELF-Datei existiert (
build/Debug/blinky.elf). Falls nicht: Benutzer darauf hinweisen, dass zuerst gebaut werden muss (ucbuild). - OpenOCD-Befehl mit absolutem Pfad zur ELF-Datei ausführen. Relative Pfade funktionieren nicht zuverlässig, da OpenOCD im eigenen Arbeitsverzeichnis läuft.
- Ausgabe prüfen:
Programming Finished+Verified OK+Resetting Target= Erfolg- Fehlermeldung analysieren und Benutzer informieren
Häufige Fehler
| Fehler | Ursache | Lösung |
|---|---|---|
couldn't open *.elf |
Relativer Pfad oder Datei fehlt | Absoluten Pfad verwenden, ggf. zuerst bauen |
Error connecting DP |
Board nicht angeschlossen oder USB-Problem | USB-Kabel prüfen, Board neu einstecken |
STLINK ... not found |
ST-LINK Treiber-Problem | brew reinstall openocd, USB-Verbindung prüfen |
Target voltage: 0.0 |
Board hat keine Stromversorgung | USB-Kabel mit Daten+Strom verwenden |
Board-Informationen
- Debug-Probe: ST-LINK V3 (integriert auf NUCLEO-G431KB)
- Interface: SWD (Serial Wire Debug)
- OpenOCD Config:
board/st_nucleo_g4.cfg(mitgeliefert mit OpenOCD) - Target Voltage: ~3.3 V
Wichtige Hinweise
- Nach dem Flashen führt OpenOCD automatisch einen Reset durch. Die Firmware startet sofort.
- Der
verify-Schritt vergleicht den Flash-Inhalt mit der ELF-Datei und meldet Fehler bei Abweichungen. - Während des Flash-Vorgangs darf das USB-Kabel nicht abgezogen werden.