2. 调试环境搭建：工欲善其事，必先利其器

调试环境这东西，说白了就是你跟硬件对话的桥梁。桥没搭好，你喊破嗓子芯片也听不见。我见过太多工程师花几周查一个bug，最后发现是调试器配置错了——嗯，我自己也干过这种事。

这一章我们就把OpenOCD+GDB、Keil/IAR调试器、串口工具这三样东西彻底讲透。你跟着走一遍，以后至少省一半的排查时间。

2.1 OpenOCD + GDB：命令行调试的黄金组合

OpenOCD（Open On-Chip Debugger）是个开源工具，专门用来跟调试适配器（比如J-Link、ST-Link、FT2232）打交道。GDB则是调试器的老大哥，两者一结合，你能干的事比IDE多得多。

安装步骤（以Ubuntu为例）

# 安装OpenOCD
sudo apt-get install openocd

# 安装ARM交叉编译工具链（自带arm-none-eabi-gdb）
sudo apt-get install gcc-arm-none-eabi

# 验证安装
openocd --version
arm-none-eabi-gdb --version

Windows用户可以去官网下载预编译包，或者用MSYS2。我个人习惯在Linux下搞，省心。

启动OpenOCD

你需要一个配置文件，告诉OpenOCD用啥调试器、连啥芯片。下面是个STM32F4的例子：

# stm32f4.cfg
source [find interface/stlink.cfg]
source [find target/stm32f4x.cfg]

# 启动命令
openocd -f stm32f4.cfg

启动后你会看到OpenOCD在3333端口开了个GDB服务。这时候另开一个终端，连上去：

arm-none-eabi-gdb your_program.elf
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue

常用GDB调试命令速查

命令	作用	我常用的场景
break main	在main函数设断点	程序跑飞时先停住看看
info registers	查看寄存器值	检查PC指针是不是跳到奇怪的地方
display /x *0x20000000	监视内存地址	看变量有没有被意外修改
backtrace	查看函数调用栈	定位死机前的调用路径
stepi	单步执行一条指令	分析汇编级别的执行流

2.2 IDE调试器配置：Keil和IAR

说实话，大部分项目我还是用IDE调试的——图形化界面确实方便。但IDE的调试器配置有个坑：默认设置不一定适合你的板子。

Keil MDK调试配置

1. 点击魔术棒（Options for Target）→ Debug选项卡
2. 选择调试器：ST-Link Debugger / J-Link / CMSIS-DAP
3. 点击Settings，配置SWD速度（建议先设1MHz，稳定后再往上调）
4. 在Flash Download选项卡里添加对应的算法文件（.FLM）

我曾经在一个项目里折腾了整整一下午，程序就是下载不进去。最后发现是Flash算法选错了——芯片是STM32F407，我选了F405的算法。你想想看，就差一个字母，折腾半天。

IAR Embedded Workbench调试配置

1. Project → Options → Debugger → Setup
2. Driver选CMSIS-DAP或J-Link/J-Trace
3. 在Download选项卡勾选"Use flash loader(s)"
4. 在Images选项卡指定.elf或.out文件

对比项	Keil MDK	IAR EWARM
调试器驱动	内置，自动识别	需要手动选Driver
断点数量	硬件断点有限（通常6个）	支持Flash Breakpoint（无限）
变量实时显示	Live Watch窗口	Live Watch + 寄存器组
Trace功能	仅ETM（需高级调试器）	IAR C-SPY支持指令Trace

2.3 串口调试工具：最朴素的调试手段

别小看串口打印。我见过最复杂的bug，最后是靠printf定位的——JTAG死活连不上，串口反而能通。串口调试，说白了就是芯片通过TX引脚往外吐数据，你在PC上用工具收着看。

硬件连接

• 目标板TX → USB转串口模块RX
• 目标板RX → USB转串口模块TX（如果需要双向通信）
• GND必须共地！GND必须共地！GND必须共地！

常用串口工具对比

工具	平台	特点	我推荐的理由
PuTTY	Windows	轻量、稳定	应急调试首选，不用安装
MobaXterm	Windows	多标签、支持X11	同时开多个串口会话很方便
screen	Linux/macOS	命令行、脚本化	自动化测试时配合脚本用
minicom	Linux	配置保存、日志记录	长时间抓日志不会丢数据

串口调试的进阶用法

光打印还不够，我教你几个实用技巧：

// 技巧1：加时间戳
printf("[%lu] ADC value: %d\r\n", HAL_GetTick(), adc_val);

// 技巧2：用不同前缀区分日志等级
#define LOG_ERR(fmt, ...)  printf("[ERR] " fmt "\r\n", ##__VA_ARGS__)
#define LOG_INFO(fmt, ...) printf("[INF] " fmt "\r\n", ##__VA_ARGS__)
#define LOG_DBG(fmt, ...)  printf("[DBG] " fmt "\r\n", ##__VA_ARGS__)

// 技巧3：环形缓冲区 + DMA发送（不阻塞主循环）
void debug_putchar(char c) {
    // 把字符塞入环形缓冲区，DMA后台发送
}

2.4 三种调试方式的协同使用

实际项目中，这三种方式我经常混着用：

• IDE调试器：日常开发、单步跟踪、变量观察
• OpenOCD+GDB：自动化测试脚本、CI集成、远程调试
• 串口调试：实时日志、性能分析、JTAG连不上时的保底手段

举个例子：我在调试一个电机驱动板时，Keil里设了断点，但电机一转就触发看门狗复位。用串口打印看门狗喂狗的时间戳，发现喂狗间隔不稳定。再用GDB的watchpoint监控看门狗寄存器，最终定位到是一个中断优先级配置错误导致喂狗被延迟。三种工具各显神通，缺一个都得查半天。