) R3 G. M# z( L* n- i

. B2 V$ N3 Q2 c1 J' l. F

STM32CubeProgrammer（STM32CubeProg）是STM32微控制器的专用编程工具。
- _8 G1 o1 N+ Q5 |& L% q5 LSTM32用户都知道，当完成程序调试，需要对芯片进行程序代码烧录编程，一般会有三个选择：
通过调试接口【JTAG/SWD】来烧写程序，一般要使用STLink Utility或STVP工具软件来完成；
2 q! \4 m6 x* p1 J! y5 B通过UART接口来烧写程序，需要下载基于PC端的flash 烧录工具软件STM32 Flash loader demonstrator配合；
通过USB接口来烧写程序，需下载USB DfuSe工具软件来实现。
! |* M" F2 F% o3 E' F2017年底，ST推出了多合一烧录工具STM32CubeProgrammer，以其高集成度支持上述三类编程接口，还兼具其它更多功能。
) _# M: Q1 d# v7 s5 |STM32CubeProg 不断迭代，至2020年10月，更新至最新版 STM32CubeProgrammer 2.5.0（点击即可下载），增添更多新功能。
7 i3 U% ?- |7 i! o- A6 z3 s

STM32CubeProgrammer 主要功能

$ j: p& r# z4 E+ p$ k& ^STM32Cube 软件家族中的 STM32CubeProgrammer 是 STM32 MCU 专用编程工具。它支持通过STLink的SWD/JTAG调试接口对STM32 MCU的片上存储器进行擦除和读写操作；或者通过UART，USB, I2C，SPI，CAN等通信接口，利用出厂时固化在芯片内部的系统bootloader，对STM32 MCU的片上存储器进行擦除和读写操作。这里需要说明的是STLink v2仅支持通过UART和USB通信接口对片上存储器进行操作，而STLink v3增加了SPI，I2C和CAN通信接口的支持。除此以外，STM32CubeProgrammer 还可以操作STM32 MCU的选项字节和一次性可编程字节。通过 STM32CubeProgrammer 提供的或者自己编写的外部 external loader，还可以对外部存储器进行编程。
- W. ?" ?3 t1 T3 c
7 x# a( H$ e% _/ `9 F# s
0 Q$ o$ r$ v# f5 e' j+ ^4 u2 }2 bSTM32CubeProgrammer 提供了图形化和命令行两种用户界面。此外，STM32CubeProgrammer 还提供了C++ API, 用户可以将 STM32CubeProgrammer 的功能集成到自己所开发的PC端应用中。

▲ STM32CubeProg的图形化界面

$ `2 i( r+ j+ R
- F0 l6 `/ u  @, a0 r/ R2 Q6 Y. O图形化用户界面如上图所示，在右侧的配置区域，用户可以选择通过STLink调试接口，或者USB、UART等通信接口连接到STM32微控制器。连接到STM32 微控制器后，在“Device information”区域可以看到当前MCU的型号，版本和Flash大小等信息。如果连接的是ST官方的开发板，还会显示该开发板的名称。

; R; q. D+ H7 j3 `) \  V. U
那么，这里显示的信息都是来自哪里呢？其中“CPU“型号，也就是内核型号，从内核的CPUID 只读寄存器读得，该寄存器的说明在各个芯片系列对应的编程手册中可以查到，比如STM32F7对应的编程手册PM0253；芯片型号”Device ID“和芯片版本”RevisionID”分别来自STM32MCU的DBGMCU_IDC只读寄存器中的Device ID字段和Revision字段。Flash大小“Flash size”的值，可以从系统Flash的Flash size只读寄存器中读到。这些寄存器的说明都可以在各个芯片系列对应的参考手册中的“调试支持”和“设备电子签名”章节找到，比如STM32H743的参考手册RM0433。开发板名称“Board”对应的信息，存储在板载的STLink中，所以只有用ST开发板自身板载的STLink进行连接时才能看到这个信息。

1 K4 x# P* i  N" V  o# r5 a# I
4 `  F% F6 ]) d+ W1 @- X% u- m在STM32CubeProgrammer最左侧一栏可以在不同的功能标签页之间切换，进行不同的操作。


6 ~- X* T3 l7 Y5 Q2 ^- Y5 Z接下来，我们会对STM32CubeProgrammer的主要功能进行介绍，关于STM32CubeProgrammer的具体操作步骤，请参考”UM2237-STM32CubeProgrammer软件工具介绍”。
8 `$ t6 X9 [, r& [' b

片上擦除和读写
" Q7 |% o8 e: }' Y# ISTM32CubeProgrammer支持按扇区对Flash进行擦除和全片擦除。可以导入多种格式的执行文件进行烧录，支持的文件格式有：二进制文件（.bin），elf文件（.elf，.axf，.out），hex文件（.hex）和摩托罗拉的S-record文件（.srec）。

, A- b, }+ H7 k
擦除操作
' c$ C$ i* `, n* B# w通过STLink与目标MCU建立连接后，在“Erasing&Programming”页面下，可以按扇区对flash进行擦除，或者选择“Fullchiperase”按钮，进行全片擦除。

