JTAG/SWD调试接口使用完全指南¶

学习目标¶

完成本教程后，你将能够:

理解JTAG和SWD调试接口的工作原理
正确连接JTAG/SWD调试器到目标板
配置调试工具链和调试器参数
使用断点、单步执行等调试功能
查看和修改寄存器、内存和变量
掌握常见调试技巧和故障排除方法

前置要求¶

在开始本教程之前，你需要:

知识要求: - 了解C语言编程基础 - 熟悉ARM Cortex-M架构基础 - 了解嵌入式系统基本概念 - 掌握基本的电路知识

技能要求: - 能够使用IDE进行代码编译 - 会使用万用表测量电压 - 了解GPIO和基本外设操作 - 能够阅读硬件原理图

准备工作¶

硬件准备¶

名称	数量	说明	参考链接
开发板	1	STM32F4 Discovery或类似ARM开发板	-
调试器	1	J-Link、ST-Link或CMSIS-DAP	-
杜邦线	若干	用于连接调试器（如果不是板载）	-
USB线	1-2	连接调试器和开发板	-
万用表	1	用于测量电压和检查连接	-

软件准备¶

IDE: Keil MDK、IAR EWARM或STM32CubeIDE
调试工具: OpenOCD、J-Link Software或ST-Link Utility
驱动程序: 对应调试器的USB驱动
示例代码: 简单的LED闪烁程序

系统要求¶

操作系统: Windows 7/10/11、Linux或macOS
内存: 至少4GB RAM
USB端口: 至少1个可用USB 2.0端口
权限: 管理员权限（用于安装驱动）

步骤1: 理解JTAG和SWD接口¶

1.1 什么是JTAG？¶

JTAG (Joint Test Action Group) 是一种国际标准测试协议（IEEE 1149.1），最初用于芯片和电路板的边界扫描测试，后来被广泛应用于嵌入式系统的调试。

JTAG的主要特点: - 标准化接口，支持多种芯片 - 可以进行边界扫描测试 - 支持多设备菊花链连接 - 需要5个信号线（TCK、TMS、TDI、TDO、TRST） - 调试速度相对较慢

JTAG信号线说明:

信号	全称	方向	功能
TCK	Test Clock	输入	测试时钟信号
TMS	Test Mode Select	输入	模式选择信号
TDI	Test Data In	输入	测试数据输入
TDO	Test Data Out	输出	测试数据输出
TRST	Test Reset	输入	测试复位（可选）

1.2 什么是SWD？¶

SWD (Serial Wire Debug) 是ARM公司开发的调试接口，专门为ARM Cortex-M系列微控制器设计，是JTAG的替代方案。

SWD的主要特点: - ARM专有协议 - 只需要2个信号线（SWDIO、SWCLK） - 调试速度更快 - 节省引脚资源 - 支持串行线输出（SWO）

SWD信号线说明:

信号	全称	方向	功能
SWDIO	Serial Wire Data I/O	双向	数据输入/输出
SWCLK	Serial Wire Clock	输入	时钟信号
SWO	Serial Wire Output	输出	串行输出（可选）
RESET	System Reset	输入	系统复位（可选）

1.3 JTAG vs SWD 对比¶

特性	JTAG	SWD
信号线数量	5个（最少4个）	2个（最少）
调试速度	较慢（最高12MHz）	较快（最高50MHz）
引脚占用	多	少
标准化	IEEE标准	ARM专有
多设备连接	支持菊花链	不支持
适用范围	通用	ARM Cortex-M
串行输出	不支持	支持SWO
推荐使用	传统项目	新项目

选择建议: - 使用SWD: ARM Cortex-M项目，引脚资源紧张，需要高速调试 - 使用JTAG: 需要多设备连接，非ARM平台，需要边界扫描测试

1.4 调试接口工作原理¶

调试架构:

PC (调试主机)
    ↓ USB
调试器 (J-Link/ST-Link)
    ↓ JTAG/SWD
目标MCU (ARM Cortex-M)
    ↓
调试访问端口 (DAP)
    ↓
调试组件 (FPB/DWT/ITM)

关键组件: 1. DAP (Debug Access Port): 调试访问端口，连接外部调试器 2. AHB-AP: AHB总线访问端口，用于访问内存和外设 3. FPB (Flash Patch and Breakpoint): 断点单元，支持硬件断点 4. DWT (Data Watchpoint and Trace): 数据观察点和跟踪单元 5. ITM (Instrumentation Trace Macrocell): 仪器跟踪宏单元，用于printf调试

步骤2: 硬件连接配置¶

2.1 识别调试接口引脚¶

STM32F4系列SWD引脚: - PA13: SWDIO (数据线) - PA14: SWCLK (时钟线) - PB3: SWO (串行输出，可选) - NRST: 复位引脚（推荐连接）

查找引脚位置: 1. 查阅芯片数据手册（Datasheet） 2. 查看开发板原理图 3. 查找板上的调试接口座子（通常标注为JTAG或SWD）

2.2 标准调试接口定义¶

20针JTAG接口（标准）:

 1  VTref    2  NC
 3  TRST     4  GND
 5  TDI      6  GND
 7  TMS      8  GND
 9  TCK     10  GND
11  RTCK    12  GND
13  TDO     14  GND
15  RESET   16  GND
17  NC      18  GND
19  NC      20  GND

10针SWD接口（Cortex Debug Connector）:

 1  VTref    2  SWDIO/TMS
 3  GND      4  SWCLK/TCK
 5  GND      6  SWO/TDO
 7  KEY      8  TDI
 9  GND     10  RESET

注意: - VTref是目标板电压参考，用于电平匹配 - KEY引脚通常被移除，防止反插 - GND必须可靠连接

2.3 连接调试器¶

方法1: 使用板载调试器

许多开发板（如STM32 Discovery、Nucleo）自带ST-Link调试器:

确认板载调试器部分已连接（检查跳线帽）
使用USB线连接开发板到PC
等待驱动自动安装
检查设备管理器中是否出现ST-Link设备

方法2: 使用外部调试器

如果使用独立的J-Link或ST-Link:

