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

1 入门指南
' Z6 b$ o0 [4 o' S本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
STM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。
8 M3 m' V, E( q" X2 V+ R
2 }2 f+ n& Z+ t6 g/ z
/ G3 N# m% P: X! J4 ~/ e; O, q! f1.1 系统要求
! I; N5 l/ a* u- t5 e5 _( z支持的操作系统和架构为：
! I2 l1 A5 C* R5 J0 D• Linux® 64位
8 a$ i7 J) B+ _6 q, w• Windows® 7/8/10/11 32位和64位
& |% {% N' ?, M2 Q# p+ n" [• macOS®（最小版本OS X® Yosemite）
4 f4 m! c/ N0 K+ M& Q  s- S* k自版本2.6.0起，无需安装任何Java™ SE Run Time Environment。在STM32CubeProgrammer运行时，使用下载的软件包中提供的绑定JRE，不再使用您的计算机上安装的JRE。
注： 绑定JRE为Liberica 8.0.265。
对于macOS软件，最低要求如下
• Xcode®必须安装在macOS计算机上
, z  d+ L. Y) q; N4 g! G. M• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
支持的最小屏幕分辨率为1024x768。
' c& O  J2 {7 U9 m1 j. j5 n% [! T2 B
. b( b/ s+ D; H. _7 k
/ i! N  f) N3 u. r1.2 安装STM32CubeProgrammer
; O3 Z  `( o! Z* ?+ L本节介绍使用STM32CubeProgrammer软件的要求和步骤。该装置还提供了“STM32 trusted package creator”工具的可选安装，该工具可用来创建安全的固件文件，用于安全的固件安装与更新。请参考STM32 Trusted Package Creator工具软件说明（UM2238）了解更多信息。


1.2.1 Linux安装
" z9 H5 V6 d  C' z4 O. `5 ?如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
sudo apt-get install libusb-1.0.0-dev
% `, \1 @& S9 t- x0 q4 ?: H$ |5 V. D7 u9 e要使用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图标默认不启用。如需启用，右键单击图标并选择“允许启动”。

& k: }1 ?3 x1 s, `) Z* }
1.2.2 Windows安装
3 t( [9 u$ M" X% e# ^& ]' `: x3 b为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。
$ t: w# e2 F/ b/ C. l
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安装文件启动安装向导。
如果发生错误，则尝试以下修复方式中的一种：
* ^+ g; z( K( F( I( }6 s• $sudo xattr -cr ~/SetupSTM32CubeProgrammer-macos.app
# N/ Z( Q+ B, T3 P• 用指令启动.exe文件sudo java -jar SetupSTM32CubeProgrammer-2.7.0.exe。

8 v8 \- @7 F9 n( p7 h" C2 H1.2.4 DFU驱动程序
如果您在USB DFU模式下使用STM32器件，则需要通过运行“STM32 Bootloader.bat”文件来安装STM32CubeProgrammer的DFU驱动程序。该驱动程序随发布包提供，可在DFU Driver文件夹中找到。
如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。


- [6 o7 h, X/ p8 B  E* w' @

* x2 U2 u. x  l- H+ p8 w

( M& x: B. z; B  ?
1.2.5 ST-LINK驱动程序
* I* T0 \; P4 a8 T为了使用ST-LINK/V2、ST-LINKV2-1或ST-LINK-V3通过调试接口连接到STM32器件，运行“stlink_winusb_install.bat”文件以便安装ST-LINK驱动程序。该驱动程序随发布包提供，可在“Driver/stsw-link009_v3”文件夹中找到。


1.3 更新
STM32CubeProgrammer更新程序使用户能够执行软件及其相关软件包的自动更新。支持的所有操作系统（即Windows 10/11、Linux和macOS）均可使用该更新程序。

' D% f3 Y5 N9 T$ D
4 R& K) N1 P5 W; n" E1.3.1 更新步骤
1. 检查连接，必要时更新连接设置
2 y1 L( W8 }0 T7 u2. 检查更新
3. 下载新版本
4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
• 无代理
; @9 i/ D9 E/ N, N9 [, V# V• 使用系统参数
2 s+ T+ ]6 p9 E• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图
: T' D* Q6 j4 N$ w" S



完整版请查看：附件