( h6 N' e! @  y7 F
9 j, @/ o8 }# ]9 ]. o烧录操作
( f, e) w! }( d2 a在“Erasing&Programming”页面下，点击“Browse”按钮导入可执行文件，然后点击“StartProgramming”进行烧录。
2 ~3 `/ G. ?! q8 D* M0 h0 o% r/ g  y也可以在“Memory&fileedition”页面下，打开要烧录的可执行文件，然后点击“download”进行烧录。
" {% R: r/ _# u  F' F; F/ ^' M在“Memory&fileedition” 的“Device Memory”页面下，还可以读出当前指定地址范围的MCU存储器值，并通过“SaveAs”菜单将读出的内容保存为二进制文件（.bin）, hex文件（.hex）或S-record文件（.srec）。
除了前面介绍的烧录整个可执行文件的方式以外，还可以在“Memory&fileedition” 的 “Device Memory”页面下直接修改某个地址的值，”回车”后STM32CubeProg会自动完成读出-修改-擦除-回写的操作。对于一次性可编程（OTP）字节就可以通过这种方式进行编程。


& x, l2 L2 _4 ^# [) Z% m' ]选项字读写
, o) m" `4 l% S3 u+ _. q点开OB页面后，可以看到当前所连接MCU的选项字的设定情况。用户可以在这里修改选项字的值。具体选项字的说明，请参考对应MCU的参考手册。
( t$ u, R9 k0 {  Y6 \* j0 b: _

' G. x( d, q5 w) ^$ I$ R' Y) L! U

“二合一”烧录
- r) `0 G; C3 V; t& [- u使用 “Erasing&Programming” 页面下的“二合一”烧录模式，可以在一次操作中完成FLASH和选项字的烧录工作。选项字的配置使用STM32CubeProgrammer命令行的 “-ob” 命令。

举例说明，现在要在烧写完Flash后，设置读保护为level1。可以按以下步骤先进行设置：
设置好要下载的可执行文件路径
勾选 “AutomaticMode” 下的 “Fullchip erase” 和 “Downloadfile”
$ e' U, l3 d/ f. M6 ^/ y在 “Optionbytes commands” 的输入框中输入：“-ob rdp=0xBB”
: R: Y  _+ m0 c7 H# O然后点击 “Start automatic mode” ，STM32CubeProgrammer就会开始按顺序执行上述的操作，同时在Log窗口显示整个执行的过程和进度。
关于选项字命令 “-ob”的格式说明，可以参考UM2237（用户手册STM32CubeProgrammer软件工具介绍）的3.2.15章节。但“-ob”命令中OptByte字段的定义在UM2237中没有说明，可以有两种方法来查询：一种是通过STM32CubeProgrammer图形界面下“Optionbytes”标签页中的“Name”一栏的名称，因为“-ob”命令中OptByte字段的定义与这里是一致的；还可以通过“-ob displ”命令来显示当前所有的选项字配置，从而也就可以知道各个OptByte字段的定义了。
( T6 u: S. }  R
4 [* |1 r) D# N" o  Z. ~
0 o6 {5 [6 I* z外部存储器读写
# O5 s2 B8 _3 T5 ^如果想要对通过 SPI，FMC，QSPI等接口连接到STM32的外部存储器进行读写操作，就需要一个external loader。
; u7 L2 S. A) z% E! _4 ~, v$ k
CubeProgrammer 默认提供了STM32开发板上集成的外部存储器对应的external loader。
用户如果使用了其他型号的存储器，也可以自己生成external loader文件(*. stldr)，详细操作请参考 UM2237 的第2.3.3章节。
在对外部存储器进行操作前，必须先在 “External Loader” 页面下，选择对应的external loader，该external loader会在接下来对外部存储器的操作中用到。然后就可以在 “Erasing&Programming” 页面和 “Memory&fileedition” 页面下进行擦除和烧写的操作了。
1 ], J' S: P& S1 ]3 t5 t$ c. D, F
Bootloader
# r: @& Y' H7 O2 A; T; Y- Z' Y* BSTM32MCU出厂时，内部的系统memory就已经烧好了bootloader，提供通过USART，USB，I2C，SPI，CAN等接口更新片上Flash的功能。

$ v2 V: b4 ^, W4 A不同STM32MCU型号支持的bootloader接口有所不同，具体可以参考应用手册AN2606。STLink v2或者STLink v3提供了从USART，USB，I2C，SPI和CAN等通信协议到USB的桥接接口，STM32MCU可以通过STLink v2或者STLink v3与PC端建立连接。而STM32CubeProgrammer则提供了PC端的操作界面，可以通过bootloader对片上Flash进行擦除和烧录。STLinkv2只提供了USART和USB两种通信接口，而STLink v3增加了I2C，SPI和CAN通信接口的支持。ST原来提供有两个独立的PC端软件：“STM32Flash loader demonstrator”和“Dfuse Demo”，分别支持USARTbootloader和USBDFU功能，现在只需要使用STM32CubeProgrammer一个软件就可以支持所有这些通信接口了。
5 a5 y9 N7 P9 e7 _/ vSWO信息输入窗口
$ M4 q+ w4 {: D8 b( R$ A我们在做开发的时候，经常会需要输出一些调试信息。
, x  i" F5 a) \! v+ C

+ o% g6 U* A# r# t6 _$ x5 H

8 c( j) l% x# t  J$ `8 k( p常用的方法就是通过重定向printf到串口来进行打印，这种方法需要占用一路串口。还有一种方法就是将printf重定向到SWD调试接口的SWO口，通过SWO来输出调试信息。STM32CubeProgrammer的SWV窗口可以显示SWO发送的调试信息，并且可以将所有接收到的信息保存在指定的“.log”文件中。

) J7 k; O2 e' N' |( l2 l
命令行界面
1 T6 m# t1 I) X9 gSTM32CubeProgrammer提供命令行界面，可以通过执行指令的方式实现大部分STM32CubeProgrammer的功能。
; A+ K9 \/ g& ~: M1 O

6 r6 x( c$ c- ^1 I1 u" \' R6 zSTM32_Programmer_CLI.exe 可执行文件在 STM32CubeProgrammer 安装路径下的 bin 文件夹下，执行 STM32_Programmer_CLI.exe 可以看到所有支持的指令及参数说明。
) N: N( H3 X  q8 [4 L命令行界面还提供了一些在图形化界面不具备的功能，例如：创建可信任包，安全烧录，计算 CRC 值等功能。详细说明请参考 UM2237。
图中举了一个通过SWD接口连接目标芯片并设置读保护级别1的例子，通过 “-c” 指令先与目标芯片建立连接，再通过 “-ob” 指令修改读保护的级别，完整的命令行指令为：STM32_Programmer_CLI.exe-c port=SWD -ob rdp=0xBB。

# F4 h; u9 Y" l9 R( ^! \
5 S5 I. Q- _  ]4 k! b. d5 {; bSTLink固件更新
将STLink调试器连接到电脑后，打开 STM32CubePorgrammer，刷新 STLink 连接就可以看到当前 STLink 的固件版本。点击 “Firmwareupgrade” 按钮，打开 STLinkUpgrade 工具可以对 STLink 固件版本进行更新。
1 P; ]; y2 C" a! Y8 Q1 F& g  j8 @+ T

STM32CubeProg 相关资源

如何找到STM32CubeProg

如上图，在浏览器地址栏中输入www.st.com/stm32cube，可以直接打开 STM32Cube 的主页面。以这个页面作为入口可以快速地找到 STM32Cube 生态系统下的所有软件工具和软件包，STM32CubeProgrammer 也在这其中。

; X% y8 ~  x7 O3 w: s! p- `
此外，直接在搜索栏搜索关键字“STM32CubeProg”也可以找到 STM32CubeProg 的主页面。在STM32CubeProgrammer页面的Overview标签页下有对STM32CubeProgrammer的介绍以及下载链接，在 Documentation 标签页下可以找到其相关的文档。


1 B4 Q! [3 v6 ]9 a

6 D, n4 r  d! W7 B" x) n% T用户手册及应用笔记
0 e1 \' p8 B+ Z* g/ r" S! b' ]UM2237 用户手册《STM32CubeProgrammer软件工具介绍》：本文档为通用文档，面向所有STM32产品，是关于 STM32CubeProgrammer 的详细使用说明以及命令行的命令用法说明；
5 e# `8 _$ {2 i  i0 Q
4 X; H0 ?+ L3 H, |- u
; z9 L+ w" \' A. R, A5 A" DUM2238 用户手册《创建STM32受信任包软件工具介绍》和 AN5054 应用笔记《通过STM32CubeProgrammer进行安全烧录》：与安全有关，介绍如何创建可信任包以及如何进行安全烧录。
9 i4 }& B+ x* g, ^3 S! Q

! I8 k, @" Z! X; {: vUM2543 用户手册《STM32MP1系列签名工具介绍》和 UM2542 用户手册《STM32MP1系列密钥生成器软件介绍》：STM32CubeProgrammer还集成了”STM32MP1系列密钥生成器”和“STM32MP1系列签名工具”，通过命令行对应的指令，可以生成ECC密钥对，并对固件进行签名。具体使用方法请参考上述两篇用户手册。
: X  M% c4 w4 y6 c0 U, m& j0 C# x
$ d9 P( |& V7 @9 F$ K

管管大人，谢谢你。因为有这篇文章，我折腾了半个月的keil无法烧录问题才告一段落。谢谢，真的谢谢。
8 n' k/ h* o8 ~; \