【RT Thread】使用QEMU模拟器结合GDB调试RT Thread内核

NormalConfidence_Man2025-08-29 12:45

在 RT-Thread 中使用 QEMU 模拟环境并通过 GDB 调试，流程相对简单（无需硬件，纯软件模拟）。核心思路是：让 QEMU 以调试模式启动 RT-Thread 固件，并等待 GDB 连接，然后通过 GDB 进行断点设置、单步执行等操作。建议直接使用RTT官方的ENV工具，集成了QEMU和常见架构的gdb，文档详解【ENV工具文档中心】

确保支持 QEMU 模拟

确认你的 RT-Thread 工程已配置为 QEMU 目标平台（如 qemu-vexpress-a9 或 qemu-virt64-aarch64 等）。一般进到对应的bsp然后配置QEMU就可以

启动 QEMU 并进入调试模式

QEMU 支持以 "等待 GDB 连接" 的模式启动，命令格式如下：
qemu-system-<架构> -M <机器型号> -kernel <固件路径> -s -S [其他选项]

-s：等价于 -gdb tcp::1234，表示在 1234 端口开启 GDB 服务器，等待连接。
-S：启动后立即暂停 CPU（不执行任何指令），等待 GDB 发送 "继续" 命令。
-M：指定 QEMU 模拟的机器型号（如 vexpress-a9 对应 ARM 平台）。
-kernel：指定要运行的 RT-Thread 固件（rtthread.elf）。

示例

复制代码

qemu-system-arm -M vexpress-a9 -kernel build/rtthread.elf -s -S -serial stdio

此时 QEMU 会启动并显示黑屏（因 -S 参数暂停执行），等待 GDB 连接。

启动 GDB 并连接 QEMU

打开新的终端 / ENV 窗口，进入工程目录。启动对应架构的 GDB（RT-Thread ENV 通常自带，或者自行配置，如 ARM 平台用 arm-none-eabi-gdb）：

复制代码

arm-none-eabi-gdb build/rtthread.elf  # 加载调试固件
(gdb) target remote localhost:1234

接下来连接成功后可以直接开始调试

最后附上GDB调试详解【Linux】GDB保姆级调试指南