1.第一个工程 翻转引脚2 Q& q. U5 i% r' A 上一篇文章我们详细介绍了 STM32F030 从复位时取得复位向量,系统初始化,然后跳转到 main( ) 函数的过程。下面我们结合一个最简单的例子,对 Cube 库的使用做一个简单的介绍。 我们用 Keil 打开下面这个工程: ) i" l: p% Z8 d STM32Cube_FW_F0_V1.11.0\Projects\STM32F030R8-Nucleo\Examples\GPIO\GPIO_IOToggle\MDK-ARM\Project.uvprojx $ l0 I ]. \1 R9 P 编译下载运行此代码,会看到一个 LED灯(连至MCU的 PA5引脚)不停地闪烁。为了完成这个简单的功能,我们看到这个工程里包含了不少文件:( e& \: X/ ^0 |; e( l' ?+ [' I . d7 G. b6 Q: [* F 如果是初次用这种库的方式做开发,乍一看还真感觉有点乱。不过让我们一个一个看一下这些文件,理清它们的关系后就会体会到这种方式的巨大优点。 " j8 D- Y4 t- I o0 U% }! l 2.文件分类解释 工程里的文件分为五大类:启动代码,M0内核初始化,驱动,板级支持包(BSP),用户代码。一般来说我们开发应用程序,主要关注用户代码文件就行了。如果硬件电路板做了改动,则修改BSP里的内容。1 f3 @# e5 O% s0 Q- p 在早期的单片机开发中,芯片内资源很少,通常的情况是一个工程师就从硬件到软件编程都做了,是没有 BSP(Board Support Package)这种概念的。BSP概念来源于较复杂的CPU系统的开发,一般是厂家设计主板,并提供 BSP(包含启动代码,驱动,Bootloader等)。我们这里的 BSP 概念稍有不同,它是指对某一块儿以 MCU 为核心的电路板的支持代码包。启动代码,内核初始化和驱动,没有包含在内。BSP会调用驱动层的代码。 l- _1 {9 ?! u5 S 对于 STM32 Nucleo 这块儿开发板来说,板上资源很少,所以BSP只提供了相应的按键(BUTTON)和指示灯(LED)支持代码。里面的ADC,SPI,LCD等代码是支持其它板子的,可以先忽略。 启动代码- ^' B) J# Z% c ) \) R8 R j9 q7 p 为理解汇编代码,我们先熟悉一下这些伪指令: ALIGN 变量或代码对齐。如: 6 q$ `3 L; [ N i3 U. F& g# c2 P1 L1 f ALIGN = 3 以8(2的3次方)字节对齐。 r9 ?6 {0 s; z7 u EQU 给标号赋值。如: - ]- o* b- T5 i$ ? Stack_Size EQU 0x400; 4 x& [4 r" o" B. u DCD 分配1个或多个字(words)的内存空间。如:2 s; J2 e; [. |/ J& x4 {' ` 7 @) H ~! H4 s* R8 C2 ^" M7 B: ~ Data DCD 1,5,8; 定义3个字并赋值为 1,5 和 8。; L7 `. o$ H7 Z5 ~ }% {0 D 1 J! p7 E# G7 F" k% F! u G AREA 定义一个代码或数据段(section),命名并指定属性。如:% _. }3 G: f ?3 n8 [% | - P, y& g9 U g AREA Func01, CODE, READONLY; 8 m+ v6 d3 J# M% J; x Y 定义了一个名字为 Func01 的只读代码段。 9 M2 u6 V" u; d! _. x l SPACE 保留一段空间并初始化为 0。如: 4 ~5 A% v6 A7 a: } Data SPACE 100; 为 Data 保留 100个字节初始化为 0 的内存空间。' \2 |/ h( ^3 R. r: n l IMPORT 导入其它文件中的标号,以在当前文件中引用。如:# |* D/ h! K; ~3 V) t- f IMPORT SystemInit ; u# Y2 k3 a! ^4 L7 ? LDR R0, =SystemInit " @: @; r% C7 }) a BLX R02 D: V+ S! S, F, A* U 3 ` e0 W' _8 b5 c# o 从文件 system_stm32f0xx.c 中导入 SystemInit 这个函数并调用。9 Y' w; g/ M0 M ! _) h0 Y, k$ ]7 S. D EXPORT 导出能被连接器(Linker)识别的标号。从ASM文件导出的标号可以在C中引用。3 N9 I9 R K! G1 v+ K) e) s# @ ) b' R" ^. [; t' A1 T; _7 R" {; o0 ~ [WEAK] 如果在其它地方定义了相同的标号,则此处定义被覆盖。 5 F9 j7 a& x1 G. ?: ]( a PROC 定义一个函数的起始地址。 ENDP 标志当前函数结束。 E5 M q I5 K, U( }9 x 例子: }8 L1 ]& X8 y: Q, w % b$ a# F1 N5 E7 N N6 d SysTick_Handler PROC, {+ C( k" y# v! G- ? 9 e# ?8 ^) o- V* h) E: r EXPORT SysTick_Handler [WEAK]: }9 ~* O8 [1 ]* r, O3 I# p, h; X/ | ) S; q+ s0 ?* U B.8 {. u$ Q$ H. l ENDP : p/ k/ [$ y b, Q R 导出 SysTick_Handler 这个中断处理函数。如果在其它地方定义了一个新的 SysTick_Handler 函数,那么新函数将覆盖此处定义的这个陷阱函数。汇编语句 B.为在当前语句死循环。4 x( T# Q7 }8 V5 I3 E 2 }# X3 y% Y* C) m$ l( c 下面我们看一下启动文件 startup_stm32f030x8.s / |& u z7 w3 J2 ^: _3 L% O5 _+ a 定义堆和栈:/ d6 [" o+ V- E; H1 Z. F3 R6 a : I2 z& s6 U3 m2 A8 A & B# B9 `# \/ O* N) U 中断向量表:" F$ R2 v( q$ R# G6 ?1 ` 1 Q- n P; ]& d0 z+ [4 t9 O& D 现在这个工程用到的只有绿线框中的几个向量: * X# @5 ^/ ?) k! Z __initial_sp ' i0 s/ Z4 r6 h: X& U( L 初始堆栈指针 . J0 U) @) K. ?/ X5 o t' P Reset_Handler & x c: f2 r9 h+ u7 l4 P F 复位向量,我们在上一篇文章已经讲到如何从复位向量一步一步执行到用户代码中的主程序main( )。- F2 H4 t9 ^; q2 e SysTick_Handler- @7 F3 B) S( t! b! C, [ 系统时钟中断向量。此程序每 1ms 产生一次中断。 需要注意的是 SysTick_Handler 这个中断处理函数在用户代码文件stm32f0xx_it.c 中进行了重定义,所以当 SysTick 中断发生时,实际会跳转到用户代码的中断处理函数,而不是跳到下图所示的汇编代码中断处理函数进入死循环。5 ^7 C, G9 ]: k1 J 0 ?$ V8 t4 v( D4 b9 S% g 再往下可以看到,对所有芯片级中断定义了一个共享的陷阱函数。用户在实际使用到某一个中断的时候,要在中断处理文件 stm32f0xx_it.c 中用相同的函数名定义,从而在中断发生时跳转到实际的中断处理函数。 在此文件的最下面的代码,是用来传递堆栈信息给库的:& K- ^4 Z% ~* H6 d l d5 K- t; a" Z* k1 c( B% a% [ 在芯片资源比较少时,可以通过选中 Options for Target->Target->Use MicroLIB 选项,使用简化版的库来实现 printf 等操作。若资源充足时使用标准库,库将调用下面的 __user_initial_stackheap 函数来获得堆栈信息。 % @4 G( H0 e7 R& n M0 内核初始化, {! `- G. M1 E" m system_stm32f0xx.c 此文件只有两个函数:: z& }- X2 S, ^9 k6 N$ k' G1 [ SystemInit( ),在启动代码中调用,把系统时钟复位到初始默认状态(8MHz的高频内部时钟 HSI)。 7 T& ?( R/ ?3 g5 u8 O( S" t SystemCoreClockUpdate( ), 在用户调用库函数更改时钟配置后,需要调用此函数以更新全局系统时钟变量 SystemCoreClock。其它模块基于此时钟的计算才会正确。一般来说更改时钟配置的 HAL函数已经包含此函数的调用,如 HAL_RCC_ClockConfig( ), 无需用户再次调用。, p/ j- i' q6 ?. i/ b7 x7 N+ e1 } 驱动0 h% `1 B4 H5 c( I& M, m$ ? h3 W ! z8 B8 @0 A( S! X stm32f0xx_hal_cortex.c" {1 f: S' Y. k. H % P7 |# @0 T) C0 Y* \8 f% M8 ^! g 包含 Cortex 内核中两个重要模块的驱动: 可嵌套中断向量控制器 NVIC(Nested Vectored Interrupt Controller), 2 F1 [0 @+ {' d7 N7 V$ \3 n 系统滴答时钟 SYSTICK。 V) `. ~; ^$ n 8 N7 _) N1 N. s+ c6 z* B6 N4 S stm32f0xx_hal.c D8 v8 Q! h% u) r. F 此文件包含用户程序必须首先调用的 HAL_Init( ),它会使能数据和指令缓存,预取指令队列;配置系统滴答时钟产生 1ms 中断;调用 HAL_MspInit( )回调函数。- K. L5 T3 Z! C% D7 i1 J2 ]! R 5 m: D# I7 n# Y. d, ? HAL_MspInit( )函数用来做系统级的初始化,配置某一模块相关的 时钟,引脚,DMA,中断等资源,但是在所有的例程中都没有实际用到此函数。可以先忽略。 stm32f0xx_hal_rcc.c3 [: U6 H; z! W$ q7 v" \4 ? 9 q6 s' Q' C4 E; K0 @ stm32f0xx_hal_rcc_ex.c RCC(Reset and Clock Controller)模块的驱动。一个模块为什么要两个驱动文件呢?前一个文件提供了基本的通用的功能驱动,后一个文件是扩展功能驱动,通常针对某一特定型号的芯片。如同我们吃饭需要餐具,_rcc.c 提供碗筷等常用必备工具,_rcc_ex 可能提供的就是酒杯,烛台等这些东西。$ f: U! F& ~. D2 [7 P$ F7 k0 N; p! Z+ b4 ] stm32f0xx_hal_gpio.c4 D" X! U O8 X GPIO 模块的驱动。 BSP 板级支持包% C8 R+ y! V' L4 a3 e* ] stm32f0xx_nucleo.c) K" _% q" I! s$ a& q. E 7 D6 J+ m% Q& \7 h1 x2 n0 a 针对 STM32 Nucleo 开发板的类型,宏定义,支持代码。 用户代码 main.c 主程序 3 R j3 n# V% J: w! i stm32f0xx_it.c 中断处理 前面介绍了一大堆文件,主要是为了清除系统的工作流程。在开发中使用库还是很简单的。在主程序中调用库,只需要通过 main.h 包含下面这个头文件:5 o) N. z3 w$ Z$ ?0 C$ d0 f 4 @$ Y' d1 _! f) @" t) \* A: g$ C% v stm32f0xx_hal.h$ i1 _! E0 H4 N7 \ ) N2 E2 V" @/ L* V3 Q9 Z 如果有 BSP 则包含 BSP 的头文件,在本工程是: stm32f0xx_nucleo.h 3 ~( a- b) z4 A( C 使用到哪个模块就在配置文件中打开使能该模块的宏定义。8 [! n, ?9 n' l9 t4 z% q6 u; y / q# P+ X3 l/ _: c1 v# T1 F stm32f0xx_hal_conf.h 然后第一步必须调用 HAL_Init( )。 第二步,如果希望系统时钟工作在默认内部时钟(8MHz HIS)以外的频率,则需要调用 SystemClock_Config( )。此函数又调用 HAL_RCC_ClockConfig( ) 完成新配置。) a) t/ c9 \2 h& Z ]( ] 4 C& ?% ^! V+ D" R8 N, e0 I 下面是应用代码: 6 \/ g/ B1 p3 @7 W) s 1 j4 R- n) f" Z: q! t, _ 所有模块一般都是这三个步骤:使能模块的时钟,初始化模块,使用模块的功能。 ; u9 i8 n. k6 T# [9 _) w2 g8 [ stm32f0xx_it.c 中的中断处理函数 SysTick_Handler( ) 很简单,每次进入就对滴答计时变量 uwTick 加1,其它 HAL 函数可以基于此变量计时。1 y' W( v/ B$ B- z: F |