STM32——库函数开发小结

STM32——库函数开发小结

宗旨：技术的学习是有限的，分享的精神是无限的。

基本上所有外设都有以下几类寄存器：【CR/DR/SR】

（1）控制寄存器 xxx_CR(Control/Configuration Register)：这类寄存器是用来配置、控制 相应 外 设 的 工 作 方 式 的 。 如 GPIOx_CRL、GPIOx_CRH， AFIO_EXTICR1~AFIO_EXTICR4，串口的 USART_CR1~USART_CR3等。

（2）数据寄存器 xxx_DR(Data Register)：这类寄存器主要是存储了外设进行输出输入的数据。如 GPIOx_IDR、GPIOx_ODR、USART_DR 等。

（3）状态寄存器 xxx_SR(Status Register)：这类寄存器主要存储了当前外设的运行状态，主要为一些标志位。如 USART_SR、ADC_SR等。

一、初始化

GPIO_InitTypeDef型的 GPIO_InitStructure 用来配置 GPIO；

NVIC_InitTypeDef型的 NVIC_InitStructure 用来配置 NVIC；

EXTI_InitTypeDef型的 EXTI_InitStructure 用来配置 EXTI；

USART_InitTypeDef型的 USART_InitStructure 用来配置 USART。

初始化结构体的控制参数，一般就是与相应外设的控制寄存器 xxx_CR 对应的。

使用ST库对外设进行初始化，一般有以下步骤：

（1）定义一个xxx_InitTypeDef类型的初始化结构体。

（2）根据使用需求，向这些初始化结构体的成员写入特定的控制参数。

（3）填充好结构体之后，把这个结构体作为输入参数调用相应的外设库函数xxx_Init()，从而实现向寄存器写入控制参数，并配置好外设。

       如ADC_InitTypeDef， ADC_Init() , I2C_InitTypeDef ，I2C_Init() 等。它们的应用方法都是相同的，区别在于不同的外设其结构体成员不一样，可输入参数相应也不同。

 

二、数据的输入输出

       对外设的使用，一般涉及其输入和输出数据。如GPIO 的 输入输出 函 数： GPIO_ReadOutputDataBit()、GPIO_ReadInputData()、GPIO_SetBits()；还有USART 的收发数据函数：USART_ReceiveData()、USART_SendData()，这类函数都是用于控制输入输出数据的。这些函数控制相应外设数据寄存器 DR 的内容，达到控制输入输出的目的。

（1）通过输入参数，向函数指定要使用的是什么外设，如用（GPIOA，GPIO_Pin_5）选定PA5进行控制，用（USART1）来指定使用串口1外设。

（2）若向外输出数据，则调用Output或 Send函数，把将要输出的数据变量作为函数的输入参数。

（3）若为接收外部数据，则调用Read或Receive函数，读取函数的返回值来得到外部输入数据。对于其他外设，也有类似的控制数据输入输出函数。如用ADC_GetConversionValue()函数来获取ADC转换所得到的数值；用I2C_SendData()函数来使用I 2 C接口进行发送数据。

 

三、状态位、标志位

         xxx_GetFlagStatus() 或 xxx_GetITStatus()，功能分别为获取事件标志位状态和中断标志位状态。xxx_ClearFlag() 或 xxx_ClearITPendingBit() 函数，功能分别为清除事件标志位和清除挂起的中断标志位。这四类函数都是对应到外设的 xxx_SR 寄存器的。

 

四、外设函数分类

函数名

功能

输入参数

返回值

具体函数举例

XXX_Init()

对外设进行初始化

XXX_InitTypeDef初始化类型结构体

void

GPIO_Init()

USART_Init()

XXX_DeInit

以系统默认的形式对外设进行初始化

将要进行默认初始化的外设名

void

USART_DeInit()

I2C_DeInit()

XXX_StructInit()

以默认数据填充初化结构体

将要进行默认填的xXX_InitTypeDef初始化类型结构体

void

GPIO_StructInit()

XXX_SendData()

使用外设发送数据

XXX(相应的外设名)；将要发送的数据

void

USART_SendData()

I2C_SendData()

XXX_ReceiveData()

获取外接收到的数据

XXX(相应的外设名)

返回接收到的数据

USART_ReceiveData()

I2C_ReceiveData()

XXX_GetFlagStatus()

检查外设事件标志位

要检查的事件标志名

返回标志位状态(SET或ESET)

USART_GetFlagStatus()

SDIO_GetFlagStatus()

XXX_GetITStatus()

检查中断标志

要检查的中断标志名(大部分跟事
件标志相同)

返回标志位状态 (SET或RESET)

USART_GetITStatus()

I2C_GetITStatus()

XXX_ClearFlag()

清除事件标志位

要清除的事件标志名

void

USART_ClearFlag() RTC_ClearFlag()

XXX_ClearITPendingBit()

清除挂起的中断标志位

要检查的中断标志名(大部分跟事件标志相同)

void

USART_ClearITPendingBit()

RTC_ClearITPendingBit()

XXX_ITConfig()

设置外设的中断

XXX(相应外设的名字)；选择要开启外设的某种中断(如接收中断，发送完成中断)；ENABLE 或DISABLE 中断

void

USART_ITConfig()

ADC_ITConfig()

XXX_Cmd()

使能或关闭外设

要 配 置 的 外 设名；ENABLE 或DISABLE

void

USART_Cmd()

TIM_Cmd()

XXX_DMACmd()要

配置外是否可 使用DMA 请求

配置的外设名；选择要配置DMA 请求 (DMA 接收请求，DMA 发 送 请求)；ENABLE 或
DISABLE

void

USART_DMACmd()

SDIO_DMACmd()