连接步骤: 1. 关闭目标板电源 2. 使用杜邦线或转接板连接调试器和目标板 3. 最小连接（SWD模式）: - SWDIO → PA13 - SWCLK → PA14 - GND → GND - VTref → 3.3V（或目标板电压） - RESET → NRST（推荐） 4. 检查连接是否牢固 5. 给目标板上电 6. 连接调试器USB到PC

连接检查清单: - [ ] 所有信号线连接正确 - [ ] GND可靠连接 - [ ] VTref电压正确（通常3.3V） - [ ] 没有短路或接触不良 - [ ] 目标板正常上电（LED指示灯亮）

2.4 验证硬件连接¶

使用万用表检查: 1. 测量VTref电压（应为3.3V或目标板工作电压） 2. 测量SWDIO和SWCLK引脚电压（应为高电平） 3. 检查GND连接（调试器GND和目标板GND应导通） 4. 确认没有短路（相邻引脚之间应不导通）

使用调试器工具检查:

ST-Link Utility检查: 1. 打开ST-Link Utility 2. 点击"Target" → "Connect" 3. 如果连接成功，会显示芯片信息 4. 可以读取内存和寄存器

J-Link Commander检查:

# 启动J-Link Commander
JLink.exe

# 连接到目标
J-Link> connect
Device> STM32F407VG
TIF> S (选择SWD)
Speed> 4000 (设置速度为4MHz)

# 如果连接成功，会显示:
# Found SW-DP with ID 0x2BA01477
# Scanning AP map to find all available APs
# AP[0]: AHB-AP (IDR: 0x24770011)

预期结果: - 调试器能够识别目标芯片 - 可以读取芯片ID - 可以读取内存内容 - 没有连接错误提示

步骤3: 配置调试环境¶

3.1 安装调试器驱动¶

ST-Link驱动安装: 1. 下载ST-Link驱动: https://www.st.com/en/development-tools/stsw-link009.html 2. 解压并运行安装程序 3. 按照向导完成安装 4. 连接ST-Link，Windows会自动识别设备

J-Link驱动安装: 1. 下载J-Link Software: https://www.segger.com/downloads/jlink/ 2. 选择对应操作系统版本 3. 运行安装程序 4. 安装完成后，J-Link会自动识别

验证驱动安装: - Windows: 打开设备管理器，查看"通用串行总线控制器" - Linux: 运行lsusb命令，查看USB设备列表 - macOS: 打开"系统信息" → "USB"，查看设备

3.2 在Keil MDK中配置¶

步骤1: 打开项目选项 1. 打开Keil MDK项目 2. 点击工具栏的"Options for Target"图标（魔术棒） 3. 或按快捷键Alt+F7

步骤2: 选择调试器 1. 切换到"Debug"标签页 2. 在"Use"下拉菜单中选择调试器: - ST-Link Debugger（用于ST-Link） - J-LINK / J-TRACE Cortex（用于J-Link） - CMSIS-DAP Debugger（用于CMSIS-DAP）

步骤3: 配置调试器设置 1. 点击"Settings"按钮 2. 在"Debug"标签页配置: - Port: 选择"SW"（SWD模式）或"JTAG" - Max Clock: 设置时钟频率（如4MHz） - Reset: 选择复位方式（推荐"SYSRESETREQ"）

步骤4: 配置Flash下载 1. 切换到"Flash Download"标签页 2. 勾选"Reset and Run"（下载后自动运行） 3. 在"Programming Algorithm"中选择对应的Flash算法 4. 确认RAM和Flash地址范围正确

步骤5: 配置跟踪选项（可选） 1. 切换到"Trace"标签页 2. 启用"Trace Enable" 3. 配置ITM端口和SWO时钟频率 4. 用于printf调试和性能分析

3.3 在STM32CubeIDE中配置¶

步骤1: 创建调试配置 1. 点击菜单"Run" → "Debug Configurations..." 2. 双击"STM32 Cortex-M C/C++ Application"创建新配置 3. 配置名称会自动生成

步骤2: 配置Debugger选项 1. 切换到"Debugger"标签页 2. Debug probe: 选择"ST-LINK (ST-LINK GDB server)"或"J-Link" 3. Interface: 选择"SWD" 4. Frequency: 设置为"4000 kHz" 5. Reset Mode: 选择"Software system reset"

步骤3: 配置Startup选项 1. 切换到"Startup"标签页 2. 勾选"Load executable" 3. 勾选"Load symbols" 4. 设置断点选项（可选）

步骤4: 应用配置 1. 点击"Apply"保存配置 2. 点击"Debug"开始调试

3.4 在OpenOCD中配置¶

安装OpenOCD:

# Ubuntu/Debian
sudo apt-get install openocd

# macOS
brew install openocd

# Windows
# 下载预编译版本: https://gnutoolchains.com/arm-eabi/openocd/

创建配置文件:

创建openocd.cfg:

# 选择调试器接口
source [find interface/stlink.cfg]

# 或使用J-Link
# source [find interface/jlink.cfg]

# 选择目标芯片
source [find target/stm32f4x.cfg]

# 配置SWD模式
transport select swd

# 设置适配器速度
adapter speed 4000

# 复位配置
reset_config srst_only

# 启动GDB服务器
init
reset init

启动OpenOCD:

openocd -f openocd.cfg

预期输出:

Open On-Chip Debugger 0.11.0
Info : auto-selecting first available session transport "swd"
Info : clock speed 4000 kHz
Info : STLINK V2J37S7 (API v2) VID:PID 0483:3748
Info : Target voltage: 3.234000
Info : stm32f4x.cpu: hardware has 6 breakpoints, 4 watchpoints
Info : starting gdb server for stm32f4x.cpu on 3333

步骤4: 使用断点调试¶

4.1 理解断点类型¶

硬件断点 (Hardware Breakpoint): - 由芯片内部的FPB单元实现 - 数量有限（Cortex-M4通常有6个） - 可以在Flash中设置 - 不修改程序代码 - 执行速度不受影响

