Nucleo板载ST-LINK妙用：SWD接线调试外部STM32芯片

手里只剩一块Nucleo-U083RC开发板，外置ST-LINK又被同事借走，可此刻真正要调的是另一颗还没上板的STM32G030F6P6。大多数人会把Nucleo板当成"一块能跑示例的板子"，但它最值钱的部分未必是板载那颗MCU，而是左上角那套独立的ST-LINK调试器。这个方案说来不复杂：把板载ST-LINK的SWD信号引出来，就能给任意一颗支持SWD协议的MCU烧录和调试。接下来我把从硬件改造到软件配置的完整过程，以及踩过的几个坑逐一拆开讲。

1. 一块Nucleo开发板，不只是开发板

1.1 板载ST-LINK的"隐藏身份"

Nucleo板上那颗ST-LINK，硬件上是一个完全独立的子系统。它的输入是USB口，输出是SWDIO、SWCLK、GND、VCC四根信号线，再通过板子内部走线连到板载目标MCU的SWD引脚上。也就是说，这块板上其实有两颗MCU：一颗是左边负责调试的ST-LINK专用MCU，另一颗是右边用户手上的目标MCU（U083RC本身）。二者之间只隔着几根信号线。

这套架构的本质是：ST-LINK是一台"支持SWD协议的任意MCU通用烧录器"，它根本不关心对面接的是板载那颗U083RC，还是用户自己画的一颗G030。只要SWD协议一致、电平匹配、共地正常，它都能工作。所以我们要做的，只是改变SWD信号的出口方向。

1.2 CN2跳线帽：整个方案的关键入口

在Nucleo-64这类板子上，ST-LINK和板载MCU之间有一组跳线帽，通常标着CN2。这个跳线帽横跨在SWD信号路径上，默认插着两个小帽子，把ST-LINK的SWDIO和SWCLK分别连通到板载MCU的对应引脚。

这个设计原本的意图是：当你不想用板载调试器、改用外部调试器时，拔掉CN2跳线帽，就可以把板载MCU的SWD信号从ST-LINK侧完全隔离出来；又或者你正在做低功耗电流测量，不希望ST-LINK通过SWD走线漏电流给目标MCU。但反过来利用一下，这个跳线帽恰好成了我们"借用调试器"的物理分界点：拔掉它，ST-LINK这侧的信号就空出来了，可以把SWDIO和SWCLK引到外部任意MCU上。

我一开始以为必须动烙铁才能把这个信号引出来，后来发现不需要。拔掉跳线帽之后，CN2还有四个焊盘裸露在那里，ST-LINK侧的SWDIO和SWCLK信号就在其中两个焊盘上，用杜邦线或者直接焊两根飞线，就能把调试信号带到板子外面。

1.3 这个方案适合谁，能解决什么问题

这招最适合两类场景。一类是我这种手头调试器紧张的情况，一块Nucleo板不仅是一块评估板，还是一个救急的独立SWD烧录器。另一类是你手里有多个不同型号的MCU项目在并行开发，每个项目都买一个独立ST-LINK显然是浪费，而Nucleo板几乎是开发桌上最不缺的东西，拿它顶一下绰绰有余。

当然，这个方案也能覆盖更极客的玩法，比如用它去调试一块完全没有板载调试电路的裸芯片系统，或者临时给一颗刚焊好的芯片做板级验证。从成本和可实现性来看，这比多买一个ST-LINK要划算得多。

2. SWD接线里最容易出错的三个细节

2.1 四根线的连接与VCC的争议

SWD接口最基础的连接是四根线：SWDIO、SWCLK、GND、VCC。网上的资料对VCC接不接争论不小，有人说只接三根线也能烧录，有人说必须接。根据我的实际测试，三根线（SWDIO、SWCLK、GND）在很多情况下确实能连上，但如果外部目标MCU是独立供电，调试器无法测量目标电平，STM32CubeProgrammer经常在连接阶段就报target voltage错误，或者出现"no target connected"这类奇怪问题。

