简介STM32 ST-LINK Utility 是意法半导体官方推出的 STM32 编程与调试工具面向嵌入式开发者、电子爱好者和学生用于固件下载、在线调试、芯片识别、内存测试等场景支持通过独立的 ST-LINK/V2 或开发板集成调试器以 SWD 或 JTAG 接口连接目标芯片。资源包为 7z 压缩格式共 277 个文件约 10MB内含可执行的 exe 主程序、dll 动态库、ST-LINK 驱动、帮助 PDF以及大量 STM32 标准外设库的 .c 源文件和 .h 头文件覆盖时钟、GPIO、FSMC、RCC 等常用外设并附有多种 IDE 的工程模板如 IAR、Keil及安全编程选项可适配常见开发环境。目前已有 4721 人浏览/下载在 STM32 社区中具有一定使用基础。开发者借助该资源能快速搭建官方工具链对照标准外设库源码理解时钟、GPIO、外设初始化逻辑同时掌握固件烧录、ST-LINK 升级与调试操作对嵌入式入门、项目移植和量产烧录均有直接帮助。1. STM32 ST-LINK Utility别只拿它当烧录器用看到“STM32 ST-LINK Utility”这个名字很多人第一反应是这不就是另一个把 hex 烧进芯片的图形界面工具吗。实际用上一段时间后会发现烧录只是它最浅的一层。读取整片 Flash 备份固件、处理芯片读保护、调整选项字节、给产线写批量烧录脚本这些才是这个工具在嵌入式开发里真正不可替代的地方。适合它的场景也很实在新板子到手要备份原厂固件接手一块读保护状态的芯片要判断能不能救产线几个小时要烧几百片板子不能靠人工点界面。如果你已经在用 ST-LINK 仿真器这个工具基本绕不开这篇文章把连接、烧录、备份、排错和批量化的完整路径讲清楚。2. 连接与识别把 ST-LINK 和芯片稳定握手连接是所有操作的前置条件。很多人卡在“工具打不开芯片”这一步其实九成问题不在工具本身而在线序、供电、驱动这三件事上。把这层理顺后面烧录、读回、改选项字节才有意义。2.1 SWD 接线与三种常见硬件场景SWD 是 ARM 调试接口里最常用的两线协议STM32 全系列都支持。它只需要 SWDIO、SWCLK 两根信号线再加上地线基本就能工作NRST 不是必须的但接上能提高不稳定环境下的连接成功率。相比 JTAG 要占用五六根引脚SWD 省出来的引脚在空间紧张的板子上非常宝贵这也是绝大多数开发板和产品板都做 SWD 排针的原因。实际接线会遇到三种场景。第一种是独立仿真器通过杜邦线或排线连到板子上的 SWD 插座适合手焊样板、维修板线长尽量控制在 20cm 以内。第二种是开发板自带的板载仿真器USB 线插上就能识别不需要额外接线但注意有些板子上的仿真器部分和 Target 部分是通过跳线断开的出厂默认连着改过跳线要接回去。第三种是产线治具用探针或 pogo pin 压接 SWDIO、SWCLK、GND、NRST这种场景线材更短但接触电阻和噪声问题更突出后面读保护相关操作之前必须先确认接触稳定。针脚作用目标板对应位置SWDIO数据输入输出芯片 SWDIO 引脚或排针标注位SWCLK时钟信号芯片 SWCLK 引脚或排针标注位GND共地目标板电源地NRST复位可选芯片 NRST 引脚或排针标注位有一种接线误区得提醒SWDIO 和 SWCLK 是复用引脚如果板子上这两个引脚同时接了其他外设比如按键、LED 甚至上拉电阻外部电路可能干扰调试信号。遇到连接不稳定时先查这两个引脚上有没有多余负载不要一上来就怀疑仿真器坏了。2.2 驱动和固件版本识别不到芯片先查这两处设备插上电脑后ST-LINK Utility 报 “No ST-LINK detected”最容易被忽略的原因是驱动没有正确安装。打开设备管理器如果看到一个带感叹号的未知设备或者设备名显示成“通用串行总线设备”而不是仿真器设备说明驱动层没有认到它。解决办法是把原厂驱动包重新装一遍装完后拔插一次 USB 再打开工具。如果之前装过其他调试器驱动可能产生冲突先把旧驱动卸载干净。另一个隐蔽原因是仿真器自身固件太旧。早期版本的仿真器固件可能不认识新出的芯片型号表现是连接时 Target 区域空白或者芯片 ID 读出来不对。这种情况需要用官方升级工具把仿真器固件刷到新版本。注意升级固件的前提是仿真器本身还能被电脑识别如果升级过程中断仿真器会变砖返厂或换新都很麻烦所以升级前不要拔线不要开其他占用 USB 的软件。买仿真器时也要留意市面上兼容版 ST-LINK 很多价格差距明显。兼容版日常烧录没问题但固件升级经常失败因为主控芯片方案和原厂不完全一致。工程师自己调试用问题不大产线大批量采购前一定要实测升级功能。不是所有“连不上”都是你板子的问题也可能是仿真器本身不具备完整的原厂协议能力。2.3 用 Target 菜单做三重确认电压、芯片型号、Flash 大小接线和驱动都正常后打开 ST-LINK Utility点击 Target 菜单里的连接选项工具会通过仿真器读取芯片的 IDCODE 和调试单元信息。连接成功的标志不是“灯亮了”而是界面下方出现具体的芯片型号、内核类型和 Flash 容量。这一步我习惯做三重确认。第一重确认目标电压。工具界面上会显示目标板的供电电压正常在 2.7V 到 3.6V 之间具体取决于芯片工作电压。如果显示 0V说明目标板没供电或者电压检测引脚没接好这种情况强行烧录大概率失败。第二重确认芯片型号。比如你手上是 512KB Flash 的芯片工具显示 64KB那说明识别异常可能是接触到其他目标或者 SWD 线序不对。第三重确认 Flash 大小与实际型号匹配。匹配不上的时候先把工具里的连接速度从自动改成较低频率再试一次某些板子高速连接时信号质量差降速后识别立刻恢复正常。注意目标电压显示 0V 但仿真器指示灯正常先给目标板单独供电不要指望仿真器给整板供电后面第 5 章会展开讲。3. 烧录与擦除hex、bin 和命令行三种写法连接稳定之后烧录是使用频率最高的操作。这个工具能烧 hex 也能烧 bin两者处理方式完全不同很多人在这上面翻过车。理解它们的区别比背命令参数更重要因为大多数烧录异常都是格式理解偏差造成的。3.1 烧录 hex地址由文件自带打开即烧hex 文件全称 Intel HEX是一种文本格式每一行都带有数据地址和校验信息。比如:020000040800F2这种行前半部分是地址段后半部分是数据烧录器按文件里的地址一条条写进去就行。正因为地址信息跟着数据走用 ST-LINK Utility 烧录 hex 时不需要你填起始地址工具会自动把数据写到正确位置。实际操作步骤就三步点击 File 菜单打开 hex 文件确认地址范围没有超出芯片 Flash 容量再点击界面上的烧录按钮或选择带校验的烧录选项。带校验的烧录会在写完后读回数据做比对产线或重要场合建议用这个方式耗时多一点但能当场发现坏块或接触不良。烧录日志窗口会逐条显示写入了哪些地址段、校验是否通过看到类似 “Verification ... OK” 才算真正成功。一个容易被忽略的细节有些 hex 文件里带的是应用程序地址比如 0x08000000 之后的偏移而有些出厂 Bootloader 的地址在别的区域。烧录前看一眼文件第一行和最末行的地址判断数据落在哪个范围别烧完发现写到了不是你想放的位置。3.2 烧录 bin起始地址填错是最常见的翻车点bin 文件是纯二进制数据里面只有字节内容没有任何地址信息。烧录器拿到 bin 文件时完全不知道你希望把它放到哪所以工具会弹出一个对话框让你填起始地址。这个地址填错轻则程序不运行重则覆盖到 Bootloader 区域直接变砖。STM32 内部 Flash 的起始地址是 0x08000000绝大多数产品也从这里启动所以填这个地址是最常见做法。有一种情况需要特意改地址你的程序包含 Bootloader 和 App 两部分Bootloader 放在 0x08000000App 打算放在 0x08010000烧录 App 的 bin 时就要把地址填成 0x08010000。很多人烧完 App 发现不跳转原因就是 App 地址和 Bootloader 里写死的跳转地址对不上。文件格式地址信息烧录时行为适合场景hex自带地址按文件地址写入无需填地址编译工具链默认输出、带校验需求bin无地址必须手工指定起始地址Bootloader 分区烧录、固件合并、量产镜像建议日常开发优先保留编译工具生成的 hex 文件除非有明确的地址拆分需求才用 bin。bin 文件另外一个问题是无法从文件内容判断目标芯片同一个 bin 烧进不同芯片可能部分数据落在非法地址工具烧录时报错还是小事静默写进去才麻烦。3.3 用 ST-LINK_CLI 命令行完成烧录与擦除图形界面适合单板操作一板一板点没问题但碰到“烧完这块马上换下一块”的重复劳动命令行效率高得多。ST-LINK Utility 安装目录下带一个命令行程序习惯上叫它 ST-LINK_CLI所有图形界面的核心操作它都能做。:: 全片擦除把 Flash 恢复到 0xFF 状态 ST-LINK_CLI.exe -ME :: 烧录 hex地址由文件自带不需要额外指定 ST-LINK_CLI.exe -P app.hex :: 烧录 bin0x08000000 是 STM32 内部 Flash 的起始地址 ST-LINK_CLI.exe -P app.bin 0x08000000第一条命令-ME是 Mass Erase全片擦除把 Flash 所有字节恢复成 0xFF。擦除是烧录 bin 前必须要做的步骤因为 Flash 只能把 1 写成 0不能单独把 0 写成 1不擦除就写入会得到脏数据。第二条命令-P后面跟 hex 文件工具解析文件里的地址并写入。第三条命令-P后面跟 bin 文件时需要再跟一个十六进制地址参数这个地址就是烧录起始地址。不同版本命令行参数会有细微差异第一次使用先执行ST-LINK_CLI.exe -help看当前版本支持哪些参数不要死记网上抄来的旧参数。命令行烧录时芯片处于读保护状态会返回错误码脚本里必须对退出码做判断这点下一章会用到。命令行还有一个隐藏优势输出结果可以重定向到文本文件相当于每一步操作都有日志留底出问题能追溯到底是哪一步失败。4. 读回固件与选项字节备份、提取和读保护处理烧录是写 Flash读回是读 Flash看起来只是方向相反但实际中读回操作的价值被严重低估。固件备份、出厂参数提取、故障板分析、产线一致性比对全都依赖这个能力。选项字节则是很多工程师不敢碰的区域其实搞清楚三档读保护的区别你会发现它没那么神秘。4.1 用 Dump 把整片 Flash 读成 bin 备份ST-LINK Utility 可以像读 U 盘一样把芯片整片 Flash 读出来存成文件。连接上芯片后在相应菜单里选择 Read Back填上起始地址和要读取的长度工具就会把这段 Flash 内容保存成 bin。读取速度比烧录慢一些整片 512KB Flash 大约几十秒到一两分钟取决于连接频率和线材质量。命令行读回用-Dump参数格式很直观:: 从 0x08000000 开始读取 64KB Flash保存为 backup.bin ST-LINK_CLI.exe -Dump 0x08000000 0x10000 backup.bin参数从左到右分别是起始地址、读取长度十六进制字节数、输出文件名。上面的 0x10000 等于 65536 字节也就是 64KB。如果芯片是 128KB Flash长度改成 0x20000不确定芯片容量时可以用工具界面读到的 Flash 大小来填。这里有个原则读取长度宁可大于实际固件不要小于实际固件因为多读出来只是文件变大少读了关键区域就找不回来了。读取出来的 bin 文件可以在工具里再次打开并烧录回芯片这相当于给固件做整体镜像复制。有些产品出厂时带有 MAC 地址、校准参数、加密密钥这些数据一般存在 Flash 末尾或独立扇区备份时如果只读主程序区域等需要恢复时就发现这些关键参数丢了。所以拿到一块没碰过的板子最稳的备份方式就是整片读回不要自作聪明只读一部分。4.2 RDP 读保护三档level 1 能解锁但要擦片level 2 没有后悔药读保护是 STM32 选项字节里的一项设置全称 Read Protection简称 RDP。它控制外部调试器能不能读 Flash 里的内容。很多工程师一听到“读保护”就慌其实它分三个级别行为差异很大。级别调试访问权限解锁方式实际影响level 0完全开放无需解锁出厂默认状态可读可写可调试level 1禁止调试接口读 Flash执行全片擦除后回到 level 0固件读不出来但可以重新烧录level 2永久禁止无不可回退调试接口永久禁用芯片只能运行现有程序level 1 是最常见的保护状态。芯片设成 level 1 后仿真器还能连接能擦除 Flash但读回来的数据全是 0xFF。想解除保护工具会提示你执行一次全片擦除擦完自动回到 level 0。这意味着解锁和保护之前的数据不可兼得如果想保留 Flash 里的内容千万不要在 level 1 状态下执行解锁操作。level 2 是老手也容易栽的坑。一旦芯片设成 level 2调试接口被永久锁定任何仿真器都无法再读、再写、再擦这块芯片等于只能跑出厂程序不能用于开发调试。有些产品为了防抄板会在出厂时设 level 2你拿到手想读固件基本没戏想反汇编只能拆芯片用其他手段。判断一块异常板子能不能救第一步就是看它处于哪个保护级别level 1 有救level 2 直接放弃。4.3 选项字节不只是读保护写保护、BOOT 位和看门狗选项字节区域除了 RDP还有 Flash 写保护、BOOT 配置、硬件看门狗、BOR 电压检测等设置。这些字段不在主 Flash 里单独存一块区域通过调试接口可以修改。最常见的是 Flash 写保护按扇区设置被保护的扇区不能被仿真器擦除和写入这通常是产品出厂时防止 Bootloader 被误刷的手段。遇到烧录失败提示“某个扇区无法擦除”不要先怀疑仿真器先打开选项字节页面看写保护状态。把对应扇区的写保护去掉重新上电后再擦除就能通过。注意有些产品在程序运行时会用代码给自己的 Bootloader 区域加密上锁仿真器连接时芯片处于运行状态这种保护是芯片内部软件逻辑工具层面看不到需要让芯片复位到停止模式再操作。时钟配置和 BOR 电压这些字段一般保持默认就好不建议在工具里乱改。选项字节的写入次数是有限制的频繁读写会损耗这个区域某些位一旦损坏可能导致芯片启动异常。我的习惯是只在明确需要时才动选项字节改完做一次验证然后不再反复进去看。4.4 常见做法新板子到手先备份原始固件不管是从项目同事手里接过的板子还是从市场买回来的测试板拿到手第一件事接上仿真器读回整片 Flash 存好。这一步成本很低未来收益可能很大。某次项目里一块板子的校准参数存在 Flash 特定位置程序被误擦后我一直调不回来后来靠之前随手备份的文件恢复了功能那次之后就养成了这个习惯。备份时要注意文件命名不要只写日期要带上芯片型号、固件版本、项目代号。比如“board-A-backup-F103-20250110.bin”这种格式半年以后翻出来还能看懂。备份文件放版本管理目录里和源码放一起不要散落在下载文件夹。做完备份再动手操作万一翻车也有后悔药吃。5. 排查与避坑连接失败、校验失败和读保护的五个高频问题工具用久了就会发现报错信息只是表象真正麻烦的是那些“看起来一切正常但结果不对”的隐蔽问题。下面五个场景是我觉得最有代表性的踩坑记录每一条都按现象、原因、解决三个层面拆开讲。5.1 一直提示 No ST-LINK detected驱动、线材和供电的排查顺序现象仿真器指示灯亮着电脑也能听到 USB 插入提示音但打开工具就报找不到仿真器换一个仿真器还是同样报错。原因这种“玄学问题”通常不在仿真器本身而在驱动识别层。最常见是驱动被其他软件覆盖或者 USB 线是只供电不传数据的劣质线。另一种可能是电脑 USB 口供电不足笔记本的某个口接了多个设备时尤其明显。解决按顺序排查先把仿真器换一个 USB 口直插排除 Hub 和劣质线的影响然后在设备管理器里看设备状态出现感叹号就重装驱动最后打开工具设置手动选择 ST-LINK 类型而不是自动检测。这个顺序能覆盖九成以上情况。5.2 目标电压显示 0V仿真器供电的真实边界现象仿真器连接成功但工具 Target 电压一栏显示 0.00V烧录时报错或者干脆无法进入调试模式。原因ST-LINK 有一部分产品可以从仿真器取电但电流能力很小一般只有几十到几百毫安级别驱动一块系统板绰绰有余碰到带电机、屏幕、传感器阵列的板子就明显力不从心。电压检测脚检测不到目标电压工具就会显示 0V。解决给目标板接独立电源仿真器和目标板只连信号线。还要注意两者之间需要共地不共地时信号电平没有参考连接可能看起来成功但一操作就异常。产线治具尤其要检查地线接触探针氧化导致地线断开是电压显示异常的常见原因。5.3 烧录成功但程序不跑BOOT 引脚和复位电路现象烧录日志显示写入成功、校验也通过但板子上电后完全没有反应用示波器测引脚也没有电平变化。原因程序不跑不代表烧录失败常见原因有三个。BOOT0 引脚被拉高导致芯片从系统存储器启动而非用户 Flash复位电路电容过大导致上电复位时间过长程序里时钟配置和外部晶振不匹配启动阶段直接卡死在时钟初始化。解决先用工具本身的复位功能让芯片运行如果工具复位后程序能跑说明硬件复位电路有问题如果还是不跑测量 BOOT0 电平正常从 Flash 启动时应为低电平。检查晶振是否起振必要时换成内部时钟配置的固件做交叉测试。5.4 读回来的 Flash 全是 0xFF读保护已开启现象Dump 命令执行成功文件也生成了但打开文件看到的所有字节都是 FF固件内容完全不存在。原因这是读保护 level 1 或 level 2 的典型表现。保护开启时调试接口无法读取 Flash 内容但读命令本身不会报错而是返回空数据 0xFF。第一次遇到的人很容易误判成芯片 Flash 是空的。解决先打开选项字节页面看 RDP 级别。level 1 的话想要读取固件必须先解锁而解锁会全片擦除数据一样拿不回来想要重新烧录则不用解锁擦除后直接写就行。level 2 的话没有任何软件途径可以恢复别再浪费时间尝试各种解锁工具。5.5 校验失败写保护或擦除不干净现象烧录过程正常但最后校验阶段报错提示某个地址的数据和预期不符有时候是固定几个扇区轮流报错。原因最常见是写保护没有解除仿真器写入时硬件层面就不允许但工具没有实时反馈校验时才发现数据没写进去。另一个原因是目标 Flash 里面残留旧数据bin 烧录前没做全片擦除新老数据混在一起校验自然对不上。解决先到选项字节页面检查 nWRP 写保护位把保护去掉。然后执行一次 Mass Erase 全片擦除再重新烧录。如果擦除时本身就报错说明芯片可能已经被设置成 level 1 之外的级别或者 Flash 处于锁定状态这时需要先处理保护再回过来烧录。6. 批量烧录与验证用脚本把产线效率拉起来单板调试用图形界面完全够但产线或小批量烧录时一板一板点界面会让人崩溃。ST-LINK 命令行工具的价值在批量场景下最能体现接好板子双击脚本烧录、校验、记录日志全自动完成。6.1 批处理脚本循环烧录并输出日志下面这段脚本是我常用的产线烧录框架循环执行擦除、烧录、记录结果三个动作echo off set CLID:\ST-Link\ST-LINK_CLI.exe set HEXfirmware.hex set LOGburn_log.txt for /L %%i in (1,1,20) do ( echo board %%i start %LOG% %CLI% -ME %CLI% -P %HEX% if errorlevel 1 ( echo board %%i FAIL %LOG% ) else ( echo board %%i OK %LOG% ) timeout /t 2 nul )脚本先定义命令行工具路径、固件文件路径和日志文件路径。循环里的-ME先全片擦除-P再烧录 hexerrorlevel判断工具返回的退出码烧录成功退出码为 0失败为非 0。timeout命令留出操作员换板的时间避免板子还没接好就进入下一轮。如果板子没接好或接触不良-ME阶段就会返回错误码脚本不会继续烧录日志里清清楚楚记下哪一块板失败。这比人工盯日志靠谱得多。产线用这个脚本时一般会把set HEX改成每次都手动指定的方式防止烧错固件版本。6.2 回读校验每片板子都做一次全检烧录成功不代表一切正常尤其接触不良时可能出现部分地址写入失败但退出码依然为 0 的情况。所以批量流程里建议加一步回读校验烧录完成后用 Dump 读取固件区域和原始 bin 文件做二进制比对。Windows 下用fc /b比较两个文件但要注意 Dump 出来的文件长度取决于读取长度bin 文件长度不足时要补齐或者只比较有效长度。更省事的方案是直接用工具界面里的 Program Verify 选项烧完自动读回校验产线操作员不需要额外动作。校验失败的工具会自动记录错误码后续可以定位到具体板子做返修。6.3 和新一代官方工具怎么取舍用这个工具跑产线的团队越来越多原厂新一代编程工具功能更全面支持图形化配置、更丰富的芯片型号和更快的烧录速度。是否要迁移我认为看存量来决定如果产线脚本已经稳定运行大半年不要为了追新而改动工具只是工具稳定产出比界面好看重要得多。新项目立项时可以把新工具纳入评估命令行参数差异不大迁移成本主要是验证测试。我自己的习惯是开发调试用 IDE 自带的下载功能产线烧录用命令行脚本固件备份和读保护处理用 ST-LINK Utility 的图形界面。每个工具放在它最顺手的场景里反而比追求一个全能工具更省心。备份固件这个习惯救过我不少次希望你也能在项目里用上这套流程希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/13 23:17:53 · 阅读 1.2k STM32 ST-LINK Utility完全使用教程：烧录、固件备份与读保护
简介STM32 ST-LINK Utility 是意法半导体官方推出的 STM32 编程与调试工具面向嵌入式开发者、电子爱好者和学生用于固件下载、在线调试、芯片识别、内存测试等场景支持通过独立的 ST-LINK/V2 或开发板集成调试器以 SWD 或 JTAG 接口连接目标芯片。资源包为 7z 压缩格式共 277 个文件约 10MB内含可执行的 exe 主程序、dll 动态库、ST-LINK 驱动、帮助 PDF以及大量 STM32 标准外设库的 .c 源文件和 .h 头文件覆盖时钟、GPIO、FSMC、RCC 等常用外设并附有多种 IDE 的工程模板如 IAR、Keil及安全编程选项可适配常见开发环境。目前已有 4721 人浏览/下载在 STM32 社区中具有一定使用基础。开发者借助该资源能快速搭建官方工具链对照标准外设库源码理解时钟、GPIO、外设初始化逻辑同时掌握固件烧录、ST-LINK 升级与调试操作对嵌入式入门、项目移植和量产烧录均有直接帮助。1. STM32 ST-LINK Utility别只拿它当烧录器用看到“STM32 ST-LINK Utility”这个名字很多人第一反应是这不就是另一个把 hex 烧进芯片的图形界面工具吗。实际用上一段时间后会发现烧录只是它最浅的一层。读取整片 Flash 备份固件、处理芯片读保护、调整选项字节、给产线写批量烧录脚本这些才是这个工具在嵌入式开发里真正不可替代的地方。适合它的场景也很实在新板子到手要备份原厂固件接手一块读保护状态的芯片要判断能不能救产线几个小时要烧几百片板子不能靠人工点界面。如果你已经在用 ST-LINK 仿真器这个工具基本绕不开这篇文章把连接、烧录、备份、排错和批量化的完整路径讲清楚。2. 连接与识别把 ST-LINK 和芯片稳定握手连接是所有操作的前置条件。很多人卡在“工具打不开芯片”这一步其实九成问题不在工具本身而在线序、供电、驱动这三件事上。把这层理顺后面烧录、读回、改选项字节才有意义。2.1 SWD 接线与三种常见硬件场景SWD 是 ARM 调试接口里最常用的两线协议STM32 全系列都支持。它只需要 SWDIO、SWCLK 两根信号线再加上地线基本就能工作NRST 不是必须的但接上能提高不稳定环境下的连接成功率。相比 JTAG 要占用五六根引脚SWD 省出来的引脚在空间紧张的板子上非常宝贵这也是绝大多数开发板和产品板都做 SWD 排针的原因。实际接线会遇到三种场景。第一种是独立仿真器通过杜邦线或排线连到板子上的 SWD 插座适合手焊样板、维修板线长尽量控制在 20cm 以内。第二种是开发板自带的板载仿真器USB 线插上就能识别不需要额外接线但注意有些板子上的仿真器部分和 Target 部分是通过跳线断开的出厂默认连着改过跳线要接回去。第三种是产线治具用探针或 pogo pin 压接 SWDIO、SWCLK、GND、NRST这种场景线材更短但接触电阻和噪声问题更突出后面读保护相关操作之前必须先确认接触稳定。针脚作用目标板对应位置SWDIO数据输入输出芯片 SWDIO 引脚或排针标注位SWCLK时钟信号芯片 SWCLK 引脚或排针标注位GND共地目标板电源地NRST复位可选芯片 NRST 引脚或排针标注位有一种接线误区得提醒SWDIO 和 SWCLK 是复用引脚如果板子上这两个引脚同时接了其他外设比如按键、LED 甚至上拉电阻外部电路可能干扰调试信号。遇到连接不稳定时先查这两个引脚上有没有多余负载不要一上来就怀疑仿真器坏了。2.2 驱动和固件版本识别不到芯片先查这两处设备插上电脑后ST-LINK Utility 报 “No ST-LINK detected”最容易被忽略的原因是驱动没有正确安装。打开设备管理器如果看到一个带感叹号的未知设备或者设备名显示成“通用串行总线设备”而不是仿真器设备说明驱动层没有认到它。解决办法是把原厂驱动包重新装一遍装完后拔插一次 USB 再打开工具。如果之前装过其他调试器驱动可能产生冲突先把旧驱动卸载干净。另一个隐蔽原因是仿真器自身固件太旧。早期版本的仿真器固件可能不认识新出的芯片型号表现是连接时 Target 区域空白或者芯片 ID 读出来不对。这种情况需要用官方升级工具把仿真器固件刷到新版本。注意升级固件的前提是仿真器本身还能被电脑识别如果升级过程中断仿真器会变砖返厂或换新都很麻烦所以升级前不要拔线不要开其他占用 USB 的软件。买仿真器时也要留意市面上兼容版 ST-LINK 很多价格差距明显。兼容版日常烧录没问题但固件升级经常失败因为主控芯片方案和原厂不完全一致。工程师自己调试用问题不大产线大批量采购前一定要实测升级功能。不是所有“连不上”都是你板子的问题也可能是仿真器本身不具备完整的原厂协议能力。2.3 用 Target 菜单做三重确认电压、芯片型号、Flash 大小接线和驱动都正常后打开 ST-LINK Utility点击 Target 菜单里的连接选项工具会通过仿真器读取芯片的 IDCODE 和调试单元信息。连接成功的标志不是“灯亮了”而是界面下方出现具体的芯片型号、内核类型和 Flash 容量。这一步我习惯做三重确认。第一重确认目标电压。工具界面上会显示目标板的供电电压正常在 2.7V 到 3.6V 之间具体取决于芯片工作电压。如果显示 0V说明目标板没供电或者电压检测引脚没接好这种情况强行烧录大概率失败。第二重确认芯片型号。比如你手上是 512KB Flash 的芯片工具显示 64KB那说明识别异常可能是接触到其他目标或者 SWD 线序不对。第三重确认 Flash 大小与实际型号匹配。匹配不上的时候先把工具里的连接速度从自动改成较低频率再试一次某些板子高速连接时信号质量差降速后识别立刻恢复正常。注意目标电压显示 0V 但仿真器指示灯正常先给目标板单独供电不要指望仿真器给整板供电后面第 5 章会展开讲。3. 烧录与擦除hex、bin 和命令行三种写法连接稳定之后烧录是使用频率最高的操作。这个工具能烧 hex 也能烧 bin两者处理方式完全不同很多人在这上面翻过车。理解它们的区别比背命令参数更重要因为大多数烧录异常都是格式理解偏差造成的。3.1 烧录 hex地址由文件自带打开即烧hex 文件全称 Intel HEX是一种文本格式每一行都带有数据地址和校验信息。比如:020000040800F2这种行前半部分是地址段后半部分是数据烧录器按文件里的地址一条条写进去就行。正因为地址信息跟着数据走用 ST-LINK Utility 烧录 hex 时不需要你填起始地址工具会自动把数据写到正确位置。实际操作步骤就三步点击 File 菜单打开 hex 文件确认地址范围没有超出芯片 Flash 容量再点击界面上的烧录按钮或选择带校验的烧录选项。带校验的烧录会在写完后读回数据做比对产线或重要场合建议用这个方式耗时多一点但能当场发现坏块或接触不良。烧录日志窗口会逐条显示写入了哪些地址段、校验是否通过看到类似 “Verification ... OK” 才算真正成功。一个容易被忽略的细节有些 hex 文件里带的是应用程序地址比如 0x08000000 之后的偏移而有些出厂 Bootloader 的地址在别的区域。烧录前看一眼文件第一行和最末行的地址判断数据落在哪个范围别烧完发现写到了不是你想放的位置。3.2 烧录 bin起始地址填错是最常见的翻车点bin 文件是纯二进制数据里面只有字节内容没有任何地址信息。烧录器拿到 bin 文件时完全不知道你希望把它放到哪所以工具会弹出一个对话框让你填起始地址。这个地址填错轻则程序不运行重则覆盖到 Bootloader 区域直接变砖。STM32 内部 Flash 的起始地址是 0x08000000绝大多数产品也从这里启动所以填这个地址是最常见做法。有一种情况需要特意改地址你的程序包含 Bootloader 和 App 两部分Bootloader 放在 0x08000000App 打算放在 0x08010000烧录 App 的 bin 时就要把地址填成 0x08010000。很多人烧完 App 发现不跳转原因就是 App 地址和 Bootloader 里写死的跳转地址对不上。文件格式地址信息烧录时行为适合场景hex自带地址按文件地址写入无需填地址编译工具链默认输出、带校验需求bin无地址必须手工指定起始地址Bootloader 分区烧录、固件合并、量产镜像建议日常开发优先保留编译工具生成的 hex 文件除非有明确的地址拆分需求才用 bin。bin 文件另外一个问题是无法从文件内容判断目标芯片同一个 bin 烧进不同芯片可能部分数据落在非法地址工具烧录时报错还是小事静默写进去才麻烦。3.3 用 ST-LINK_CLI 命令行完成烧录与擦除图形界面适合单板操作一板一板点没问题但碰到“烧完这块马上换下一块”的重复劳动命令行效率高得多。ST-LINK Utility 安装目录下带一个命令行程序习惯上叫它 ST-LINK_CLI所有图形界面的核心操作它都能做。:: 全片擦除把 Flash 恢复到 0xFF 状态 ST-LINK_CLI.exe -ME :: 烧录 hex地址由文件自带不需要额外指定 ST-LINK_CLI.exe -P app.hex :: 烧录 bin0x08000000 是 STM32 内部 Flash 的起始地址 ST-LINK_CLI.exe -P app.bin 0x08000000第一条命令-ME是 Mass Erase全片擦除把 Flash 所有字节恢复成 0xFF。擦除是烧录 bin 前必须要做的步骤因为 Flash 只能把 1 写成 0不能单独把 0 写成 1不擦除就写入会得到脏数据。第二条命令-P后面跟 hex 文件工具解析文件里的地址并写入。第三条命令-P后面跟 bin 文件时需要再跟一个十六进制地址参数这个地址就是烧录起始地址。不同版本命令行参数会有细微差异第一次使用先执行ST-LINK_CLI.exe -help看当前版本支持哪些参数不要死记网上抄来的旧参数。命令行烧录时芯片处于读保护状态会返回错误码脚本里必须对退出码做判断这点下一章会用到。命令行还有一个隐藏优势输出结果可以重定向到文本文件相当于每一步操作都有日志留底出问题能追溯到底是哪一步失败。4. 读回固件与选项字节备份、提取和读保护处理烧录是写 Flash读回是读 Flash看起来只是方向相反但实际中读回操作的价值被严重低估。固件备份、出厂参数提取、故障板分析、产线一致性比对全都依赖这个能力。选项字节则是很多工程师不敢碰的区域其实搞清楚三档读保护的区别你会发现它没那么神秘。4.1 用 Dump 把整片 Flash 读成 bin 备份ST-LINK Utility 可以像读 U 盘一样把芯片整片 Flash 读出来存成文件。连接上芯片后在相应菜单里选择 Read Back填上起始地址和要读取的长度工具就会把这段 Flash 内容保存成 bin。读取速度比烧录慢一些整片 512KB Flash 大约几十秒到一两分钟取决于连接频率和线材质量。命令行读回用-Dump参数格式很直观:: 从 0x08000000 开始读取 64KB Flash保存为 backup.bin ST-LINK_CLI.exe -Dump 0x08000000 0x10000 backup.bin参数从左到右分别是起始地址、读取长度十六进制字节数、输出文件名。上面的 0x10000 等于 65536 字节也就是 64KB。如果芯片是 128KB Flash长度改成 0x20000不确定芯片容量时可以用工具界面读到的 Flash 大小来填。这里有个原则读取长度宁可大于实际固件不要小于实际固件因为多读出来只是文件变大少读了关键区域就找不回来了。读取出来的 bin 文件可以在工具里再次打开并烧录回芯片这相当于给固件做整体镜像复制。有些产品出厂时带有 MAC 地址、校准参数、加密密钥这些数据一般存在 Flash 末尾或独立扇区备份时如果只读主程序区域等需要恢复时就发现这些关键参数丢了。所以拿到一块没碰过的板子最稳的备份方式就是整片读回不要自作聪明只读一部分。4.2 RDP 读保护三档level 1 能解锁但要擦片level 2 没有后悔药读保护是 STM32 选项字节里的一项设置全称 Read Protection简称 RDP。它控制外部调试器能不能读 Flash 里的内容。很多工程师一听到“读保护”就慌其实它分三个级别行为差异很大。级别调试访问权限解锁方式实际影响level 0完全开放无需解锁出厂默认状态可读可写可调试level 1禁止调试接口读 Flash执行全片擦除后回到 level 0固件读不出来但可以重新烧录level 2永久禁止无不可回退调试接口永久禁用芯片只能运行现有程序level 1 是最常见的保护状态。芯片设成 level 1 后仿真器还能连接能擦除 Flash但读回来的数据全是 0xFF。想解除保护工具会提示你执行一次全片擦除擦完自动回到 level 0。这意味着解锁和保护之前的数据不可兼得如果想保留 Flash 里的内容千万不要在 level 1 状态下执行解锁操作。level 2 是老手也容易栽的坑。一旦芯片设成 level 2调试接口被永久锁定任何仿真器都无法再读、再写、再擦这块芯片等于只能跑出厂程序不能用于开发调试。有些产品为了防抄板会在出厂时设 level 2你拿到手想读固件基本没戏想反汇编只能拆芯片用其他手段。判断一块异常板子能不能救第一步就是看它处于哪个保护级别level 1 有救level 2 直接放弃。4.3 选项字节不只是读保护写保护、BOOT 位和看门狗选项字节区域除了 RDP还有 Flash 写保护、BOOT 配置、硬件看门狗、BOR 电压检测等设置。这些字段不在主 Flash 里单独存一块区域通过调试接口可以修改。最常见的是 Flash 写保护按扇区设置被保护的扇区不能被仿真器擦除和写入这通常是产品出厂时防止 Bootloader 被误刷的手段。遇到烧录失败提示“某个扇区无法擦除”不要先怀疑仿真器先打开选项字节页面看写保护状态。把对应扇区的写保护去掉重新上电后再擦除就能通过。注意有些产品在程序运行时会用代码给自己的 Bootloader 区域加密上锁仿真器连接时芯片处于运行状态这种保护是芯片内部软件逻辑工具层面看不到需要让芯片复位到停止模式再操作。时钟配置和 BOR 电压这些字段一般保持默认就好不建议在工具里乱改。选项字节的写入次数是有限制的频繁读写会损耗这个区域某些位一旦损坏可能导致芯片启动异常。我的习惯是只在明确需要时才动选项字节改完做一次验证然后不再反复进去看。4.4 常见做法新板子到手先备份原始固件不管是从项目同事手里接过的板子还是从市场买回来的测试板拿到手第一件事接上仿真器读回整片 Flash 存好。这一步成本很低未来收益可能很大。某次项目里一块板子的校准参数存在 Flash 特定位置程序被误擦后我一直调不回来后来靠之前随手备份的文件恢复了功能那次之后就养成了这个习惯。备份时要注意文件命名不要只写日期要带上芯片型号、固件版本、项目代号。比如“board-A-backup-F103-20250110.bin”这种格式半年以后翻出来还能看懂。备份文件放版本管理目录里和源码放一起不要散落在下载文件夹。做完备份再动手操作万一翻车也有后悔药吃。5. 排查与避坑连接失败、校验失败和读保护的五个高频问题工具用久了就会发现报错信息只是表象真正麻烦的是那些“看起来一切正常但结果不对”的隐蔽问题。下面五个场景是我觉得最有代表性的踩坑记录每一条都按现象、原因、解决三个层面拆开讲。5.1 一直提示 No ST-LINK detected驱动、线材和供电的排查顺序现象仿真器指示灯亮着电脑也能听到 USB 插入提示音但打开工具就报找不到仿真器换一个仿真器还是同样报错。原因这种“玄学问题”通常不在仿真器本身而在驱动识别层。最常见是驱动被其他软件覆盖或者 USB 线是只供电不传数据的劣质线。另一种可能是电脑 USB 口供电不足笔记本的某个口接了多个设备时尤其明显。解决按顺序排查先把仿真器换一个 USB 口直插排除 Hub 和劣质线的影响然后在设备管理器里看设备状态出现感叹号就重装驱动最后打开工具设置手动选择 ST-LINK 类型而不是自动检测。这个顺序能覆盖九成以上情况。5.2 目标电压显示 0V仿真器供电的真实边界现象仿真器连接成功但工具 Target 电压一栏显示 0.00V烧录时报错或者干脆无法进入调试模式。原因ST-LINK 有一部分产品可以从仿真器取电但电流能力很小一般只有几十到几百毫安级别驱动一块系统板绰绰有余碰到带电机、屏幕、传感器阵列的板子就明显力不从心。电压检测脚检测不到目标电压工具就会显示 0V。解决给目标板接独立电源仿真器和目标板只连信号线。还要注意两者之间需要共地不共地时信号电平没有参考连接可能看起来成功但一操作就异常。产线治具尤其要检查地线接触探针氧化导致地线断开是电压显示异常的常见原因。5.3 烧录成功但程序不跑BOOT 引脚和复位电路现象烧录日志显示写入成功、校验也通过但板子上电后完全没有反应用示波器测引脚也没有电平变化。原因程序不跑不代表烧录失败常见原因有三个。BOOT0 引脚被拉高导致芯片从系统存储器启动而非用户 Flash复位电路电容过大导致上电复位时间过长程序里时钟配置和外部晶振不匹配启动阶段直接卡死在时钟初始化。解决先用工具本身的复位功能让芯片运行如果工具复位后程序能跑说明硬件复位电路有问题如果还是不跑测量 BOOT0 电平正常从 Flash 启动时应为低电平。检查晶振是否起振必要时换成内部时钟配置的固件做交叉测试。5.4 读回来的 Flash 全是 0xFF读保护已开启现象Dump 命令执行成功文件也生成了但打开文件看到的所有字节都是 FF固件内容完全不存在。原因这是读保护 level 1 或 level 2 的典型表现。保护开启时调试接口无法读取 Flash 内容但读命令本身不会报错而是返回空数据 0xFF。第一次遇到的人很容易误判成芯片 Flash 是空的。解决先打开选项字节页面看 RDP 级别。level 1 的话想要读取固件必须先解锁而解锁会全片擦除数据一样拿不回来想要重新烧录则不用解锁擦除后直接写就行。level 2 的话没有任何软件途径可以恢复别再浪费时间尝试各种解锁工具。5.5 校验失败写保护或擦除不干净现象烧录过程正常但最后校验阶段报错提示某个地址的数据和预期不符有时候是固定几个扇区轮流报错。原因最常见是写保护没有解除仿真器写入时硬件层面就不允许但工具没有实时反馈校验时才发现数据没写进去。另一个原因是目标 Flash 里面残留旧数据bin 烧录前没做全片擦除新老数据混在一起校验自然对不上。解决先到选项字节页面检查 nWRP 写保护位把保护去掉。然后执行一次 Mass Erase 全片擦除再重新烧录。如果擦除时本身就报错说明芯片可能已经被设置成 level 1 之外的级别或者 Flash 处于锁定状态这时需要先处理保护再回过来烧录。6. 批量烧录与验证用脚本把产线效率拉起来单板调试用图形界面完全够但产线或小批量烧录时一板一板点界面会让人崩溃。ST-LINK 命令行工具的价值在批量场景下最能体现接好板子双击脚本烧录、校验、记录日志全自动完成。6.1 批处理脚本循环烧录并输出日志下面这段脚本是我常用的产线烧录框架循环执行擦除、烧录、记录结果三个动作echo off set CLID:\ST-Link\ST-LINK_CLI.exe set HEXfirmware.hex set LOGburn_log.txt for /L %%i in (1,1,20) do ( echo board %%i start %LOG% %CLI% -ME %CLI% -P %HEX% if errorlevel 1 ( echo board %%i FAIL %LOG% ) else ( echo board %%i OK %LOG% ) timeout /t 2 nul )脚本先定义命令行工具路径、固件文件路径和日志文件路径。循环里的-ME先全片擦除-P再烧录 hexerrorlevel判断工具返回的退出码烧录成功退出码为 0失败为非 0。timeout命令留出操作员换板的时间避免板子还没接好就进入下一轮。如果板子没接好或接触不良-ME阶段就会返回错误码脚本不会继续烧录日志里清清楚楚记下哪一块板失败。这比人工盯日志靠谱得多。产线用这个脚本时一般会把set HEX改成每次都手动指定的方式防止烧错固件版本。6.2 回读校验每片板子都做一次全检烧录成功不代表一切正常尤其接触不良时可能出现部分地址写入失败但退出码依然为 0 的情况。所以批量流程里建议加一步回读校验烧录完成后用 Dump 读取固件区域和原始 bin 文件做二进制比对。Windows 下用fc /b比较两个文件但要注意 Dump 出来的文件长度取决于读取长度bin 文件长度不足时要补齐或者只比较有效长度。更省事的方案是直接用工具界面里的 Program Verify 选项烧完自动读回校验产线操作员不需要额外动作。校验失败的工具会自动记录错误码后续可以定位到具体板子做返修。6.3 和新一代官方工具怎么取舍用这个工具跑产线的团队越来越多原厂新一代编程工具功能更全面支持图形化配置、更丰富的芯片型号和更快的烧录速度。是否要迁移我认为看存量来决定如果产线脚本已经稳定运行大半年不要为了追新而改动工具只是工具稳定产出比界面好看重要得多。新项目立项时可以把新工具纳入评估命令行参数差异不大迁移成本主要是验证测试。我自己的习惯是开发调试用 IDE 自带的下载功能产线烧录用命令行脚本固件备份和读保护处理用 ST-LINK Utility 的图形界面。每个工具放在它最顺手的场景里反而比追求一个全能工具更省心。备份固件这个习惯救过我不少次希望你也能在项目里用上这套流程希望帮到你。本文还有配套的精品资源点击获取