1. ST-LINK 烧录 STM32:代码开发工具里最容易被低估的一步
拿到一块 STM32F103C8T6 最小系统板,工程在 Keil 里编译通过了,点下载按钮却没反应,这是很多人第一次用 ST-LINK 烧录 STM32 时遇到的场面。ST-LINK 是配合 Keil 这套代码开发工具使用的调试与烧录探头,走 SWD 两线,既能下载程序,也能在线打断点。它解决的是串口 ISP 每次要手动拨 BOOT0、下载完还要复位的问题,适合刚转 STM32 的学生、课程实验和小批量打样。反直觉的地方在于:插上 ST-LINK 不等于能下载,Keil 工程里的 Device 型号和 Debug 驱动没对上,探头识别到了也烧不进去。这一篇只讲这条烧录链路,从魔术棒配置一直写到失败排查。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具的第一处配置:魔术棒里的 Device 与 Debug 怎么选
2.1 魔术棒不是一根线:Options for Target 里与烧录有关的只有三页
打开需要烧录的工程文件,点击工具栏上那个像魔术棒一样的图标,Keil 会弹出 Options for Target 对话框。这个窗口里选项很多,但跟 ST-LINK 烧录直接相关的只有三页:Device、Debug、Utilities。Device 页决定当前工程按哪颗芯片的存储布局去编译和下载;Debug 页决定点下载和点调试时调用哪个探头;Utilities 页决定 Flash 下载阶段用哪个驱动、哪段算法。三页里任何一页对不上,表现都可能是“下载失败”或“下载成功但不运行”。
我习惯的顺序是:先开 Device,再开 Debug,最后开 Utilities。原因很实际,Device 页选完型号后,Keil 会自动带出对应的 Flash 算法,Utilities 页的算法列表会跟着变;如果先把 Utilities 配好再改 Device,算法列表可能还停留在旧型号上。操作上不需要写代码,但每一步都要落到具体选项上:
text复制1. 打开工程文件
2. 点击魔术棒(Options for Target)
3. Device 页:选 STM32F103C8
4. Debug 页:Use 下拉选 ST-Link Debugger,Port 选 SW
5. Utilities 页:Use Target Driver 选 ST-Link Debugger
6. Utilities → Settings → Flash Download:勾选 Reset and Run
这段清单不是让你背下来,而是每次新建工程或换板子时按顺序过一遍。下面把三页拆开说。
2.2 Device 页选型号:STM32F103C8T6 为什么落到 STM32F103C8
原文里有一句很关键的话:打开需要烧录的工程文件,点击魔术棒,点开 Device 菜单,选择好自己连接的 STM32 具体型号,如果是 STM32F103C8T6 那就选择 STM32F103C8。这句话看起来像常识,实际是烧录失败最高频的分界点。
Keil 的器件列表按型号归类,STM32F103C8T6 在列表里通常归到 STM32F103C8 这一项,而不是直接写全丝印。选 C8 之后,Keil 会按 C8 对应的存储容量带出 Flash 算法,下载地址范围和校验范围也跟着对上。如果你图省事选了 STM32F103C6,或者随手选了同系列更大容量的型号,编译可能照样过,但下载阶段用的算法容量跟板上芯片不一致,容易出现烧到一半报错、校验不过,或者程序只跑一部分就停。这个坑我在课程实验里见过不止一次,现象很像“板子坏了”,其实只是 Device 页点错了一行。
具体操作是:魔术棒 → Device 页 → 在搜索框输入 STM32F103C8 → 选中列表里的 STM32F103C8 → 点 OK。选完后不要急着下载,先去 Utilities 页看一眼算法列表,确认里面出现的是跟 C8 对应的算法,而不是上一个工程残留的型号。换工程时尤其要注意,Device 页的型号是跟着工程文件走的,不是跟着电脑走的,别人发来的工程可能还停留在他的板子型号上。
| 配置项 | 位置 | 应该选什么 | 选错的典型后果 |
|---|---|---|---|
| 芯片型号 | 魔术棒 → Device | STM32F103C8(对应 C8T6) | Flash 算法容量不匹配,下载报错或程序不完整 |
| 调试探头 | 魔术棒 → Debug → Use | ST-Link Debugger | 点下载提示找不到设备 |
| 调试端口 | Debug → Settings → Port | SW | 用 JTAG 模式多接两根线,容易接错 |
| 下载驱动 | 魔术棒 → Utilities | ST-Link Debugger | 下载走错通道,Output 提示无可用算法 |
| 下载后复位 | Utilities → Settings → Flash Download | 勾选 Reset and Run | 下载成功但程序不跑,按复位才跑 |
2.3 Debug 页:Use 下拉切到 ST-Link Debugger
Debug 页管的是“用哪个探头去下载和调试”。打开 Debug 页,看 Use 后面的下拉框,把它切到 ST-Link Debugger。切完之后点右侧的 Settings,会弹出另一个窗口,里面能看到 SW Device 区域。如果接线和供电正常,这里应该出现一行 IDCODE,说明 Keil 已经通过 ST-LINK 读到了芯片的识别码。这个 IDCODE 是后面判断“探头通没通、芯片活没活”的第一手证据。
Port 这一项选 SW,不要选 JTAG。SWD 模式只需要 SWCLK 和 SWDIO 两根信号线,加上电源和地,接线简单,排错也简单。JTAG 要多接好几根线,在最小系统板上反而容易接错。Settings 里通常还有速率选项,识别不到芯片时可以先把速率降下来再试,线长、杜邦线接触不良、板上没供电,都会让高速率下的握手失败。这个参数不需要一次调到最高,先求识别,再求速度。
还有一点容易被忽略:Debug 页的 Use 和 Utilities 页的 Use Target Driver 要选成同一个探头。只在 Debug 页选了 ST-Link,Utilities 页还停在别的驱动,点下载时 Keil 会按 Utilities 页的设置去走,结果就是“调试能连、下载不走”。两页都看一眼,比事后猜半天省时间。
2.4 Utilities 页:下载驱动与 Flash 算法要跟 Debug 页一致
Utilities 页是烧录链路的最后一环。这里要确认 Use Target Driver for Flash Programming 选的是 ST-Link Debugger,然后点 Settings 进到 Flash Download 页。这个页面里有两个东西值得盯:一个是算法列表,里面应该出现当前 Device 型号对应的 Flash 算法;另一个是 Reset and Run 复选框,建议勾上。
算法列表为空或者还挂着旧型号的算法,下载阶段就会报 “Flash Download failed” 一类错误。遇到这种情况,先回 Device 页确认型号,再回 Utilities 页看算法是否刷新;如果还没刷新,把工程关掉重开一次,让 Keil 重新加载器件库。Reset and Run 勾上之后,下载完成会自动复位运行,不用手按板子上的复位键。不勾的表现是 Output 显示下载完成,板子却安静得像没烧进去,新手很容易误判成烧录失败。
3. 从 SWD 接线到点下载:ST-LINK 烧录的完整动作与参数
3.1 接线:SWDIO、SWCLK、GND、3.3V 四根线
ST-LINK 与目标板之间走 SWD,最少需要四根线:SWDIO、SWCLK、GND、3.3V。ST-LINK 外壳丝印上一般能找到这几个标识,目标板上找对应的 SWD 排针。SWDIO 是数据线,SWCLK 是时钟线,GND 必须共地,3.3V 视板子供电方式决定接不接。如果目标板自己已经有稳定供电,3.3V 可以不从探头取,只接三根信号线加地;如果目标板没有独立电源,才从 ST-LINK 的 3.3V 取电。
接线时有三个细节比选什么线更重要。第一,GND 一定要接,只接两根信号线不共地,Keil 里经常表现为 SW Device 空白。第二,杜邦线尽量短,长线加松动的杜邦头是识别不到芯片的常见原因。第三,不要照着 JTAG 的引脚定义去接 TDI、TDO,SWD 模式只用 SWDIO 和 SWCLK,多接反而容易把信号搞乱。板上如果有 BOOT0 跳线,烧录时把它拉到低电平,让芯片从主 Flash 启动,避免进了系统存储器还以为是下载失败。
3.2 Flash Download 页:勾 Reset and Run
Utilities → Settings → Flash Download 页面里,除了算法列表,最值得动手的就是 Reset and Run。勾选它的含义是:下载完成后由调试器发起一次复位,让芯片从复位向量开始跑新程序。不勾的话,芯片下载完仍停在暂停状态,看起来就是“没反应”。很多“下载成功但不运行”的疑问,第一步就应该看这个复选框。
同一页里还有擦除方式的选择。日常迭代下载用擦除扇区就够了,速度快,也不会把整个 Flash 清空;换工程、换芯片型号、或者怀疑旧程序残留时,再用全片擦除。全片擦除会连同选项字节一起处理,如果芯片之前被设过读保护,普通下载会先报错,这时需要先解除保护再擦除。这个顺序不要反过来,先擦后解保护容易把自己锁在门外。
3.3 编译与下载:Build Output 看什么
接线和配置都确认后,先点 Build 编译,看 Build Output 窗口最后是不是 0 Errors。编译没过就点下载,Keil 会直接拒绝,但有些人只看弹窗不看 Output,误以为是烧录问题。编译通过后点下载按钮,Output 窗口会刷出烧录进度,成功时能看到校验通过的提示;失败时第一行通常会给原因,比如找不到探头、无法访问目标、Flash 算法不匹配。排错时先看第一行,不要从最后一行倒着猜。
下载完成后不要立刻拔线。先看板子上的电源灯、运行灯有没有变化,有串口的话看有没有启动打印。如果什么反应都没有,按一下板子复位键,再判断是程序问题还是下载问题。这个动作能把“没勾 Reset and Run”和“程序本身跑飞”区分开。
3.4 在线调试:ST-LINK 不只是烧录器
ST-LINK 除了下载,还能在线调试。点 Start/Stop Debug Session 进入调试模式,可以看外设寄存器、打断点、单步执行。调试模式下程序是受控运行的,不要在看变量的时候拔掉 ST-LINK,也不要在下载过程中拔线。需要退出时先点 Stop,再拔探头。把调试和下载分开看:下载解决“程序进没进 Flash”,调试解决“程序跑得对不对”,两个问题不要混在一起查。
4. 代码开发工具用不顺时:五类烧录失败的排查
4.1 现象:点下载提示找不到 ST-LINK
现象很直接:点下载按钮,Keil 弹窗提示找不到探头,或者 Output 里刷出 no ST-LINK detected 一类信息。原因通常在三处:USB 线是只能充电的电源线,没有数据线芯;ST-LINK 驱动没装好,设备管理器里看不到对应设备;Debug 页的 Use 还停在别的探头,根本没切到 ST-Link Debugger。解决顺序是先换一根确认能传数据的 USB 线,再看设备管理器有没有新设备插入,最后回魔术棒 Debug 页确认 Use 下拉框。三步都过一遍,比反复插拔有效。
4.2 现象:探头识别到了,但读不到芯片 ID
现象是 Debug → Settings 里能看到 ST-LINK,但 SW Device 区域空白,或者提示 cannot access target。原因常见于接线和供电:SWCLK 与 SWDIO 接反、杜邦线松动、目标板没供电、没有共地,或者芯片之前进过低功耗模式、被设了读保护。解决时先量目标板 3.3V 有没有电,再把 SWCLK 和 SWDIO 对调试一下,确认 GND 接牢。还读不到就按住板上复位键再点下载,让芯片在复位期间被探头接管。读保护的情况要先解除保护,不要直接硬下载。
4.3 现象:下载报 Flash Download failed,算法对不上
现象是下载进度走到一半停住,提示 Flash Download failed,或者校验不通过。原因八成是 Device 页型号选错。板上是 STM32F103C8T6,Device 页却选了 C6 或更大容量的型号,Flash 算法按错误容量去擦写,地址范围对不上。解决是回魔术棒 Device 页,按板上丝印重新选 STM32F103C8,再去 Utilities 页确认算法列表已经刷新。换过工程之后尤其要检查这一页,工程文件会带着上一个使用者的型号设置。
4.4 现象:下载成功但程序不跑
现象是 Output 显示下载完成,板子没有任何反应,手按复位键之后才跑起来。原因有两个常见方向:Flash Download 页没勾 Reset and Run,芯片停在暂停状态;或者 BOOT0 跳线在高电平,芯片从系统存储器启动,根本没走到主 Flash。解决是先勾上 Reset and Run,再把 BOOT0 拉到低电平,下载完自动复位。还不行就看程序里的时钟配置和启动文件,但那已经属于程序问题,不是烧录链路的问题了。
4.5 现象:连着 ST-LINK 能跑,拔掉就停
现象是调试模式下程序正常跑,一旦拔掉 ST-LINK,板子立刻停。原因通常是目标板的电是从 ST-LINK 的 3.3V 取过来的,拔掉探头就断电;也可能是程序进了低功耗模式,探头在的时候被调试事件唤醒。解决是给目标板独立供电,探头只接 SWDIO、SWCLK、GND 三根信号线;同时检查程序里有没有进 STOP 或 STANDBY 的代码。带电机、继电器的板子不要从探头取电,电流一冲,探头也会掉线。
5. 烧完不算完:验证程序真跑起来的三招
下载完成不等于验证完成。我一般用三个动作确认板子真的在跑。第一招,进调试模式看 PC 指针是不是落在 0x08000000 附近的复位向量区域,如果 PC 停在一个奇怪地址,多半是启动文件或 BOOT0 的问题。第二招,看板上 LED 或串口打印,这是最直观的运行证据,比看 Output 窗口可靠。第三招,在 Debug → Settings 里再看一次 SW Device 的 IDCODE,确认探头和芯片的链路一直稳定,排除接触不良。
| 验证动作 | 看什么 | 异常时先查 |
|---|---|---|
| 进调试看 PC | 是否指向复位向量 | BOOT0 电平、启动文件 |
| 看 LED 或串口 | 有没有周期性输出 | Reset and Run、时钟配置 |
| 再看 SW Device | IDCODE 是否稳定 | 杜邦线、共地、供电 |
进阶一点的做法是把 Utilities 页的擦除方式用熟:日常下载用扇区擦除,换工程或怀疑芯片被锁时用全片擦除;如果全片擦除仍然报错,先确认是不是读保护或写保护被打开,再决定要不要解除。批量烧同一块板时,把 Device、Debug、Utilities 三页的配置固定下来,后面只换工程不换配置,能少很多重复排查。
血泪经验是:我以前总以为下载失败是板子的问题,后来发现十次里有八次是魔术棒里 Device 页选错型号,或者 Debug 页没切到 ST-Link Debugger。从那以后我每次新建工程,先开魔术棒把 Device、Debug、Utilities 三页过一遍,再点下载。这个习惯不花什么时间,但能把“玄学烧录”变成可复现的流程。希望帮到你。
