01 引言
* E% @7 t, _5 \9 Q& oSTM32MP13x 系列 MPU 是 STM32 Arm®Cortex® MPU 家族中的一部分，它拥有单核Cortex®-A7 核心，支持核心频率 650MHz~1GHz，不仅能够轻松运行 Linux 操作系统，还同时提供官方 HAL 库，用于支持基于 RTOS 或无 OS 的项目方案，即裸跑应用程序。
2 @2 g0 W) e& W% q: R5 b; S, s
# V3 X# u5 V5 m2 ?. P6 k本应用文档将就以下几个部分简述如何在 STM32MP13 系列 MPU 上开始无 OS 项目的开发：
• STM32MP13x Baremetal 开发环境简介
• STM32MP13x 工程的创建
• STM32MP13x 工程的在线调试
4 N% L2 o. A9 i5 `* s  h/ f5 w• 镜像烧录及从外部 Flash 启动
/ L3 Z! y4 s9 Y: {- O. b
, L. z5 N7 c3 z6 }" ^: I* [# q2 J02 STM32MP13x Baremetal 开发环境简介
2.1 开发工具及环境
# ~7 u3 V8 Q) o2 j. B5 p" |STM32MP13x Baremetal 开发工具主要包括：
1. 烧录工具：STM32CubeProg （ 版本大于 v2.15.0）
# q+ q' m3 J" ]7 }0 _  _2. 配置工具：STM32CubeMX （版本大于 v6.10.0）
3. 开发调试工具：IAR（版本大于 v9.50），或 STM32CubeIDE（版本大于 v1.14）
$ m# @# m- f( V$ ~, C% g本文示例基于 STM32CubeIDE 开发调试工具。
  k  \# b: O# P: ?; ?

( J! _% U( y' L% ]  Y2.2 STM32CubeMP13 开发包
STM32CubeMP13 开发包同步发布于 ST 官网 www.st.com 和 github.com，可通过如下方式下载：
: \1 u' r, O5 i& f2 A4 L  J1. ST 官网下载链接
) ^% `! S' W- }8 B9 t& c8 P2. Github 仓库链接
3. 通过 STM32CubeMx 软件下载
7 m- M! ]6 G1 {$ H4 Z) a, l
2.2.1. STM32CubeMP13 开发包总览
8 X6 X+ ^9 y3 g( V" s9 A) V+ ASTM32CubeMP13 开发包运行在 Arm® Cortex®-A7 处理器上，由以下三部分组成：
• Level 0：驱动程序，包含 HAL、LL、BSP、CMSIS
9 [7 X& V  }; b$ X/ a• Level 1：中间件，包含 Eclipse ThreadX（原 AzureRTOS），USB Host & Device 库
. J6 t- X4 f! y; C/ s! f( r. y3 x• Level 2：包含各种板级示例程序
除此之外，还包括一些工具助手等。
' F: F- E0 j* A


5 ?2 n$ x8 l3 m( g▲ 图 1 Baremetal 开发包源码框架


2.2.2. 源码目录结构
0 f1 T2 Q* G0 q: H
▲ 图 2 Baremetal 开发包源码目录

$ C8 c& I$ S( w2.2.3. 开发包支持模块列表
% ~, S2 ]6 {8 l6 {4 O1 j" w已支持的 HAL drivers :
• ADC, BSEC, CRC, CRYP (including SAES), DCMIPP, DDR, DFSDM, DMA,DTS, ETH, ETZPC, EXTI, FDCAN, FMC_NAND, GPIO, HASH, I2C, I2S, IWDG,LPTIM, LTDC, MCE, MDMA, PKA, PWR, XSPI (QSPI replaced with XSPI),RCC, RNG, RTC (including TAMP), SAI, SDMMC (including EMMC), SMARTCARD, SPDIFRX, SPI, TIM, UART, USART, USB
9 w4 H2 P' Z/ e# [5 a1 o
已支持的 LL drivers :
• ADC, DMA/DMAMUX, EXTI, ETZPC, GPIO, I2C, LPTIM, MDMA, PWR, RCC & BUS, RTC, SPI, TIM, USART
# W5 x: Q( r9 a$ k( j
BSP 与 BSP 组件:
8 x& w. t' t  Q2 S) Q' _• 基于 HAL 封装了更高一级的 API，为 LED、按钮、相机、LCD、SD 卡和 COM 端口提供 API，包含了以下一些外围器件的驱动：GC2145， LAN8742， MCP23x17， RK043FN48H， STMIPID02
5 `- ]% {$ i$ O7 P2 X( o
  M; @3 @% ~/ T5 P" e6 B, P+ [中间件程序:
• 包含一系列支持某种服务的库文件及接口文件，目前已支持：Eclipse ThreadX（原 AzureRTOS），STM32_USB_Device_Library,
9 q3 O# M1 ~, u1 _* j0 k; D- XSTM32_USB_Host_Library
; s; _5 g# |. m5 g# b
$ v0 \# j) Y0 G' x/ J( U项目工程:
• Examples：基于 HAL 接口的简单示例，没有中间件功能。
• Applications：较完整的工程应用实例，包含中间件功能。
# {, a" [1 e) r' w1 `9 x• External_Loader: 烧录镜像及从外部存储器启动的应用示例。
• Template: 板级工程应用框架。
- h! Q1 B/ D& A6 I4 n
实用工具:
: p( g, {3 M- c8 c/ U• Imageheader：用于添加 stm32 头，支持存储设备启动。
• Fonts：提供了一组用于显示的标准字体，包括 font8，font12，font16，font20，font24


$ s, Q2 R1 h; u# A/ s) q03 STM32MP13x 工程的创建
' _$ T8 N' R3 |0 tSTM32MP13x 工程创建，可通过以下两种方式：
1. 使用 STM32CubeMx 配置并生成项目框架代码，并基于该框架代码开发应用。
2. 导入 STM32CubeMP13 开发包示例工程代码，并基于该示例代码开发应用。
( h6 y1 N! z5 D9 [2 C2 ~9 L% q6 i6 s
3.1. 从 STM32CubeMX 创建工程
STM32CubeMX 是 STM32Cube 工具家族中的一员，它采用简单易用的图形界面，可以帮助开发者快速配置硬件和软件。可支持从 MCU/MPU 选型，引脚配置，系统时钟以及外设时钟设置，到外设参数配置，中间件参数配置等，并可生成适用的 C 代码项目。

本章节简述如何通过 STM32CubeMx 生成适用于 STM32MP13x 的裸跑应用框架。使用该方式无需提前下载 STM32CubeMP13 开发包，STM32CubeMx 可自动联网下载。
1. 打开 STM32CubeMX，点击 ACCESS TO MCU SELECTOR，
$ f( @7 N5 i7 `  W" Y2. 在搜索框中输入 STM32MP13 相应料号，如：STM32MP135FAF7，双击打开配置窗口
3. 弹框选择 MP13 Bare Metal，将生成 bare metal 工程框架。

& U' f, k2 N# K- d2 ]
9 F" m( `2 b$ b7 @  R* F8 j▲ 图 3 STM32CubeMx 选择器件


▲ 图 4 STM32CubeMx 选择工程类型


* }6 W' S; U' w4. 切换到 Project Manager 标签页，输入工程名称。
5. 在此页进行项目选项配置，可保持默认。


2 I& ~4 u: l+ l▲ 图 5 STM32CubeMx 工程设置页面


6. 回到 Pinout & Configuration 标签页。
- ^+ y7 |' N, W! i% u! l% F, M- t7. 使能 RCC 和 DDR。
+ g3 f) t! L; F8 Q3 q8. 配置各外设总线，配置方法与其他 STM32 MCU 相同（也可参考 Help -> Docs & Resources）
+ s# W2 R( R: i6 X

4 t0 {& L7 S0 V: @( k% U# I

$ L5 }* t+ z" u; p! C0 N  F
1 k* F% w2 Q1 u4 @▲ 图 6 STM32CubeMx 外设配置页面
# q: p% t( n$ w; Q9 e

& r, W$ c' o2 v9. 切换到 Clock Configuration 标签页。
" |* {# @2 z% [4 ?+ V10. 若软件报告时钟错误，可点击 Yes 自动修复。
11. 输入 CPU、DDR、总线等的工作频率，系统会自动匹配合适参数。
( i2 x5 G- t( z' e3 c* d
* Z8 j" R. x( Y& c' }
▲ 图 7 STM32CubeMx 时钟配置页面
8 Q# b9 l# n3 }3 D( t

7 F; b. M! p9 w7 [$ Z! T* [12. 所有外设配置完成，即可点击 GENERATE CODE，开始生成工程代码。
13. 若第一次使用，软件将提示是否下载 STM32CubeMP13 开发包，可点击“yes”，软件自动联网下载前述 STM32CubeMP13 开发包。
14. 生成完成后，可直接点击 Open Project，将打开 STM32CubeIDE 工程。


▲ 图 8 STM32CubeMx 代码生成页面
8 O3 ~" k. K4 e1 ]
▲ 图 9 STM32CubeMx 完成代码生成页面

▲ 图 10 STM32CubeMx 生成工程代码示例

15. 至此，工程框架已生成，可通过 STM32CubeIDE 进行用户代码的编辑、编译、调试。
+ Y1 I$ u2 K$ ?0 }7 g

! [; D1 c( r7 p' c0 B8 G5 b3.2. 从 STM32CubeMP13 开发包导入工程
5 H  J% V2 H2 p! |( S若已事先通过 ST 官方网站或 Github 下载了 STM32CubeMP13 软件开发包，也可导入开发包中的工程示例代码，从示例代码开始进行项目开发。

6 _. |8 y6 D% s$ \' d5 T这里以 FSBLA_Sdmmc1 工程为例。
项目路径：\Projects\STM32MP135C-DK\Applications\FSBLA\FSBLA_Sdmmc1
' x+ J9 k# A0 s, e& }# X1. 打开 STM32CubeIDE，导入 project
2. 点击 Files -> Import…

▲ 图 11 STM32CubeIDE 右键项目菜单
5 E' l4 Z* V' Z  P6 ~8 h

3. 选择 Existing Projects into Workspace
4. 点击 Next>
. N. V( j) X. R9 `

▲ 图 12 STM32CubeIDE 导入已存在项目
  n+ U9 p' ?5 ~- H
2 r8 I3 k, r* r9 H. |* V
5.点击 Browse…，找到目录 \Projects\STM32MP135C-DK\Applications\FSBLA
2 N/ I1 i3 O1 v, q7 l- v# q6. 选中 FSBLA_Sdmmc1_A7 工程
0 x: U- {* R4 ?- g' x1 b$ y( h7. 点击 Finish，导入 Project
1 O/ {5 z- L  B) u8 ]% |
4 u1 I+ Q' b, t" t
7 {! e% s. ~- y) h▲ 图 13 STM32CubeIDE 选择导入项目
8 e9 w9 T, E! c
* u3 T+ s' H$ l9 `4 p) \
8. 工程导入完成。

* D- L. f. x. Y. [
. k, \- A. h  k' f0 b# v) [9 L04 STM32MP13x 工程的在线调试
8 s) P* s. w& u+ g5 G4 l( A工程创建完成后，接下来本章节将介绍如何基于 STM32CubeIDE 进行工程编译及在线调试。
! U8 H, A+ Y+ y+ M4 H* x" W
* ~8 x- ?6 V* T8 J- W5 ]7 gSTM32MP135 内部包含 128KByte SYSRAM，若代码小于 128KByte，可直接运行于内部SYSRAM 中，适用于验证一些简单的外设实例。若代码大于 128KByte，则需要将程序运行于DDR 中。下面将分别阐述。
$ I) d! l# O( W: I: m- u: ^( {
, w1 Z6 L: N& v2 R4.1. 在 SYSRAM 中调试程序
仍以前述导入的 FSBLA_Sdmmc1_A7 工程为例。
1. 首先，将开发板切换到工程模式
2. 连接 Type-C 电源3. 连接 MicroUSB，这里板载已支持 ST-Link
" m! ?6 |4 n* e" U

▲ 图 14 开发板切换工程模式

' E" X6 u" K& ~4. 右键项目工程名称，选择 Build Project，完成编译。
( i% N3 C( n$ I

5 V# G/ \, _: d. x' l0 A: E▲ 图 15 选择编译工程
% ^5 U/ B1 h; [9 T' I
2 w* @4 e5 {' j8 q8 Z# c6 q
* r) O$ ?! p: ^' P5. 右键工程名称，选择 Debug As -> STM32 C/C++ Application


▲ 图 16 选择调试项目方法 1
6. 或点击 Debug 图标
7. 进入 Debug Configurations….
7 |! f8 {3 d" j  i9 a

▲图 17 选择调试项目方法 2


8. 进入调试配置菜单


▲图 18 调试配置页面




% W4 T( J! m. q7 @% A

1 F0 v! P- ^; L$ q1 w2 j; `9 k4 C9. 即可像 MCU 一样调试您的代码。


▲图 19 项目调试窗口

$ i7 J9 W1 z/ u" `: w: S! W4.2. 在 DDR 中调试程序
7 e( q4 O9 T4 x$ R& ~5 e当代码量超过 SYSRAM(128KB)的大小时，需要将程序运行在 DDR。这里以 BSP_BasicTemplates 工程为例展示如何开发运行于 DDR 的用户程序、
$ P2 \$ n  N0 P+ n8 w
1. 首先，按照前述方法导入项目工程


▲图 20 导入 Templates 工程

4 X2 t; n# O2 R. f0 o- j. O
2. 打开 C/C++ Build 配置
3. 在 Preprocessor 中添加 USE_DDR 宏定义

/ x& F' x% `+ I, Y$ ]
▲图 21 使能 DDR 宏

/ G; Q+ C' C8 A, b0 J: [
4. 修改链接文件，重命名为 “stm32mp13xx_a7_ddr.ld”
5. 修改 REGION_ALIAS 定义到 DDR 区域：
9 X4 N1 L3 O4 p, X6. 重新编译后，目标文件将链接到 DDR
  i% r3 s3 g8 z
: j& F) ]2 l$ h; E/ Q$ |4 v
5 q, v# T# D$ u( K▲图 22 修改链接空间
5 c8 A2 M8 C  h4 Z  y: c

▲图 23 选择链接文件

7. 在调试之前需要先运行 DDR_Init 对 DDR 进行初始化
8. 按照前述方法导入 DDR_Init 工程，编译后全速运行一次，并保持开发板不掉电项目路径：\STM32MP135C-DK\Examples\DDR\DDR_Init
3 J& ~: Q9 ^$ Q6 e. X* g: c% S

2 a8 t; o  m8 E: F▲ 图 24 运行 DDR 初始化

" A4 E% r) o% j7 @6 M
0 m& K9 j& j$ a* y9. 回到 BSP_BasicTemplates 工程。
: x0 Q; N- s# J- I10. 在 Debug configuration 对话框中，将 Startup 页面的 monitor reset 删除。

7 K8 F3 Y8 X" L* L8 Z( L  u
▲ 图 25 修改调试参数
) S# m. f% {: W; A9 c2 c  r; r& ?

11. 点击 Debug 进入调试
12. 可以看到当前 main 函数的地址已经为 0xC000 开头的 DDR 位置

+ ^% i! a( p# t' s

7 `" c- {* K. U/ _
' S) E% I- X. ~# r: j▲ 图 26 在 DDR 中调试工程

/ \! F9 w0 y. H5 O* E# k! ^
* F: ?9 J+ ~/ X" F05 从外部 Flash 启动


▲ 图 27 STM32MP13 启动流程
; d% I6 Y& ^# D. B8 l
0 S+ E/ z* x- y, x4 O+ Y从外部 flash 引导 STM32MP13， 一般需要包含两个部分源码。如上图所示，芯片上电后，首先运行内部固化的一段 ROM CODE，ROM CODE 从用户配置的启动器件中寻找 FSBLA，并将其拷贝至 SYSRAM 中，FSBLA 运行后，执行 DDR 初始化及用户代码（CUBE EXAMPLE）拷贝到 DDR 中，最终实现跳转到 DDR 中运行用户程序的目的。
9 g. Q( c. {* r7 ]9 |
这里以 SDCard 启动为例，在第三章节中，我们编译调试的 FSBLA_Sdmmc1_A7 工程，即实现了 FSBLA 部分的功能，BSP_BasicTemplates 工程为实际开发的用户项目。完成启动需要将这两个工程生成的镜像文件都烧录到 SDCard 中。

3 e  i* ~+ J, G7 d- d/ \• FSBLA 需烧录到 SDCard 的固定位置 LBA128 或 LBA640，ROM CODE 固定从这两个位置寻找 FSBLA。
9 }, k$ N3 ?$ I  h• CUBE EXAMPLE 的存放位置可在 FSBLA 程序中修改，默认为 SDCard 的 LBA640。
• 如果有烧录过 OpenSTLinux 的卡，需先格式化。原因是 ROM Code 优先从 GPT 分区表中寻找 FSBLA，若分区表存在，新烧录到 LBA128 位置的 FSBLA 将会被忽略。

▲ 图 28 镜像在 SDCard 中的 Layout

需要注意的是，FSBLA 和 CUBE EXAMPLE 都需要加入 STM32 Header，才能被系统识别。STM32 Header 是 ROM CODE 加载二进制文件的必要格式，每一个被 ROM CODE 加载的二进制文件都需要在头部添加特定的 STM32 Header。STM32CubeMP13 开发包中提供了ImageHeader 工具，用于为项目二进制文件添加 STM32 Header。开发者不需要深究 STM32Header 的详细内容。
( [; s1 n( G5 h
$ \3 I/ Z7 X% a' L▲ 图 29 STM32 Header 信息
( x5 J$ Q5 c$ V, c- a" S6 L
为用户程序加入 STM32 Header，可在工程配置的 post-build steps 中加入如下命令：
“(path_to_STM32CubeMP13
Package)/Utilities/ImageHeader/postbuild_STM32MP13.sh"
9 ?; B- e7 [/ h. Q! H7 _  V$ \"${gnu_tools_for_stm32_compiler_path}"
3 [$ p% g; i8 H9 V"${BuildArtifactFileBaseName}"

5 E0 \' p0 w% d) H
重新编译完成后，即可生成打上 STM32 Header 的目标文件。

$ c) V" s4 ?; X" @9 r" b3 ^3 d, p0 D' G% g& i▲ 图 30 添加 Post-build 命令
* b- ?& K; C! g2 V* C, d1 [
6 S  b- [/ Q5 U! ^3 B. B注：path_to_STM32CubeMP13 Package 为 STM32CubeMP13 开发包的存放路径。
, E7 i; \, l8 |* ^7 c& p) U, I
至此，已准备好待烧入 SDCard 的目标文件：
1. 已添加 STM32 Header 的 FSBLA_Sdmmc 目标文件：FSBLA_Sdmmc1_A7_Signed.bin （即 FSBL）
/ r" f% b; E7 m7 v& {( [2. 已添加 STM32 Header 的 CUBE EXAMPLE 目标文件：MP13_BSP_BasicTemplates.stm32（即用户工程）

2 H' R  x4 S! Y0 K( w4 p) g烧录工程位于 STM32CubeMP13 开发包的如下目录:
6 ]0 ?+ S, H5 J* h8 A. }4 y3 f$ a\Projects\STM32MP135C-DK\External_Loader，以二进制的方式提供了烧录时需要的两个引导文件，包括：
1.STM32PRGFW_UTIL_MP13xx_CP_Serial_Boot.stm32
2.SD_Ext_Loader.bin其中，STM32PRGFW_UTIL_MP13xx_CP_Serial_Boot.stm32 为基于开源工程。


Openbootloader 实现的一套 IAP 应用，执行烧录流程管理。SD_Ext_Loader.bin 工程执行SDCard 设备的实际擦写操作。
# _! V# r+ N! V$ A

目前，引导设备可支持 SDCard，QSPI NOR FLASH、EMMC 等，若项目开发中需要修改适配不同的存储设备，可联系 ST 窗口获取烧录工程源码。

# `7 N; \, R' h: Z. n. u" y将需要烧录的两个文件拷贝到 External_Loader 目录下，与烧录工程的两个文件存放在相同位置，然后修改 tsv 文件。完成后，目录中文件列表和 tsv 文件内容如图所示。

, \8 q4 Z. g6 N. u8 E( }: O' R▲ 图 31 烧录文件列表

▲ 图 32 tsv 文件内容
; O# I0 Y) C! ~% O6 B, x6 s

9 V5 G* m4 k' a7 E) d4 h* z接下来，即可使用 STM32CubeProg 进行镜像烧录。可支持通过 USB 或 UART 连接，不支持通过 ST-LINK 连接。这里以 UART 连接为例：
1. 开发板跳线设置到 000 并上电
1 b' w6 p0 O: Q8 {2. 连接 MicroUSB 口，查看 COM 号。注意通过串口连接时需要断开 USB OTG
3. STM32CubeProgrammer 选择连接方式为 UART，选择相应 COM 口
0 r$ }8 C2 f- A; `8 d. H$ J4. 点击 Connect 连接
6 Y* b0 t! O5 `1 i# ^

9 O% e& i% t  u6 b
6 N  q% Z- n4 J) W8 g- B5. 点击 Open File，选择 FlashLayout_OpenBL_ExtLoaderSDMMC_SerialBoot.tsv 文件
6. 点击 Browse，选择目标文件夹：\Projects\STM32MP135C DK\External_Loader\SD_Ext_Loader
7. 点击 Download，开始下载镜像
) Y6 i% f3 A: r& w: X- p


& ^1 U3 [, D3 V$ ], X
8. 等待烧录完成
* c; f2 N6 d) r$ O& }) @& D8 G5 y& V9. 将板子断电，boot mode 切换至 SDCard 启动
10. 重新上电，即可引导启动
+ J7 B, s' m* I- j: S+ y
* Q- Y1 x! ^" e
* z( f) t. c3 y7 Y转载自:STM32

, e6 M, \) Z* m4 ]$ }: w