我的建议很直接：把VCC也接上，而且接的是外部目标MCU的电源轨，不是板载ST-LINK的3.3V输出。这么做是为了让ST-LINK通过VCC引脚感知目标芯片的电压水平，从而正确匹配SWD信号电平。至于给目标板供电，用外部目标自己的电源即可，甚至可以不从Nucleo板取电。

下表是我在调试外部MCU时实际采用的接线关系，可以直接照着接。

2.2 电压匹配和供电电流限制

电压匹配是新手最容易炸板的地方。SWD信号不是隔离的，ST-LINK侧输出的逻辑电平需要和目标MCU的电源电压兼容。目标板是3.3V供电，那基本没有风险，VCC接3.3V、信号电平3.3V，一路畅通。如果目标板是5V系统，就要谨慎了，虽然很多ST-LINK变体支持5V目标，但板载ST-LINK的调试接口不一定电平兼容，而且VCC检测方向一旦接错，轻则连不上，重则烧毁调试器。针对5V目标，比较稳妥的做法是目标板自己供电，SWDIO/SWCLK之间加电平转换，VCC脚只做检测不供电。

关于供电电流还有一个经常被忽略的点：Nucleo板载ST-LINK不是一个大功率电源，它通过USB取电，输出能力非常有限。如果你的外部目标板上有数码管、液晶屏、电机驱动这类功耗较高的外设，千万不要指望用板载ST-LINK的3.3V去带。老老实实让目标板自己供电，调试器只做信号连接，互不干扰。

2.3 目标MCU的启动模式与复位状态

接线完成后还有个容易被忽略的坑：目标芯片当前处于什么启动模式。STM32系列通常有BOOT0引脚，有的芯片还有BOOT1。如果BOOT0被拉高，芯片复位后会进入系统引导程序，而不是从用户Flash启动。这时候烧录本身通常不会失败，但烧完一复位，程序不跑，很多人第一反应是"烧录出错了"，其实芯片停在系统BootLoader里。

另外，如果目标芯片已经进入了低功耗模式，比如STOP或STANDBY，SWD连接也可能失败。因为核心时钟可能在停止状态，调试接口无法响应。这种情况下最好的办法是接上NRST线，在连接时按住目标复位键，让芯片在复位状态下建立调试会话。这个操作在STM32CubeProgrammer里叫Connect Under Reset，后面我会专门讲。

3. 硬件改造与接线实操：从跳线帽到焊点

3.1 拔跳线帽之前，先做两件事

第一件事是断电，把USB线拔下来再操作，避免在带电状态下碰触焊盘或插拔跳线，防止短路把ST-LINK烧了。第二件事是拍照，把CN2跳线帽的原始位置拍下来，尤其是你手上有好几块不同型号Nucleo板的时候，不同板子的跳线定义可能不完全一样，留个底方便还原。

接下来就是拔跳线帽。Nucleo-64板子上的CN2通常位于板子左侧中段，靠近ST-LINK区域，是一组2x2的排针，上面插着两个黑色的小跳线帽。处理方式是用镊子轻轻夹住跳线帽两端，垂直往上拔，不要太用力左右晃，否则容易把排针本体晃歪。

3.2 把SWD信号引出来的三种方式

拔掉跳线帽之后，CN2下面空出来四个焊盘。其中两个信号来自ST-LINK侧，另外两个是通往板载目标MCU侧的。要找到哪边是ST-LINK侧，可以打开Nucleo-U083RC的原理图，搜SWDIO这个网络名，看它从ST-LINK MCU出来后去了哪个焊盘。一般来说，四个焊盘中靠近ST-LINK芯片一侧的两个就是ST-LINK直出信号。

具体的引线方式有三种，按动手难度从低到高排列：

