引言
, W" B6 p% U9 W$ s9 u. lSTM32CubeU5 MCU 包带一组丰富的运行于意法半导体板件之上的示例。示例按板件进行管理，提供预先配置的项目给主要支持的工具链（请参考）。
图 1. STM32CubeU5 固件组件
7 @% J- m; i4 V# y8 G

2.STM32CubeU5 示例
示例根据其适用的 STM32Cube 级别进行分类。各个类别的命名如下：
• 示例
, ~  q7 W: G% ]% b这些示例只使用 HAL 和 BSP 驱动程序（不使用中间件）。其目的是演示产品或外设的特性和使用方式。这些示例按外设进行管理（每个外设（如 TIM）一个文件夹）。从给定外设的基础应用（如使用定时器生成PWM）到多个外设的集成（如使用 DAC 从 TIM6 和 DMA 同步生成信号），各类情况的复杂程度不一。板件资源的使用量严格地控制在最低水平。
• Examples_LL
这些示例只使用 LL 驱动程序（不使用 HAL 驱动程序和中间件组件）。它们提供了外设特性和配置流程的典型用例的最佳实现。示例按外设进行管理（每个外设（如 TIM）一个文件夹），主要部署在 Nucleo 板上。
4 c, G/ q9 F2 @6 F- a  |* U; P• Examples_MIX
) f* n8 C8 E2 D+ H3 h9 J3 O这些示例只使用 HAL、BSP 和 LL 驱动程序（不使用中间件组件）。它们旨在演示如何在同一应用中使用HAL 和 LL API，以便结合两种 API 的优势：
. y# `( f! s. l* ?. E6 v0 {0 I* Z– HAL 提供面向高级功能的 API，具有高度可移植性，这是通过对最终用户隐藏产品/IP 复杂性来实现的。
) G  A! z0 V8 V' ]– LL 提供寄存器层面的底层 API，获得更好的优化效果。示例按外设进行管理（每个外设（如 TIM）一个文件夹），只部署在 Nucleo 板上。
• 应用
应用演示产品性能和可用中间件栈的使用方式。应用按中间件（每个中间件（如 Azure® RTOS ThreadX）一个文件夹）或需要高级固件模块（如 LPBAM）的产品特性进行管理。此外，还支持使用多个中间件栈的应用
的集成。
2 K+ ^0 X" U$ ~; _. ~" \) t• 演示
演示旨在集成和运行最大数量的外设和中间件栈，以便展示产品特性和性能。
• 模板项目
提供的模板项目帮助用户在给定板件上使用 HAL 和 BSP 驱动程序快速构建固件应用。
6 W3 L0 q9 X3 g9 P; a• Template_LL 项目
9 ~& W8 Q/ I! @0 q& n提供的模板 LL 项目帮助用户在给定板件上使用 LL 驱动程序快速构建固件应用。
示例位于 STM32Cube_FW_U5_VX.Y.Z\Projects\目录下。
这些示例具有相同结构，默认产品的配置禁用 Arm® TrustZone®
• *\Inc 文件夹，包含所有头文件
• 包含源代码的*\Src 文件夹
- G! r1 E! ~; V+ ?1 J• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境启用了 Arm® TrustZone®的示例带有后缀“_TrustZone”（TFM 应用除外）并具有相同结构：
: I* v9 t. C, f+ f• *\Secure\Inc 文件夹，包含所有安全项目头文件
" f  y4 {" A& O" i: i/ f9 J; Q• *\Secure\Src 和*\Secure_nsclib\文件夹，包含所有安全项目源代码
( I: d% N: `. a. ~8 a• *\NonSecure\Inc 文件夹，包含所有非安全项目头文件
• *\NonSecure\Src 文件夹，包含所有非安全项目源代码
• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
1 }1 L$ S+ c/ T& T5 E+ T( }• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境
为了运行示例，执行如下操作：
1. 使用首选工具链打开示例。
2. 重新编译所有文件，并将二进制文件加载到目标内存中。
3. 按照*\README.md 和*\readme.html 文件中的指示运行示例。

' S4 C: A/ t; t( C7 S% n: L
6 s9 P6 O- @$ ]2 C( b提示
如需了解关于 MCU 包开发和确认使用的软件/硬件环境的更多信息，请参考固件包版本说明中的“开发工具链和编译器”和“支持的器件和评估板”章节。不保证所提供示例在其他环境中也能正确运行，例如在使用不同编译器或板件版本时。
. T* t& \4 i( j: J' g5 Q3 @可以对示例进行定制，以便在任何兼容的硬件上运行：如果具有相同硬件功能（LED、LCD、按钮及其他），只需更新板件的 BSP 驱动程序即可。BSP 基于模块化架构，可通过实现低级例程轻松移植到任何硬件。
1 o) Q8 b0 Z% S
" ~) O6 C5 j, |

9 v, C2 ~/ Z7 S' F- D. J

$ r( p8 f; s" X# s
2 h3 \0 ?: s" Y5 ^5 g$ ?; d. t

! r0 M3 E# l7 H* n( V& @' G
. a1 W8 B6 A: W) M2 t3 c- K+ |
详情见附件
9 m: ^5 |9 U  {! X/ k
* _, Y7 z  W( m9 ~