UM3088
STM32Cube 命令行工具集快速入门指南
用户手册
介绍
本文档是用户快速入门 STM32CubeCLT 的简要指南，STM32CubeCLT 是 STMicroelectronics 用于 STMXNUMX MCU 的命令行工具集。
STM32CubeCLT 提供所有打包的 STM32CubeIDE 工具，供第三方 IDE 在命令提示符下使用，或持续集成和持续开发 (CD/CI)。
精简的单个 STM32CubeCLT 软件包包括：
- ST 工具的 CLI（命令行界面）版本，例如工具链、探针连接实用程序和闪存编程实用程序
- 最新的系统 view 描述符 (SVD) files
- 任何其他与 IDE 相关的元数据 STM32CubeCLT 允许：
- 使用增强的 STM32 GNU 工具链为 STM32 MCU 设备构建程序
- 编程STM32 MCU内部存储器（闪存、RAM、OTP等）和外部存储器
- 验证编程内容（校验和，编程期间和之后的验证，与 file)
- 自动化 STM32 MCU 编程
- 通过 STM32 MCU 产品的接口调试应用程序，使用基本调试功能提供对 MCU 内部资源的访问
一般信息
用于 STM32 MCU 的 STM32CubeCLT 命令行工具集提供了用于构建、编程、运行和调试基于 Arm® Cortex® ‑M 处理器的 STM32 微控制器的应用程序的工具。
笔记：
Arm 是 Arm Limited（或其子公司）在美国和/或其他地方的注册商标。
参考文档
- STM32 MCU 的命令行工具集 (DB4839)，STM32CubeCLT 数据简介
- STM32CubeCLT安装指南（UM3089）
- STM32CubeCLT 发行说明 (RN0132)
本文档中的屏幕截图
第 2 节、第 3 节和第 4 节中提供的屏幕截图仅用于amp命令提示符下的工具用法文件。
本文档中未说明在第三方 IDE 中的集成或在 CD/CI 脚本中的使用。
建筑
STM32CubeCLT 软件包包含用于为 STM32 微控制器构建程序的 STM32 工具链的 GNU 工具。 Windows® 控制台窗口 example如图1所示。
- 在项目文件夹中打开一个控制台。
- 执行以下命令构建项目：> make -j8 all -C .\Debug
笔记： make 实用程序可能需要一个单独的安装步骤。
电路板编程
STM32CubeCLT 包中包含 STM32CubeProgrammer (STM32CubeProg)，用于将先前获得的构建编程到目标 STM32 微控制器中。
- 确保检测到 ST-LINK 连接
- 在控制台窗口中选择项目文件夹位置
- 或者，擦除所有闪存内容（参见图 2）： > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
- 上传程序 file 到 0x08000000 闪存地址（参见图 3）： > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000
调试
除了用于 STM32 工具链的 GNU 工具之外，STM32CubeCLT 包还包含 ST-LINK GDB 服务器。 两者都需要启动调试会话。
- 在另一个 Windows® PowerShell® 窗口中启动 ST-LINK GDB 服务器（参见图 4）： > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
- 使用 STM32 工具链的 GNU 工具在 PowerShell® 窗口中启动 GDB 客户端：
> arm-无-eabi-gdb.exe
> (gdb) target remote localhost:port（使用GDB服务器打开连接时指示的端口）
建立连接并显示 GDB 服务器会话消息，如图 5 所示。然后可以在调试会话中运行 GDB 命令，例如使用 GDB 重新加载 .elf 程序： > (gdb) load YOUR_PROGRAM.elf
修订历史
表 1. 文档修订历史
| 日期 | 修订 | 更改 |
| 16 年 23 月 XNUMX 日 | 1 | 初始版本。 |
重要通知——请仔细阅读
STMicroelectronics NV 及其子公司 (“ST”) 保留随时更改、更正、增强、修改和改进 ST 产品和/或本文档的权利，恕不另行通知。购买者应在下订单前获取有关 ST 产品的最新相关信息。ST 产品根据订单确认时有效的 ST 销售条款和条件销售。
购买者对 ST 产品的选择、挑选和使用负全部责任，ST 对应用协助或购买者产品的设计不承担任何责任。
ST 在此不授予任何明示或暗示的知识产权许可。
如果转售的 ST 产品的规定与此处所述的信息不同，则 ST 对该产品授予的任何保证将失效。
ST 和 ST 徽标是 ST 的商标。有关 ST 商标的更多信息，请参阅 www.st.com/trademarks. 所有其他产品或服务名称均属于其各自所有者的财产。
本文档中的信息取代并替换了该文档之前任何版本中提供的信息。
UM3088 – 修订版 1 – 2023 年 XNUMX 月
如需更多信息，请联系您当地的意法半导体销售办事处。
www.st.com
© 2023 STMicroelectronics – 保留所有权利
文件/资源
 | ST STM32Cube 命令行工具集 [pdf] 用户手册 UM3088, STM32Cube 命令行工具集, STM32Cube, 命令行工具集, 工具集 |
 | ST STM32Cube 命令行工具集 [pdf] 用户手册 RN0132、STM32Cube 命令行工具集、STM32Cube、命令行工具集、行工具集、工具集 |
