File tree Expand file tree Collapse file tree 1 file changed +19
-9
lines changed
Expand file tree Collapse file tree 1 file changed +19
-9
lines changed Original file line number Diff line number Diff line change 1- # gdbrunner
1+ # π gdbrunner
22
3- GDB runner - start debug servers and attach GDB.
3+ A simple CLI tool that starts a GDB server and automatically attaches GDB to debug embedded targets .
44
5- ## Installation
5+ ## β¨ Features
6+
7+ - π ** Multiple backends** - Supports J-Link and ST-Link debug probes
8+ - π ** Auto-discovery** - Automatically finds STM32CubeProgrammer installation
9+ - π§Ή ** Clean lifecycle** - Starts the server, attaches GDB, and cleans up when done
10+ - βοΈ ** Configurable** - JSON-based backend configuration for easy customization
11+
12+ ## π¦ Installation
613
714``` bash
815pip install gdbrunner
916```
1017
11- ## Usage
18+ ## π Usage
1219
1320``` bash
1421gdbrunner < backend> [options] elf
@@ -22,18 +29,21 @@ gdbrunner <backend> [options] elf
2229### Examples
2330
2431``` bash
25- # Start J-Link and attach GDB
32+ # π§ Start J-Link and attach GDB
2633gdbrunner jlink --device STM32H743VI firmware.elf
2734
28- # Start ST-Link and attach GDB
29- gdbrunner stlink --cube-prog /path/to/cubeprog firmware.elf
35+ # π§ Start ST-Link and attach GDB (auto-discovers CubeProgrammer path)
36+ gdbrunner stlink firmware.elf
3037
31- # Dry run - print server command without running
38+ # π Dry run - print server command without running
3239gdbrunner jlink --device STM32H743VI --dryrun firmware.elf
40+
41+ # πΊ Show server output for debugging connection issues
42+ gdbrunner stlink --show-output firmware.elf
3343```
3444
3545Run ` gdbrunner --help ` for all options.
3646
37- ## License
47+ ## π License
3848
3949MIT
You canβt perform that action at this time.
0 commit comments