STMCU小助手
发布时间:2024-11-22 19:09
|
01 引言 STM32MP13x 系列 MPU 是 STM32 Arm®Cortex® MPU 家族中的一部分,它拥有单核Cortex®-A7 核心,支持核心频率 650MHz~1GHz,不仅能够轻松运行 Linux 操作系统,还同时提供官方 HAL 库,用于支持基于 RTOS 或无 OS 的项目方案,即裸跑应用程序。5 N5 v, v. F/ J! H! |, H 本应用文档将就以下几个部分简述如何在 STM32MP13 系列 MPU 上开始无 OS 项目的开发:9 L0 {" [& ~& I, g/ @* ^ • STM32MP13x Baremetal 开发环境简介3 J: |; E6 b$ G • STM32MP13x 工程的创建 • STM32MP13x 工程的在线调试 • 镜像烧录及从外部 Flash 启动& B7 b1 d, A: [. J: \ $ K" \! J i( }& S$ F% J 02 STM32MP13x Baremetal 开发环境简介 2.1 开发工具及环境& w7 a( e+ C& L/ m% X; @0 y STM32MP13x Baremetal 开发工具主要包括: 1. 烧录工具:STM32CubeProg ( 版本大于 v2.15.0). C* U, }0 y4 w$ u" N 2. 配置工具:STM32CubeMX (版本大于 v6.10.0) 3. 开发调试工具:IAR(版本大于 v9.50),或 STM32CubeIDE(版本大于 v1.14) 本文示例基于 STM32CubeIDE 开发调试工具。8 O' c) w( }; O" w3 Z' w, ~ ! ]. ?1 T/ ]" k. g6 K+ }" Q 2.2 STM32CubeMP13 开发包 STM32CubeMP13 开发包同步发布于 ST 官网 www.st.com 和 github.com,可通过如下方式下载: 1. ST 官网下载链接+ L5 W1 E6 {" k* d 2. Github 仓库链接( g! L" V9 X' f4 D" D6 O 3. 通过 STM32CubeMx 软件下载1 p: ~" u) \6 h0 ` D; w 2.2.1. STM32CubeMP13 开发包总览 STM32CubeMP13 开发包运行在 Arm® Cortex®-A7 处理器上,由以下三部分组成: • Level 0:驱动程序,包含 HAL、LL、BSP、CMSIS" A v( Z; f' e6 C • Level 1:中间件,包含 Eclipse ThreadX(原 AzureRTOS),USB Host & Device 库 • Level 2:包含各种板级示例程序 除此之外,还包括一些工具助手等。+ P C2 q9 T. L2 y# l2 J4 D& c ' ?7 o' }7 Q' f0 y
▲ 图 1 Baremetal 开发包源码框架% Q3 c" L6 D, W9 _$ s- m7 I 5 c2 k) ~2 z) T' x2 X3 B 2.2.2. 源码目录结构
▲ 图 2 Baremetal 开发包源码目录 [# u$ q9 I1 q 2.2.3. 开发包支持模块列表 已支持的 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 已支持的 LL drivers : • ADC, DMA/DMAMUX, EXTI, ETZPC, GPIO, I2C, LPTIM, MDMA, PWR, RCC & BUS, RTC, SPI, TIM, USART % i, v- S1 `( l @( w6 J BSP 与 BSP 组件:0 m: x& M0 @) T • 基于 HAL 封装了更高一级的 API,为 LED、按钮、相机、LCD、SD 卡和 COM 端口提供 API,包含了以下一些外围器件的驱动:GC2145, LAN8742, MCP23x17, RK043FN48H, STMIPID029 L7 @$ T' w# `# g q a* S) O, @ 中间件程序: • 包含一系列支持某种服务的库文件及接口文件,目前已支持:Eclipse ThreadX(原 AzureRTOS),STM32_USB_Device_Library,, t# L: a* X& J/ o& i6 l. ^; @3 _ STM32_USB_Host_Library" K x8 E2 K ?. T* ?7 Y) V 项目工程:+ Q+ V2 L" M# a- R8 t • Examples:基于 HAL 接口的简单示例,没有中间件功能。" v% n# L. v" o/ [8 n • Applications:较完整的工程应用实例,包含中间件功能。 • External_Loader: 烧录镜像及从外部存储器启动的应用示例。 • Template: 板级工程应用框架。 实用工具:9 H4 ]9 D9 }& m* Q& X, V • Imageheader:用于添加 stm32 头,支持存储设备启动。: C7 [6 B- t+ @0 l1 F0 X • Fonts:提供了一组用于显示的标准字体,包括 font8,font12,font16,font20,font24# E5 y% D0 D, N. [' _9 B; ^ 03 STM32MP13x 工程的创建! e) ]1 E; Q6 s o/ r, c5 z STM32MP13x 工程创建,可通过以下两种方式: 1. 使用 STM32CubeMx 配置并生成项目框架代码,并基于该框架代码开发应用。5 U5 s5 t. ^* d& ~* j 2. 导入 STM32CubeMP13 开发包示例工程代码,并基于该示例代码开发应用。 2 F6 r# u. ]4 `% Q9 K4 J* ] 3.1. 从 STM32CubeMX 创建工程 STM32CubeMX 是 STM32Cube 工具家族中的一员,它采用简单易用的图形界面,可以帮助开发者快速配置硬件和软件。可支持从 MCU/MPU 选型,引脚配置,系统时钟以及外设时钟设置,到外设参数配置,中间件参数配置等,并可生成适用的 C 代码项目。 本章节简述如何通过 STM32CubeMx 生成适用于 STM32MP13x 的裸跑应用框架。使用该方式无需提前下载 STM32CubeMP13 开发包,STM32CubeMx 可自动联网下载。/ ?8 E: k; C8 c b 1. 打开 STM32CubeMX,点击 ACCESS TO MCU SELECTOR, 2. 在搜索框中输入 STM32MP13 相应料号,如:STM32MP135FAF7,双击打开配置窗口 3. 弹框选择 MP13 Bare Metal,将生成 bare metal 工程框架。
▲ 图 3 STM32CubeMx 选择器件9 L! Y* ]8 {! m: s9 {8 S
1 L- A8 C( w0 W L4 H% {$ X/ G! t" R ▲ 图 4 STM32CubeMx 选择工程类型 4 D& j9 g5 e5 E3 Y: G4 ` A4 d 4. 切换到 Project Manager 标签页,输入工程名称。 5. 在此页进行项目选项配置,可保持默认。5 w. |8 L- h7 I) G+ [. \
+ n2 c7 g! q9 B0 x% Z3 ]- \ ▲ 图 5 STM32CubeMx 工程设置页面, P. o% L( v6 F+ Q# X 8 V& s2 p! A) F9 ?1 V1 b' O 6. 回到 Pinout & Configuration 标签页。 7. 使能 RCC 和 DDR。+ L5 E. D. O# R 8. 配置各外设总线,配置方法与其他 STM32 MCU 相同(也可参考 Help -> Docs & Resources) * V; x& A8 P% j2 b ) R) K7 e/ j. {8 i
▲ 图 6 STM32CubeMx 外设配置页面! @8 R, H) b4 p2 `0 B - A. X1 V8 T# D! v , |1 S% ~' e2 Q8 R% k( Y6 a2 E; [ 9. 切换到 Clock Configuration 标签页。 10. 若软件报告时钟错误,可点击 Yes 自动修复。: P _8 c; q y2 i- O6 j 11. 输入 CPU、DDR、总线等的工作频率,系统会自动匹配合适参数。
▲ 图 7 STM32CubeMx 时钟配置页面- ~. X! I1 B; D* O4 V3 X- n . u+ [: x9 E# A3 U; P 12. 所有外设配置完成,即可点击 GENERATE CODE,开始生成工程代码。) C& ^ t+ o# t1 [; l 13. 若第一次使用,软件将提示是否下载 STM32CubeMP13 开发包,可点击“yes”,软件自动联网下载前述 STM32CubeMP13 开发包。 14. 生成完成后,可直接点击 Open Project,将打开 STM32CubeIDE 工程。% T+ x: @% B3 h
▲ 图 8 STM32CubeMx 代码生成页面
▲ 图 9 STM32CubeMx 完成代码生成页面
▲ 图 10 STM32CubeMx 生成工程代码示例 : T6 A) G6 N6 D9 b' c 15. 至此,工程框架已生成,可通过 STM32CubeIDE 进行用户代码的编辑、编译、调试。( Y% ^. x. b8 z& y3 a8 V; N / A/ A h! U1 i1 L 3.2. 从 STM32CubeMP13 开发包导入工程 若已事先通过 ST 官方网站或 Github 下载了 STM32CubeMP13 软件开发包,也可导入开发包中的工程示例代码,从示例代码开始进行项目开发。 这里以 FSBLA_Sdmmc1 工程为例。 项目路径:\Projects\STM32MP135C-DK\Applications\FSBLA\FSBLA_Sdmmc1 1. 打开 STM32CubeIDE,导入 project" K% e/ U& Z, B. T1 R9 D 2. 点击 Files -> Import…- h- ~7 p6 t9 l* A5 @" M% K- I
▲ 图 11 STM32CubeIDE 右键项目菜单 , b, U+ G% c M' U. q % b* ^! P6 Q4 ^4 w/ x3 ? 3. 选择 Existing Projects into Workspace 4. 点击 Next>
▲ 图 12 STM32CubeIDE 导入已存在项目* O- v1 d4 m6 o- B& d; N* O ( N% k! u- _4 t+ ?: a, k; s 5.点击 Browse…,找到目录 \Projects\STM32MP135C-DK\Applications\FSBLA 6. 选中 FSBLA_Sdmmc1_A7 工程 7. 点击 Finish,导入 Project
6 P! R/ g8 i- ], E5 B; s" E6 Z& Y( r ▲ 图 13 STM32CubeIDE 选择导入项目+ ~6 F) A& `6 E+ ]- B6 ^# l( a 1 a1 S# Z! `0 d; v" Y: m1 I 1 z4 U9 ^. J; F% K9 u3 l k( ~* V0 [ 8. 工程导入完成。4 \2 c k! J. B! w; ~ M 04 STM32MP13x 工程的在线调试( |3 D* B5 ?1 J3 j- s3 Q 工程创建完成后,接下来本章节将介绍如何基于 STM32CubeIDE 进行工程编译及在线调试。 * g V, x/ r( a3 T STM32MP135 内部包含 128KByte SYSRAM,若代码小于 128KByte,可直接运行于内部SYSRAM 中,适用于验证一些简单的外设实例。若代码大于 128KByte,则需要将程序运行于DDR 中。下面将分别阐述。8 C$ v1 r/ H& r 1 s" K) \* p7 ], S0 U 4.1. 在 SYSRAM 中调试程序 仍以前述导入的 FSBLA_Sdmmc1_A7 工程为例。3 o/ d7 a( G4 y" Z6 p b 1. 首先,将开发板切换到工程模式( K$ a' N5 \+ A+ ~% K$ B 2. 连接 Type-C 电源3. 连接 MicroUSB,这里板载已支持 ST-Link
3 y: Y, T' P& V* c R4 N ▲ 图 14 开发板切换工程模式: L8 l2 x4 P+ n 4. 右键项目工程名称,选择 Build Project,完成编译。. P' W# w. O; u8 W3 v; l- f
▲ 图 15 选择编译工程6 U7 u1 k. D! [) s9 s0 N$ N2 i 8 E; U8 n' `' {- s( o9 I 5. 右键工程名称,选择 Debug As -> STM32 C/C++ Application
▲ 图 16 选择调试项目方法 1 b+ B. U% y: a% {8 Y8 }! q8 C 6. 或点击 Debug 图标 7. 进入 Debug Configurations….
▲图 17 选择调试项目方法 2: p. K. W: h; `4 X 3 _" e* Z: a$ x - c7 M. e6 q+ {% m4 h* e' A$ B& O 8. 进入调试配置菜单/ Y6 y, Y7 e3 y2 G. ]
▲图 18 调试配置页面 6 }: } S/ @+ |# U0 D
) ^6 R& c0 h3 G- E6 y C 9 E( m t* @) k - {7 u0 \6 b- L$ X 9. 即可像 MCU 一样调试您的代码。
▲图 19 项目调试窗口 ]* I1 }$ l$ @# g3 w* P 9 `' g. x# U/ {: x; b) y 4.2. 在 DDR 中调试程序 当代码量超过 SYSRAM(128KB)的大小时,需要将程序运行在 DDR。这里以 BSP_BasicTemplates 工程为例展示如何开发运行于 DDR 的用户程序、3 K) B8 h- L0 h. Q2 S" S8 t3 U% R 1. 首先,按照前述方法导入项目工程
▲图 20 导入 Templates 工程/ [3 ]% R5 v6 I( S3 l* O* q% R 2. 打开 C/C++ Build 配置' T1 H5 S* o! T: X2 ?7 C* i% u7 w1 h 3. 在 Preprocessor 中添加 USE_DDR 宏定义
) R0 B- a" @7 `7 s1 ^4 l" d3 | ▲图 21 使能 DDR 宏# c& U( m6 {" X% n- ~ : ^/ @& h+ C: |+ T1 P5 f# q + i0 V2 [: D( t# o 4. 修改链接文件,重命名为 “stm32mp13xx_a7_ddr.ld” Q, E/ ]3 Z- u( b 5. 修改 REGION_ALIAS 定义到 DDR 区域: 6. 重新编译后,目标文件将链接到 DDR
▲图 22 修改链接空间' i0 h; Q9 C$ i; w+ O, F
▲图 23 选择链接文件 7 q$ Z; C1 I; m 7. 在调试之前需要先运行 DDR_Init 对 DDR 进行初始化8 X5 [# m* x% s E 8. 按照前述方法导入 DDR_Init 工程,编译后全速运行一次,并保持开发板不掉电项目路径:\STM32MP135C-DK\Examples\DDR\DDR_Init
2 L. A* u7 e( x$ A ▲ 图 24 运行 DDR 初始化9 W# f7 R- F; _/ H. J* B9 Z0 t 1 e3 P( w, r2 q. a+ y# B- l* f, j% u 9. 回到 BSP_BasicTemplates 工程。 10. 在 Debug configuration 对话框中,将 Startup 页面的 monitor reset 删除。
9 H0 G! U! [6 y9 v$ D. O2 f ▲ 图 25 修改调试参数 % n0 j Q. G: l8 _3 ]$ C5 | 11. 点击 Debug 进入调试 12. 可以看到当前 main 函数的地址已经为 0xC000 开头的 DDR 位置4 g5 g$ J! u' A' [ * T- s2 U) t# Y! R- o$ m
5 y. d0 S; p4 ~ ▲ 图 26 在 DDR 中调试工程 X, w$ P/ T w+ P 05 从外部 Flash 启动4 x' Q* T* K1 {% R& Q
▲ 图 27 STM32MP13 启动流程 0 P1 G" B1 H. O+ T' G V 从外部 flash 引导 STM32MP13, 一般需要包含两个部分源码。如上图所示,芯片上电后,首先运行内部固化的一段 ROM CODE,ROM CODE 从用户配置的启动器件中寻找 FSBLA,并将其拷贝至 SYSRAM 中,FSBLA 运行后,执行 DDR 初始化及用户代码(CUBE EXAMPLE)拷贝到 DDR 中,最终实现跳转到 DDR 中运行用户程序的目的。( y$ }+ P* s8 q0 x4 O ! V% t3 U+ F" }" F' R; ^ 这里以 SDCard 启动为例,在第三章节中,我们编译调试的 FSBLA_Sdmmc1_A7 工程,即实现了 FSBLA 部分的功能,BSP_BasicTemplates 工程为实际开发的用户项目。完成启动需要将这两个工程生成的镜像文件都烧录到 SDCard 中。! W3 ~& a* y% q/ E • FSBLA 需烧录到 SDCard 的固定位置 LBA128 或 LBA640,ROM CODE 固定从这两个位置寻找 FSBLA。 • CUBE EXAMPLE 的存放位置可在 FSBLA 程序中修改,默认为 SDCard 的 LBA640。+ O' \2 p, m, c: V • 如果有烧录过 OpenSTLinux 的卡,需先格式化。原因是 ROM Code 优先从 GPT 分区表中寻找 FSBLA,若分区表存在,新烧录到 LBA128 位置的 FSBLA 将会被忽略。4 @. H l$ F$ O' a1 z/ Z1 @
▲ 图 28 镜像在 SDCard 中的 Layout 5 _9 h; M1 O& |& d( ` 需要注意的是,FSBLA 和 CUBE EXAMPLE 都需要加入 STM32 Header,才能被系统识别。STM32 Header 是 ROM CODE 加载二进制文件的必要格式,每一个被 ROM CODE 加载的二进制文件都需要在头部添加特定的 STM32 Header。STM32CubeMP13 开发包中提供了ImageHeader 工具,用于为项目二进制文件添加 STM32 Header。开发者不需要深究 STM32Header 的详细内容。3 O a1 [- G+ L
▲ 图 29 STM32 Header 信息 为用户程序加入 STM32 Header,可在工程配置的 post-build steps 中加入如下命令: “(path_to_STM32CubeMP13 Package)/Utilities/ImageHeader/postbuild_STM32MP13.sh" "${gnu_tools_for_stm32_compiler_path}" & M. u' i+ M2 E0 [6 e, n "${BuildArtifactFileBaseName}" " I# h7 p+ `/ o+ Y8 E4 u 重新编译完成后,即可生成打上 STM32 Header 的目标文件。. r, o7 R9 ~2 p$ P; M/ r' K+ a
▲ 图 30 添加 Post-build 命令: X) Q0 u" s* t! q* V' W! K8 } ) _. K3 x$ y6 ]/ _4 f5 f 注:path_to_STM32CubeMP13 Package 为 STM32CubeMP13 开发包的存放路径。; g+ t- X, ~3 U0 ^- G" C4 A 至此,已准备好待烧入 SDCard 的目标文件: 1. 已添加 STM32 Header 的 FSBLA_Sdmmc 目标文件:FSBLA_Sdmmc1_A7_Signed.bin (即 FSBL) 2. 已添加 STM32 Header 的 CUBE EXAMPLE 目标文件:MP13_BSP_BasicTemplates.stm32(即用户工程) 烧录工程位于 STM32CubeMP13 开发包的如下目录:' k$ B) \3 D- M; s \Projects\STM32MP135C-DK\External_Loader,以二进制的方式提供了烧录时需要的两个引导文件,包括: 1.STM32PRGFW_UTIL_MP13xx_CP_Serial_Boot.stm327 a/ L0 m6 l- b9 Q: D 2.SD_Ext_Loader.bin其中,STM32PRGFW_UTIL_MP13xx_CP_Serial_Boot.stm32 为基于开源工程。) `) L( T/ @! Q& a& Z6 H/ x ( i2 y3 `3 e: I1 {* O( V2 r4 ]0 d; C' q 8 m8 }+ R( V- ?! B9 F Openbootloader 实现的一套 IAP 应用,执行烧录流程管理。SD_Ext_Loader.bin 工程执行SDCard 设备的实际擦写操作。 ]* W6 A# p0 z2 F- j& O ` 8 _/ S# ]7 u3 Y7 w$ M) n9 r: q, Z' P 目前,引导设备可支持 SDCard,QSPI NOR FLASH、EMMC 等,若项目开发中需要修改适配不同的存储设备,可联系 ST 窗口获取烧录工程源码。 ( @6 E# k; y+ K 将需要烧录的两个文件拷贝到 External_Loader 目录下,与烧录工程的两个文件存放在相同位置,然后修改 tsv 文件。完成后,目录中文件列表和 tsv 文件内容如图所示。8 m1 {; t2 J1 @ W4 ?$ a
▲ 图 31 烧录文件列表- t# e$ m8 o7 Y' ?4 e ?/ U7 i
▲ 图 32 tsv 文件内容8 T. |" e6 z( M" c 0 H7 P8 i: P3 ^' L! j) |8 m ) b$ z2 r2 L) u6 F9 j) x; M 接下来,即可使用 STM32CubeProg 进行镜像烧录。可支持通过 USB 或 UART 连接,不支持通过 ST-LINK 连接。这里以 UART 连接为例: 1. 开发板跳线设置到 000 并上电 2. 连接 MicroUSB 口,查看 COM 号。注意通过串口连接时需要断开 USB OTG 3. STM32CubeProgrammer 选择连接方式为 UART,选择相应 COM 口9 i2 J7 k/ L0 V 4. 点击 Connect 连接; O$ q6 {6 P& [+ r3 a6 D8 T+ X6 k
5. 点击 Open File,选择 FlashLayout_OpenBL_ExtLoaderSDMMC_SerialBoot.tsv 文件1 K# {7 z$ e" H 6. 点击 Browse,选择目标文件夹:\Projects\STM32MP135C DK\External_Loader\SD_Ext_Loader 7. 点击 Download,开始下载镜像0 N$ [' `1 B2 \7 H
3 y/ F6 C; l- j, w: x+ C. X
8. 等待烧录完成2 P( Z1 I- u- E' ~; W; x 9. 将板子断电,boot mode 切换至 SDCard 启动 10. 重新上电,即可引导启动& G* w! F" L, S' }7 H7 Q
% B* b9 x, D( a/ V1 q9 ` 转载自:STM32 * J' k; P X5 `* c* m8 {; c |
直播回顾+QA | STM32MP135在工业组态HMI和工业网关中的应用实践
STM32MP135 MP157 MP257 CoreMark移植&&跑分对比&&多核心负载不均衡问题排查与解决
有奖直播 | STM32MP135在工业组态HMI和工业网关中的应用实践
拷打cubemx【001】——艰难的选型路
linux eclipse编译后自动更新程序
eclipse编写stm32mp135配置
eclipse编写stm32mp135程序
STM32MP135F-DK 开箱测试
openSTlinux系统搭建过程分享
《STM32MPU安全启动》学习笔记之uboot如何校验kernel和如何使能校验
微信公众号
手机版