引言
# C: @6 f# C$ s8 CSTM32CubeU5 MCU 包带一组丰富的运行于意法半导体板件之上的示例。示例按板件进行管理，提供预先配置的项目给主要支持的工具链（请参考）。
4 K# ], k" `% Q! q8 @9 A8 J
: e( L! E7 h7 Z3 \# {
3 ~. p5 s; E# |) `6 o5 l, g
; R( ~  w0 n- s1 I5 T9 J1 参考文档
以下各项构成了本应用笔记中出现的示例的参考集合：
6 h1 V% ?7 N, [) A% d• 用于 STM32U5 系列的 32 位微控制器（基于具有 Arm® TrustZone®的 Arm® Cortex®-M 处理器）最新的 STM32CubeU5 MCU包
• 面向 STM32U5系列的 STM32CubeU5入门（UM2883）
• STM32U5 HAL与底层驱动程序说明 (UM2911)
0 _% j5 H8 K4 q" R6 B' T* c; u• STM32CubeU5 TFM应用程序入门 (UM2851)
& v7 \6 ?0 C6 _0 X4 O• Arm® TrustZone® STM32系列微控制器上的安全启动和安全固件更新解决方案概述（AN5447）提示 Arm和 TrustZone是 Arm Limited（或其子公司）在美国和或其他地区的注册商标。
7 F0 @* v: J) W5 H% N8 P' Q
2 STM32CubeU5 示例
示例根据其适用的 STM32Cube 级别进行分类。各个类别的命名如下：
• 示例
这些示例只使用 HAL 和 BSP 驱动程序（不使用中间件）。其目的是演示产品或外设的特性和使用方式。这些示例按外设进行管理（每个外设（如 TIM）一个文件夹）。从给定外设的基础应用（如使用定时器生成PWM）到多个外设的集成（如使用 DAC 从 TIM6 和 DMA 同步生成信号），各类情况的复杂程度不一。板件资源的使用量严格地控制在最低水平。
• Examples_LL
: Z% B  }4 [' F  w: O0 `8 Z9 l( V- n这些示例只使用 LL 驱动程序（不使用 HAL 驱动程序和中间件组件）。它们提供了外设特性和配置流程的典型用例的最佳实现。示例按外设进行管理（每个外设（如 TIM）一个文件夹），主要部署在 Nucleo 板上。
; U% ]: I) O$ V9 ]/ z  T6 m1 K• Examples_MIX
" g. c- `! O- a4 A- z$ F8 c这些示例只使用 HAL、BSP 和 LL 驱动程序（不使用中间件组件）。它们旨在演示如何在同一应用中使用HAL 和 LL API，以便结合两种 API 的优势：
– HAL 提供面向高级功能的 API，具有高度可移植性，这是通过对最终用户隐藏产品/IP 复杂性来实现的。
; \: W% n  ?- [: ]& F- S– LL 提供寄存器层面的底层 API，获得更好的优化效果。
1 T$ U8 ]' S6 Y7 H6 W9 b示例按外设进行管理（每个外设（如 TIM）一个文件夹），只部署在 Nucleo 板上。
1 s7 \/ i1 C$ _$ v! A, L• 应用
0 ]/ X" o$ p2 ^# `; o6 t# A$ B应用演示产品性能和可用中间件栈的使用方式。应用按中间件（每个中间件（如 Azure® RTOS ThreadX）一个文件夹）或需要高级固件模块（如 LPBAM）的产品特性进行管理。此外，还支持使用多个中间件栈的应用的集成。
• 演示
0 r" Y2 j( t6 e9 ?演示旨在集成和运行最大数量的外设和中间件栈，以便展示产品特性和性能。
• 模板项目
提供的模板项目帮助用户在给定板件上使用 HAL 和 BSP 驱动程序快速构建固件应用。
8 o6 p; K# c) K0 w. U' `/ k# `, t• Template_LL 项目
提供的模板 LL 项目帮助用户在给定板件上使用 LL 驱动程序快速构建固件应用。
示例位于 STM32Cube_FW_U5_VX.Y.Z\Projects\目录下。
$ n9 W6 S$ V: |6 H. q这些示例具有相同结构，默认产品的配置禁用 Arm® TrustZone®
7 b0 a9 n0 t4 J• *\Inc 文件夹，包含所有头文件
• 包含源代码的*\Src 文件夹
• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境启用了 Arm® TrustZone®的示例带有后缀“_TrustZone”（TFM 应用除外）并具有相同结构：
# Y% K* r+ }5 ~! _• *\Secure\Inc 文件夹，包含所有安全项目头文件
, P5 R/ t& `. u% P• *\Secure\Src 和*\Secure_nsclib\文件夹，包含所有安全项目源代码
5 N9 ^) Z1 R: I% e: m+ w7 Z• *\NonSecure\Inc 文件夹，包含所有非安全项目头文件
• *\NonSecure\Src 文件夹，包含所有非安全项目源代码
& ~0 L" {9 a: c" T' u• *\EWARM、*\MDK-ARM 和*\STM32CubeIDE 文件夹包含每个工具链的预配置项目
( A7 N3 i4 V$ Z  j( T( O5 g• *\README.md 和*\readme.html 文件，描述了示例行为和运行示例所需的环境
: M/ E2 M, R" I, g7 p
为了运行示例，执行如下操作：
3 ]8 y/ U" m! y5 Z1. 使用首选工具链打开示例。
2. 重新编译所有文件，并将二进制文件加载到目标内存中。
, ~: c( m" o3 f* U; a; Q; R3. 按照*\README.md 和*\readme.html 文件中的指示运行示例。
! i" I+ O; Q! h9 N
提示
/ E* @# ^" @- I5 w: M# ]8 n如需了解关于 MCU 包开发和确认使用的软件/硬件环境的更多信息，请参考固件包版本说明中的“开发工具链和编译器”和“支持的器件和评估板”章节。不保证所提供示例在其他环境中也能正确运行，例如在使用不同编译器或板件版本时。
: [3 m1 G3 b- Y/ k- G; t2 q' V可以对示例进行定制，以便在任何兼容的硬件上运行：如果具有相同硬件功能（LED、LCD、按钮及其他），只需更新板件的 BSP 驱动程序即可。BSP 基于模块化架构，可通过实现低级例程轻松移植到任何硬件。
表 1. STM32CubeU5 固件示例 包含随 STM32CubeU5 MCU 包提供的示例的列表。
5 H: q  b/ J/ c% `该表格中的标签
( H8 U  w& c+ w& J表示项目是使用 STM32CubeMX，即 STM32Cube 初始化代码生成器创建的。这些项目可使用此工具打开，以便修改项目本身。其他项目为手动创建，用于演示产品特性。该表格中的标签 TrustZone 表示项目是为启用了 Arm® TrustZone®的器件创建的。读取项目*\README.md 和*\readme.html

9 ]  s9 q( k9 v( Z+ A1 t

% o+ X2 z4 l- [" T4 i! }完整版请查看：附件
7 Z; p% z4 a2 F, a/ `. a. |