引言
STM32CubeU5 MCU 包带一组丰富的运行于意法半导体板件之上的示例。示例按板件进行管理，提供预先配置的项目给主要支持的工具链（请参考）。
" y5 \; y& g9 s$ @  r8 k图 1. STM32CubeU5 固件组件

) f/ K; t, g0 H/ k
; t" [4 _3 t. c/ G( K" x  I2.STM32CubeU5 示例
- v! v9 `; r6 n5 |6 h& C8 O/ W5 H示例根据其适用的 STM32Cube 级别进行分类。各个类别的命名如下：
• 示例
这些示例只使用 HAL 和 BSP 驱动程序（不使用中间件）。其目的是演示产品或外设的特性和使用方式。这些示例按外设进行管理（每个外设（如 TIM）一个文件夹）。从给定外设的基础应用（如使用定时器生成PWM）到多个外设的集成（如使用 DAC 从 TIM6 和 DMA 同步生成信号），各类情况的复杂程度不一。板件资源的使用量严格地控制在最低水平。
• Examples_LL
4 s, i- @: o; d: _9 L这些示例只使用 LL 驱动程序（不使用 HAL 驱动程序和中间件组件）。它们提供了外设特性和配置流程的典型用例的最佳实现。示例按外设进行管理（每个外设（如 TIM）一个文件夹），主要部署在 Nucleo 板上。
3 w* ~! i1 i' i• Examples_MIX
这些示例只使用 HAL、BSP 和 LL 驱动程序（不使用中间件组件）。它们旨在演示如何在同一应用中使用HAL 和 LL API，以便结合两种 API 的优势：
: t- w; h& P7 Y, |2 V– HAL 提供面向高级功能的 API，具有高度可移植性，这是通过对最终用户隐藏产品/IP 复杂性来实现的。
– LL 提供寄存器层面的底层 API，获得更好的优化效果。示例按外设进行管理（每个外设（如 TIM）一个文件夹），只部署在 Nucleo 板上。
0 {$ \% D6 [- \+ e" O• 应用
应用演示产品性能和可用中间件栈的使用方式。应用按中间件（每个中间件（如 Azure® RTOS ThreadX）一个文件夹）或需要高级固件模块（如 LPBAM）的产品特性进行管理。此外，还支持使用多个中间件栈的应用
的集成。
5 u% G# Q$ M- ]. A! a, A8 u( M# x• 演示
/ K+ _2 v6 o  j! S7 |; X$ d演示旨在集成和运行最大数量的外设和中间件栈，以便展示产品特性和性能。
• 模板项目
+ d4 w4 I$ p; j' W. C0 X/ k提供的模板项目帮助用户在给定板件上使用 HAL 和 BSP 驱动程序快速构建固件应用。
• Template_LL 项目
提供的模板 LL 项目帮助用户在给定板件上使用 LL 驱动程序快速构建固件应用。
$ s: b, d+ c: t) S( G8 @示例位于 STM32Cube_FW_U5_VX.Y.Z\Projects\目录下。
* Y: I; T2 b, M4 C  ^这些示例具有相同结构，默认产品的配置禁用 Arm® TrustZone®
' h! b1 S( i$ k# |4 e: y• *\Inc 文件夹，包含所有头文件
• 包含源代码的*\Src 文件夹
• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
) ]3 B! {. Z. W: S• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境启用了 Arm® TrustZone®的示例带有后缀“_TrustZone”（TFM 应用除外）并具有相同结构：
0 k( @) E  d  I) g5 f# q; h• *\Secure\Inc 文件夹，包含所有安全项目头文件
) j6 [  C8 q: j8 ]" A# v2 N- u# u• *\Secure\Src 和*\Secure_nsclib\文件夹，包含所有安全项目源代码
$ E5 ?" h2 b& q8 j5 e• *\NonSecure\Inc 文件夹，包含所有非安全项目头文件
• *\NonSecure\Src 文件夹，包含所有非安全项目源代码
* r1 X# N' a: p• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境
为了运行示例，执行如下操作：
" {6 i: \" B6 G; ~; m1 m* {1. 使用首选工具链打开示例。
; R* V0 d) h0 w. @$ {) e6 O" m, _2. 重新编译所有文件，并将二进制文件加载到目标内存中。
3. 按照*\README.md 和*\readme.html 文件中的指示运行示例。
/ g6 b/ j5 l4 N# P

' O/ C1 _; ^5 [# _5 b4 Q8 k) x提示
; q# S- n1 y  w2 [0 L* _. {! d如需了解关于 MCU 包开发和确认使用的软件/硬件环境的更多信息，请参考固件包版本说明中的“开发工具链和编译器”和“支持的器件和评估板”章节。不保证所提供示例在其他环境中也能正确运行，例如在使用不同编译器或板件版本时。
5 a$ U, `2 ~! F2 b可以对示例进行定制，以便在任何兼容的硬件上运行：如果具有相同硬件功能（LED、LCD、按钮及其他），只需更新板件的 BSP 驱动程序即可。BSP 基于模块化架构，可通过实现低级例程轻松移植到任何硬件。
. p  W! j3 a) s  M% C; l4 b
9 @3 a4 |1 o5 G

4 f" j9 F: y, j: T. y

/ O  V' n2 {0 \& `7 m
" n' D& K% N0 W4 O
# r3 W0 h% y# u/ }7 w( u% E) C# ^% z


9 y8 H# R! m5 L  [详情见附件