• 直接用2.54mm间距的排针插入CN2的焊盘孔，再从排针上飞线出去。这一招最简单，不需要焊接，但是要注意CN2焊盘孔的间距刚好是标准排针间距，插进去后要确保方向正确。
• 用尖头烙铁在CN2背面焊盘上直接焊两根细飞线。这个最稳，接触可靠，缺点是焊完以后如果想要恢复原状，得把飞线拆掉。
• 把跳线帽换成一根短的杜邦线母对母，一头插在ST-LINK侧焊盘上，另一头直接连到目标板。这只能算是应急方案，固定性比较差，手一抖就松了。

我实测下来，最推荐第二种，焊飞线。焊的时候烙铁温度设在320度左右，先给焊盘上一点锡，再把飞线头镀锡，快速贴上焊盘，一两秒就完成。焊接完成后用万用表蜂鸣档确认ST-LINK侧焊盘和飞线另一端是导通的，这一步非常关键，能排除虚焊问题。

3.3 检查连通性，不用急着上电

飞线焊好后别急着插USB或者接目标板。先把万用表调到蜂鸣档，确认以下三件事：飞线到目标板SWDIO之间是通的，飞线到目标板SWCLK之间是通的，目标板GND和Nucleo板GND之间是通的。

这三项检查的目的是把"硬件接线问题"和"软件配置问题"隔离开，后面排错时能省一半时间。我在第一次做这个方案时，跳过了连通性检查，结果接上目标板后CubeProgrammer一直报连接失败，排查了大半天才发现是飞线焊点虚焊，焊盘上那一小坨锡看起来连上了，实际内部是断的。

3.4 不同Nucleo板型的差异

Nucleo-64的CN2跳线帽很好认，但Nucleo-32板子（比如L432KC）的跳线位置和命名不一样，Nucleo-144板子又可能有其他辅助跳线。所以拿到一块不熟悉的Nucleo板，第一件事永远是去ST官网下载对应的手册和原理图，找到ST-LINK和目标MCU之间的跳线网络名，再动手。

这些差异化的板子，核心原理是完全一致的：ST-LINK的信号线上会有一个可断开的跳线点，找到它，断开它，从ST-LINK侧取信号，接到外部目标。剩下的都是工程细节。

4. 软件配置与第一次外接烧录

4.1 驱动和工具准备

硬件接好之后，第一次上电前建议先装好ST-LINK的USB驱动。新版Windows系统大多能自动识别，但严谨起见，还是建议下载ST官方驱动安装包（STSW-LINK009），手动安装一遍。装好后插上Nucleo板USB口，打开设备管理器，能看到一个ST-LINK相关的调试接口设备，有时候还会附带一个COM口设备，那是虚拟串口，后面章节会用到。

烧录工具我用的是STM32CubeProgrammer，这个工具已经取代了老一代的STM32 ST-LINK Utility，界面更清晰，还支持命令行操作。如果你电脑上还留着老旧的ST-LINK Utility，它其实也能完成类似的工作，但新项目建议直接用CubeProgrammer，命令行脚本扩展性更好。

4.2 CubeProgrammer连接配置

打开STM32CubeProgrammer，进入右侧的ST-LINK配置区域，主要有两个选项要设置：

• 接口选择：选SWD，不要选JTAG，因为我们的外部目标板通常只引出了SWD四根线。
• 连接模式：选HOT PLUG模式。这个模式下调试器不会主动对目标进行复位和供电等待，非常适合调试外部独立供电的目标板。

配置好后，点右上角的Connect按钮。正常情况下，下面log区域会出现连接信息，显示目标芯片的Device ID、Flash大小、Target voltage电压值。如果Target voltage能读到一个大概3.3V左右的电压，说明VCC检测线路正常；如果显示0V或者N/A，就要怀疑VCC没接好或者目标板没上电。

4.3 实际烧录一个程序到外部MCU

我这里用一个真实的例子来演示。目标板是一颗STM32G030F6P6，独立3.3V供电，SWD四根线从Nucleo-U083RC的CN2焊盘引出，按前面表格接好。

