一、STM公司对于该文件的简述
现在能够看到的关于GPIO操作的库函数是V1.8.0,可以在STM官方库支持中下载,文档的综述表明其功能是管理GPIO的外设功能,总共是三点:1.初始化;2.读写;3.复用。
二、文件中函数的使用
整个文件中包含14个函数,其中初始化与配置4个函数;读写操作9个;复用1个。
初始化函数:
GPIO_DeInit() 表示将取消初始化,恢复为其默认复位值。默认引脚悬空(除JTAG)。
GPIO_Init() 根据初始化结构体来自定义初始化引脚。例如下面的PA0引脚作为输入功能的初始化,在主函数中循环前使用,即可完成初始化的工作。
void demo(void)
{
GPIO_InitTypeDef GPIO_InitStructure; //定义结构体
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); //使能A端口引脚
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN; //输入模式
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; //推挽模式
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL; //不上拉不下拉
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; //IO速度
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; //初始化的引脚为PA0
GPIO_Init(GPIOA, &GPIO_InitStructure);
}
GPIO_StructInit() 根据默认模式初始化引脚。
GPIO_InitStruct->GPIO_Pin = GPIO_Pin_All;
GPIO_InitStruct->GPIO_Mode = GPIO_Mode_IN;
GPIO_InitStruct->GPIO_Speed = GPIO_Speed_2MHz;
GPIO_InitStruct->GPIO_OType = GPIO_OType_PP;
GPIO_InitStruct->GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_PinLockConfig() 锁定寄存器GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR,GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH,可使用复位操作来解除锁定。
读写操作:
加了bit的函数,需要选定端口和具体引脚,未加的函数只是选定了端口
GPIO_ReadInputDataBit()/ GPIO_ReadInputData() 获得在输入模式下配置的引脚电平。
GPIO_ReadOnputDataBit()/ GPIO_ReadOnputData() 获得在输出模式下配置的引脚电平。
GPIO_SetBits()/ GPIO_ResetBits() 设置/复位在输出模式下使用的引脚电平。
GPIO_Write()/ GPIO_WriteBit() 将数据写入指定的GPIO数据端口。
GPIO_ToggleBits() 切换指定的GPIO引脚使用的引脚电平,即是1变0,0变1。
复用函数:
GPIO_PinAFConfig() 为单个引脚提供复用的函数。
三、h文件中的基地址定义等
头文件中总共包含声明:对于C语言库的支持,初始化结构体的各项配置,相应开发板上的引脚基地址,上一节中的14个函数。
下面根据头文件的声明,枚举一下各种模式的初始化配置:
GPIO_Mode_IN/OUT/AF/AN; 分别为输入/输出/复用/模拟模式的配置。模拟主要面向ADC/DAC
GPIO_OType_PP/OD; 分别为推挽/开漏的配置,区别:引脚输出高电平/不输出电压。
GPIO_Low_Speed/Medium/Fast/High; 速度分别为2/25/50/100MHz,也可以自定义IO速度。
GPIO_PuPd_NOPULL/UP/DOWN; 不上拉不下拉,上拉,下拉。
typedef struct
{
uint32_t GPIO_Pin;
GPIOMode_TypeDef GPIO_Mode;
GPIOSpeed_TypeDef GPIO_Speed;
GPIOOType_TypeDef GPIO_OType;
GPIOPuPd_TypeDef GPIO_PuPd;
}GPIO_InitTypeDef;
从上面的结构体可以看出我们需要这样来初始化GPIO,1.引脚,根据GPIO_pins_define的宏还找引脚;2.工作模式;3.引脚速度;4.引脚的输出类型;5.上拉下拉设置。
四、使用例子
最后实现的功能是,在按键之后一直每行打印1。
void InitKey(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); //使能A引脚
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN; //输入模式
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; //推挽模式
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL; //不上拉不下拉
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; //IO速度
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; //按键为PA0所扯出
GPIO_Init(GPIOA, &GPIO_InitStructure);
}
//按键函数
uint8_t GetKey(GPIO_TypeDef* GPIOx,uint16_t GPIO_Pin){
if(1 == GPIO_ReadInputDataBit(GPIOx,GPIO_Pin)){
if(1 == GPIO_ReadInputDataBit(GPIOx,GPIO_Pin));
return 1;
}else return 0;
}
int main(void){
int a;
InitKey();
while(1){
if (1 == GetKey(GPIOA,GPIO_Pin_0)){
a=1;
}
printf("%d\r\n",a);
}
}