软件断点 (Software Breakpoint): - 通过替换指令实现（BKPT指令） - 数量不限 - 只能在RAM中设置 - 会修改程序代码 - 适合调试运行在RAM中的代码

数据断点 (Data Watchpoint): - 由DWT单元实现 - 监视内存访问（读/写） - 数量有限（通常4个） - 用于检测变量修改

4.2 设置和管理断点¶

在Keil MDK中设置断点:

方法1: 代码窗口 1. 在代码行号处单击，出现红色圆点 2. 再次单击取消断点 3. 右键点击断点可以设置条件

方法2: 使用快捷键 - F9: 在当前行设置/取消断点 - Ctrl+B: 打开断点管理窗口

方法3: 断点窗口 1. 点击菜单"View" → "Breakpoints" 2. 在断点窗口中管理所有断点 3. 可以启用/禁用/删除断点

设置条件断点: 1. 右键点击断点 2. 选择"Breakpoint Properties" 3. 在"Expression"中输入条件（如i == 10） 4. 只有条件满足时才会触发断点

设置计数断点: 1. 在断点属性中设置"Count" 2. 断点会在命中指定次数后触发 3. 用于循环调试

4.3 单步执行¶

单步执行命令:

命令	快捷键	功能	说明
Step Over	F10	逐过程执行	不进入函数内部
Step Into	F11	逐语句执行	进入函数内部
Step Out	Shift+F11	跳出函数	执行到函数返回
Run to Cursor	Ctrl+F10	运行到光标	临时断点

使用场景: - Step Over: 调试主流程，不关心函数内部实现 - Step Into: 深入函数内部查看执行细节 - Step Out: 快速跳出当前函数 - Run to Cursor: 快速执行到指定位置

示例调试流程:

int main(void) {
    int result = 0;

    // 在这里设置断点
    result = calculate(10, 20);  // F11进入函数

    if (result > 0) {            // F10跳过
        process_result(result);  // F11进入或F10跳过
    }

    while(1) {
        // 循环体
    }
}

4.4 断点调试技巧¶

技巧1: 使用临时断点 - 使用"Run to Cursor"快速执行到指定位置 - 避免设置过多永久断点

技巧2: 条件断点优化 - 在循环中使用条件断点，只在特定情况下停止 - 例如: i == 100 或 buffer[0] == 0xFF

技巧3: 断点组管理 - 将相关断点分组 - 可以批量启用/禁用断点组 - 适合调试不同模块

技巧4: 使用数据断点 - 监视关键变量的修改 - 快速定位变量被意外修改的位置 - 例如: 监视error_flag变量的写入

技巧5: 断点命令 - 在断点触发时自动执行命令 - 例如: 打印变量值、修改寄存器等 - 减少手动操作

常见问题:

问题1: 断点无法命中 - 检查代码是否被优化掉 - 降低优化级别（-O0或-O1） - 使用volatile关键字防止优化

问题2: 硬件断点不足 - 减少同时使用的断点数量 - 使用软件断点（在RAM中） - 使用条件断点减少断点数量

问题3: 断点位置不准确 - 确保调试信息完整（-g选项） - 检查代码和可执行文件是否匹配 - 重新编译项目

步骤5: 查看和修改变量¶

5.1 查看局部变量¶

在Keil MDK中: 1. 进入调试模式（Ctrl+F5） 2. 点击菜单"View" → "Watch Windows" → "Locals" 3. 局部变量窗口会自动显示当前函数的所有局部变量

变量显示格式: - 十进制: 默认显示 - 十六进制: 右键选择"Hexadecimal Display" - 二进制: 右键选择"Binary Display" - 字符: 对于char类型，显示ASCII字符

查看结构体和数组: - 点击变量前的"+"展开结构体成员 - 数组会显示所有元素 - 可以修改显示的数组元素数量

5.2 添加监视变量¶

Watch窗口: 1. 点击菜单"View" → "Watch Windows" → "Watch 1" 2. 在空白行输入变量名 3. 按Enter添加到监视列表

快速添加方法: - 在代码中选中变量名 - 右键选择"Add to Watch" - 变量会自动添加到Watch窗口

监视表达式: 除了变量名，还可以监视表达式:

// 简单表达式
i + j

// 数组元素
buffer[10]

// 结构体成员
sensor.temperature

// 指针解引用
*ptr

// 类型转换
(uint32_t)value

// 寄存器访问
*(uint32_t*)0x40020014  // GPIOD->ODR

5.3 修改变量值¶

在调试过程中修改变量: 1. 在Watch或Locals窗口中找到变量 2. 双击变量的值 3. 输入新值 4. 按Enter确认

修改场景: - 测试不同的输入值 - 跳过错误条件 - 模拟特定状态 - 验证算法逻辑

示例:

int main(void) {
    int count = 0;
    int threshold = 100;

    while(count < threshold) {  // 在这里设置断点
        count++;
        // 在调试时可以修改threshold的值
        // 例如改为10，快速测试循环结束逻辑
    }
}

5.4 查看内存内容¶

Memory窗口: 1. 点击菜单"View" → "Memory Windows" → "Memory 1" 2. 在地址栏输入内存地址 3. 查看内存内容

常用内存地址:

// Flash起始地址
0x08000000

// SRAM起始地址
0x20000000

// 外设寄存器基地址
0x40000000

// 查看变量地址
&variable_name

内存显示格式: - 右键选择显示格式（Hex、Decimal、Binary） - 可以选择字节宽度（8-bit、16-bit、32-bit） - 支持ASCII显示

修改内存内容: 1. 双击内存单元 2. 输入新值（十六进制） 3. 按Enter确认

应用场景: - 查看数组内容 - 检查缓冲区数据 - 验证Flash写入 - 调试DMA传输

5.5 查看寄存器¶

核心寄存器: 1. 点击菜单"View" → "Registers" → "Core Registers" 2. 查看ARM Cortex-M核心寄存器

核心寄存器说明:

寄存器	说明	用途
R0-R12	通用寄存器	存储临时数据
SP (R13)	栈指针	指向当前栈顶
LR (R14)	链接寄存器	存储返回地址
PC (R15)	程序计数器	指向下一条指令
xPSR	程序状态寄存器	存储标志位

