1. 调试基础：调试工具介绍与环境搭建
各位同学，咱们正式开始这门课。第一章不讲代码，先聊聊吃饭的家伙——调试工具。
我见过不少新手，代码写得飞起，一遇到硬件问题就抓瞎。其实说白了，调试就像破案，工具就是你的放大镜和指纹刷。工具用对了，问题就解决了一半。
1.1 三大核心工具：示波器、逻辑分析仪、调试器
做嵌入式调试，这三样东西你绕不开。我个人的习惯是：调试器常备，逻辑分析仪随叫随到，示波器关键时刻救命。
| 工具 | 核心能力 | 典型场景 | 我的推荐 |
|---|---|---|---|
| 示波器 | 看模拟信号波形、时序、噪声 | 电源纹波、PWM波形、I2C/SPI信号质量 | 带宽100MHz以上，采样率1GSa/s起步 |
| 逻辑分析仪 | 抓数字信号逻辑电平、协议解码 | UART乱码、SPI时序错位、I2C地址冲突 | 24通道以上，支持常见协议硬件解码 |
| 调试器 | 控制MCU运行、读写寄存器、断点调试 | 程序跑飞、变量异常、外设初始化失败 | J-Link或ST-Link，SWD模式最常用 |
我的经验： 别迷信贵工具。一台二手泰克示波器加一个几十块的Saleae逻辑分析仪克隆版，足够搞定90%的调试场景。省下的钱，多买几块开发板更实在。
1.2 示波器——硬件调试的"眼睛"
示波器看的是"真实世界"。数字信号在芯片引脚上不是完美的0和1，有上升沿、下降沿、过冲、振铃。这些逻辑分析仪看不到。
什么时候必须用示波器？
- 怀疑电源不稳——看纹波，峰峰值超过50mV就要警惕
- 通信距离远——检查信号幅值是否衰减
- EMC问题——看高频噪声的幅度和频率
- 时序临界——测量建立时间、保持时间是否满足
避坑： 我曾经调试一块电机驱动板，PWM一开启MCU就复位。用逻辑分析仪抓了半天，啥也没发现。后来用示波器一看，电源线上有个200mV的毛刺，正好打在MCU的复位引脚上。加个10μF电容搞定。所以——电源纹波问题，示波器才是正解。
1.3 逻辑分析仪——数字协议的"翻译官"
逻辑分析仪只看高低电平，不看电压具体多少。它的强项是：多通道同时抓、长时间记录、协议自动解码。
我常用的逻辑分析仪场景：
- UART通信乱码——抓TX/RX，看波特率对不对，数据位是否对齐
- SPI从机无响应——检查CS、SCK、MOSI时序，确认从机是否在正确时刻采样
- I2C总线死锁——看SCL/SDA电平，确认是否被从机拉低
- 多个外设中断冲突——同时抓多个GPIO，看谁先触发
关键设置： 采样率至少是信号最高频率的4倍。比如SPI时钟10MHz，采样率设40MHz以上。触发条件设对，不然抓一整天也找不到问题。
1.4 调试器——MCU的"遥控器"
调试器让你能"看"进芯片内部。单步执行、查看变量、修改寄存器——这些是软件调试的根基。
SWD vs JTAG：怎么选？
| 接口 | 引脚数 | 速度 | 适用场景 |
|---|---|---|---|
| SWD | 2线（SWDIO + SWCLK） | 最高可达几十MHz | STM32调试首选，省引脚 |
| JTAG | 4-5线（TMS/TCK/TDI/TDO/nTRST） | 稍慢于SWD | 多芯片链式调试、FPGA/CPLD |
我的建议： 做STM32项目，直接用SWD。省下的3个引脚可以多接一个传感器或按键。除非你要同时调试多个芯片，否则JTAG没必要。
1.5 调试环境搭建——别让工具卡住你
环境搭不好，调试效率直接减半。我见过有人花一上午装驱动，结果发现线没接对。
标准调试链路：
- 硬件连接： 调试器 → SWD排线 → 目标板（注意线长不超过20cm，太长信号会失真）
- 驱动安装： 调试器厂商驱动（J-Link用SEGGER驱动，ST-Link用ST官方驱动）
- IDE配置： 选择调试器型号、接口（SWD/JTAG）、速度（建议先设1MHz，稳定后再提高）
- 验证连接： 点击"连接"或"读取设备ID"，能读到芯片型号和IDCODE才算成功
常见翻车现场：
- SWD线序搞反——GND和SWDIO接错，调试器直接烧掉
- 目标板供电不足——调试器给板子供了电，但电流不够，MCU半死不活
- 复位引脚被拉低——板子上有外部复位电路，调试器无法接管
1.6 知识体系总览
下面这张图，把本章的核心逻辑串起来了。你调试时遇到问题，可以按这个思路选工具。
1.7 调试接口连接规范
接口接不对，一切白费。我整理了一份标准连接表，你照着接就行。
| SWD引脚 | 功能 | 连接目标 | 注意事项 |
|---|---|---|---|
| SWDIO | 数据输入输出 | MCU的SWDIO引脚 | 需上拉10kΩ到3.3V |
| SWCLK | 时钟 | MCU的SWCLK引脚 | 需下拉10kΩ到GND |
| GND | 地 | 目标板GND | 必须连接，否则调试器无法建立参考电平 |
| VCC | 参考电压（可选） | 目标板3.3V | 用于电平匹配，不是供电！ |
| RESET | 复位（可选） | MCU的NRST引脚 | 某些调试器需要，用于连接后复位MCU |
核心原则： GND必须接，VCC可以不接但建议接（用于电平检测）。SWDIO和SWCLK的上拉/下拉电阻，很多开发板已经内置了，但自己做板子时别忘了加。
1.8 调试环境快速验证
环境搭好之后，别急着写代码。先跑一个"Hello World"级别的验证——读取MCU的Device ID。
// 以STM32F103为例，通过调试器读取DBGMCU_IDCODE寄存器
// 地址：0xE0042000
// 返回值：0x1BA01477（STM32F103x8/xB）
uint32_t ReadMCU_ID(void)
{
return *((volatile uint32_t *)0xE0042000);
}
// 如果能读到正确的ID，说明：
// 1. SWD连接正常
// 2. 调试器驱动安装正确
// 3. MCU供电正常
// 4. 复位电路工作正常
小技巧： 如果读不到ID，先检查GND是否连通，再量SWCLK引脚有没有时钟信号。很多时候是线没插紧，或者杜邦线接触不良。我习惯用带锁扣的排线，比杜邦线靠谱得多。
好了，第一章就到这里。工具和环境是调试的基石，别嫌麻烦，花点时间把这一步做扎实。后面每一章都会用到这些工具，到时候你就知道今天花的时间值不值了。