引言
本应用笔记描述如何在意法半导体的 STM32CubeIDE 集成开发环境中开始基于 STM32L5 Series 微控制器的项目。
% O5 {& w2 h, F" Q) v; r9 r+ H# I
2 }! S- R& a6 W4 q1 概述
STM32CubeIDE 支持基于 Arm® Cortex®处理器的 STM32 32 位产品。
+ \# E) s. i; Q' X! C; I! ]" a提示 Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.
  X* E) Y" G  a5 v! B8 ]0 E/ b: Y1.1 先决条件
7 X# H4 x6 n6 L# W以下工具是理解本文档中的教程并开发基于 STM32L5 Series（Arm® TrustZone®已启用）的应用程序的先决条件：
; }. y; n' p0 G1 @• STM32CubeIDE 1.2.0
+ b2 y; B# B! q6 j+ j# X* l• STM32CubeProgrammer (STM32CubeProg) 2.3.0: 选项字节配置
• STM32Cube_FW_L5_V1.0.0：STM32CubeL5 固件与示例项目
4 }0 ?5 }& J5 r- M* @
1.2 本文档中的用例
在 STM32CubeIDE 上下文中，用户有许多不同的方法来探索和着手开发基于 STM32L5 Series 的项目：
. V' f% i& h, C! |9 p• 从 STM32CubeL5 MCU 开发包导入一个 STM32CubeIDE 项目，以通过工作示例来学习
• 使用 STM32CubeMX 工具创建 STM32CubeMX 项目
) a3 `/ p0 m8 y8 v: J, j  d, H; k• 在 STM32CubeIDE 中创建一个空项目，编写自己的代码
• 在 STM32CubeIDE 中创建一个空项目，从 STM32CubeL5 MCU 开发包中复制示例项目代码到创建的项目中建议采用以下方法熟悉和开始基于 STM32L5 Series 的项目开发：
1. 导入一个 TrustZone®示例项目，该项目是 STM32CubeL5 MCU 开发包的组成部分。这是了解 STM32L5MCU 启动部分代码 CMSIS 和 HAL 驱动程序的最快方法。
2. 创建一个空项目，并从 STM32CubeL5 MCU 开发包复制代码。在空项目中，用户完全控制源代码和配置文件，STM32CubeMX 则无法触及。这为用户提供了更高的灵活性，但需要稍微陡一些的学习曲线。
3. 创建一个 STM32CubeMX 项目，使用图形界面配置硬件并生成相应的 HAL 驱动程序。这可以作为量产项目或学习项目，以便进行深入探索和学习。
! J. _9 B* _( w5 j2 {. w2 o5 T一些模板项目以 STM32CubeIDE 项目的格式提供；这些项目是已启用或未启用 TrustZone®的模板项目。例如：
• 使用 TZEN = 1：
/ [) y0 c# \6 }. u3 a7 T4 K" pSTM32Cube_FW_L5_V1.0.0\STM32Cube_FW_L5_V1.0.0\Projects\STM32L552E-EV\Templates\TrustZoneEnabled\
• 使用 TZEN = 0：
STM32Cube_FW_L5_V1.0.0\STM32Cube_FW_L5_V1.0.0\Projects\STM32L552E-EV\Templates\TrustZoneDisabled\
该应用笔记上面提到的参考项目 TrustZone 已启用，TrustZone 是通过置位选项字节的 TZEN 位来使能的。
3 R6 ?( k$ N  V: N( G, o) x# d1 L该项目模板的 readme 文件描述如何配置选项字节以匹配代码；它提供了一个很好的模板，可用于学习一些重要的配置用例。
在首次学习体验之后，用户可以选择创建一个空项目，或者使用 STM32CubeMX 给自己的应用创建一个新项目，也可以两者都尝试一下。
固件 STM32Cube_FW_L5 包含许多面向不同外设的其他示例项目，带有 STM32CubeIDE 项目文件。可以将这些项目导入 STM32CubeIDE 并进行研究，以了解如何使用 STM32L5 外设。

. |- U) V1 R1 j6 H1.3 选项字节
9 f/ M  I4 [2 H' k, A9 J3 J若要详细了解选项字节有关信息，请参见 STM32L5 Series（RM0438）中的微控制器参考手册。对于作为此应用笔记基础的特定示例项目模板，示例项目的 readme.txt 文件中列出了正确的选项字节值。用户必须使用
STM32CubeProgrammer （STM32CubeProg）更改选项字节

1.4 特殊的分层项目结构面向安全多核 MCU
在导入或创建项目之前，考虑一些项目结构概念很重要。创建 STM32L5 项目之后，项目结构自动分层。单核项目的项目结构是扁平的。在多核项目或采用启用了 TrustZone®的 MCU 的项目（如 STM32L5 Series 中所示）中，使用分层项目结构。当用户创建或导入一个项目时，它由一个根项目和被称为 MCU 项目的子项目组成。MCU 项目是真实 CDT 项目；它们可以包含构建和调试配置，而根项目不能。根项目是一个简单的容器，允许在安全和非安全MCU 项目之间共享公共代码（在 STM32L5 Series 的情况下），如图 1 中所示。

( m! ]8 ?1 k0 W5 T8 R9 D


如果设置已更改，或者项目不在分层结构中，则可以进行更改，如图 2 中所示。

7 u" M6 V5 O/ r" a1 X, C/ D- G+ m; W
/ o' q4 Y( O( q. I' Z

; n8 R/ W( f+ w5 E  |
1 E. M. y3 H: k/ d; x5 ?在文件系统中，两个 MCU 项目位于根项目中，根项目只包含一个.project 文件。
& `- T* }' E. c; o

( {* A2 i0 Z6 i. J1 z& P  H$ d2 b完整版请查看：附件

* D' M7 d* o$ ^6 m+ }