1. 调试基础：嵌入式调试的核心概念、调试器工作原理、JTAG/SWD协议简介
嵌入式调试，说白了就是让程序在目标硬件上停下来，让你看看里面到底发生了什么。我刚开始做嵌入式那会儿，全靠串口打印，满屏的 printf 满天飞。后来第一次用上 JTAG 调试器，那种感觉——就像从看黑白电视直接跳到 4K 高清。
这一章我们先把调试的底牌翻出来看看。不急着上手操作，先把概念理清楚。
1.1 嵌入式调试的核心概念
调试的本质是什么？我个人理解就三件事：暂停执行、查看状态、单步推进。你想想看，程序跑得再快，只要你能让它停下来，就能把它的五脏六腑看个遍。
| 核心概念 | 说明 | 我的经验 |
|---|---|---|
| 断点 (Breakpoint) | 让 CPU 在指定地址停下来 | 硬件断点有限，软件断点无限，但会改 Flash |
| 单步执行 (Step) | 一次执行一条指令或一行源码 | Step Over 和 Step Into 要分清楚，别跳进库函数里出不来 |
| 变量监视 (Watch) | 实时查看变量值的变化 | 优化后的变量可能被优化掉，加 volatile 保平安 |
| 调用栈 (Call Stack) | 查看函数调用链 | 栈溢出时调用栈会乱掉，这时候先查栈大小 |
| 寄存器查看 (Register View) | 查看 CPU 内核寄存器的值 | PC 指针乱跳，十有八九是函数指针或中断向量表出问题 |
核心要点：调试不是碰运气，而是用工具把「黑盒」变成「白盒」。你看到的每一行代码、每一个变量，都是你破案的线索。
1.2 调试器工作原理
调试器到底是怎么让 CPU 停下来的？这个问题我当年琢磨了很久。其实原理不复杂，核心就两条路：硬件断点和软件断点。
1.2.1 硬件断点
CPU 内部有一组调试寄存器，专门用来比较地址。你设一个断点，调试器就把地址写进寄存器。CPU 每次取指令时，硬件自动比较——地址匹配，就触发异常，进入调试模式。
优点：不修改 Flash，可以在 ROM 里设断点。
缺点：数量有限，ARM Cortex-M 一般只有 4-8 个。
1.2.2 软件断点
调试器把目标地址的指令替换成一条特殊指令——比如 ARM 的 BKPT 或者 x86 的 INT 3。CPU 执行到这条指令时，触发异常，进入调试模式。
优点：数量无限。
缺点：会修改 Flash，不能在只读区域用。
避坑指南：我曾经在量产固件里忘了关调试接口，结果客户现场程序跑飞，调试器一接发现 BKPT 指令还在。从那以后，我每次发布前都会检查调试接口是否关闭，BKPT 指令是否清除干净。
1.3 JTAG/SWD 协议简介
调试器和 CPU 之间怎么通信？这就得靠调试协议了。目前嵌入式领域主流就两种：JTAG 和 SWD。
1.3.1 JTAG (Joint Test Action Group)
JTAG 本来是做边界扫描测试的，后来被拿来调试。它用 5 根线：
- TMS：模式选择
- TCK：时钟
- TDI：数据输入
- TDO：数据输出
- TRST（可选）：复位
JTAG 的核心是一个有限状态机——TAP 控制器。调试器通过 TMS 和 TCK 的组合，让状态机在不同状态之间跳转，实现数据读写。
1.3.2 SWD (Serial Wire Debug)
SWD 是 ARM 搞的简化版，只用 2 根线：
- SWDIO：双向数据线
- SWCLK：时钟
SWD 比 JTAG 省引脚，速度还更快。现在 Cortex-M 系列基本都支持 SWD。
| 对比项 | JTAG | SWD |
|---|---|---|
| 引脚数 | 4-5 根 | 2 根 |
| 速度 | 一般 | 更快（可达 10MHz+） |
| 支持芯片 | 几乎所有 MCU/FPGA | ARM Cortex-M/R/A 系列 |
| 边界扫描 | 支持 | 不支持 |
| 调试功能 | 完整 | 完整 |
注意：SWD 虽然只有 2 根线，但调试器复位和目标板复位信号最好也接上。我遇到过好几次因为没接复位线，导致调试器连不上目标板，折腾半天才发现是上电时序问题。
1.4 调试链路全景
从 IDE 到目标芯片，整个调试链路是这样的：
IDE (Keil/IAR/VS Code)
↓ USB/以太网
调试器 (J-Link/ST-Link/DAPLink)
↓ JTAG/SWD
目标芯片 (STM32/ESP32/...)
↓
CPU 内核 (Cortex-M/RISC-V/...)
↓
调试接口 (DAP/FPB/...) 每一层都有自己的职责。IDE 负责用户界面，调试器负责协议转换，目标芯片负责执行和响应。
1.5 调试接口的硬件连接
实际项目中，调试接口的连接有很多坑。我列几个常见的：
- SWD 的 SWO 引脚：有些调试器支持 SWO 输出调试信息，但需要额外接线
- 复位引脚：建议接上，防止调试器连不上
- 电源：调试器可以给目标板供电，但电流有限，大功率板子要独立供电
- 地线：调试器和目标板必须共地，否则信号乱飞
个人习惯：我一般会在 PCB 上留一个 10 针的 SWD 接口，把 SWDIO、SWCLK、SWO、RESET、GND、VCC 都引出来。虽然 SWD 只需要 2 根线，但多留几个引脚，调试时能省很多事。
1.6 调试器与目标芯片的握手过程
调试器连接目标芯片时，会经历一个标准的握手流程：
- 复位目标芯片：让 CPU 回到已知状态
- 发送连接请求：通过 JTAG/SWD 协议发送特定序列
- 读取 ID 寄存器：确认芯片型号和调试接口版本
- 配置调试寄存器：使能调试功能，设置断点等
- 进入调试模式：CPU 暂停，等待用户指令
如果哪一步卡住了，调试器会报错。常见的错误有：
- No target connected：没接好线，或者芯片没上电
- ID mismatch：芯片型号不对，或者调试接口被锁了
- Timeout：时钟频率太高，或者信号干扰
避坑指南：我曾经遇到一个项目，调试器死活连不上。查了半天，发现是芯片的 SWD 引脚被复用成 GPIO 了，而且代码里把这两个引脚拉低了。解决办法：按住复位键，在松开的一瞬间点击连接——趁芯片还没跑代码，先把调试器连上。
1.7 本章小结
调试的核心就三件事：暂停、查看、推进。JTAG 和 SWD 是调试器和芯片之间的桥梁，理解它们的工作原理，能帮你更快地定位问题。