单片机与物联网 / 系统课时
布置 SWD 下载与调试接口
布置 SWD 下载与调试接口
本课以支持 ARM SWD 的 3.3 V 单片机最小系统为例,完成从 MCU 调试引脚到板载连接器的布线设计。你将确定必需信号、处理复位与引脚复用、检查接插件方向,并通过上电测量和调试器连接验证接口是否可用,避免样板焊好后无法烧录或单步调试。
学习目标
- 正确连接 SWDIO、SWCLK、GND、目标参考电压 VTref 和可选 nRESET。
- 识别调试接口的引脚复用、电平、走线和连接器方向问题。
- 按上电前检查、供电测量、设备识别和固件下载的顺序完成验收。
确定 SWD 信号与连接方式
SWD(Serial Wire Debug)是 ARM Cortex-M 系列常用的两线调试接口,主要使用 SWDIO 传输双向数据、SWCLK 提供时钟。除此之外,调试器通常还需要目标参考电压和公共地;复位引脚则用于提高异常固件情况下的连接成功率。
以 STM32F103C8T6 为例,使用默认调试功能时可按下表连接。其他 MCU 必须根据实际型号的数据手册核对引脚及复用功能,不能直接照搬 STM32 的管脚号。
| 信号 | STM32F103C8T6 引脚 | 连接目的 | 设计要求 |
|---|---|---|---|
| SWDIO | PA13 | 双向调试数据 | 接调试器 SWDIO |
| SWCLK | PA14 | 调试时钟 | 接调试器 SWCLK |
| GND | VSS 所在地网络 | 信号回流与电平基准 | 与调试器 GND 共地 |
| VTref | 板上 3.3 V 数字电源 | 检测目标板 I/O 电平 | 接调试器目标电压检测端 |
| nRESET | NRST | 外部复位目标 MCU | 推荐引出,视调试器能力使用 |
这里的 VTref 是目标电平参考信号,不等于调试器必然给目标板供电。采用外部 3.3 V 供电时,通常把板上 MCU 的 VDD 电源网络引到 VTref;不要将调试器的 5 V 供电输出直接连接到 3.3 V MCU 电源网络。
选择接插件并明确引脚方向
开发样板可以采用 2.54 mm 单排排针,也可以使用带防呆结构的标准调试连接器。单排排针成本低,但插反和错位的风险较高;需要频繁测试或量产维护时,优先考虑有明确定位结构的连接器。
例如使用自定义 1×5 排针,可以在原理图和 PCB 上统一定义以下针脚,不应将此顺序误认为任何调试器的通用标准。
| 自定义排针编号 | 信号 |
|---|---|
| 1 | VTref |
| 2 | SWDIO |
| 3 | SWCLK |
| 4 | GND |
| 5 | nRESET |
如果采用标准 ARM Cortex Debug 10-pin、STDC14 等连接器,应直接使用对应标准或调试器官方适配器的实际引脚定义,不要套用上述自定义顺序。对于未使用的标准针脚,也必须遵循接口规范处理。

