2. 调试环境搭建：硬件调试器、IDE 配置与 GDB 基础

RTOS 内核调试的核心在于精确控制指令流与观察中断响应。本章将系统讲解硬件调试器（J-Link、ST-Link）、主流 IDE（Keil、IAR、VS Code）的配置方法，以及 GDB 调试器的基本操作。正确的环境搭建是后续单步执行与中断时序排查的基础。

2.1 硬件调试器选型与连接

硬件调试器负责主机与目标 MCU 之间的通信，提供 JTAG/SWD 接口协议转换。下表对比了两种常用调试器的关键特性：

连接方式采用标准的 4 线 SWD 接口：

• SWDIO — 数据输入输出线
• SWCLK — 时钟线
• GND — 地线
• VCC (3.3V) — 目标板供电（可选，部分调试器可提供）

2.2 IDE 调试配置

2.2.1 Keil MDK 配置步骤

1. 打开项目，点击 Project → Options for Target。
2. 选择 Debug 选项卡，在 Use 下拉框中选择调试器（如 J-Link / ST-Link）。
3. 点击 Settings，配置 Port 为 SW，Max SW Clock 设为 4 MHz（调试 RTOS 时建议降低时钟以保证稳定）。
4. 在 Flash Download 选项卡中，勾选 Reset and Run。
5. 点击 Debug 按钮进入调试模式。

2.2.2 IAR EWARM 配置步骤

1. 打开项目，右键点击工程名，选择 Options。
2. 进入 Debugger 分类，在 Setup 选项卡中选择 Driver（如 J-Link/JTAGjet）。
3. 点击 Download 选项卡，勾选 Use flash loader(s) 和 Verify download。
4. 进入 Debugger → Images，添加 RTOS 内核镜像文件（如 FreeRTOS 的 .out 文件）。
5. 点击 Download and Debug 按钮。

2.2.3 VS Code + Cortex-Debug 配置

VS Code 配合 Cortex-Debug 插件提供灵活的 GDB 前端，适合高级 RTOS 调试。

// .vscode/launch.json 配置示例 (J-Link + STM32F4)
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "RTOS Debug (J-Link)",
            "type": "cortex-debug",
            "request": "launch",
            "servertype": "jlink",
            "cwd": "${workspaceRoot}",
            "executable": "./build/rtos_demo.elf",
            "device": "STM32F407VG",
            "interface": "swd",
            "serialNumber": "",
            "runToMain": true,
            "svdFile": "./STM32F407.svd",
            "rtos": "FreeRTOS"
        }
    ]
}

2.3 GDB 调试器基础

GDB（GNU Debugger）是 RTOS 内核调试的核心工具，支持断点管理、内存查看、寄存器操作等。以下为常用命令：

2.4 调试环境验证

搭建完成后，执行以下验证步骤确保环境正常工作：

1. 连接测试： 在 GDB 中执行 monitor halt，观察目标 MCU 是否暂停。
2. 断点测试： 在 main() 设置断点，执行 continue，确认程序停在入口处。
3. 单步测试： 使用 stepi 单步执行 10 条指令，观察 PC 寄存器变化。
4. RTOS 感知测试： 在 VS Code 中查看 RTOS 任务列表，确认任务状态正确显示。