单片机与物联网 / 系统课时

布置 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 等连接器,应直接使用对应标准或调试器官方适配器的实际引脚定义,不要套用上述自定义顺序。对于未使用的标准针脚,也必须遵循接口规范处理。

MCU SWD 五信号连接与自定义排针方向示意

PCB 上至少在 1 脚附近放置明显的三角形或数字 1 丝印,并在有空间时标出 3V3、DIO、CLK、GND、RST。注意连接器数据手册可能从插合面或焊接面定义针脚视角,必须与 PCB 封装的顶视图进行核对。

处理调试引脚与外围电路

SWDIO 和 SWCLK 应优先保持为调试专用信号。对于 STM32F103,在复位后的默认调试配置下,PA13、PA14 承担 SWD 功能;如果应用程序重新配置相关引脚或关闭调试功能,后续可能出现运行后无法连接的问题。

建议采用以下原理图和布局约束:

  1. SWDIO、SWCLK 从 MCU 引脚连接到调试接口,尽量保持短且直接,避免与继电器线圈、开关电源节点或大电流回路并行长距离走线。
  2. MCU 与接插件之间保持连续接地回流路径,接插件 GND 必须可靠连接到目标板地网络。
  3. SWDIO 和 SWCLK 通常不需要额外强上拉、强下拉;如预留串联阻尼电阻位置,可在靠近 MCU 端设置 0 Ω 默认装配位,并根据实际波形调试。不要未经验证就加入大电容滤波。
  4. NRST 按 MCU 官方推荐复位电路设计。对于 STM32F103,可参考典型 10 kΩ 上拉至 3.3 V、100 nF 到地的外部复位网络,但须结合芯片手册、板上其他复位源和目标调试器的复位方式确认。
  5. 不要把 SWDIO、SWCLK 同时直接连接到可能主动驱动相反电平的外设。如果确实必须复用,应保证复位和调试连接阶段不存在总线冲突。

对于普通几厘米以内的样板连接,可先从 100 kHz~1 MHz 的 SWD 时钟开始调试,再根据调试器、MCU、线缆与信号质量逐步提高。这里的频率是初始调试建议,不是 SWD 协议的统一最高速率。

在 PCB 中检查网络和封装

原理图连线正确并不意味着 PCB 连接器一定可用。封装镜像、丝印误导、走线遗漏和地网络错误,都可能使调试器无法识别目标芯片。

以 KiCad 9 为例,可以按照以下步骤完成核验;其他 EDA 软件使用对应的 ERC、DRC 和网络高亮功能即可。

  1. 在原理图编辑器执行 Inspect → Electrical Rules Checker,检查供电网络、引脚类型和未连接项。
  2. 执行 Tools → Update PCB from Schematic,将连接关系同步到 PCB。
  3. 在 PCB 编辑器使用 Inspect → Design Rules Checker,检查未布线网络、间距及焊盘连接问题。
  4. 使用 Highlight Net 分别选中 SWDIO、SWCLK、NRST、3V3 和 GND,确认信号实际连到预定焊盘。
  5. 切换到 PCB 顶层视图,核对排针 1 脚、方形焊盘、丝印方向与实际插头插合方向。
  6. 打开 3D Viewer 检查调试插头周围的元件干涉,并根据实物插头尺寸复核插拔空间。

重点核对 SWDIO 与 SWCLK 有没有交叉接反、VTref 是否误接到未经过稳压的电源输入、NRST 是否被其他电路持续拉低。DRC 通常不能识别调试接口的逻辑引脚定义错误,因此还需要将 PCB 焊盘编号逐项与调试器线束引脚表对照。

通电验证下载与调试链路

建议首次调试使用限流电源为目标板供电,并用万用表先确认电压,再连接调试器。不要以调试软件是否报错作为唯一电气检查手段。

  1. 断电检查 VTref 与 GND 之间是否存在异常低阻,确认相邻排针没有焊锡短路。
  2. 接入限流电源,测量 MCU VDD 与 GND,3.3 V 系统应落在芯片数据手册规定的工作范围内,不能只凭标称值判断。
  3. 测量调试接插件 VTref 与 GND,确认实际检测电压与 MCU I/O 供电域匹配。
  4. 正确接入 SWDIO、SWCLK、GND、VTref 和可选 nRESET,在调试软件中选择 SWD 接口,并以较低时钟连接。
  5. 读取设备标识或芯片信息,下载最小测试固件,再设置断点并尝试单步执行。

使用 STM32CubeProgrammer 时,可以在 ST-LINK 连接选项中选择 SWD;正常连接后,软件能够显示识别到的目标设备信息。具体字段随芯片和软件版本变化,不应将某个 Device ID 数值当作所有 STM32 的固定结果。

本课还可以使用 OpenOCD 进行命令行连接验证。以下示例适用于已安装 OpenOCD、使用 ST-LINK 且目标为 STM32F103 的环境;其余调试器和 MCU 需替换对应配置文件。

bash
openocd -f interface/stlink.cfg -f target/stm32f1x.cfg -c "adapter speed 1000; init; targets; shutdown"

预期结果:OpenOCD 成功初始化调试接口,并输出目标设备信息和目标状态,随后正常退出。以下仅展示典型关键日志形式,实际内容会随 OpenOCD 版本、硬件及目标运行状态变化。

text
Info : ...
Info : ... target ...
... stm32f1x.cpu ...
shutdown command invoked

示例中的 1000 表示请求设置适配器时钟为 1000 kHz,实际支持程度取决于调试器。日志中的省略号仅用于说明输出结构,并非完整原始日志。

如果出现无法识别目标,应按电源、GND、VTref、SWDIO/SWCLK 顺序检查,再尝试降低时钟。对于程序重新配置调试引脚、进入低功耗状态或持续复位的情况,可以在调试器支持时尝试 Connect under Reset,并确保 nRESET 已正确连接。

验收的最低标准是:连续断电重启后能可靠识别目标、完成固件下载、复位启动并命中断点。只有下载成功却不能调试时,还应检查固件是否禁用 SWD、调试符号是否匹配,以及目标是否在连接后立即进入低功耗或复位循环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

布置 SWD 下载与调试接口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通