你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

新一代烧写工具 - STM32CubeProgrammer

[复制链接]
STMCU-管管 发布时间:2020-11-4 17:41
, P# w) h+ m2 A
# w! l- ]7 q, q
1.png / r5 c1 k' x0 N' O
STM32CubeProgrammer(STM32CubeProg)是STM32微控制器的专用编程工具。& C: E; ]0 G* V! u. Q& o
STM32用户都知道,当完成程序调试,需要对芯片进行程序代码烧录编程,一般会有三个选择:
8 ^6 k# G% Q) g9 k9 q( a通过调试接口【JTAG/SWD】来烧写程序,一般要使用STLink Utility或STVP工具软件来完成;. A# f" N& r; {$ h6 t1 y$ A- U; O6 Y
通过UART接口来烧写程序,需要下载基于PC端的flash 烧录工具软件STM32 Flash loader demonstrator配合;* K: \# P) d/ l# J0 q0 m8 f7 o8 O
通过USB接口来烧写程序,需下载USB DfuSe工具软件来实现。
: x/ L5 v- d- w" n+ z
2017年底,ST推出了多合一烧录工具STM32CubeProgrammer,以其高集成度支持上述三类编程接口,还兼具其它更多功能。% ~( s; {" l  ~% ?4 W& h0 D
STM32CubeProg 不断迭代,至2020年10月,更新至最新版 STM32CubeProgrammer 2.5.0(点击即可下载),增添更多新功能。
( B6 d4 Z1 O' T2 {( n8 J& ]
STM32CubeProgrammer 主要功能

: I! v% m: a: s$ D4 v' |1 ~; BSTM32Cube 软件家族中的 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,还可以对外部存储器进行编程。
9 d+ K+ b0 I3 z0 G" q4 a
6 h8 M. Q+ F% d

; [: X) i0 O: B# }$ tSTM32CubeProgrammer 提供了图形化和命令行两种用户界面。此外,STM32CubeProgrammer 还提供了C++ API, 用户可以将 STM32CubeProgrammer 的功能集成到自己所开发的PC端应用中。
4 Q0 H. T' s/ u5 F0 r% U
2.png
▲ STM32CubeProg的图形化界面
1 E' L' B% R5 O7 T) t. K2 y' ~

  z( @, g- w7 E* @图形化用户界面如上图所示,在右侧的配置区域,用户可以选择通过STLink调试接口,或者USB、UART等通信接口连接到STM32微控制器。连接到STM32 微控制器后,在“Device information”区域可以看到当前MCU的型号,版本和Flash大小等信息。如果连接的是ST官方的开发板,还会显示该开发板的名称。% v5 m7 K7 z  T! u% {6 n
: l. T/ @2 |& `" T! L: s# M  `7 d( [5 S
  b* k, Y  N! p7 M4 c6 p$ w+ ^% ^
那么,这里显示的信息都是来自哪里呢?其中“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进行连接时才能看到这个信息。% M3 Y. A7 i( f
5 W4 W& ^8 B  |2 ^6 e7 L% k- Y

* T% d' p6 N' `& E在STM32CubeProgrammer最左侧一栏可以在不同的功能标签页之间切换,进行不同的操作。+ ]9 r" f6 f  |, d

% T! j) Y' C) N: a& o: u1 y# A
  m1 ?3 `' s' ~, _
接下来,我们会对STM32CubeProgrammer的主要功能进行介绍,关于STM32CubeProgrammer的具体操作步骤,请参考”UM2237-STM32CubeProgrammer软件工具介绍”。
6 f. D% p% f1 y- T. i
2 \6 g, P/ d! K( k8 [% J7 [
片上擦除和读写
9 j" v( b( V8 I* z- MSTM32CubeProgrammer支持按扇区对Flash进行擦除和全片擦除。可以导入多种格式的执行文件进行烧录,支持的文件格式有:二进制文件(.bin),elf文件(.elf,.axf,.out),hex文件(.hex)和摩托罗拉的S-record文件(.srec)。
3.png
5 O3 T+ q% q4 {4 A( s" W3 a. r* ~, K; {" q
擦除操作% ~; m; J3 f% G/ ^% E) o
通过STLink与目标MCU建立连接后,在“Erasing&Programming”页面下,可以按扇区对flash进行擦除,或者选择“Fullchiperase”按钮,进行全片擦除。
4 w3 M& D4 D" `/ m* }/ S9 E* `  ~2 d, p) ]; ^
1 x1 u+ l7 n' _/ s6 W
烧录操作5 Y3 g7 e: m' m! |$ P0 Q5 j$ X
在“Erasing&Programming”页面下,点击“Browse”按钮导入可执行文件,然后点击“StartProgramming”进行烧录。
( N+ G& ^- F3 |# S5 Q5 H" A2 ~也可以在“Memory&fileedition”页面下,打开要烧录的可执行文件,然后点击“download”进行烧录。
: G' _& b0 t6 j3 L在“Memory&fileedition” 的“Device Memory”页面下,还可以读出当前指定地址范围的MCU存储器值,并通过“SaveAs”菜单将读出的内容保存为二进制文件(.bin), hex文件(.hex)或S-record文件(.srec)。
% v1 s, ]( b; _! p除了前面介绍的烧录整个可执行文件的方式以外,还可以在“Memory&fileedition” 的 “Device Memory”页面下直接修改某个地址的值,”回车”后STM32CubeProg会自动完成读出-修改-擦除-回写的操作。对于一次性可编程(OTP)字节就可以通过这种方式进行编程。
  Y' e( S9 \+ V
& _& A" a$ K/ x
% M% D# t! J! J8 Q% ^7 }5 i. X' G
选项字读写$ Z3 s9 Y( q1 J4 h
点开OB页面后,可以看到当前所连接MCU的选项字的设定情况。用户可以在这里修改选项字的值。具体选项字的说明,请参考对应MCU的参考手册。

- h  x# V- j' E$ K. {6 t- {
4.png " x0 H( |! _7 I! I
“二合一”烧录1 g" L, M: B* G8 D: M
使用 “Erasing&Programming” 页面下的“二合一”烧录模式,可以在一次操作中完成FLASH和选项字的烧录工作。选项字的配置使用STM32CubeProgrammer命令行的 “-ob” 命令。
: V0 `- ^+ B6 D3 F2 S/ f
5.png
! m0 k+ G9 z8 C: [. Q+ a, O/ w

& X1 w% z" Z" a, O5 [举例说明,现在要在烧写完Flash后,设置读保护为level1。可以按以下步骤先进行设置:+ ~. q2 j. m* q& \' S" F
设置好要下载的可执行文件路径
+ |- p9 d2 X1 X$ `' m勾选 “AutomaticMode” 下的 “Fullchip erase” 和 “Downloadfile”+ M, b" t$ X& v; {* M
在 “Optionbytes commands” 的输入框中输入:“-ob rdp=0xBB”
2 T" K# w# X8 }0 q) A然后点击 “Start automatic mode” ,STM32CubeProgrammer就会开始按顺序执行上述的操作,同时在Log窗口显示整个执行的过程和进度。
  J. s, |/ h9 `/ j" [关于选项字命令 “-ob”的格式说明,可以参考UM2237(用户手册STM32CubeProgrammer软件工具介绍)的3.2.15章节。但“-ob”命令中OptByte字段的定义在UM2237中没有说明,可以有两种方法来查询:一种是通过STM32CubeProgrammer图形界面下“Optionbytes”标签页中的“Name”一栏的名称,因为“-ob”命令中OptByte字段的定义与这里是一致的;还可以通过“-ob displ”命令来显示当前所有的选项字配置,从而也就可以知道各个OptByte字段的定义了。
( h# L& e$ L7 T" c- o
2 c; ?0 ?# [$ p' O

) ]( @8 w4 T5 W5 r9 @. T6 g- I外部存储器读写3 N1 i1 Z: R$ R! R7 G
如果想要对通过 SPI,FMC,QSPI等接口连接到STM32的外部存储器进行读写操作,就需要一个external loader。

9 B& w% d  c( D 7.png
' L) m7 ^4 ~- m/ w9 {0 K! C+ Y
CubeProgrammer 默认提供了STM32开发板上集成的外部存储器对应的external loader。" k' C0 l$ m5 e+ O' Q8 i
用户如果使用了其他型号的存储器,也可以自己生成external loader文件(*. stldr),详细操作请参考 UM2237 的第2.3.3章节。; B! S; y9 q7 f4 C
在对外部存储器进行操作前,必须先在 “External Loader” 页面下,选择对应的external loader,该external loader会在接下来对外部存储器的操作中用到。然后就可以在 “Erasing&Programming” 页面和 “Memory&fileedition” 页面下进行擦除和烧写的操作了。+ o! Z. S$ F" s

5 W% H! Q+ `" R8 mBootloader
  h3 B1 a( E& W4 g- Z  l: D, }1 oSTM32MCU出厂时,内部的系统memory就已经烧好了bootloader,提供通过USART,USB,I2C,SPI,CAN等接口更新片上Flash的功能。
9 H+ `8 w" z: ]# u) @6 A
8.png
. M" N$ @+ w3 e9 N# b! e7 i' _5 W

+ |9 C# v) N4 D6 b. N
, K4 `4 A2 q# |' j6 ^: Z9 h; h* ^7 K
不同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一个软件就可以支持所有这些通信接口了。
. }3 m4 t' Y. k, A$ S& U* P# B" DSWO信息输入窗口
! I, H9 b; _# C5 i我们在做开发的时候,经常会需要输出一些调试信息。

; s0 @) }1 o& L, F3 y
9.png ' G( l: V# O3 `  n( G5 p

+ ?' d2 i; x& g; f: ^常用的方法就是通过重定向printf到串口来进行打印,这种方法需要占用一路串口。还有一种方法就是将printf重定向到SWD调试接口的SWO口,通过SWO来输出调试信息。STM32CubeProgrammer的SWV窗口可以显示SWO发送的调试信息,并且可以将所有接收到的信息保存在指定的“.log”文件中。9 a+ T8 \* s% m7 g5 @2 o0 B' O

# H: H( t5 X& [( d. j- f
. {+ G% F& Q1 d+ h& q" H
命令行界面
' O9 t$ D9 Y, l+ [5 M' a* c$ oSTM32CubeProgrammer提供命令行界面,可以通过执行指令的方式实现大部分STM32CubeProgrammer的功能。

1 y7 f* H$ k' a( C' w' p
10.png
% W* W  B- f& M% Q/ C) O+ E7 }9 @- Y

. I' X& ]% ~# O* o4 M$ j6 _STM32_Programmer_CLI.exe 可执行文件在 STM32CubeProgrammer 安装路径下的 bin 文件夹下,执行 STM32_Programmer_CLI.exe 可以看到所有支持的指令及参数说明。
0 }/ u; m2 X. g  T' c) M' n$ e命令行界面还提供了一些在图形化界面不具备的功能,例如:创建可信任包,安全烧录,计算 CRC 值等功能。详细说明请参考 UM2237。
/ R% Y$ `6 K. a" S2 q8 T图中举了一个通过SWD接口连接目标芯片并设置读保护级别1的例子,通过 “-c” 指令先与目标芯片建立连接,再通过 “-ob” 指令修改读保护的级别,完整的命令行指令为:STM32_Programmer_CLI.exe-c port=SWD -ob rdp=0xBB。/ h+ i* [- ^! H5 @) c( E5 E+ Q% s) f2 Z
/ j% P% M: d% ~1 L, O: }% c

. T! }$ _3 C' ^# v- p! c5 W3 dSTLink固件更新! b8 }% V) A! d% D: t% P
将STLink调试器连接到电脑后,打开 STM32CubePorgrammer,刷新 STLink 连接就可以看到当前 STLink 的固件版本。点击 “Firmwareupgrade” 按钮,打开 STLinkUpgrade 工具可以对 STLink 固件版本进行更新。

+ R) j' U- D* L6 C
11.png
" m8 K' ~; |* Q! a5 P
STM32CubeProg 相关资源
如何找到STM32CubeProg
12.png / @" \& G7 o6 C. S/ U
如上图,在浏览器地址栏中输入www.st.com/stm32cube,可以直接打开 STM32Cube 的主页面。以这个页面作为入口可以快速地找到 STM32Cube 生态系统下的所有软件工具和软件包,STM32CubeProgrammer 也在这其中。
+ g  X- F* R: E; E: j/ c
& `' ?: p1 Y" \& I

6 s1 }$ C% ?% K- j此外,直接在搜索栏搜索关键字“STM32CubeProg”也可以找到 STM32CubeProg 的主页面。在STM32CubeProgrammer页面的Overview标签页下有对STM32CubeProgrammer的介绍以及下载链接,在 Documentation 标签页下可以找到其相关的文档。
; J" m# P3 p% a, l# n) T3 [; g6 D! n* s

0 I- u' r" E1 `& \3 _8 \9 s# ^" v) J7 g+ a* `3 A  g1 ~
5 X9 H7 L( M! p0 I- O' i$ @
用户手册及应用笔记
+ @& d5 i' B+ m; e! N0 v: M! \UM2237 用户手册《STM32CubeProgrammer软件工具介绍》:本文档为通用文档,面向所有STM32产品,是关于 STM32CubeProgrammer 的详细使用说明以及命令行的命令用法说明;! H3 h( r- V; a' n( w3 Y
5 p  D& i5 F/ k5 y! R, U
- S$ f2 h. l8 F& d9 ~5 k. V0 Z
UM2238 用户手册《创建STM32受信任包软件工具介绍》和 AN5054 应用笔记《通过STM32CubeProgrammer进行安全烧录》:与安全有关,介绍如何创建可信任包以及如何进行安全烧录。
6 u$ ^8 I3 h, ]1 m9 q8 D$ Y5 h
* X- B( G8 B: c. E3 Q) |

9 a# |% {" x" q) G3 tUM2543 用户手册《STM32MP1系列签名工具介绍》和 UM2542 用户手册《STM32MP1系列密钥生成器软件介绍》:STM32CubeProgrammer还集成了”STM32MP1系列密钥生成器”和“STM32MP1系列签名工具”,通过命令行对应的指令,可以生成ECC密钥对,并对固件进行签名。具体使用方法请参考上述两篇用户手册。
* U( M, h( z! F
. y" A* }; j- c. X7 ~! }- }: Z
9 q6 L- }% n, K7 r. T
赞 收藏 1 评论1 发布时间:2020-11-4 17:41

举报

1个回答
飞羽喜欢开发板 回答时间:2022-10-5 20:03:22
管管大人,谢谢你。因为有这篇文章,我折腾了半个月的keil无法烧录问题才告一段落。谢谢,真的谢谢。8 r4 b2 \7 W4 w5 }& C, ^/ R

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版