1. 课程导入

嵌入式调试，说白了就是在一片漆黑的芯片里找bug。你没法像PC程序那样直接打断点看变量，因为你的代码跑在资源受限的MCU上，甚至可能连printf都打不出来。我刚开始做嵌入式那会儿，最头疼的就是程序跑飞了，完全不知道它死在了哪一行。

这一章，我们先搭个全景图。把调试的难点、常用的工具、背后的协议理清楚。后面每一章都会基于这个框架展开。

1.1 嵌入式调试到底难在哪？

你想想看，一个典型的嵌入式系统，CPU、内存、外设都集成在一个芯片里。代码烧进去之后，它自己跑自己的。你没法像调试桌面软件那样，直接挂上一个调试器看堆栈。为什么？

• 资源极度受限：RAM可能只有几KB，放不下调试信息缓冲区。我遇到过Flash只剩2KB的情况，连个断点表都塞不进去。
• 实时性要求：电机控制、通信协议栈，你单步执行的时候，外部世界已经变了。我曾经在调试CAN总线时，一单步，总线就报错离线了。
• 硬件耦合：软件bug和硬件问题经常混在一起。比如一个GPIO没拉高，可能是代码没配，也可能是焊盘虚焊。
• 非确定性行为：中断触发时间、DMA传输完成时刻，每次运行都可能不一样。这种bug最难复现。

1.2 常用调试工具概览

工具不在多，在于顺手。我这些年用下来，真正核心的就那么几样。下面这张表帮你快速建立认知。

工具	角色	典型场景	我的经验
GDB	调试器前端	命令行断点、单步、查看变量	几乎所有调试的入口，必须熟练
OpenOCD	调试桥接层	把GDB命令翻译成JTAG/SWD信号	开源、灵活，但配置稍复杂
J-Link	硬件调试器	ARM Cortex-M全系列调试	稳定、速度快，我项目里用得最多
ST-Link	硬件调试器	STM32专用调试与烧录	便宜、够用，但功能不如J-Link全

1.3 GDB：调试界的瑞士军刀

GDB（GNU Debugger）是命令行调试的基石。它本身不直接跟硬件打交道，而是通过一个中间层——比如OpenOCD——来操作目标芯片。

我个人习惯，在调试嵌入式程序时，最常用的GDB命令就这几个：

# 连接远程调试服务器（OpenOCD默认端口3333）
(gdb) target remote localhost:3333

# 加载固件到目标芯片
(gdb) load my_firmware.elf

# 在main函数入口打断点
(gdb) break main

# 继续运行
(gdb) continue

# 单步进入函数
(gdb) step

# 查看当前局部变量
(gdb) info locals

# 查看内存地址0x20000000开始的32字节
(gdb) x/32bx 0x20000000

1.4 OpenOCD：软件桥接层

OpenOCD（Open On-Chip Debugger）是一个开源软件，它负责把GDB的调试命令，转换成JTAG或SWD协议的电平信号。它支持多种硬件调试器，比如FT2232、J-Link（通过libjaylink）、CMSIS-DAP等。

它的工作流程是这样的：

1. GDB发送调试命令（比如“读寄存器R0”）
2. OpenOCD接收命令，解析成JTAG/SWD的扫描链操作
3. 通过USB把数据发给硬件调试器（如J-Link）
4. 硬件调试器产生对应的JTAG/SWD时序信号
5. 目标芯片响应，数据原路返回

我曾经在调试一个国产RISC-V芯片时，OpenOCD官方不支持。我花了三天时间，自己写了一个target配置文件，才把调试跑通。嗯，那之后我对OpenOCD的配置结构就门儿清了。

1.5 J-Link vs ST-Link：怎么选？

这两个是ARM Cortex-M开发最常用的硬件调试器。我直接说结论：

• J-Link：速度快、功能全、支持芯片多。如果你做产品级开发，或者调试复杂问题（比如RTT、实时跟踪），J-Link是首选。缺点就是贵。
• ST-Link：买STM32开发板基本都送。烧录、单步调试完全够用。但速度慢，而且只支持ST的芯片。

1.6 调试接口协议：JTAG与SWD

协议是调试器跟芯片沟通的语言。目前主流就两种：JTAG和SWD。

特性	JTAG	SWD
引脚数	5（TCK, TMS, TDI, TDO, nTRST）	2（SWCLK, SWDIO）
速度	理论上更快（并行）	实际中更常用（串行但高效）
调试能力	支持边界扫描、多核调试	仅支持调试（ARM专有）
适用芯片	几乎所有芯片（ARM、RISC-V、FPGA）	仅ARM Cortex-M/A/R系列
我的推荐	多核或非ARM芯片时用	ARM Cortex-M开发首选

为什么SWD只有两根线？因为它把JTAG的TDI和TDO合并成了SWDIO这一根双向数据线。你想想看，省下来的三个引脚，可以留给GPIO或者电源，对PCB布局很友好。我做过一个四层板的项目，就是因为SWD省了引脚，才把BGA封装的芯片扇出成功。

1.7 知识结构图：调试工具链全景

下面这张图，把整个调试工具链的层次关系画清楚了。从最上层的GDB，到中间的OpenOCD，再到硬件调试器，最后通过JTAG/SWD协议跟目标芯片通信。

1.8 避坑指南：调试器连接不上怎么办？

这个问题，我几乎每次培训都会被问到。这里列几个最常见的坑：

• 接线错误：SWD只需要SWCLK、SWDIO、GND三根线就能调试。但很多人忘了接GND，或者接了VCC（其实不需要）。我遇到过不下十次，都是因为GND没接好。
• 芯片被锁：如果芯片的读保护（RDP）级别设为1或2，调试器就无法连接。解决办法是用串口ISP擦除整片Flash。嗯，这个坑我踩过，当时折腾了一下午。
• 时钟问题：调试器跟芯片通信需要时钟同步。如果芯片内部时钟没起振，或者调试器速率设得太高（比如超过10MHz），连接就会失败。我一般先从1MHz开始试，稳定了再往上提。
• 电源不稳定：目标板供电不足，调试器无法正确识别芯片IDCODE。用示波器看VCC，如果纹波超过100mV，先解决电源问题。