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 或 | void | USART_DMACmd() SDIO_DMACmd() |