1. 调试基础与工具链

嵌入式调试，说白了就是让硬件和软件「开口说话」。我做了十几年嵌入式，见过太多同事拿着万用表戳来戳去，折腾半天找不到问题。其实，选对工具、搭好环境，很多问题一眼就能看穿。

这一章，咱们先把地基打牢。我会带你过一遍调试的核心概念，聊聊那些你桌上迟早会有的家伙事儿——示波器、逻辑分析仪、调试器，再手把手搭一个能干活的环境。

1.1 嵌入式调试到底在调什么？

嵌入式系统是个混合体。软件跑在硬件上，硬件被软件驱动。出问题的时候，你得判断：是代码逻辑错了？还是时序没对上？还是信号质量太差？

我个人习惯把调试场景分成三类：

调试类型	典型问题	常用工具
软件逻辑调试	变量值不对、程序跑飞、死锁	JTAG/SWD 调试器、IDE
硬件信号调试	波形畸变、毛刺、电平不匹配	示波器、逻辑分析仪
软硬件联调	外设无响应、中断丢失、时序错乱	调试器 + 示波器 双机联动

1.2 常用调试工具，你该备哪些？

工具不在多，在于会用。我见过有人拿两万块的示波器只当电压表用，也见过有人用几十块的逻辑分析仪搞定复杂时序问题。下面这三样，是嵌入式调试的「三驾马车」。

1.2.1 示波器——硬件的眼睛

示波器看的是模拟信号。电压高低、上升沿陡不陡、有没有振铃、噪声有多大，这些都得靠它。

• 带宽：至少是你被测信号最高频率的 5 倍。测 10MHz 的 SPI 时钟，50MHz 带宽起步。
• 采样率：带宽的 5~10 倍。采样率不够，波形会「混叠」，你看到的根本不是真实信号。
• 通道数：4 通道是黄金配置。测 SPI 刚好用满：MOSI、MISO、SCK、CS 各占一路。

1.2.2 逻辑分析仪——数字的侦探

逻辑分析仪只看 0 和 1，不关心电压具体是多少。它擅长抓协议时序：I²C 的起始条件对不对？UART 的波特率偏了多少？SPI 的相位和极性配没配错？

• 采样率：至少是被测信号速率的 4 倍。测 1MHz 的 I²C，4MHz 勉强够用，10MHz 更稳。
• 通道数：8 通道起步，16 通道更灵活。调试并行总线或同时监控多路信号时，通道多就是王道。
• 触发功能：能设置「上升沿触发」「下降沿触发」「码型触发」的，才算合格。

1.2.3 JTAG/SWD 调试器——软件的手术刀

调试器让你能「看」进芯片内部。单步执行、查看变量、设置断点、读取寄存器——这些是软件调试的基本操作。

接口类型	引脚数	速度	适用场景
JTAG	5 (TCK, TMS, TDI, TDO, nTRST)	中	ARM、FPGA、复杂 SoC
SWD	2 (SWDIO, SWCLK)	高	Cortex-M 系列 MCU

我个人更偏爱 SWD。两根线就能干活，省下的引脚可以留给其他功能。而且 SWD 的速度通常比 JTAG 快，下载固件和单步调试都更利索。

1.3 调试环境搭建——别让工具链卡住你

环境搭不好，调试还没开始就结束了。我见过太多新手在驱动和配置上浪费半天。下面是我总结的一套「三步走」流程。

1.3.1 硬件连接

1. 供电：调试器和目标板共地。不共地，信号就是浮空的，读回来的数据全是乱码。
2. 接线：SWD 只需要 SWDIO、SWCLK、GND。如果目标板支持，再接一个 SWO（串行线输出），可以输出 printf 日志，省一个 UART 口。
3. 复位：把调试器的 nRESET 接到目标板的复位引脚。这样调试器可以在连接失败时强制复位芯片，重新建立连接。

1.3.2 软件配置

以常用的 ARM Cortex-M 系列为例，IDE 用 Keil MDK 或 IAR Embedded Workbench，调试器用 J-Link 或 ST-Link。

// 调试配置示例（Keil MDK）
// 1. 打开 Project -> Options for Target -> Debug
// 2. 选择调试器：J-LINK / J-TRACE Cortex
// 3. 点击 Settings：
//    - Port: SW (SWD 模式)
//    - Max SWO Clock: 4 MHz (根据目标芯片调整)
//    - Connect: Under Reset (复位后连接，防止低功耗模式干扰)
// 4. 在 Utilities 选项卡中：
//    - 勾选 "Update Target before Debugging"
//    - 选择 "Use Debug Driver" 进行 Flash 编程

1.3.3 验证环境

写一个最简单的程序，下载进去，确认能单步执行、能查看变量。

// 验证代码示例
#include "stm32f1xx_hal.h"

int main(void)
{
    HAL_Init();
    
    volatile uint32_t counter = 0;  // volatile 防止编译器优化
    
    while (1)
    {
        counter++;                  // 在这里打一个断点
        for (volatile uint32_t i = 0; i < 100000; i++);  // 软件延时
    }
}

下载后，在 counter++; 这一行设置断点。全速运行，看程序能不能停在断点处。能停，说明调试器、IDE、目标板之间的通信链路是通的。然后单步执行，观察 counter 的值每次加 1。一切正常，环境就搭好了。

1.4 知识体系总览

下面这张图，把本章的核心脉络串起来了。你可以把它当作调试的「作战地图」。

这张图把调试分成了三条主线：软件、硬件、联调。每条线都有对应的核心工具。环境搭建是底座，底座不稳，上面全白搭。