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

/ d% B9 q* X9 I4 s1 入门指南
本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
1 ]# e9 z$ Z4 H+ f  L" z7 C5 O$ `STM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。
* @; C7 }4 Y3 P6 k9 k$ m. l( C

1.1 系统要求
  M4 Z/ }2 A: w0 m& q+ |7 G3 G支持的操作系统和架构为：
6 {, s, A. [% g• Linux® 64位
9 M5 g, f  U4 f2 D1 v• Windows® 7/8/10/11 32位和64位
• macOS®（最小版本OS X® Yosemite）
1 R# }2 Y5 b) F! A5 N& s自版本2.6.0起，无需安装任何Java™ SE Run Time Environment。在STM32CubeProgrammer运行时，使用下载的软件包中提供的绑定JRE，不再使用您的计算机上安装的JRE。
注： 绑定JRE为Liberica 8.0.265。
, I3 A  j9 b* |/ C: `8 `+ Q3 d! W6 P8 G对于macOS软件，最低要求如下
& W( e; B3 M, p) A+ n) f2 i% z• Xcode®必须安装在macOS计算机上
• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
2 b; E0 T3 S0 J! P7 d; a支持的最小屏幕分辨率为1024x768。


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

% [2 B2 a3 i& X$ b& I1 d1.2.1 Linux安装
如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
9 B( U- L4 {5 J0 _2 K% V7 fsudo apt-get install libusb-1.0.0-dev
要使用ST-LINK工具或USB DFU连接到目标，需要将位于Driver/rules 文件夹下的规则文件复制在Ubuntu上的/etc/udev/rules.d/文件夹中（"sudo cp *.* /etc/udev/rules.d"）。
" e( o; z) H# D+ V% @) }2 C注： 需要使用libusb1.0.12版本或更高版本来运行STM32CubeProgrammer。
为了安装STM32CubeProgrammer工具，在Linux计算机上用STM32CubeProg-Linux产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.linux，它将指导您完成安装过程。Ubuntu 20 STM32CubeProgrammer图标默认不启用。如需启用，右键单击图标并选择“允许启动”。

' d/ Y  c0 l! ?3 D
1.2.2 Windows安装
: `5 `$ `9 V9 K. v为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。

, @0 d3 O4 P" ?! k! z1.2.3 macOS安装
6 e2 ]9 M3 Z  S9 m+ s" W为了安装STM32CubeProgrammer工具，用STM32CubeProg-Mac产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.app，它将指导您完成安装过程。
注： 如果安装失败，则在CLI模式下使用指令./SetupSTM32CubeProgrammerx.y.z.app/Contents/MacOs/SetupSTM32CubeProgrammer-x_y_z_macos进行启动。
. l8 `$ ^" O% `) ^& T9 A3 u2 }确保拥有管理员权限，然后双击SetupSTM32CubeProgrammer-macos安装文件启动安装向导。
6 r3 y. N3 d" k" @, f  u/ V如果发生错误，则尝试以下修复方式中的一种：
" r9 ~; V- }5 t" z. U6 C0 |& P• $sudo xattr -cr ~/SetupSTM32CubeProgrammer-macos.app
• 用指令启动.exe文件sudo java -jar SetupSTM32CubeProgrammer-2.7.0.exe。

1.2.4 DFU驱动程序
如果您在USB DFU模式下使用STM32器件，则需要通过运行“STM32 Bootloader.bat”文件来安装STM32CubeProgrammer的DFU驱动程序。该驱动程序随发布包提供，可在DFU Driver文件夹中找到。
$ F! F! l6 J5 o4 v/ X2 S如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。
0 D/ y. r1 ]. P5 z# j0 {' v! w
6 h  T8 F2 |$ {& E& v, P; d



" \  k  d6 l( f7 Z/ B

1.2.5 ST-LINK驱动程序
& _; L# n# G; x' m  p( T为了使用ST-LINK/V2、ST-LINKV2-1或ST-LINK-V3通过调试接口连接到STM32器件，运行“stlink_winusb_install.bat”文件以便安装ST-LINK驱动程序。该驱动程序随发布包提供，可在“Driver/stsw-link009_v3”文件夹中找到。
8 M+ _0 n) y3 v. v' g7 H
# h. A4 o  z* v* u
1.3 更新
+ j' z+ l" f& ]- g6 n: S) N2 `1 H$ g6 ESTM32CubeProgrammer更新程序使用户能够执行软件及其相关软件包的自动更新。支持的所有操作系统（即Windows 10/11、Linux和macOS）均可使用该更新程序。
2 |- O9 p6 F$ ?! ?$ M8 ^" d- s& p) G" y
3 }3 a1 `8 H* S: a8 B# u4 n
1.3.1 更新步骤
* X4 N8 l& R0 f7 `3 W  j* f1. 检查连接，必要时更新连接设置
2. 检查更新
3. 下载新版本
$ C. n  H( D" |4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
; M* O0 u4 |2 m1 A: Y7 ^• 无代理
4 q# y: r: U' D+ I9 h7 A8 E# e• 使用系统参数
5 K3 R" q! P& m) l• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图



, F6 o; q  f6 J
完整版请查看：附件