（STM32）GPIO库函数使用一览

一、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("%drn",a);

  }

}