外设寄存器: 1. 点击菜单"View" → "Peripheral Registers" 2. 展开外设（如GPIOD、TIM2等） 3. 查看和修改寄存器值

示例 - 查看GPIO寄存器:

GPIOD
├── MODER    : 0x00000000  (模式寄存器)
├── OTYPER   : 0x00000000  (输出类型寄存器)
├── OSPEEDR  : 0x00000000  (输出速度寄存器)
├── PUPDR    : 0x00000000  (上下拉寄存器)
├── IDR      : 0x00000000  (输入数据寄存器)
└── ODR      : 0x00000000  (输出数据寄存器)

修改寄存器值: 1. 双击寄存器值 2. 输入新值（十六进制） 3. 按Enter确认 4. 立即生效

调试技巧: - 通过修改GPIO ODR寄存器直接控制LED - 修改定时器寄存器改变PWM频率 - 清除中断标志位 - 测试外设配置

步骤6: 高级调试技巧¶

6.1 使用SWO进行printf调试¶

SWO (Serial Wire Output) 是SWD接口的可选输出通道，可以实现高速的printf调试输出，不占用UART资源。

配置SWO:

步骤1: 硬件连接 - 连接SWO引脚（PB3）到调试器的SWO引脚 - 确保调试器支持SWO（J-Link、ST-Link V2.1及以上）

步骤2: 在Keil MDK中配置 1. 打开"Options for Target" → "Debug" → "Settings" 2. 切换到"Trace"标签页 3. 勾选"Trace Enable" 4. 设置"Core Clock"为系统时钟频率（如168MHz） 5. 设置"Trace Port"为"Serial Wire Output" 6. 配置ITM端口（Port 0用于printf）

步骤3: 添加重定向代码

#include <stdio.h>

// 重定向fputc到ITM
int fputc(int ch, FILE *f) {
    // 等待ITM端口0可用
    while (ITM->PORT[0].u32 == 0);
    // 发送字符
    ITM->PORT[0].u8 = (uint8_t)ch;
    return ch;
}

// 初始化ITM
void ITM_Init(void) {
    // 使能TRCENA位
    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
    // 解锁ITM
    ITM->LAR = 0xC5ACCE55;
    // 使能ITM
    ITM->TCR = ITM_TCR_ITMENA_Msk;
    // 使能端口0
    ITM->TER = 0x1;
}

int main(void) {
    ITM_Init();

    printf("Hello from SWO!\n");
    printf("Counter: %d\n", 123);

    while(1) {
        // 主循环
    }
}

步骤4: 查看输出 1. 启动调试 2. 点击菜单"View" → "Serial Windows" → "Debug (printf) Viewer" 3. 查看printf输出

SWO优势: - 不占用UART资源 - 高速输出（最高几MB/s） - 不影响程序时序 - 支持多通道输出

6.2 实时变量监视¶

Live Watch功能:

在Keil MDK中，可以在程序运行时实时查看变量值，无需停止程序。

配置步骤: 1. 点击菜单"View" → "Watch Windows" → "Watch 1" 2. 添加要监视的变量 3. 右键选择"Live Update" 4. 运行程序，变量值会实时更新

应用场景: - 监视传感器数据 - 观察状态机状态 - 调试通信协议 - 性能监控

注意事项: - 实时监视会占用调试带宽 - 不要同时监视过多变量 - 某些优化可能影响实时监视

6.3 使用逻辑分析仪¶

Keil MDK内置逻辑分析仪:

可以图形化显示变量的波形，非常适合调试时序相关问题。

配置步骤: 1. 点击菜单"View" → "Analysis Windows" → "Logic Analyzer" 2. 点击"Setup"按钮 3. 添加要观察的变量 4. 设置显示范围和触发条件 5. 运行程序，观察波形

示例 - 观察GPIO状态:

volatile uint32_t gpio_state = 0;

void TIM2_IRQHandler(void) {
    if (TIM2->SR & TIM_SR_UIF) {
        TIM2->SR &= ~TIM_SR_UIF;

        // 切换GPIO状态
        GPIOD->ODR ^= GPIO_PIN_12;

        // 记录状态供逻辑分析仪显示
        gpio_state = (GPIOD->ODR & GPIO_PIN_12) ? 1 : 0;
    }
}

应用场景: - 调试PWM波形 - 分析通信时序 - 验证状态机转换 - 检测信号抖动

6.4 性能分析¶

使用DWT进行性能测量:

DWT (Data Watchpoint and Trace) 单元提供了周期计数器，可以精确测量代码执行时间。

代码示例:

// 使能DWT周期计数器
void DWT_Init(void) {
    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
    DWT->CYCCNT = 0;
    DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
}

// 测量函数执行时间
void measure_performance(void) {
    uint32_t start, end, cycles;

    // 记录开始时间
    start = DWT->CYCCNT;

    // 执行要测量的代码
    complex_function();

    // 记录结束时间
    end = DWT->CYCCNT;

    // 计算周期数
    cycles = end - start;

    // 计算执行时间（假设168MHz）
    float time_us = cycles / 168.0f;

    printf("Execution time: %.2f us (%lu cycles)\n", time_us, cycles);
}

Keil MDK性能分析器: 1. 点击菜单"View" → "Analysis Windows" → "Performance Analyzer" 2. 添加要分析的函数 3. 运行程序 4. 查看函数调用次数和执行时间

6.5 调试多线程程序¶

RTOS调试支持:

Keil MDK支持FreeRTOS、RTX等RTOS的调试。

查看任务列表: 1. 点击菜单"View" → "RTOS Windows" → "Task List" 2. 查看所有任务的状态、优先级、栈使用情况

任务状态: - Running: 正在运行 - Ready: 就绪状态 - Blocked: 阻塞状态 - Suspended: 挂起状态

调试技巧: - 在任务切换点设置断点 - 查看任务栈使用情况，防止栈溢出 - 监视信号量和队列状态 - 分析任务执行时间

