2 STM32CubeU5 示例
示例根据其适用的 STM32Cube 级别进行分类。各个类别的命名如下：
• 示例
这些示例只使用 HAL 和 BSP 驱动程序（不使用中间件）。其目的是演示产品或外设的特性和使用方式。这些
示例按外设进行管理（每个外设（如 TIM）一个文件夹）。从给定外设的基础应用（如使用定时器生成
PWM）到多个外设的集成（如使用 DAC 从 TIM6 和 DMA 同步生成信号），各类情况的复杂程度不一。板件
资源的使用量严格地控制在最低水平。
• Examples_LL
这些示例只使用 LL 驱动程序（不使用 HAL 驱动程序和中间件组件）。它们提供了外设特性和配置流程的典
型用例的最佳实现。示例按外设进行管理（每个外设（如 TIM）一个文件夹），主要部署在 Nucleo 板上。
• Examples_MIX
这些示例只使用 HAL、
BSP 和 LL 驱动程序（不使用中间件组件）。它们旨在演示如何在同一应用中使用
HAL 和 LL API，以便结合两种 API 的优势：
– HAL 提供面向高级功能的 API，具有高度可移植性，这是通过对最终用户隐藏产品/IP 复杂性来实现的。
– LL 提供寄存器层面的底层 API，获得更好的优化效果。
示例按外设进行管理（每个外设（如 TIM
）一个文件夹），只部署在 Nucleo 板上。
• 应用
应用演示产品性能和可用中间件栈的使用方式。应用按中间件（每个中间件（如 Azure
®
RTOS ThreadX）一
个文件夹）或需要高级固件模块（如 LPBAM）的产品特性进行管理。此外，还支持使用多个中间件栈的应用
的集成。
• 演示
演示旨在集成和运行最大数量的外设和中间件栈，以便展示产品特性和性能。
• 模板项目
提供的模板项目帮助用户在给定板件上使用 HAL 和 BSP 驱动程序快速构建固件应用。
• Template_LL 项目
提供的模板 LL 项目帮助用户在给定板件上使用 LL 驱动程序快速构建固件应用。
示例位于 STM32Cube_FW_U5_VX.Y.Z\Projects\目录下。
这些示例具有相同结构，默认产品的配置禁用
Arm
®
TrustZone
®
• *\Inc 文件夹，包含所有头文件
• 包含源代码的
*\Src 文件夹
• *\EWARM、
*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
• *\README.md 和
*\readme.html 文件，描述了示例行为和运行示例所需的环境
启用了 Arm
®
TrustZone
®
的示例带有后缀
“_TrustZone”（TFM 应用除外）并具有相同结构：
• *\Secure\Inc 文件夹，包含所有安全项目头文件
• *\Secure\Src 和
*\Secure_nsclib\文件夹，包含所有安全项目源代码
• *\NonSecure\Inc 文件夹，包含所有非安全项目头文件
• *\NonSecure\Src 文件夹，包含所有非安全项目源代码
• *\EWARM、
*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
• *\README.md 和
*\readme.html 文件，描述了示例行为和运行示例所需的环境
为了运行示例，执行如下操作：
1. 使用首选工具链打开示例。
2. 重新编译所有文件，并将二进制文件加载到目标内存中。
3. 按照
*\README.md 和*\readme.html 文件中的指示运行示例。
提示
如需了解关于
MCU
包开发和确认使用的软件
/
硬件环境的更多信息，请参考固件包版本说明中的
“
开发工具链和编
译器
”
和
“
支持的器件和评估板
”
章节。不保证所提供示例在其他环境中也能正确运行，例如在使用不同编译器或板
件版本时。
可以对示例进行定制，以便在任何兼容的硬件上运行：如果具有相同硬件功能（LED、LCD、按钮及其他），只需
更新板件的 BSP 驱动程序即可。BSP 基于模块化架构，可通过实现低级例程轻松移植到任何硬件。
AN5701
STM32CubeU5 示例
AN5701 - Rev 1
page 3/24