PCB 上至少在 1 脚附近放置明显的三角形或数字 1 丝印,并在有空间时标出 3V3、DIO、CLK、GND、RST。注意连接器数据手册可能从插合面或焊接面定义针脚视角,必须与 PCB 封装的顶视图进行核对。
处理调试引脚与外围电路
SWDIO 和 SWCLK 应优先保持为调试专用信号。对于 STM32F103,在复位后的默认调试配置下,PA13、PA14 承担 SWD 功能;如果应用程序重新配置相关引脚或关闭调试功能,后续可能出现运行后无法连接的问题。
建议采用以下原理图和布局约束:
- SWDIO、SWCLK 从 MCU 引脚连接到调试接口,尽量保持短且直接,避免与继电器线圈、开关电源节点或大电流回路并行长距离走线。
- MCU 与接插件之间保持连续接地回流路径,接插件 GND 必须可靠连接到目标板地网络。
- SWDIO 和 SWCLK 通常不需要额外强上拉、强下拉;如预留串联阻尼电阻位置,可在靠近 MCU 端设置 0 Ω 默认装配位,并根据实际波形调试。不要未经验证就加入大电容滤波。
- NRST 按 MCU 官方推荐复位电路设计。对于 STM32F103,可参考典型 10 kΩ 上拉至 3.3 V、100 nF 到地的外部复位网络,但须结合芯片手册、板上其他复位源和目标调试器的复位方式确认。
- 不要把 SWDIO、SWCLK 同时直接连接到可能主动驱动相反电平的外设。如果确实必须复用,应保证复位和调试连接阶段不存在总线冲突。
对于普通几厘米以内的样板连接,可先从 100 kHz~1 MHz 的 SWD 时钟开始调试,再根据调试器、MCU、线缆与信号质量逐步提高。这里的频率是初始调试建议,不是 SWD 协议的统一最高速率。
在 PCB 中检查网络和封装
原理图连线正确并不意味着 PCB 连接器一定可用。封装镜像、丝印误导、走线遗漏和地网络错误,都可能使调试器无法识别目标芯片。
以 KiCad 9 为例,可以按照以下步骤完成核验;其他 EDA 软件使用对应的 ERC、DRC 和网络高亮功能即可。
- 在原理图编辑器执行 Inspect → Electrical Rules Checker,检查供电网络、引脚类型和未连接项。
- 执行 Tools → Update PCB from Schematic,将连接关系同步到 PCB。
- 在 PCB 编辑器使用 Inspect → Design Rules Checker,检查未布线网络、间距及焊盘连接问题。
- 使用 Highlight Net 分别选中 SWDIO、SWCLK、NRST、3V3 和 GND,确认信号实际连到预定焊盘。
- 切换到 PCB 顶层视图,核对排针 1 脚、方形焊盘、丝印方向与实际插头插合方向。
- 打开 3D Viewer 检查调试插头周围的元件干涉,并根据实物插头尺寸复核插拔空间。
重点核对 SWDIO 与 SWCLK 有没有交叉接反、VTref 是否误接到未经过稳压的电源输入、NRST 是否被其他电路持续拉低。DRC 通常不能识别调试接口的逻辑引脚定义错误,因此还需要将 PCB 焊盘编号逐项与调试器线束引脚表对照。
通电验证下载与调试链路
建议首次调试使用限流电源为目标板供电,并用万用表先确认电压,再连接调试器。不要以调试软件是否报错作为唯一电气检查手段。
- 断电检查 VTref 与 GND 之间是否存在异常低阻,确认相邻排针没有焊锡短路。
- 接入限流电源,测量 MCU VDD 与 GND,3.3 V 系统应落在芯片数据手册规定的工作范围内,不能只凭标称值判断。
- 测量调试接插件 VTref 与 GND,确认实际检测电压与 MCU I/O 供电域匹配。
- 正确接入 SWDIO、SWCLK、GND、VTref 和可选 nRESET,在调试软件中选择 SWD 接口,并以较低时钟连接。
- 读取设备标识或芯片信息,下载最小测试固件,再设置断点并尝试单步执行。
使用 STM32CubeProgrammer 时,可以在 ST-LINK 连接选项中选择 SWD;正常连接后,软件能够显示识别到的目标设备信息。具体字段随芯片和软件版本变化,不应将某个 Device ID 数值当作所有 STM32 的固定结果。
本课还可以使用 OpenOCD 进行命令行连接验证。以下示例适用于已安装 OpenOCD、使用 ST-LINK 且目标为 STM32F103 的环境;其余调试器和 MCU 需替换对应配置文件。
openocd -f interface/stlink.cfg -f target/stm32f1x.cfg -c "adapter speed 1000; init; targets; shutdown"预期结果:OpenOCD 成功初始化调试接口,并输出目标设备信息和目标状态,随后正常退出。以下仅展示典型关键日志形式,实际内容会随 OpenOCD 版本、硬件及目标运行状态变化。
Info : ...
Info : ... target ...
... stm32f1x.cpu ...
shutdown command invoked示例中的 1000 表示请求设置适配器时钟为 1000 kHz,实际支持程度取决于调试器。日志中的省略号仅用于说明输出结构,并非完整原始日志。
如果出现无法识别目标,应按电源、GND、VTref、SWDIO/SWCLK 顺序检查,再尝试降低时钟。对于程序重新配置调试引脚、进入低功耗状态或持续复位的情况,可以在调试器支持时尝试 Connect under Reset,并确保 nRESET 已正确连接。
验收的最低标准是:连续断电重启后能可靠识别目标、完成固件下载、复位启动并命中断点。只有下载成功却不能调试时,还应检查固件是否禁用 SWD、调试符号是否匹配,以及目标是否在连接后立即进入低功耗或复位循环。