连接成功后，我打开编译生成的Blinky程序hex文件，点击Download按钮。CubeProgrammer会自动擦除目标Flash，写入新程序，最后校验。这个过程非常快，十几秒就完成了。烧完后给目标板重新上电，LED正常闪烁，说明程序已经跑起来了。

烧录过程中有一个细节值得注意：目标板上的Flash起始地址。STM32 G0系列的Flash起始地址是0x08000000，一般hex文件自带地址信息，bin文件则需要手动填写起始地址。如果你用的是bin文件，在烧录界面的"Download"区域要确认起始地址填对，否则程序写进去也跳不到正确位置。

4.4 第一次连接时常见的三类提示

第一次用外部目标连接，CubeProgrammer经常会弹出三类提示，这里提前说明，遇到时心里有底。

• "No ST-LINK detected"：说明电脑没识别到Nucleo板上的调试器，检查USB线有没有插紧，驱动是否安装，或者换个USB口试试。部分USB口供电能力差，也可能导致ST-LINK枚举失败。
• "Target connection error"：说明ST-LINK已经和电脑通信正常，但与目标MCU通信失败。最常见的原因是接线错误、目标未上电、VCC检测脚没接、或者目标芯片处于低功耗模式。按前面说的，用万用表量量接线，把NRST线也接上，再点Connect Under Reset试试。
• "Read protection" 相关提示：目标芯片开启了读保护，调试器无法访问Flash。这种提示不是连接失败，而是芯片被保护了。解除方法下面细说。

4.5 STM32 ST-LINK Utility还能干什么

虽然ST官方已经不再积极更新ST-LINK Utility，但它仍然是一个很轻量的小工具，尤其在老的Windows系统上，打开速度快，界面简单。如果你只是做最简单的烧录和读Flash，它还够用。比如上面读保护的问题，老工具里也有remove protection的选项，功能上没有缺失。

不过我的个人建议是，新方案一律用STM32CubeProgrammer，原因是它把GUI操作和命令行烧录统一了，后面做批量烧录用同一套工具更方便，不用学两套逻辑。

5. 排查链路：连接不上时按这个顺序找原因

5.1 排查顺序表

外部目标连接不上的时候，最容易犯的错是乱试。一会儿调频率，一会儿换模式，折腾半小时也不知道问题在哪。我建议严格按下面的顺序排查，从最底层往上走。

5.2 读保护：最常见的“连不上”假象

读保护（RDP）是STM32系列里最容易让新手误判为"芯片坏了"的机制。RDP分三个等级：Level 0是不保护，调试接口完全开放；Level 1是禁止调试接口访问Flash，也禁止通过调试口读内存，这是大多数商用产品量产时设置的等级；Level 2是永久保护，一旦设置几乎无法回退，芯片基本锁死。

如果你拿到一颗已经烧录过且开了Level 1读保护的芯片，连接时CubeProgrammer会弹出提示，告诉你当前芯片受保护。这时可以选解除保护，但代价是整片Flash会被擦除，芯片回到出厂状态。如果你的目的是继续用这颗芯片，那没问题；如果只是想读出里面的固件做逆向，这条路基本走不通，而且这种行为也不值得提倡。

我在调试外部MCU时遇到过一颗已经开了读保护的目标芯片，当时程序要紧急升级，手头又没有原厂工具，最后用CubeProgrammer的remove protection选项全片擦除后重新烧录，问题解决。

5.3 Connect Under Reset 的适用场景

当你发现目标芯片连接不上，而且怀疑它处于低功耗状态、死循环状态、或者主时钟配置错误导致调试口失效时，就可以启用Connect Under Reset功能。这个功能的工作逻辑是：在芯片复位信号有效的瞬间发起SWD连接，趁芯片刚从复位中被释放、内核还没跑起来时，抢先建立调试会话。

使用方法是接好NRST线，在CubeProgrammer连接设置里勾选Connect Under Reset，然后点Connect。软件会自动控制复位时序，多数情况下能救回来。

5.4 SWD速率的选择

