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

1 入门指南
本节介绍安装STM32CubeProgrammer软件工具的要求和步骤。
STM32CubeProgrammer支持基于Arm®(a) Cortex®-M处理器的STM32 32位MCU和基于Arm®Cortex®-A处理器的STM32 32位MPU。


1.1 系统要求
支持的操作系统和架构为：
• 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软件，最低要求如下
• Xcode®必须安装在macOS计算机上
• Xcode®和Rosetta®必须安装在内置Apple® M1处理器的macOS计算机上
支持的最小屏幕分辨率为1024x768。


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


1.2.1 Linux安装
如果使用USB端口连接STM32器件，则输入以下指令安装libusb1.0软件包：
sudo 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"）。
注： 需要使用libusb1.0.12版本或更高版本来运行STM32CubeProgrammer。
为了安装STM32CubeProgrammer工具，在Linux计算机上用STM32CubeProg-Linux产品编号从网站下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.linux，它将指导您完成安装过程。Ubuntu 20 STM32CubeProgrammer图标默认不启用。如需启用，右键单击图标并选择“允许启动”。


1.2.2 Windows安装
为了安装STM32CubeProgrammer工具，从STM32CubeProg-Win-32bits或STM32CubeProgWin-64bits（分别适用于Windows 32位和Windows 64位操作系统）下载zip压缩包并解压缩，并执行SetupSTM32CubeProgrammer-vx.y.z.exe，它将指导您完成安装过程。

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安装文件启动安装向导。
如果发生错误，则尝试以下修复方式中的一种：
• $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文件夹中找到。
如果您的计算机上安装了DFUSE驱动程序，则首先卸载程序，然后重启计算机并运行前面提到的“.bat”文件。为避免插入板件时和之后重复安装旧版驱动程序，必须选中“删除此器件的驱动程序软件”选项。







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”文件夹中找到。


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


1.3.1 更新步骤
1. 检查连接，必要时更新连接设置
2. 检查更新
3. 下载新版本
4. 安装下载的版本（更新后工具重启）1.3.2 代理设置用户可使用“代理设置”窗口手动检查连接，该窗口可通过帮助按钮中提供的子菜单打开（参见图 4）。有三种不同的代理设置可供选择（图 5）：
• 无代理
• 使用系统参数
• 使用服务器的手动配置：输入HTTP代理名称、端口和凭证图




完整版请查看：附件