示例 - FreeRTOS任务调试:

void vTask1(void *pvParameters) {
    while(1) {
        // 在这里设置断点
        printf("Task 1 running\n");
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

void vTask2(void *pvParameters) {
    while(1) {
        // 在这里设置断点
        printf("Task 2 running\n");
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

查看任务栈: 1. 在任务内设置断点 2. 查看"Call Stack"窗口 3. 可以看到任务的调用栈 4. 检查栈使用情况

故障排除¶

问题1: 无法连接到目标¶

现象:

Error: Could not connect to target
Error: No target connected

可能原因: 1. 硬件连接问题 2. 目标板未上电 3. 调试引脚被占用 4. 调试器驱动问题 5. 目标芯片处于低功耗模式

解决方法:

检查硬件连接: - 使用万用表测量VTref电压（应为3.3V） - 检查SWDIO、SWCLK、GND连接 - 确认没有短路或接触不良 - 尝试更换杜邦线或调试器

检查目标板: - 确认目标板已上电（LED指示灯亮） - 测量芯片VDD引脚电压 - 检查复位引脚是否被拉低 - 尝试手动复位目标板

检查调试引脚:

// 确保调试引脚未被重映射
// 在系统初始化时添加:
void SystemInit(void) {
    // 禁用JTAG，保留SWD
    AFIO->MAPR |= AFIO_MAPR_SWJ_CFG_JTAGDISABLE;

    // 或完全禁用调试（不推荐）
    // AFIO->MAPR |= AFIO_MAPR_SWJ_CFG_DISABLE;
}

降低调试速度: - 在调试器设置中降低时钟频率 - 尝试从4MHz降到1MHz或更低 - 某些情况下低速更稳定

使用Connect Under Reset: - 在调试器设置中启用"Connect Under Reset" - 调试器会在复位期间连接 - 适用于芯片进入低功耗模式的情况

问题2: 下载失败¶

现象:

Error: Flash Download failed
Error: Flash Erase failed
Error: Flash Verify failed

可能原因: 1. Flash被写保护 2. Flash已损坏 3. 电压不稳定 4. Flash算法不匹配

解决方法:

解除Flash保护:

使用ST-Link Utility: 1. 打开ST-Link Utility 2. 点击"Target" → "Option Bytes" 3. 取消"Read Out Protection" 4. 点击"Apply"

使用命令行:

# 使用OpenOCD解除保护
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg -c "init; reset halt; stm32f4x unlock 0; reset; exit"

检查Flash算法: - 在"Options for Target" → "Debug" → "Settings" → "Flash Download" - 确认选择了正确的Flash算法 - 检查地址范围是否正确

检查电源: - 测量VDD电压，应稳定在3.3V±10% - 检查电源纹波 - 尝试使用外部稳压电源

擦除整个Flash:

# 使用ST-Link Utility完全擦除
# Target → Erase Chip

# 或使用OpenOCD
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg -c "init; reset halt; flash erase_sector 0 0 last; reset; exit"

问题3: 断点无法命中¶

现象: - 设置断点后程序不停止 - 断点显示为灰色或带问号 - 程序跳过断点继续执行

可能原因: 1. 代码被优化 2. 硬件断点不足 3. 断点位置不正确 4. 调试信息缺失

解决方法:

降低优化级别:

// 在"Options for Target" → "C/C++"中
// 将Optimization改为"-O0"或"-O1"

// 或使用编译指令
#pragma GCC optimize ("O0")
void debug_function(void) {
    // 这个函数不会被优化
}

// 使用volatile防止变量被优化
volatile int debug_var = 0;

检查硬件断点数量: - Cortex-M4通常只有6个硬件断点 - 减少同时使用的断点数量 - 或使用软件断点（在RAM中）

确保调试信息完整: - 在"Options for Target" → "C/C++"中 - 确认勾选了"Debug Information" - 重新编译项目

检查代码是否执行:

// 添加LED指示或串口输出
void test_function(void) {
    GPIOD->ODR |= GPIO_PIN_12;  // 点亮LED
    printf("Function called\n");  // 串口输出

    // 在这里设置断点
    int result = calculate();
}

问题4: 变量值显示不正确¶

现象: - 变量显示为"" - 变量值与预期不符 - 无法查看某些变量

可能原因: 1. 变量被优化 2. 变量作用域问题 3. 编译器优化 4. 内存对齐问题

解决方法:

使用volatile关键字:

// 防止变量被优化
volatile int sensor_value = 0;
volatile uint8_t buffer[256];

// 对于调试变量
#ifdef DEBUG
    volatile int debug_counter = 0;
#endif

降低优化级别: - 在调试版本使用-O0或-O1 - 在发布版本使用-O2或-Os

检查变量作用域:

void function(void) {
    int local_var = 10;  // 只在函数内可见

    // 如果需要在外部查看，改为全局变量
}

// 或使用static全局变量
static int debug_var = 0;

使用内存窗口直接查看: - 如果变量显示不正确 - 使用Memory窗口查看变量地址 - 输入&variable_name查看实际内存内容

问题5: 程序运行异常¶

现象: - 程序进入HardFault - 程序卡死不响应 - 程序行为不符合预期

可能原因: 1. 栈溢出 2. 非法内存访问 3. 未初始化的指针 4. 中断配置错误

解决方法:

检查HardFault原因:

// HardFault处理函数
void HardFault_Handler(void) {
    // 读取故障状态寄存器
    uint32_t cfsr = SCB->CFSR;
    uint32_t hfsr = SCB->HFSR;
    uint32_t mmfar = SCB->MMFAR;
    uint32_t bfar = SCB->BFAR;

    // 在这里设置断点，查看寄存器值
    while(1) {
        __NOP();
    }
}

增加栈大小:

; 在启动文件中修改
Stack_Size      EQU     0x00001000  ; 增加到4KB

                AREA    STACK, NOINIT, READWRITE, ALIGN=3
Stack_Mem       SPACE   Stack_Size
__initial_sp

检查指针初始化:

// 错误示例
uint8_t *ptr;
*ptr = 0x55;  // 未初始化的指针

// 正确示例
uint8_t *ptr = NULL;
if (ptr != NULL) {
    *ptr = 0x55;
}

// 或分配内存
uint8_t *ptr = (uint8_t*)malloc(100);
if (ptr != NULL) {
    *ptr = 0x55;
    free(ptr);
}

使用断言检查:

#include <assert.h>

void process_data(uint8_t *data, uint32_t len) {
    assert(data != NULL);
    assert(len > 0 && len <= MAX_LEN);

    // 处理数据
}

进阶技巧¶

技巧1: 使用GDB进行命令行调试¶

启动GDB调试会话:

# 启动OpenOCD（在一个终端）
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

# 启动GDB（在另一个终端）
arm-none-eabi-gdb firmware.elf

# 连接到OpenOCD
(gdb) target extended-remote localhost:3333

# 加载程序
(gdb) load

# 复位并停止
(gdb) monitor reset halt

# 设置断点
(gdb) break main
(gdb) break file.c:123

# 运行
(gdb) continue

# 单步执行
(gdb) step      # 进入函数
(gdb) next      # 跳过函数
(gdb) finish    # 执行到函数返回

# 查看变量
(gdb) print variable_name
(gdb) print /x variable_name  # 十六进制显示
(gdb) print *ptr@10           # 显示数组前10个元素

# 查看内存
(gdb) x/10x 0x20000000        # 显示10个字（十六进制）
(gdb) x/10b 0x20000000        # 显示10个字节

# 查看寄存器
(gdb) info registers
(gdb) print $r0
(gdb) set $r0 = 0x1234

# 查看调用栈
(gdb) backtrace
(gdb) frame 1

# 查看反汇编
(gdb) disassemble main

GDB脚本自动化:

创建debug.gdb:

# 连接到目标
target extended-remote localhost:3333

# 加载程序
load

# 复位
monitor reset halt

# 设置断点
break main
break error_handler

# 启用SWO
monitor tpiu config internal /tmp/swo.log uart off 168000000

# 运行
continue

使用脚本:

arm-none-eabi-gdb -x debug.gdb firmware.elf

技巧2: 远程调试¶

通过网络进行远程调试:

服务器端（目标板）:

# 启动OpenOCD，监听所有网络接口
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg -c "bindto 0.0.0.0"

客户端（开发机）:

# 连接到远程OpenOCD
arm-none-eabi-gdb firmware.elf
(gdb) target extended-remote 192.168.1.100:3333

通过SSH隧道:

# 建立SSH隧道
ssh -L 3333:localhost:3333 user@remote-host

# 在本地连接
arm-none-eabi-gdb firmware.elf
(gdb) target extended-remote localhost:3333

技巧3: 使用脚本自动化调试¶

Python脚本控制GDB:

创建auto_debug.py:

import gdb

class AutoDebug(gdb.Command):
    def __init__(self):
        super(AutoDebug, self).__init__("auto_debug", gdb.COMMAND_USER)

    def invoke(self, arg, from_tty):
        # 连接到目标
        gdb.execute("target extended-remote localhost:3333")

        # 加载程序
        gdb.execute("load")

        # 设置断点
        gdb.execute("break main")

        # 运行
        gdb.execute("continue")

        # 自动收集信息
        while True:
            try:
                # 获取变量值
                value = gdb.parse_and_eval("sensor_value")
                print(f"Sensor value: {value}")

                # 继续执行
                gdb.execute("continue")
            except:
                break

AutoDebug()

使用脚本:

arm-none-eabi-gdb -x auto_debug.py firmware.elf
(gdb) auto_debug

技巧4: 使用条件编译进行调试¶

调试宏定义:

// 在编译选项中定义DEBUG宏
#ifdef DEBUG
    #define DEBUG_PRINT(fmt, ...) printf(fmt, ##__VA_ARGS__)
    #define DEBUG_ASSERT(x) assert(x)
    #define DEBUG_VAR(x) volatile x
#else
    #define DEBUG_PRINT(fmt, ...)
    #define DEBUG_ASSERT(x)
    #define DEBUG_VAR(x) x
#endif

// 使用示例
void process_data(uint8_t *data, uint32_t len) {
    DEBUG_ASSERT(data != NULL);
    DEBUG_PRINT("Processing %lu bytes\n", len);

    DEBUG_VAR(uint32_t debug_counter) = 0;

    for (uint32_t i = 0; i < len; i++) {
        // 处理数据
        DEBUG_VAR(debug_counter)++;
    }

    DEBUG_PRINT("Processed %lu items\n", debug_counter);
}

调试版本和发布版本:

// 调试版本配置
#ifdef DEBUG
    // 禁用优化
    #pragma GCC optimize ("O0")

    // 启用断言
    #define NDEBUG 0

    // 启用详细日志
    #define LOG_LEVEL LOG_DEBUG
#else
    // 发布版本配置
    #pragma GCC optimize ("O2")
    #define NDEBUG 1
    #define LOG_LEVEL LOG_ERROR
#endif

技巧5: 使用ETM进行指令跟踪¶

ETM (Embedded Trace Macrocell) 可以记录程序执行的每一条指令，用于复杂问题的分析。

注意: ETM需要专门的调试器支持（如J-Trace）。

配置ETM:

void ETM_Init(void) {
    // 使能TRCENA
    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;

    // 配置ETM
    // 具体配置取决于芯片型号
}

在Keil MDK中使用ETM: 1. 在"Options for Target" → "Debug" → "Settings" → "Trace" 2. 选择"Trace Port"为"ETM" 3. 配置ETM参数 4. 运行程序并记录跟踪数据 5. 分析跟踪结果

应用场景: - 分析程序执行流程 - 查找性能瓶颈 - 调试复杂的时序问题 - 代码覆盖率分析

总结¶

通过本教程，你已经学习了:

✅ JTAG和SWD调试接口的原理和区别
✅ 正确连接和配置调试器硬件
✅ 在不同IDE中配置调试环境
✅ 使用断点、单步执行等基本调试功能
✅ 查看和修改变量、内存、寄存器
✅ 使用SWO进行printf调试
✅ 高级调试技巧和性能分析
✅ 常见问题的排查和解决方法

关键要点: 1. SWD是ARM Cortex-M的首选调试接口，只需2根信号线 2. 正确的硬件连接是调试成功的基础 3. 断点是最常用的调试工具，要合理使用 4. 实时监视和逻辑分析仪适合调试时序问题 5. SWO提供了高效的printf调试方式 6. 了解常见问题的解决方法可以节省大量时间

下一步学习¶

建议继续学习以下内容:

初级进阶¶

GDB调试器基础使用 - 学习命令行调试
串口调试技巧大全 - 掌握串口调试方法
逻辑分析仪使用入门 - 学习信号分析

中级进阶¶

OpenOCD调试工具使用 - 开源调试方案
J-Link调试器高级功能 - 专业调试技术
内存泄漏检测与分析 - 内存调试

高级进阶¶

单元测试框架搭建 - 建立测试体系
硬件在环(HIL)测试系统 - 自动化测试

实践项目建议¶

项目1: LED调试练习¶

难度: ⭐ 目标: 使用JTAG/SWD调试简单的LED程序任务: - 设置断点观察程序执行 - 修改延时变量改变闪烁频率 - 使用逻辑分析仪观察GPIO波形 - 通过寄存器窗口直接控制LED

学习要点: - 基本调试操作 - 变量监视 - 寄存器操作 - 波形分析

项目2: 串口通信调试¶

难度: ⭐⭐ 目标: 调试UART通信程序任务: - 使用SWO输出调试信息 - 设置数据断点监视缓冲区 - 分析发送和接收时序 - 定位通信错误原因

学习要点: - SWO使用 - 数据断点 - 时序分析 - 问题定位

项目3: 中断调试实战¶

难度: ⭐⭐⭐ 目标: 调试复杂的中断程序任务: - 在中断服务函数中设置断点 - 观察中断嵌套情况 - 分析中断响应时间 - 优化中断处理性能

学习要点: - 中断调试技巧 - 性能分析 - 实时监视 - 代码优化

项目4: RTOS任务调试¶

难度: ⭐⭐⭐⭐ 目标: 调试多任务RTOS程序任务: - 查看任务列表和状态 - 分析任务切换过程 - 检测栈溢出问题 - 调试任务间通信

学习要点: - RTOS调试 - 任务管理 - 栈分析 - 同步机制

常见问题FAQ¶

Q1: JTAG和SWD可以同时使用吗？¶

A: 不可以同时使用，但可以在同一个引脚上切换： - STM32的PA13、PA14引脚复用JTAG和SWD - 通过配置寄存器选择使用哪种接口 - 默认情况下两种接口都可用 - 可以通过软件禁用JTAG保留SWD，释放PB3、PB4引脚

Q2: 为什么推荐使用SWD而不是JTAG？¶

A: SWD相比JTAG有以下优势： - 只需2根信号线，节省引脚 - 调试速度更快（最高50MHz） - 支持SWO串行输出 - 更适合引脚资源紧张的小封装芯片 - ARM官方推荐的调试接口

但JTAG也有优势： - 标准化接口，支持多种芯片 - 支持多设备菊花链连接 - 可以进行边界扫描测试

Q3: 调试时程序运行速度会变慢吗？¶

A: 会有一定影响，但通常可以忽略： - 设置断点时程序会停止 - 实时监视变量会占用调试带宽 - SWO输出会占用一定时间 - 单步执行时程序暂停

建议： - 不要同时监视过多变量 - 使用条件断点减少停止次数 - 关键时序代码不要设置断点 - 使用SWO代替串口输出

Q4: 如何选择调试器？¶

A: 根据需求和预算选择：

ST-Link: - 优点：价格便宜，STM32官方支持好 - 缺点：功能相对简单，速度较慢 - 适合：STM32开发，预算有限

J-Link: - 优点：功能强大，速度快，支持多种芯片 - 缺点：价格较高 - 适合：专业开发，多平台项目

CMSIS-DAP: - 优点：开源，价格便宜，跨平台 - 缺点：功能和性能一般 - 适合：学习和简单项目

Q5: 调试时如何保护Flash不被意外擦除？¶

A: 可以采取以下措施： 1. 启用Flash写保护 2. 在调试配置中禁用"Erase Full Chip" 3. 使用"Program"而不是"Erase and Program" 4. 备份重要数据到外部存储 5. 使用版本控制管理固件

Q6: 为什么有时候断点设置不上？¶

A: 可能的原因： 1. 硬件断点数量不足（Cortex-M4只有6个） 2. 代码被编译器优化掉了 3. 断点位置不是有效的指令地址 4. 调试信息不完整

解决方法： - 减少同时使用的断点数量 - 降低编译优化级别 - 使用volatile防止变量被优化 - 确保编译时包含调试信息（-g选项）

Q7: 如何调试启动代码和中断向量表？¶

A: 调试启动代码的方法： 1. 在调试器设置中启用"Connect Under Reset" 2. 在Reset_Handler设置断点 3. 使用"Run to main"跳过启动代码 4. 查看反汇编窗口观察启动过程

调试中断向量表： 1. 查看内存地址0x00000000（中断向量表） 2. 确认向量表地址正确 3. 检查VTOR寄存器（向量表偏移寄存器） 4. 在中断服务函数设置断点

Q8: 如何在调试时测量代码执行时间？¶

A: 有多种方法：

方法1: 使用DWT周期计数器

uint32_t start = DWT->CYCCNT;
function_to_measure();
uint32_t cycles = DWT->CYCCNT - start;

方法2: 使用GPIO翻转

GPIOD->ODR |= GPIO_PIN_12;  // 拉高
function_to_measure();
GPIOD->ODR &= ~GPIO_PIN_12; // 拉低
// 用示波器或逻辑分析仪测量

方法3: 使用Keil性能分析器 - 在"View" → "Analysis Windows" → "Performance Analyzer" - 自动统计函数执行时间

方法4: 使用SWO时间戳 - 配置ITM时间戳 - 分析SWO输出的时间信息

参考资料¶

官方文档¶

调试器文档¶

教程和文章¶

视频教程¶

工具下载¶

附录¶

附录A: 常用调试器对比¶

特性	ST-Link V2	ST-Link V3	J-Link BASE	J-Link PLUS	CMSIS-DAP
价格	¥50-100	¥200-300	¥400-600	¥2000-3000	¥50-150
最高速度	4MHz	24MHz	12MHz	50MHz	10MHz
SWO支持	有限	完整	完整	完整	有限
虚拟串口	是	是	是	是	可选
支持芯片	STM32	STM32	多种	多种	多种
Flash下载	快	很快	快	很快	中等
RTT支持	否	否	是	是	否
跟踪功能	否	否	否	是	否

附录B: SWD信号时序¶

SWD读操作时序:

SWCLK:  ___/‾‾‾\___/‾‾‾\___/‾‾‾\___/‾‾‾\___
SWDIO:  START|APnDP|R/W|ADDR[2:3]|PARITY|STOP|PARK|ACK|DATA[0:31]|PARITY

SWD写操作时序:

SWCLK:  ___/‾‾‾\___/‾‾‾\___/‾‾‾\___/‾‾‾\___
SWDIO:  START|APnDP|R/W|ADDR[2:3]|PARITY|STOP|PARK|ACK|DATA[0:31]|PARITY

附录C: 调试寄存器地址¶

Cortex-M4调试组件基地址:

组件	基地址	说明
ITM	0xE0000000	仪器跟踪宏单元
DWT	0xE0001000	数据观察点和跟踪
FPB	0xE0002000	Flash断点单元
SCS	0xE000E000	系统控制空间
TPIU	0xE0040000	跟踪端口接口单元
ETM	0xE0041000	嵌入式跟踪宏单元

重要寄存器:

// DWT周期计数器
#define DWT_CYCCNT  (*(volatile uint32_t*)0xE0001004)

// ITM端口0
#define ITM_PORT0   (*(volatile uint32_t*)0xE0000000)

// 调试异常和监视控制寄存器
#define DEMCR       (*(volatile uint32_t*)0xE000EDFC)

附录D: 故障排除检查清单¶

硬件连接检查: - [ ] VTref电压正常（3.3V） - [ ] SWDIO、SWCLK连接正确 - [ ] GND可靠连接 - [ ] 没有短路或接触不良 - [ ] 目标板正常上电 - [ ] 调试器USB连接正常

软件配置检查: - [ ] 调试器驱动已安装 - [ ] IDE中选择了正确的调试器 - [ ] 调试接口配置为SWD - [ ] 时钟频率设置合理 - [ ] Flash算法选择正确 - [ ] 调试信息已包含（-g选项）

调试问题检查: - [ ] 断点数量未超过限制 - [ ] 优化级别不会影响调试 - [ ] 变量未被优化掉 - [ ] 代码和可执行文件匹配 - [ ] 调试引脚未被占用 - [ ] Flash未被写保护

反馈与支持: - 如果你在学习过程中遇到问题，欢迎在评论区留言 - 发现文档错误或有改进建议，请提交Issue - 想要分享你的调试经验，欢迎投稿

版本历史: - v1.0 (2024-01-15): 初始版本发布

许可证: 本文档采用 CC BY-SA 4.0 许可协议

JTAG/SWD调试接口使用完全指南¶

学习目标¶

前置要求¶

准备工作¶

硬件准备¶

软件准备¶

系统要求¶

步骤1: 理解JTAG和SWD接口¶

1.1 什么是JTAG？¶

1.2 什么是SWD？¶

1.3 JTAG vs SWD 对比¶

1.4 调试接口工作原理¶

步骤2: 硬件连接配置¶

2.1 识别调试接口引脚¶

2.2 标准调试接口定义¶

2.3 连接调试器¶

2.4 验证硬件连接¶

步骤3: 配置调试环境¶

3.1 安装调试器驱动¶

3.2 在Keil MDK中配置¶

3.3 在STM32CubeIDE中配置¶

3.4 在OpenOCD中配置¶

步骤4: 使用断点调试¶

4.1 理解断点类型¶

4.2 设置和管理断点¶

4.3 单步执行¶

4.4 断点调试技巧¶

步骤5: 查看和修改变量¶

5.1 查看局部变量¶

5.2 添加监视变量¶

5.3 修改变量值¶

5.4 查看内存内容¶

5.5 查看寄存器¶

步骤6: 高级调试技巧¶

6.1 使用SWO进行printf调试¶

6.2 实时变量监视¶

6.3 使用逻辑分析仪¶

6.4 性能分析¶

6.5 调试多线程程序¶

故障排除¶

问题1: 无法连接到目标¶

问题2: 下载失败¶

问题3: 断点无法命中¶

问题4: 变量值显示不正确¶

问题5: 程序运行异常¶

进阶技巧¶

技巧1: 使用GDB进行命令行调试¶

技巧2: 远程调试¶

技巧3: 使用脚本自动化调试¶

技巧4: 使用条件编译进行调试¶

技巧5: 使用ETM进行指令跟踪¶

总结¶

下一步学习¶

初级进阶¶

中级进阶¶

高级进阶¶

实践项目建议¶

项目1: LED调试练习¶

项目2: 串口通信调试¶

项目3: 中断调试实战¶

项目4: RTOS任务调试¶

常见问题FAQ¶

Q1: JTAG和SWD可以同时使用吗？¶

Q2: 为什么推荐使用SWD而不是JTAG？¶

Q3: 调试时程序运行速度会变慢吗？¶

Q4: 如何选择调试器？¶

Q5: 调试时如何保护Flash不被意外擦除？¶

Q6: 为什么有时候断点设置不上？¶

Q7: 如何调试启动代码和中断向量表？¶

Q8: 如何在调试时测量代码执行时间？¶

参考资料¶

官方文档¶

调试器文档¶

教程和文章¶

视频教程¶

工具下载¶

推荐书籍¶

附录¶

附录A: 常用调试器对比¶

附录B: SWD信号时序¶