STM32CubeProgrammer 烧录全攻略：ST-Link、串口与USB下载实战

STM32 开发这几年工具链的变化其实挺大的。早些年大家烧程序基本就是 Keil MDK 里点一下 Download 按钮或者用 J-Link 的 J-Flash 单独操作再老一点用 ST-Link Utility。后来 ST 官方把 ST-Link Utility 停更了全面转向STM32CubeProgrammer这个工具现在已经是 STM32 生态里绕不开的一环。不管你是用 ST-Link、UART 串口、USB DFU 还是 OTA它基本都能覆盖。而且它跨平台Windows、Linux、macOS 都有对应版本命令行模式还能直接塞进 CI 流水线里做自动化烧录。我平时接触最多的场景有两类一类是产线或者实验室里用 ST-Link 给 C8T6 这类小板子烧程序另一类是板子已经焊死在设备里、SWD 引脚没引出来只能靠USB 下载或者系统存储器启动模式来救场。这两种场景用 STM32CubeProgrammer 的姿势完全不一样踩的坑也不同。下面我就按自己实际操作的顺序把整个流程、原理和那些文档里不会写的细节都捋一遍不管你是刚上手 STM32 的新人还是想把这套工具用进自动化流程的老手应该都能捞到点东西。1. 先搞清楚 STM32CubeProgrammer 到底解决什么问题1.1 它和 Keil、J-Flash 的分工区别很多人第一次接触这个工具会有点懵我 Keil 里明明能下载为什么还要单独装一个 STM32CubeProgrammer这个问题得从工具定位说起。Keil MDK 的下载功能本质上是把编译产物通过调试器ST-Link 或 J-Link写进 Flash它依赖的是调试会话。也就是说你得先能连上芯片的调试接口Keil 才能下载。而 STM32CubeProgrammer 是一个独立的烧录工具它不关心你的代码是怎么编译出来的只关心把这份二进制数据写进目标存储区这件事。它支持的连接方式比 Keil 广得多ST-LinkSWD 或 JTAG 接口最常用的方式UART通过串口 Bootloader 下载不需要调试器USB DFU芯片内置的 USB 设备固件升级模式OTA通过无线方式更新这就意味着当你的板子 SWD 引脚被占用、被锁、或者根本没引出来的时候Keil 就无能为力了但 STM32CubeProgrammer 还能通过串口或 USB 把程序灌进去。这是它最大的价值。另外还有一个容易被忽略的点STM32CubeProgrammer 能直接操作选项字节Option Bytes比如读写保护、BOR 电平、复位行为这些。Keil 里做这些操作很别扭而在这个工具里就是点几下的事。所以哪怕你平时用 Keil 开发手边备一个 STM32CubeProgrammer 也是刚需。1.2 三种下载方式的适用场景对比在动手之前先想清楚你手上这块板子适合走哪条路。我把三种主流方式列个表方便你对号入座下载方式依赖硬件是否需要调试器典型场景速度ST-Link (SWD)SWD 四线需要 ST-Link开发调试、产线烧录快UART 串口TX/RX/GND BOOT0不需要SWD 被占用、救砖中等USB DFUUSB D/D-不需要板子有 USB 口、现场升级较快选哪种核心看两个条件SWD 引脚是否可用以及BOOT0 是否可控。如果 SWD 好好的直接用 ST-Link别折腾。如果 SWD 连不上但 BOOT0 能拉高那就走串口或 USB DFU。如果 BOOT0 也被焊死了那就只能上电复位时序那套骚操作了后面会讲。提示C8T6 这类最小系统板BOOT0 通常有个跳线帽或者 0 欧电阻改起来很方便。但如果是已经集成到产品里的板子BOOT0 可能直接接地这时候就得看芯片手册里系统存储器的进入条件了。1.3 系统存储器启动模式的原理要理解 UART 和 USB DFU 下载必须先搞懂系统存储器启动模式。STM32 的 Flash 里其实有两块区域一块是你自己写的用户程序区另一块是 ST 出厂时就烧好的系统存储器System Memory里面存着一段 Bootloader。芯片上电时会根据 BOOT0 和 BOOT1 两个引脚的电平决定从哪里开始执行BOOT0 0从主 Flash 启动也就是跑你自己的程序BOOT0 1BOOT1 0从系统存储器启动跑 ST 的 BootloaderBOOT0 1BOOT1 1从 SRAM 启动一般调试用当芯片从系统存储器启动时ST 的 Bootloader 会去检测各个外设接口USART1、USART3、CAN、USB 等等待上位机发来的下载命令。这时候你用 STM32CubeProgrammer 通过串口或 USB 连上去就能把新的固件写进主 Flash。写完之后把 BOOT0 拉回低电平重新上电芯片就从主 Flash 跑新程序了。这个机制的好处是它不依赖你原来的程序是否正常。哪怕你之前烧进去的程序把 SWD 引脚复用成了普通 IO或者开了读保护只要 Bootloader 还在你就能通过系统存储器模式把芯片救回来。这是嵌入式开发里非常重要的一条后路。2. 用 ST-Link 下载最常规也最容易翻车的方式2.1 硬件连接与驱动确认ST-Link 下载是最标准的路径但恰恰因为太常规很多人连接上就出问题。先把硬件接对STM32 的 SWD 接口一共四根线SWDIO数据线SWCLK时钟线GND地3.3V供电可选如果板子自己供电就不用接注意ST-Link 上的引脚标法可能和板子上的标法不一样。常见的 ST-Link V2 小U盘那种引脚顺序是 3.3V、SWDIO、SWCLK、GND而板子上的 SWD 排针顺序可能是 GND、SWCLK、SWDIO、3.3V。接反了不会烧但连不上这是新手最常犯的错。我的习惯是先用万用表确认一下板子的 GND 和 3.3V再对照 ST-Link 的丝印一根根接。驱动方面Windows 下装了 STM32CubeProgrammer 之后ST-Link 的驱动会自动装上。如果你之前装过旧版 ST-Link Utility可能会有驱动冲突建议先在设备管理器里把旧的 ST-Link 设备卸载干净再装新工具。Linux 下需要把 udev 规则加上否则普通用户没权限访问 USB 设备这个后面命令行部分会细说。2.2 在 CubeProgrammer 里建立连接打开 STM32CubeProgrammer界面左上角是连接配置区。操作顺序是这样的在ST-LINK下拉框里选择你的调试器。如果只插了一个通常显示 ST-LINK/V2 或 ST-LINK/V3Port选 SWD除非你用 JTAGFrequency先保持默认的 4000 kHz连不上再往下调点击右上角的Connect按钮连接成功后右侧会显示芯片的详细信息Device ID、Flash 大小、UID 等。如果这里能看到正确的芯片型号和 Flash 容量说明连接没问题可以进入下一步。如果点 Connect 报错最常见的几个原因接线错误SWDIO 和 SWCLK 接反或者 GND 没接目标板没供电ST-Link 的 3.3V 输出电流有限大板子带不动得单独供电频率太高长排线或者干扰大的环境下4000 kHz 连不上降到 1000 kHz 甚至 500 kHz 试试芯片被读保护如果之前开了 RDP Level 1连接时会提示需要先解除保护注意如果连接时提示 No STM32 target found先别急着怀疑芯片坏了。把频率降到 500 kHz重新上电再试一次。我遇到过好几次都是频率问题不是硬件问题。2.3 下载配置与选项字节设置连接成功后切换到Erasing Programming标签页。这里有几个关键选项File path选择你的固件文件支持 .hex、.bin、.elf 等格式Start address.bin 文件必须手动填起始地址通常是 0x08000000.hex 和 .elf 自带地址信息不用填Verify programming建议勾上下载完自动校验Run after programming下载完自动运行调试时很方便点击Start Programming就开始烧录了。进度条走完如果勾了 Verify会再校验一遍全部通过就说明成功了。这里有个细节值得说.bin 和 .hex 的区别。.bin 是纯二进制没有任何地址信息所以你必须告诉工具从哪个地址开始写。.hex 是 Intel Hex 格式每行数据都带了地址工具自己会解析。如果你拿不准优先用 .hex省心。但有些产线为了省空间会用 .bin这时候起始地址填错程序就跑不起来而且现象很诡异——芯片能连上但程序没反应。我踩过一次地址填成了 0x08000000 之外的偏移查了半天才发现。选项字节Option Bytes在另一个标签页里。这里能改的东西包括RDP读保护等级Level 0 无保护Level 1 禁止读出 FlashBOR欠压复位电平nRST_STOP / nRST_STDBY低功耗模式下是否保持复位引脚Boot configurationBOOT0 相关的配置改选项字节要格外小心尤其是 RDP。一旦从 Level 0 升到 Level 1再想降回来会触发全片擦除Flash 里的程序全没了。所以量产阶段如果要用读保护一定要在最后一步做别在调试阶段就开。3. UART 串口下载SWD 被占用时的救命稻草3.1 BOOT0 拉高与串口接线当 SWD 引脚被占用、或者你手上根本没有 ST-Link 的时候串口下载就是最实用的方案。前提是芯片的 BOOT0 引脚可控。操作步骤把BOOT0 拉高接 3.3VBOOT1 保持低电平接地用 USB-TTL 模块连接芯片的USART1TX 接 PA10RXRX 接 PA9TXGND 共地给板子重新上电让芯片进入系统存储器启动模式这里要注意不同型号的 STM32Bootloader 支持的串口不一样。F103 系列通常是 USART1PA9/PA10有些型号还支持 USART3、CAN 等。具体看参考手册的 Bootloader 章节。接错串口工具是连不上的。USB-TTL 模块的选择也有讲究。CH340、CP2102、FT232 都可以但要注意电平匹配。STM32 是 3.3V 电平如果你的 USB-TTL 模块输出 5V长期用可能会损伤 IO。建议选带 3.3V/5V 跳线的模块拨到 3.3V 档。3.2 在 CubeProgrammer 中配置 UART 连接回到 STM32CubeProgrammer这次连接方式选UART而不是 ST-LINK。配置项Port选择 USB-TTL 对应的 COM 口Baudrate默认 115200可以往上调但 Bootloader 对波特率的容忍度有限建议先用 115200ParityEven偶校验这是 ST Bootloader 的默认要求选错了连不上Data bits8Stop bits1点 Connect如果一切正常会读到芯片信息。然后和 ST-Link 一样在 Erasing Programming 里选文件、填地址、点下载。串口下载的速度比 ST-Link 慢不少一个几十 KB 的固件可能要十几秒。如果固件大可以考虑把波特率提到 230400 甚至 460800但前提是你的 USB-TTL 和线材质量跟得上否则会丢包导致下载失败。提示串口下载完成后一定要把 BOOT0 拉回低电平再重新上电。否则芯片会一直停在 Bootloader 里你的程序永远不跑。这个错误太常见了我见过不止一个同事对着板子发呆半小时最后发现是跳线帽没拔。3.3 串口下载失败的排查思路串口下载失败的原因比 ST-Link 多因为多了一层 USB-TTL 和 Bootloader 的交互。按这个顺序排查确认 BOOT0 真的拉高了用万用表量一下 BOOT0 引脚对地电压应该是 3.3V确认串口线序正确TX 和 RX 是交叉连接的不是直连确认 COM 口没被占用串口助手、其他工具如果开着同一个 COM 口CubeProgrammer 会打不开确认 Parity 设置必须是 Even这是最容易忽略的降低波特率从 115200 降到 57600 或 9600 试试检查供电USB-TTL 的 3.3V 输出电流很小如果板子功耗大得单独供电如果以上都试过还不行可能是芯片的 Bootloader 版本问题或者芯片本身有故障。这时候可以换一块板子验证排除是工具还是硬件的问题。4. USB DFU 下载现场升级的优雅方案4.1 DFU 模式的进入条件USB DFUDevice Firmware Upgrade是 STM32 内置的另一种下载方式走的是芯片的 USB 外设。相比串口它的速度更快而且很多产品板本身就带 USB 接口现场升级时不用额外接线。进入 DFU 模式的条件和串口类似BOOT0 拉高从系统存储器启动。但有个额外要求芯片的 USB 外设通常是 PA11/PA12即 USB_DM/USB_DP必须引出来并且 Bootloader 支持 USB DFU。不是所有 STM32 都支持 USB DFU。F103 系列里中等容量和以上容量的型号支持小容量的可能没有。具体查对应型号的参考手册。进入 DFU 模式后电脑上会枚举出一个 USB 设备在设备管理器里显示为 STM32 BOOTLOADER 或者类似的 DFU 设备。如果没识别到检查USB 线是不是数据线有些线只能充电PA11/PA12 有没有接反芯片是否真的进入了系统存储器模式4.2 用 CubeProgrammer 走 USB 下载连接方式选USB如果设备被正确识别Port 下拉框里会出现对应的 USB 设备。选中后点 Connect后面的操作和前面一样。USB DFU 的下载速度明显比串口快一个 100KB 左右的固件几秒钟就完事。而且它不需要额外的 USB-TTL 模块一根 USB 线搞定现场升级时特别方便。但 DFU 也有它的局限需要芯片支持不是所有型号都有 USB DFU Bootloader需要 USB 接口可用如果产品的 USB 口被外壳挡住或者用作其他用途就不方便BOOT0 要可控和串口一样得能拉高 BOOT0所以实际产品里如果要做现场升级更常见的方案是在用户程序里实现 IAPIn-Application Programming通过 USB 或串口接收新固件自己写进 Flash。这样就不依赖 BOOT0 了。但 IAP 的实现复杂度高而且一旦用户程序跑飞就没法升级了。所以很多产品会保留 DFU 作为最后的救砖手段。4.3 DFU 与 IAP 的取舍这里多说一句 DFU 和 IAP 的选择。我个人的经验是开发阶段用 ST-Link最快最方便产线烧录用 ST-Link 或者脱机烧录器效率高现场升级优先 IAP用户体验好DFU 作为备用救砖DFU 或串口看哪个接口方便DFU 的优势是不依赖用户程序哪怕 Flash 里的程序全乱了只要 Bootloader 在就能救回来。IAP 的优势是不需要动 BOOT0用户操作简单。两者不是替代关系而是互补。5. 命令行模式把烧录塞进自动化流程5.1 CLI 基本用法STM32CubeProgrammer 除了图形界面还提供了命令行工具路径通常在安装目录的bin文件夹下Windows 下是STM32_Programmer_CLI.exeLinux 下是STM32_Programmer_CLI。基本用法STM32_Programmer_CLI -c portSWD -w firmware.hex -v -rst参数解释-c portSWD连接方式SWD 或 UART 或 USB-w firmware.hex写入文件-v写入后校验-rst写完后复位运行如果是 UARTSTM32_Programmer_CLI -c portCOM3 br115200 parityeven -w firmware.hex -v -rst命令行模式最大的价值是可以脚本化。产线上几百块板子要烧录用图形界面一块块点太慢了写个批处理脚本插上 ST-Link 自动烧录、自动校验、自动记录效率提升不是一点半点。5.2 Linux 下的 udev 权限配置Linux 下用命令行工具最常见的问题是权限。普通用户默认没有权限访问 USB 设备会报 Unable to open device 之类的错误。解决办法是加一条 udev 规则。在/etc/udev/rules.d/下新建一个文件比如49-stlinkv2.rules内容SUBSYSTEMSusb, ATTRS{idVendor}0483, ATTRS{idProduct}3748, MODE06660483是 ST 的 Vendor ID3748是 ST-Link V2 的 Product ID。不同版本的 ST-LinkProduct ID 可能不同可以用lsusb命令查。加完规则后执行sudo udevadm control --reload-rules sudo udevadm trigger然后重新插拔 ST-Link普通用户就能访问了。这个配置在 CI 环境里尤其重要因为 CI 通常以非 root 用户运行。5.3 批量烧录脚本示例给一个我实际用过的批量烧录脚本思路Windows 批处理echo off set CLIC:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\bin\STM32_Programmer_CLI.exe set FIRMWAREfirmware.hex :loop echo 请插入板子按任意键开始烧录... pause nul %CLI% -c portSWD -w %FIRMWARE% -v -rst if %errorlevel%0 ( echo 烧录成功 ) else ( echo 烧录失败请检查连接 ) goto loop这个脚本的逻辑是插一块板子按一下键烧录拔下来换下一块。产线上配合夹具使用效率很高。如果要做全自动可以结合 USB 热插拔检测但那个复杂度就上去了一般用半自动就够了。注意批量烧录时ST-Link 的固件版本要统一。不同批次的 ST-Link 固件版本不一样有时候会出现某几台能烧、某几台不能烧的情况。建议产线用的 ST-Link 统一升级到最新固件。6. 常见问题与排查速查表6.1 连接类问题现象可能原因解决方法No STM32 target found接线错误/频率过高/未供电检查 SWD 四线降频到 500kHz确认供电连接时提示读保护RDP Level 1解除保护会全片擦除UART 连不上Parity 设置错误/BOOT0 未拉高改为 Even确认 BOOT03.3VUSB 设备不识别线材问题/PA11PA12 接反换数据线检查 USB 差分线连接时断时续排线过长/干扰大缩短排线降低频率6.2 下载类问题现象可能原因解决方法下载到一半失败波特率过高/Flash 未擦除降波特率勾选全片擦除下载成功但程序不跑BOOT0 未拉回/起始地址错误拉低 BOOT0检查 .bin 起始地址校验失败Flash 坏块/供电不稳换板子验证检查电源下载后芯片锁死选项字节配置错误用系统存储器模式救砖6.3 几个容易忽略的细节第一ST-Link 的固件版本。STM32CubeProgrammer 连接时会检查 ST-Link 固件版本如果太旧会提示升级。升级本身没问题但升级过程中如果断电ST-Link 可能变砖。所以升级时确保 USB 连接稳定别中途拔线。第二目标板的复位引脚。有些板子的 NRST 引脚接了电容或者复位芯片ST-Link 的复位信号可能驱动不了。这时候可以在 CubeProgrammer 的连接设置里把 Reset mode 改成 Software reset 或者 Hardware reset多试几种。第三低功耗模式下的连接。如果芯片跑进了 Stop 或 Standby 模式SWD 可能连不上。这时候需要先唤醒芯片或者在连接设置里勾选 Connect under reset让 ST-Link 在复位状态下建立连接。第四多块板子同时烧录。如果一台电脑插了多个 ST-LinkCubeProgrammer 会列出所有设备需要手动选择对应的序列号。命令行模式下可以用sn参数指定 ST-Link 序列号实现多工位并行烧录。7. 我踩过的几个坑和实操心得说几个文档里不会写、但实际会遇到的坑。坑一C8T6 的 Flash 容量识别问题。有些便宜的 C8T6 板子芯片实际容量和标称不符CubeProgrammer 读出来的 Flash 大小可能是 128KB 而不是 64KB。这时候如果你按 64KB 写程序没问题但如果程序超过了实际容量就会写失败。遇到这种情况以实际读出的容量为准别硬写。坑二Keil 和 CubeProgrammer 抢 ST-Link。如果你 Keil 开着调试会话CubeProgrammer 是连不上 ST-Link 的。反过来也一样。所以切换工具时先把另一个工具的连接断开。这个看似简单但我见过有人折腾半天最后发现是 Keil 还在后台占着调试器。坑三USB DFU 的驱动问题。Windows 10 以上通常能自动识别 DFU 设备但有些精简版系统会缺驱动。如果设备管理器里显示黄色感叹号需要手动装 ST 的 DFU 驱动驱动文件在 CubeProgrammer 安装目录里能找到。坑四串口下载的波特率陷阱。ST 的 Bootloader 对波特率有容差要求不是所有波特率都支持。115200 是最稳的230400 在有些芯片上会失败。如果非要提速先小批量验证别一上来就全产线推。坑五选项字节改完没生效。改完选项字节后需要断电重新上电才生效光点复位按钮不够。这个细节很容易忽略尤其是改读保护的时候以为没生效其实是没重新上电。实操心得我现在做新板子调试第一步永远是先用 STM32CubeProgrammer 连一下确认芯片能识别、Flash 容量对、选项字节正常。这一步花不了一分钟但能提前排除很多硬件问题。如果连都连不上那后面写代码也是白搭。另外我习惯把常用的烧录命令写成脚本放在项目根目录换电脑或者重装系统后直接跑脚本就行不用重新记参数。最后再分享一个小技巧STM32CubeProgrammer 的图形界面里连接成功后可以点Firmware upgrade旁边的按钮把当前芯片的完整 Flash 内容读出来存成 .bin 文件。这个功能在逆向分析或者备份出厂固件时特别有用。读出来的文件可以直接用 CubeProgrammer 再写回另一块同型号的芯片相当于克隆。产线上如果要做小批量复制这个功能能省不少事。