Merge pull request #10 from openmv/qemu_support

backends: Add Qemu support.

Author: iabdalkader

README.md

@@ -4,7 +4,7 @@ A simple CLI tool that starts a GDB server and automatically attaches GDB to deb
 
 ## ✨ Features
 
-- 🔌 **Multiple backends** - Supports J-Link and ST-Link debug probes
+- 🔌 **Multiple backends** - Supports J-Link, ST-Link, and QEMU
 - 🔍 **Auto-discovery** - Automatically finds STM32CubeProgrammer installation
 - 🧹 **Clean lifecycle** - Starts the server, attaches GDB, and cleans up when done
 - ⚙️ **Configurable** - JSON-based backend configuration for easy customization
@@ -25,6 +25,7 @@ gdbrunner <backend> [options] elf
 
 - `jlink` - J-Link GDB server
 - `stlink` - ST-Link GDB server
+- `qemu` - QEMU ARM emulator
 
 ### Examples
 
@@ -40,6 +41,9 @@ gdbrunner jlink --device STM32H743VI --dryrun firmware.elf
 
 # 📺 Show server output for debugging connection issues
 gdbrunner stlink --show-output firmware.elf
+
+# 🖥️ Start QEMU and attach GDB
+gdbrunner qemu --machine mps2-an500 firmware.elf
 ```
 
 Run `gdbrunner --help` for all options.

src/gdbrunner/backends.json

@@ -1,4 +1,13 @@
 {
+  "qemu": {
+    "command": "qemu-system-arm",
+    "fixed_args": ["-nographic", "-monitor", "null", "-semihosting", "-S", "-serial", "pty"],
+    "elf_arg": "-kernel",
+    "arguments": [
+      {"flag": "--machine", "cmd": "-machine", "required": true, "help": "QEMU machine type (e.g., mps2-an500, mps3-an547)"},
+      {"flag": "--port", "cmd": "-gdb", "prefix": "tcp::", "type": "int", "default": 1234, "help": "GDB server port (default: 1234)"}
+    ]
+  },
   "jlink": {
     "command": "JLinkGDBServer",
     "fixed_args": ["-nogui", "1"],

src/gdbrunner/cli.py

@@ -89,7 +89,12 @@ def build_command(config, args):
             if value:
                 cmd.append(arg["cmd"])
         else:
-            cmd.extend([arg["cmd"], str(value)])
+            prefix = arg.get("prefix", "")
+            cmd.extend([arg["cmd"], f"{prefix}{value}"])
+
+    # Add ELF file if backend requires it (e.g., QEMU uses -kernel)
+    if "elf_arg" in config:
+        cmd.extend([config["elf_arg"], args.elf])
 
     return cmd