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

1 入门指南
& P$ b& Q' M+ k+ U  q本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
) }$ b1 L( p) m+ y4 K; M0 a- OSTM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。


1.1 系统要求
# Q, t- s: }$ }" V5 z支持的操作系统和架构为：
$ d: _1 y# \$ {• 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软件，最低要求如下
  {2 \6 i/ B2 ]6 u* z; W- d• Xcode®必须安装在macOS计算机上
• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
! k+ _" ~9 U, ]支持的最小屏幕分辨率为1024x768。


1.2 安装STM32CubeProgrammer
本节介绍使用STM32CubeProgrammer软件的要求和步骤。该装置还提供了“STM32 trusted package creator”工具的可选安装，该工具可用来创建安全的固件文件，用于安全的固件安装与更新。请参考STM32 Trusted Package Creator工具软件说明（UM2238）了解更多信息。

+ a. @0 V) M7 G; i, _7 L
$ z' K$ ^- }3 D; I6 i0 ]1.2.1 Linux安装
如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
& ?) H- ~0 ^$ ^& `sudo apt-get install libusb-1.0.0-dev
9 `9 O# F; G" r* ?1 t) j3 E要使用ST-LINK工具或USB DFU连接到目标，需要将位于Driver/rules 文件夹下的规则文件复制在Ubuntu上的/etc/udev/rules.d/文件夹中（"sudo cp *.* /etc/udev/rules.d"）。
6 x) N9 g; m! H9 m6 p# F1 S; x注： 需要使用libusb1.0.12版本或更高版本来运行STM32CubeProgrammer。
为了安装STM32CubeProgrammer工具，在Linux计算机上用STM32CubeProg-Linux产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.linux，它将指导您完成安装过程。Ubuntu 20 STM32CubeProgrammer图标默认不启用。如需启用，右键单击图标并选择“允许启动”。


1 Q! L; H& S( W: u# c1.2.2 Windows安装
为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。

; R* s+ w6 @! h# _. v# ]1.2.3 macOS安装
为了安装STM32CubeProgrammer工具，用STM32CubeProg-Mac产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.app，它将指导您完成安装过程。
注： 如果安装失败，则在CLI模式下使用指令./SetupSTM32CubeProgrammerx.y.z.app/Contents/MacOs/SetupSTM32CubeProgrammer-x_y_z_macos进行启动。
确保拥有管理员权限，然后双击SetupSTM32CubeProgrammer-macos安装文件启动安装向导。
; m6 K$ r7 u+ f) h如果发生错误，则尝试以下修复方式中的一种：
3 x: K% F3 _$ n2 u4 Q- W9 G8 S' B• $sudo xattr -cr ~/SetupSTM32CubeProgrammer-macos.app
5 p( B  B# d, u2 ]• 用指令启动.exe文件sudo java -jar SetupSTM32CubeProgrammer-2.7.0.exe。
6 m. S) o3 [9 X: I; x0 l" J0 O  Z
1.2.4 DFU驱动程序
' }7 M2 C5 t0 E4 m3 i如果您在USB DFU模式下使用STM32器件，则需要通过运行“STM32 Bootloader.bat”文件来安装STM32CubeProgrammer的DFU驱动程序。该驱动程序随发布包提供，可在DFU Driver文件夹中找到。
如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。



) p( T  ?4 {$ T5 e. H, [



/ `: x+ [! H$ R; `' k, c1.2.5 ST-LINK驱动程序
/ j3 Y- ]6 z4 c9 F1 B* n为了使用ST-LINK/V2、ST-LINKV2-1或ST-LINK-V3通过调试接口连接到STM32器件，运行“stlink_winusb_install.bat”文件以便安装ST-LINK驱动程序。该驱动程序随发布包提供，可在“Driver/stsw-link009_v3”文件夹中找到。
, y9 P/ L% l! \' i
" e2 q5 a/ P  {- x
1.3 更新
' Z5 V& c  j, N5 X+ tSTM32CubeProgrammer更新程序使用户能够执行软件及其相关软件包的自动更新。支持的所有操作系统（即Windows 10/11、Linux和macOS）均可使用该更新程序。
0 [( [1 j! E, E
, ?* ~1 T7 Z' S7 v
1.3.1 更新步骤
7 L2 Y( d$ s) L! z) F1. 检查连接，必要时更新连接设置
6 ]' K& v3 W0 i3 M+ `$ @' ]2. 检查更新
3. 下载新版本
4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
9 X6 ?) v$ E8 q3 N• 无代理
• 使用系统参数
• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图

) S  E% G# S, N5 m4 l/ V* t

6 ~0 q/ w7 ~2 Z$ }' D  r
; f5 K6 O% e" |# f  A( k5 e5 I完整版请查看：附件
% ?6 W8 A" w+ \$ d8 K) e! P
# x+ R7 {# z( |: M! b3 Q( e! j: y5 Q