引言STM32CubeProgrammer（STM32CubeProg）为任意环境下的STM32器件编程提供了一个一体化的软件工具：多操作系统，图形用户界面或命令行界面，支持多种连接选择（JTAG、SWD、USB、UART、SPI、CAN和I2C），采用手动操作或通过脚本自动操作。
: U2 T8 C. l9 }! s6 ]" y4 G本文档详细介绍了硬件和软件环境先决条件，以及可用的STM32CubeProgrammer软件功能。

1 入门指南
* f: H0 |% ~5 n5 q* ~本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
0 O1 _5 M0 `) x. z/ h( ]: A2 _STM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。

. v, ?" x5 Q  G- U! `
; V# L' g# G5 h0 S. m1.1 系统要求
支持的操作系统和架构为：
2 I5 a* Z2 z0 ~4 W8 J• Linux® 64位
• Windows® 7/8/10/11 32位和64位
• macOS®（最小版本OS X® Yosemite）
自版本2.6.0起，无需安装任何Java™ SE Run Time Environment。在STM32CubeProgrammer运行时，使用下载的软件包中提供的绑定JRE，不再使用您的计算机上安装的JRE。
注： 绑定JRE为Liberica 8.0.265。
对于macOS软件，最低要求如下
/ M+ P0 I' |6 u  n; {" t• Xcode®必须安装在macOS计算机上
• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
支持的最小屏幕分辨率为1024x768。


* F2 J, _3 h2 _9 F7 P$ X1 V# [8 ?1.2 安装STM32CubeProgrammer
本节介绍使用STM32CubeProgrammer软件的要求和步骤。该装置还提供了“STM32 trusted package creator”工具的可选安装，该工具可用来创建安全的固件文件，用于安全的固件安装与更新。请参考STM32 Trusted Package Creator工具软件说明（UM2238）了解更多信息。

3 r- l& y$ M+ k& W) F6 D
1.2.1 Linux安装
如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
) a  {5 @. s. [0 Ysudo apt-get install libusb-1.0.0-dev
9 \- ]6 R& P! O8 o8 f/ l要使用ST-LINK工具或USB DFU连接到目标，需要将位于Driver/rules 文件夹下的规则文件复制在Ubuntu上的/etc/udev/rules.d/文件夹中（"sudo cp *.* /etc/udev/rules.d"）。
% X  f0 J9 f4 G/ J4 S5 c' z; C注： 需要使用libusb1.0.12版本或更高版本来运行STM32CubeProgrammer。
% r2 `' V/ C! \+ C+ a3 j为了安装STM32CubeProgrammer工具，在Linux计算机上用STM32CubeProg-Linux产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.linux，它将指导您完成安装过程。Ubuntu 20 STM32CubeProgrammer图标默认不启用。如需启用，右键单击图标并选择“允许启动”。
( a3 v! j7 A$ d0 ]2 u$ x

1.2.2 Windows安装
7 {3 a, p+ l1 M& l) }- y! R+ R为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。

1.2.3 macOS安装
  c5 A/ J* l- z, }/ U& B; Z3 ]7 u为了安装STM32CubeProgrammer工具，用STM32CubeProg-Mac产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.app，它将指导您完成安装过程。
9 f4 e' ]9 o" i# M0 `注： 如果安装失败，则在CLI模式下使用指令./SetupSTM32CubeProgrammerx.y.z.app/Contents/MacOs/SetupSTM32CubeProgrammer-x_y_z_macos进行启动。
  k/ D0 \* u6 K" ?* [+ l) U* F确保拥有管理员权限，然后双击SetupSTM32CubeProgrammer-macos安装文件启动安装向导。
( j7 X4 D6 v+ p7 C0 T2 p% Y6 Y* D如果发生错误，则尝试以下修复方式中的一种：
# s4 _+ J& |, v8 a8 K, K• $sudo xattr -cr ~/SetupSTM32CubeProgrammer-macos.app
• 用指令启动.exe文件sudo java -jar SetupSTM32CubeProgrammer-2.7.0.exe。

1.2.4 DFU驱动程序
( C* C+ W' B& G' @8 w; s# i如果您在USB DFU模式下使用STM32器件，则需要通过运行“STM32 Bootloader.bat”文件来安装STM32CubeProgrammer的DFU驱动程序。该驱动程序随发布包提供，可在DFU Driver文件夹中找到。
如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。
, A; {8 ?' B5 e. t  z' v7 n
  q1 H  }) i6 Y' K; h


% ~) m- J# J) m3 Q, k7 `6 ~
3 W% Q' X' ~, m6 o! F
2 z8 M# H+ n$ F# F" `/ W8 [
) n4 v: a( @  }! C: n0 R( o1.2.5 ST-LINK驱动程序
为了使用ST-LINK/V2、ST-LINKV2-1或ST-LINK-V3通过调试接口连接到STM32器件，运行“stlink_winusb_install.bat”文件以便安装ST-LINK驱动程序。该驱动程序随发布包提供，可在“Driver/stsw-link009_v3”文件夹中找到。
% i9 r- R$ N; `8 r" A2 H

5 O' w% T3 N3 A) B1.3 更新
STM32CubeProgrammer更新程序使用户能够执行软件及其相关软件包的自动更新。支持的所有操作系统（即Windows 10/11、Linux和macOS）均可使用该更新程序。


1.3.1 更新步骤
9 x3 `4 i( v: {* h8 @1. 检查连接，必要时更新连接设置
- d7 @7 Q6 O( N8 m4 J, D2. 检查更新
+ f& O' h" j: k) o! X3. 下载新版本
% {# v' U" p( B+ r  V, R4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
$ Q  v& \+ V) A  _! ^( G• 无代理
• 使用系统参数
/ D% A. B" N: T  a$ n8 i• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图
* J) b& m( U: w/ s- [



: {; ?3 G' l% I2 _' r9 q完整版请查看：附件
. W8 D% w! [% ]5 g. C