解析STM32的库函数-1

一、引言

我们在学习32的过程中，固件库是个必不可少的东西，因为程序开发不再是从寄存器层次起始，而要首先去熟悉 STM32 所提供的固件库。那是否一定要使用固件库呢？当然不是。但 STM32 微控制器的寄存器规模可不 是常见的 8 位单片机可以比拟，若自己细细琢磨各个寄存器的意义，必然会消耗相当的时间， 并且对于程序后续的维护，升级来说也会增加资源的消耗。

二、正题

以最常用的 GPIO 设备的初始化函数为例，如下程序段一：

GPIO_InitTypeDef GPIO_InitStructure; ○1
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4; ○2
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; ○3
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; ○4
GPIO_Init(GPIOA , &GPIO_InitStructure); ○5

这是一个在 STM32 的程序开发中经常使用到的 GPIO 初始化程序段，其功能是将 GPIOA.4 口 初始化为推挽输出状态，并最大翻转速率为 50MHz。下面逐一分解：

首先是O1 ，该语句显然定义了一个 GPIO_InitTypeDef 类型的变量，名为 GPIO_InitStructure,找出GPIO_InitTypeDef的原型位于

“stm32f10x_gpio.h”文件，原型为如下：

typedef struct
{
u16 GPIO_Pin;
GPIOSpeed_TypeDef GPIO_Speed;
GPIOMode_TypeDef GPIO_Mode;
}GPIO_InitTypeDef;

由此可知 GPIO_InitTypeDef 是一个结构体类型同义字，其功能是定义一个结构体，该结 构体有三个成员分别是 u16 类型的 GPIO_Pin、GPIOSpeed_TypeDef 类型的 GPIO_Speed和 GPIOMode_TypeDef 类 型 的 GPIO_Mode 。继 续 探 查 GPIOSpeed_TypeDef 和GPIOMode_TypeDef 类型，在“stm32f10x_gpio.h”文件中找到对 GPIOSpeed_TypeDef 的 定义：

typedef enum
{
 GPIO_Speed_10MHz = 1,
 GPIO_Speed_2MHz,
 GPIO_Speed_50MHz
}GPIOSpeed_TypeDef;

则可知 GPIOSpeed_TypeDef 枚举类型同一只，其功能是定义一个枚举类型变量，该变量 可表示 GPIO_Speed_10MHz、GPIO_Speed_2MHz 和 GPIO_Speed_50MHz 三个含义（其中GPIO_Speed_10MHz 已经定义为 1，读者必须知道 GPIO_Speed_2MHz 则依次被编译器赋予 2，而 GPIO_Speed_50MHz 为 3）。同样也在“stm32f10x_gpio.h”文件中找到对 GPIOMode_TypeDef 的定义：

typedef enum
{
GPIO_Mode_AIN = 0x0,
GPIO_Mode_IN_FLOATING = 0x04,
 GPIO_Mode_IPD = 0x28,
 GPIO_Mode_IPU = 0x48,
 GPIO_Mode_Out_OD = 0x14,
 GPIO_Mode_Out_PP = 0x10,
 GPIO_Mode_AF_OD = 0x1C,
 GPIO_Mode_AF_PP = 0x18
}GPIOMode_TypeDef;

这同样是一个枚举类型同义字，其成员有 GPIO_Mode_AIN、GPIO_Mode_AF_OD 等（也 可以轻易判断出这表示 GPIO 设备的工作模式）。至此对程序段一的O1 解析可以做一个总结：该行定义一个结构体类型的变量 GPIO_InitStructure，并且该结构体有 3 个成员，分别为 GPIO_Pin、GPIO_Speed 和 GPIO_Mode，并且 GPIO_Pin 表示 GPIO 设备引脚 GPIO_Speed 表示 GPIO 设备速率和 GPIO_Mode 表示 GPIO 设备工作模式。