简介：STM32 ST-LINK Utility是意法半导体推出的STM32编程与调试工具，面向嵌入式开发者和硬件工程师，解决固件烧录、在线调试、闪存读写、芯片检测、内存测试及ST-LINK调试器固件升级等需求。压缩包为7z格式，共277个文件，总大小约10.05MB，内容包括ST-LINK USB驱动安装脚本、Windows兼容性处理脚本、STM32标准外设库的C/H源码、Keil与IAR等IDE的工程和配置文件、动态链接库、可执行程序、PDF说明文档以及多种链接脚本，便于直接导入开发环境使用。已有4721人参与学习或下载。读者可获得完整工具程序与配套工程源码，快速搭建STM32开发环境，理解SWD和JTAG接口的调试原理，也能参考安装脚本和工程模板完成自己的项目。对于刚入门的开发者，节省搜集工具与例程的时间；对经验丰富的工程师，固件更新和安全编程选项也能提供参照。
1. 为什么还在折腾 STM32 ST-LINK Utility：一个老工具的不可替代场景
某开发者在调试某跨平台系统时遇到过一次很狼狈的现场：板子被代码跑飞，仿真器连不上，手里只有一根 ST-LINK 和一台没装集成开发环境的办公电脑。最后把他拉回来的不是最新调试工具，而是 STM32 ST-LINK Utility 这个老牌工具。它对 SWD 连接的容错比大多数集成调试器更宽松，烧录时不依赖目标芯片的当前固件状态，只要四根线握手成功，就能直接擦除、重写。这篇笔记写给三类人：量产烧录遇到连接玄学的产线工程师、手里攒了一批旧 STM32 芯片想批量升级的维护者，以及刚被读保护锁死板子、正准备扔板子的开发者。
2. 从连不上到稳定烧录：SWD 连接、芯片识别与传输设置
2.1 硬件连接与驱动检查：先排除八成“连接失败”
先说最容易出问题的地方。很多人连不上目标板，第一反应是怀疑工具版本，实际上八成是连接线、供电、驱动这三件事没做好。ST-LINK 与目标板之间常用的 SWD 是四根线：SWDIO、SWCLK、GND，加上 NRST 复位线。SWDIO 对应板载调试口的 PA13，SWCLK 对应 PA14，GND 共地，千万别接反。遇到过最离谱的情况是 A同学把 SWDIO 和 SWCLK 当成 I2C 的 SDA 和 SCL 交叉接了，结果自然是“No target connected”。
接好线之后的检查顺序我一般是这样：先看 ST-LINK 本体上的红蓝双色灯，红色常亮且蓝色闪烁通常说明驱动异常或者固件丢了；然后打开设备管理器，在通用串行总线设备下面找有没有显示“STM32 ST-LINK”之类的虚拟串口或调试设备。如果设备管理器里是黄色感叹号，说明驱动没装上。这时候把 ST-LINK 拔掉重插，或者换 USB 口，大多数情况能解决。
供电是另一个易坑点。ST-LINK 的 VCC 引脚可以给目标板供电，但电流能力有限。如果你给一个带 Wi-Fi 模块、屏幕、电机驱动芯片的板子全部走 VCC 供电，ST-LINK 会瞬间进入保护状态，然后表现为连接不上。正确做法是目标板单独供电，ST-LINK 只接 GND 和数据线。这个习惯我从某次量产现场翻车之后就一直保留：先单独上电再插 ST-LINK，而不是让 ST-LINK 去驱动整块板子。
检查驱动和供电没问题后，打开 STM32 ST-LINK Utility，正常会看到 Left Panel 里自动识别出连接的 ST-LINK 序列号，Target 菜单下的 Connect 按钮变成可用状态。如果左侧栏显示无设备，先别急着点连接，回头检查 USB 线和驱动。
2.2 Target 设置里的传输频率与复位模式：别再默认值跑到底
很多人在 Target Settings 里只知道点 Connect，其他都不动。实际上这里有个非常影响稳定性的参数：传输频率。默认值一般是 4MHz 左右，短引线、干净的手工板没问题，但一旦你的 SWDIO/SWCLK 线超过 15cm，或者板子上干扰大（比如继电器大电流开关附近），就会随机出现握手失败或者读回数据错误。
传输频率需要往下调。经验值是：
- 10cm 以内杜邦线，2.5MHz 到 4MHz；
- 15cm 到 30cm 的飞线，1.2MHz 到 2.5MHz；
- 用了转接板、排线、插座链路过长的场景，直接降到 1.8MHz 以下，甚至 250kHz。
调频率的位置在 Target → Settings → SWD 通讯速率，或者连接时弹出的对话框里。不需要重新插拔 ST-LINK，改完重新 Connect 即可生效。这个频率并不影响烧录结果，只影响连接速度和稳定性。我一般先用默认值试连一次，如果第一次握手就成功，后续也稳定，就不动；如果连通后第一次“在读目标芯片型号”卡住超过 10 秒，第一件事就把频率降一半再试。
复位模式是另一个容易被忽略的点。Target Settings 里有 Normal、Under Reset、Hot Plug 三个连接模式。Normal 就是正常模式，大多数情况下用这个。Under Reset 的意思是 ST-LINK 先拉低 NRST，让目标芯片复位状态下强制进入调试模式，然后连接。这个模式专门对付“芯片里跑飞了、一上电就跳转乱执行”的情况。某次在升级一台老设备的固件时，设备上电后程序里立刻关闭调试接口，用 Normal 模式怎么都连不上，切成 Under Reset 之后正常识别，原因就是目标代码在启动早期把 SWD 引脚功能改成了 GPIO。
Hot Plug 则用于目标板已经被程序占用了 SWD 引脚、但还能跑的情况，它会在连接前不发送任何复位信号，纯靠 SWD 协议的在线探测。实际上它不如 Under Reset 可靠，但某些 Scenario 下反而能连上。
我用命令行检查连接情况的习惯也保留着。ST-LINK 自带的命令行工具和图形界面是同一个驱动栈，用命令先试一次，能快速排除界面软件的干扰：
"C:\Program Files (x86)\STMicroelectronics\STM32 ST-LINK Utility\ST-LINK Utility\ST-LINK_CLI.exe" -List-List参数列出当前 PC 上所有已被驱动的 ST-LINK 设备，输出里能看到设备序列号。如果这一条能输出设备，说明驱动与连接线没问题，接下来就是把固件版本、目标芯片型号确认清楚再动手。如果-List输出为空，那问题一定在驱动或者 ST-LINK 本体，继续调图形界面设置没有意义。需要说明的是，不同机器安装路径可能不一样，参数以你本机实际安装版本为准。
3. 烧录一个 HEX 到内部 Flash：文件加载、擦除、校验的完整流程
3.1 HEX 与 BIN 的选择逻辑：加载前先想好对齐与起始地址
拿到固件，到底是选 HEX 还是 BIN？这决定了后续烧录参数怎么填。HEX 文件（Intel HEX 格式）内部自带目标地址，烧录工具只需要把文件丢进去，起始地址自动按文件内记录走。BIN 文件是没有地址信息的裸数据，必须在烧录时手动指定起始地址，一般是 0x08000000（STM32 内部 Flash 起始地址），或者你需要烧到特定偏移，比如带 bootloader 的 App 地址 0x08010000。
这个差异不搞清楚，最常见的翻车就是从 KEIL 工程目录里只拷了 .bin 出来，忘记了 App 的偏移地址，直接按 0x08000000 烧进去，结果板子起不来。KEIL 的 Output 配置里如果设置了 IROM 起始地址 0x08010000，那么生成的 .bin 本身是从这个地址开始的数据，但 BIN 文件不把地址写进去，烧录工具默认会从你指定的地址存放，数据错位是必然。
反之，HEX 从 KEIL 或者 GCC 编译链生成后，因为内嵌地址，几乎不会出这种错。所以我的判断逻辑是：凡是工程编译直接产出的文件，优先用 HEX；凡是交付给产线的方案，才统一转成 BIN 并明确写明起始地址。产线用 BIN 的好处是可以完全控制烧录地址，避免某个 HEX 意外包含其他区域数据。
3.2 擦除策略与编程选项：片擦、扇区擦、编程后校验
烧录到内部 Flash 前一定要先擦除。这是 Flash 的工作原理决定的，擦除后 Flash 位全为 1，写入时才能把需要的位置 0。不同的擦除策略，烧录时间和数据风险也不一样：
| 擦除方式 | 效果范围 | 适用场景 | 风险 |
|---|---|---|---|
| Full chip erase | 整片 Flash 清除为 0xFF | 首次量产、固件结构不明确、需要完全干净环境 | 耗时最长，但最保险 |
| Sector erase | 只擦除目标扇区 | App 升级、带 bootloader 场景、只想覆盖某段数据 | 如果地址映射错误，残留旧代码，可能启动逻辑混乱 |
| Page erase | 按页擦除 | 小改动、特定页失效处理 | 单页擦除不彻底，周围页保留，需要考虑跨越页的数据 |
ST-LINK Utility 的图形界面里，在 Program 对话框的 Erase 区域可以选择片擦（Full chip erase）或者按扇区擦。如果你只是下载一个新的完整固件，我建议直接选 Full chip erase，避免上一次固件在 Flash 尾部落下什么残留数据，造成莫名其妙的启动异常。如果是带 bootloader 的升级场景，必须选 Sector erase，而且要把 bootloader 所在区域排除在外，否则一擦就把自己的升级引导也抹了。
编程后校验（Verify after programming）这个选项默认就是开着的。烧录完再读回 Flash 做逐字节比对，发现不一致会报警。产线烧录不建议关掉这个选项，除非你是在连续烧几百片赶时间，并且对目标芯片和供电很有把握，才考虑关闭以缩短每片工时。我自己做小批量时仍然开着，每片多花两三秒，但能挡住个别芯片惨遭写入失败后“看似烧成功”的翻车。
3.3 用 ST-LINK Utility 的图形界面走一次完整烧录流程
图形界面核心流程就三步：加载文件、检查偏移、点烧录。
第一步，菜单 File → Open file，选你的 .hex 或者 .bin 文件。加载后左侧窗口会显示地址段和校验信息。对于 HEX 文件，你几乎不用管地址，工具自动按内部记录跳转。对于 BIN 文件，弹出来的对话框会让你输入起始地址，务必核对前面说的 IROM 地址，不能想当然用默认 0x08000000。
第二步，Target → Connect，确认芯片识别正确。连接成功后在 Device 信息区域能看到具体的 FLASH 大小、固件版本等。有时候你会遇到一种“能 Connect 但读不到 FLASH size”的尴尬，多半是频率太高或者芯片进入读保护状态，此时先降频或者检查选项字节是否被改过。
第三步，烧录入口在菜单 Target → Program & Verify。弹出的编程对话框里做三件事：确认你要烧的文件路径和地址、擦除方式选好、勾上校验，然后点 Start。烧录过程底部有进度条，速度取决于文件大小和 SWD 频率，几十 KB 的小固件一般几秒完成。若在最后阶段报验证错误，直接换一根杜邦线、降低 SWD 频率再试，大概率能解决，先不要怀疑文件。
命令行下等价的操作是这样：
ST-LINK_CLI.exe -Connect ST-LINK_CLI.exe -ME ST-LINK_CLI.exe -P "app.hex" 0x08000000 ST-LINK_CLI.exe -V ST-LINK_CLI.exe -Rst-Connect执行一次正常连接；-ME是 Mass Erase，整片擦除，等价于图形界面的 Full chip erase；-P指定编程文件，第二参数是起始地址，HEX 文件也要写这个参数但工具优先按文件内地址解析；-V是编程后的校验；-Rst复位目标板让它跑起来。这个命令序列我用到量产脚本里，比图形界面稳定得多，而且不会因为界面焦点问题漏掉某一步。
4. 读回与固件导出：读保护、选项字节和“读出来不进仿真器”的边界问题
4.1 读 Flash 的正确姿势：Read All 与 Save As 的格式坑
除了烧录，ST-LINK Utility 另一个高频功能是把目标芯片里的代码读出来备份或分析。很多人第一次在这个功能的格式上栽跟头：用 Target → Read All 读完整个 Flash 后，再点 Save As，发现默认保存成 .hex 或者 .stldr，而没有 bin 的选项，或者存出来的 bin 文件大小和 Flash 容量不一致，无法直接用于反向比对。
原因是这样的：Read All 把整个 Flash 空间按物理地址全量读出来，包括那些没有被擦除的 0xFF 空洞，保存为 BIN 时会把空洞也一并写入文件，文件体积往往就是 Flash 容量的整数倍（比如 1MB 容量的芯片读出 1MB 文件）。这在做固件对比时够用，但想把它作为原始固件重新烧给别人时，1MB 全量数据可能和实际固件不匹配，因为原本写完代码小区块外的区域也一起被读走了。
本地解法有几个：一是先读完整芯片，然后用第三方工具或脚本把尾部全为 0xFF 的部分截掉，得到干净的 BIN；二是直接从工程编译输出取原始文件，不依赖读回；三是用 Utility 的 Memory and File Editor 工具只读取一段指定地址区间（菜单 Target → Memory Access → Read），设置好起始地址和长度，再导出。最后一种方式适合做局部排查，比如怀疑 0x08000000 处向量表被写坏，只读前 1KB 出来看，比全芯片读回高效太多。
4.2 选项字节的读写与 RDP 保护：设一次保护容易，解除却要先擦除
选项字节（Option Bytes）是 STM32 里独立于 Flash 主存储区的一块特殊配置区，里面的读保护等级 RDP 是最容易把人绕晕的地方。在 ST-LINK Utility 里，菜单 Target → Option Bytes 打开设置面板，可以看到三个等级：Level 0 无保护；Level 1 禁止从调试接口读取 Flash 内容，但仍可擦除；Level 2 则彻底禁用调试和烧录，几乎等于永久锁死。
| RDP 等级 | 调试接口读取 | 擦除/写入 | 解除条件 |
|---|---|---|---|
| Level 0 | 允许 | 允许 | 无需 |
| Level 1 | 禁止 | 允许（但必须先擦除） | 先 Mass Erase 全片 |
| Level 2 | 禁止 | 禁止 | 一般无法解除 |
很多人失手的地方是：设了 Level 1 之后，想再回到 Level 0，直接改选项字节却报错或者连不上。这是因为进入 Level 1 后，解除保护的唯一路径是先进行全片擦除，把 Flash 里的 APP 代码全清空，然后回退保护等级。那些数据一旦擦除就找不回来。所以量产阶段绝不建议轻易打开读保护，尤其是你想后续调试或者逆向验证固件的时候。某开发者就因为在样机上设了 Level 1，后来想读回一段代码做崩溃分析，发现必须先全擦，悔得直拍大腿。
另外注意选项字节在不同 STM32 系列上的布局和写入方式不一样，F1 系列是一个相对简单的独立区域，F4 和 L4 系列则加入了写保护选项、BOR 电压阈值、看门狗配置等。在图形界面里点错一个勾都可能影响芯片启动行为。安全做法是修改前先用 Read 把当前选项字节的全部值截图留底，遇到异常能恢复。
4.3 外部 Flash 与 SVD 查看：Utility 不为人知的调试增值点
ST-LINK Utility 并不仅限于内部 Flash。对于 STM32 系列里那些通过 FSMC/FMC 外扩了 NOR Flash 或 NAND Flash 的目标板，它支持加载外部 Flash 加载算法（External Loader），把程序直接烧到外部存储。操作入口在 Target → External programming 或者 Option Bytes 面板下方。
这个功能对做“代码放内部 Flash，字库/资源放外部 SPI NOR Flash”的产品很有用。比如某块板子外扩了一个 SPI NOR 存字库和图片，修改资源文件后不必重新打包整个内部固件，直接在 Utility 里选对应的外部 Flash 型号、加载地址、写入长度，单独烧资源文件，省去内部镜像整个重烧的时间。但前提是你得有对应的外部 Flash loader 文件，通常由芯片原厂或 Flash 厂商提供。如果没有，而是想用读 SPI Flash 内容的方式做验证，Utility 反而做不了，这类读取得依赖 SVD 调试器或另一个专用工具。
Utility 的自带 SVD 文件支持也很实用。连接目标板后，左侧栏展开能按寄存器名看外设状态，比如 GPIOA 的 MODER、RCC 时钟使能。对“板子起不来”这种问题，我用这个方式查过好几次：看 RCC 寄存器里各路时钟有没有被启动、FLASH 等待周期设置是否正常、PLL 配置是否生效。比起随手写个 GPIO 翻转代码去试，直接看寄存器更直观。SVD 文件的加载路径在菜单 Target → Options → SVD，需要你预先下载对应型号的 .svd 文件然后用 Debug 菜单下的外设查看窗打开。
5. 踩坑排查：连接失败、变砖错觉、固件升级玄学的五个实战记录
5.1 现象：能识别 ST-LINK 但识别不了目标芯片
有一次在某公司的产线上，十多台电脑都装了 ST-LINK Utility，其中两台总是弹“Cannot read target voltage”或者识别不到芯片。换一台电脑就能正常烧录，换 ST-LINK 也一样，最后查下来是那两台电脑的 USB 口电压不稳，接上 ST-LINK 后电压波动过大。
原因：ST-LINK 在连接前会读取目标板供电电压来做电平校准，目标板的 VDD 和 SWD 引脚的电压参考必须稳定。USB 口供电不足时 ST-LINK 内部电压抖动，识别逻辑就翻车。
解决：换到主机箱后面板 USB 口，避免前置 USB 扩展线，同时目标板单独供电，不要用 ST-LINK 的 VCC 给板子供电。从那以后每到一个新工位，我先用-List确认设备，再 Connect。
5.2 现象：烧录时报错，同时出现校验和错误
烧到一个 STM32F407 的板卡，一直报校验错误，但是同样的烧录文件在另一块板上能烧过。第一反应怀疑文件损坏，重新编译生成还是不行。
原因：那一次排查后发现是 SWD 线太长，而且旁边有一个正在工作的直流电机，干扰了 SWCLK 时钟线，导致写入的部分字节位翻转。
解决：把 SWDIO 和 SWCLK 杜邦线缩短到 5cm 内，或者用示波器抓线序波形没法看这时直接降 SWD 频率到 1MHz。降频后烧录通过，校验也通过。现在遇到任何校验错误，我先做两件事：降频率，换短线，再考虑文件问题。
5.3 现象：目标板无法连接，报“No device connected”
一块 STM32L4 的板子，程序里初始化了 Low Power 模式并将 SWD 引脚重映射为模拟输入，导致 ST-LINK 无法握手。普通连接方式直接失败。
原因：目标代码在启动早期就执行了重映射和睡眠指令，SWD 引脚功能被夺走。调试口默认要在一个特定状态才能接管，而芯片进入 STOP 模式后几乎不可连接。
解决：连接选项改 Under Reset，拉低 NRST 的同时连接。如果还不行，把 NRST 手动接地（做一个短接线），在连接瞬间复位芯片，然后再断开。这种做法虽然粗暴但有效，适合芯片已经死锁的板子。
5.4 现象：使用 ST-LINK Utility 升级固件后，ST-LINK 变成了无法识别的设备
有时候看到提示 ST-LINK 固件需要升级，点了确认，升级到一半拔了 USB，设备就失踪了。
原因：ST-LINK 内部自带一段 bootloader，固件更新过程断线会让 bootloader 区不完整或状态机跳出，主固件没写入，设备枚举不出来。
解决：把 ST-LINK 按住复位键重新插入 USB，或者使用 ST 官方固件升级工具进入 DFU 模式刷回。某开发者一次在升级中途被同事叫走，回来发现 ST-LINK 红灯常亮，差点以为坏了，后来强制进入维护模式重刷才救回来。这个锅别丢给 Utility，任何引导升级程序中断都是这样。
5.5 现象：连上目标芯片后 Flash 读出来全是 0xFF，但程序运行却正常
调试某跨平台系统时怀疑 Flash 内容被清空，Read All 全 0xFF，可系统功能完全正常。
原因：下载进去的程序并不在内部 Flash 里，而是通过调试器加载到 RAM 中运行，或者芯片是从外部存储器启动的，而 Utility 读的只是内部 Flash 地址区域。
解决：查看 BOOT 引脚电平，确认启动源是内部 Flash 还是外部总线。RAM 运行模式下，读内部 Flash 当然是空的，这个现象不是异常。发生这种误解的原因是不知道芯片复位后是从哪个存储空间取的第一条指令，排查方法就是先看 BOOT 选型，再决定往哪里读。
6. 进阶用法：用 ST-LINK CLI 做批处理烧录脚本，顺带绕过界面版的老毛病
ST-LINK Utility 的图形界面在交互式调试、临时看寄存器、单次烧录时很好用，但到了要连续处理几十块板子、跑产线记录、对接自动化流程的时候，它就成了效率短板。这种场景更适合直接用命令行工具组一个批处理脚本。
先看一个完整的烧录脚本结构。假设产线上每块板都要先擦除、再烧录、再校验，然后记录结果到日志文件：
@echo off set CLI="C:\Program Files (x86)\STMicroelectronics\STM32 ST-LINK Utility\ST-LINK Utility\ST-LINK_CLI.exe" set FW="D:\firmware\app.hex" %CLI% -List >> flash_log.txt %CLI% -Connect >> flash_log.txt if errorlevel 1 ( echo CONNECT_FAIL >> flash_log.txt goto end ) %CLI% -ME >> flash_log.txt %CLI% -P %FW% 0x08000000 >> flash_log.txt if errorlevel 1 ( echo PROGRAM_FAIL >> flash_log.txt goto end ) %CLI% -V >> flash_log.txt if errorlevel 1 ( echo VERIFY_FAIL >> flash_log.txt goto end ) %CLI% -Rst echo PASS >> flash_log.txt :end这个脚本做了几件事：-List先确认调试器存在，-Connect握手，连不上直接跳过后面动作，避免误烧。-ME全片擦除，保证芯片干净。-P写入固件并指定地址，HEX 文件的地址以内部记录为准。-V做编程校验，失败就记录 VERIFY_FAIL 而不是当成功，这对量产追溯很重要。最后-Rst复位板子跑起程序。
参数不是随便加的。-V校验和-ME全擦在一般开发中可能觉得没必要，但产线上每片板子都不做校验就放行，万一有一次环境干扰写入错误，后面整批出了问题回查成本极高。我在脚本里保留了校验，只是它会让每片板子的烧录时间多出几秒，对于批量在 100 片以内的项目完全可接受。
再补充一个 CLI 常用参数速查表，方便手写脚本时对照：
| 参数 | 作用 | 补充说明 |
|---|---|---|
-List | 列出所有已连接的 ST-LINK | 输出包含序列号，脚本判断设备存在 |
-Connect | 建立与目标芯片的连接 | 可加UnderReset强制连接 |
-ME | 整片擦除 | 全片擦除需要一定时间，脚本里等待即可 |
-P <文件> <地址> | 编程文件到地址 | HEX 文件也建议带上起始地址参数 |
-V | 编程后校验 | 校验失败以非零码返回 |
-Rst | 复位目标板 | 让烧录完的代码直接运行 |
-Run | 不复位直接运行 | 适合连接后已经继续运行的情况 |
如果你已经开始用了新版调试工具，会发现 ST-LINK Utility 在官方维护上进入了一个半退休状态，新出的开发环境逐步把功能并进了统一烧录工具里。但把 ST-LINK Utility 作为纯烧录器和产线配套脚本的角色，在现有设备里仍然大量存在。彼此之间的命令行参数差异不大，脚本迁移成本极低。我现在写量产脚本时依然用的是这套语法，遇到新的芯片型号只改地址和文件路径，其他不动。
从那次在公司把两千多块钱的 ST-LINK 玩到固件跑飞以后，我每接触一个调试工具第一件事就是先找它的命令行模式，并且强制自己把常用操作都写成可重复执行的脚本。图形界面方便把玩，可一旦涉及翻车现场和量产体量，能挽回局面的永远是这批不依赖鼠标的备份方案。希望这篇笔记能帮你少走一段我刚接触 ST-LINK 时走过的弯路。
本文还有配套的精品资源，点击获取
