引言STM32CubeProgrammer（STM32CubeProg）为任意环境下的STM32器件编程提供了一个一体化的软件工具：多操作系统，图形用户界面或命令行界面，支持多种连接选择（JTAG、SWD、USB、UART、SPI、CAN和I2C），采用手动操作或通过脚本自动操作。
本文档详细介绍了硬件和软件环境先决条件，以及可用的STM32CubeProgrammer软件功能。
, e0 ?9 B- x- q8 e
2 D3 W# _7 }+ M% y$ [" [1 入门指南
* p2 x& @7 G. G. }4 r本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
0 j5 f0 v: P: {8 ]' w0 X6 q9 kSTM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。
2 i, p/ n, Z1 w& P3 @- O6 ~! a# e
2 B7 H& b4 J& C; b" K  ?% Q8 N
* G. Q  S2 C  T8 k$ W; A1.1 系统要求
支持的操作系统和架构为：
• Linux® 64位
" ?7 S* Z; {/ W) L5 p/ q• Windows® 7/8/10/11 32位和64位
5 ~9 Q; W1 r1 g9 u5 h1 A• macOS®（最小版本OS X® Yosemite）
自版本2.6.0起，无需安装任何Java™ SE Run Time Environment。在STM32CubeProgrammer运行时，使用下载的软件包中提供的绑定JRE，不再使用您的计算机上安装的JRE。
注： 绑定JRE为Liberica 8.0.265。
* L; k3 J. T; ]  r对于macOS软件，最低要求如下
• Xcode®必须安装在macOS计算机上
• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
6 Y/ b4 ]- e; U4 @" s/ k支持的最小屏幕分辨率为1024x768。


: \( m; v' ~  Y3 x# [1.2 安装STM32CubeProgrammer
5 s5 T- z) P; \# x, c. W/ G本节介绍使用STM32CubeProgrammer软件的要求和步骤。该装置还提供了“STM32 trusted package creator”工具的可选安装，该工具可用来创建安全的固件文件，用于安全的固件安装与更新。请参考STM32 Trusted Package Creator工具软件说明（UM2238）了解更多信息。


1.2.1 Linux安装
, B3 d( A9 d" I, U! B4 E如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
sudo apt-get install libusb-1.0.0-dev
) z+ Q* E9 i- o5 N5 u! d9 S# v要使用ST-LINK工具或USB DFU连接到目标，需要将位于Driver/rules 文件夹下的规则文件复制在Ubuntu上的/etc/udev/rules.d/文件夹中（"sudo cp *.* /etc/udev/rules.d"）。
注： 需要使用libusb1.0.12版本或更高版本来运行STM32CubeProgrammer。
为了安装STM32CubeProgrammer工具，在Linux计算机上用STM32CubeProg-Linux产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.linux，它将指导您完成安装过程。Ubuntu 20 STM32CubeProgrammer图标默认不启用。如需启用，右键单击图标并选择“允许启动”。

) j/ ~$ ]) s: R7 |) O& R
5 V7 p2 c- i9 Y* m# Q$ t- J) [$ H; [1.2.2 Windows安装
为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。

3 m9 R8 C7 d9 s+ T1.2.3 macOS安装
为了安装STM32CubeProgrammer工具，用STM32CubeProg-Mac产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.app，它将指导您完成安装过程。
7 r3 A" m5 L" t5 r9 M) K8 {5 Z注： 如果安装失败，则在CLI模式下使用指令./SetupSTM32CubeProgrammerx.y.z.app/Contents/MacOs/SetupSTM32CubeProgrammer-x_y_z_macos进行启动。
确保拥有管理员权限，然后双击SetupSTM32CubeProgrammer-macos安装文件启动安装向导。
+ U7 W- _% O3 e9 k如果发生错误，则尝试以下修复方式中的一种：
• $sudo xattr -cr ~/SetupSTM32CubeProgrammer-macos.app
- O/ ~- G, {4 D4 l" I- P• 用指令启动.exe文件sudo java -jar SetupSTM32CubeProgrammer-2.7.0.exe。

1 `" K& \7 \. c, y$ v+ U1.2.4 DFU驱动程序
如果您在USB DFU模式下使用STM32器件，则需要通过运行“STM32 Bootloader.bat”文件来安装STM32CubeProgrammer的DFU驱动程序。该驱动程序随发布包提供，可在DFU Driver文件夹中找到。
+ u7 U7 n* o  B% B如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。
( I5 x( S6 k% M) e' `


6 s: d: Z. N+ U# j5 H% x
# u5 N% e: N4 D5 W2 H4 u


1.2.5 ST-LINK驱动程序
为了使用ST-LINK/V2、ST-LINKV2-1或ST-LINK-V3通过调试接口连接到STM32器件，运行“stlink_winusb_install.bat”文件以便安装ST-LINK驱动程序。该驱动程序随发布包提供，可在“Driver/stsw-link009_v3”文件夹中找到。
! s9 P" H2 h( D8 F$ x
& L; ^- Q5 y/ d- V- W
/ R' S; p$ c' E. N1 t- _# z1.3 更新
STM32CubeProgrammer更新程序使用户能够执行软件及其相关软件包的自动更新。支持的所有操作系统（即Windows 10/11、Linux和macOS）均可使用该更新程序。
( [7 A4 @& L( {) w6 ~, G6 P

' d5 q' i2 E: A/ e2 x6 O8 e2 v1.3.1 更新步骤
' j& a. h0 h4 ?# U" p$ _  y1. 检查连接，必要时更新连接设置
2. 检查更新
! @* t3 U  x6 g8 z; L1 {* Q3. 下载新版本
- ^4 |4 V; m2 }8 e9 N4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
• 无代理
• 使用系统参数
• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图




7 y/ t" S% l9 a! v& ~完整版请查看：附件

0 b- C8 w) k2 X4 e7 e