SWD速率不是越高越好，尤其是飞线比较长、没有做阻抗控制的时候，高频率下信号反射严重，连接会不稳定。我倾向于在遇到连接不稳定时，把SWD速率从默认的4MHz降到1MHz甚至更低。烧录速度虽然慢一点，但成功率高，对于调试功能来说完全够用。如果是批量烧录的场景，再根据实际飞线长度逐步提高速率，找到稳定边界。

6. 额外收益：虚拟串口与命令行烧录

6.1 把ST-LINK的虚拟串口也借过来

Nucleo板载ST-LINK通常带一个USB虚拟串口（VCP）。正常情况下，这个串口连接的是板载目标MCU的某个USART引脚。但当我们把CN2跳线帽断开后，ST-LINK的VCP通道并没有失效，只要找到ST-LINK侧对应的UART TX/RX引脚，同样能把它引出来，接到外部目标MCU的串口上。

具体引脚位置要查原理图，不同Nucleo板定义不同。以我手头这块U083RC为例，原理图里ST-LINK的VCP TX/RX会有一组明确的网络名，顺着网络就能找到对应焊盘或者测试点。把外部目标的UART TX接到ST-LINK的RX，目标的UART RX接到ST-LINK的TX，注意电平都是3.3V，共地已经有了。接线完成后，电脑上会出现一个COM口，开任意串口终端就能看到外部MCU的调试日志。

这里有一个串口配置的小细节值得单独说：很多MCU的UART RX引脚默认是浮空输入，如果外部没有加上拉电阻，空闲状态下RX电平不确定，容易收到乱码。所以外部目标连ST-LINK虚拟串口时，最好在固件里把UART RX引脚配置成内部上拉输入，或者在硬件上加一个10k上拉电阻到3.3V。这也是我实际调试中遇到乱码后查出来的原因之一，跟MCU串口接收端口是否有上拉是同一个问题。

6.2 命令行烧录：批量生产的福音

ST-LINK被“借用”来烧录外部MCU这件事，在批量生产中还有一种玩法，就是命令行脚本。STM32CubeProgrammer自带了一个命令行工具，在Windows上叫STM32_Programmer_CLI.exe，在Linux上也有对应版本。

举个例子，要向外部目标MCU烧录firmware.hex并校验，一条命令就能搞定：

STM32_Programmer_CLI -c port=SWD mode=HOTPLUG -w firmware.hex -v

如果要在烧录后设置读保护Level 1，加一条选项：

STM32_Programmer_CLI -c port=SWD mode=HOTPLUG -w firmware.hex -v -ob RDP=0xBB

这里将RDP设置为0xBB就是Level 1保护，注意这个操作会锁死调试接口的Flash访问权限，要确保固件已经没问题再执行。批量生产时，把命令写进脚本，工人只需要把目标板接到Nucleo板引出的SWD线上，双击脚本等结果，效率比手工在界面上点按钮高得多。

6.3 直接连接与恢复原状

用完后想恢复Nucleo板原始功能，也不复杂。把之前焊的飞线拆掉或者断开，把CN2两个跳线帽按原来方向插回去，插上USB，板载U083RC就会重新出现在调试器面前，一切照旧。

需要注意的一点是，拔下跳线帽这个动作不要反复频繁操作，排针的镀层磨损几次后接触电阻会增大，导致调试不稳定。我自己的习惯是，如果长时间不需要用板载MCU，就让跳线帽保持断开状态，把这块Nucleo板当做一个纯粹的ST-LINK调试器来用，不来回折腾。

最后

这个玩法我用了很长一段时间，最初只是因为手头调试器不够，后来发现它其实是一种值得推荐的调试资源复用方式。尤其是手头同时有几块不同型号Nucleo板时，哪块顺手就用哪块的ST-LINK去调试外部MCU，省下的钱不多，但省下的桌面空间和找工具的烦躁很值。最后分享一个踩坑后的习惯：断电再操作、先拍照再拔跳线帽、上电前先量通断，这三件事做全了，整个方案基本不会出大问题。