应用笔记LAT1187+在Keil中使用STM32CubeProgrammer

STM32 MCU 新产品的早期用户有时候会遇见工具链还在完善中的情形，例如，一部分 STM32 工具已经支持该产品，而另外一部分 STM32 工具还在更新中。具体到 Keil 用户， 用户有可能可以使用 STM32CubeProgrammer 进行下载，但是 Keil 编译器中支持该产品 系列的软件 Pack 还需要一些时间才会被更新。从而，用户能够使用 Keil 编译器进行编译 甚至调试，但没法直接在 Keil 环境中对新产品进行下载。对此，用户可以选择等待，也可 以自行扩展 Keil 的 FLM 来支持该产品。但考虑到用户产品开发的时间限制以及新的 STM32 正式 Pack 很快就会发布，更简单快速的一种解决方案是在 Keil 中直接使用 STM32CubeProgammer 在进行调试前下载。 ### 应用笔记LAT1187+: 在Keil中使用STM32CubeProgrammer #### 1. 前言 随着STM32微控制器（MCU）新产品的不断推出，开发人员可能会遇到工具链尚未完全适配新产品的状况。这种情况下，尽管某些工具已经支持新产品，但其他的工具可能还需要一段时间才能完成更新。对于使用Keil开发环境的用户而言，可能已经能够利用STM32CubeProgrammer进行固件的下载操作，但在Keil编译器中支持该产品的软件包（Pack）可能尚未更新到位。这意味着开发者虽然能够使用Keil编译器进行编译和调试，但却无法直接通过Keil环境对新产品进行程序的下载。 面对这种情况，开发者有两种选择：等待新的STM32 Pack发布或者自行扩展Keil的FLM文件来支持新产品。然而，考虑到项目开发周期的压力和STM32正式Pack即将发布的实际情况，本指南推荐了一种更为简单且快速的方法——在Keil环境中直接使用STM32CubeProgrammer进行程序下载。 #### 2. 使用STM32CubeProgrammer进行Flash编程 ##### 2.1 准备工作 以NUCLEO-H723ZG开发板上的CRC_Example为例，此例程是STM32Cube包中提供的一个完整的工程，能够正常地使用配套的Pack进行编译、下载和调试。下面将详细介绍如何直接使用STM32CubeProgrammer进行Flash下载： 1. **打开配置菜单**：在Keil工程界面中选择[Flash]->[Configure Flash Tools]菜单项，或者右键点击工程名称，选择[Options]，然后进入[Utilities]页面。 2. **查看当前配置**：如图3所示，此时可以看到该工程默认使用的是Pack中的FLM进行下载。 3. **切换为外部工具**：将配置选项改为[Use External Tool for Flash Programming]，即使用外部工具来进行Flash编程。 4. **指定外部工具路径**：在[Command]字段中输入STM32_Programmer_CLI.exe的完整路径，例如`C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\bin\STM32_Programmer_CLI.exe`。 5. **设置命令行参数**：在[Agruments]字段中输入命令行参数，以指定使用ST-Link接口和目标文件路径，例如`-c port=swd -w #L`。其中`-c port=swd`指定了使用SWD接口进行通信，`-w #L`则是用于指定待烧录的目标文件路径。这里的关键是使用了`#L`这一Keil特有的参数，它可以确保即使工程文件的位置发生变动，该命令依然能够正确找到目标文件。 6. **进一步定制**：如果需要在调试前修改特定的选项字节或其他配置，可以参考STM32CubeProgrammer用户手册UM2237了解更多的命令行参数用法。 ##### 2.2 使用技巧与注意事项 - **Keil #L 参数**：为了提高命令行的通用性，建议使用Keil编译器工具提供的参数如`#L`等来间接指定待烧录文件的路径，而非直接硬编码路径。这样可以确保即便工程选项有所变动，该命令也能够保持不变，同时方便在不同工程间复制使用。关于这些参数的具体含义，可以在Keil的帮助文档中查找“Key Sequence for Tool Parameters”获取更多信息。 通过简单的几步配置，即使在Keil环境尚未全面支持新产品的阶段，开发者也能利用STM32CubeProgrammer轻松实现程序的下载与调试，有效推进项目进度的同时避免了不必要的等待。