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()