STM32 GPIO详细篇（基于HAL库）

一、基础认识

GPIO全名为General Purpose Input Output，即通用输入输出。有时候简称为“IO口”。通用，说明它是常见的。输入输出，就是说既能当输入口使用，又能当输出口使用。端口，就是元器件上的一个引脚。

输入模式和输出模式是GPIO的基本特性，当然GPIO还有其它模式可选。

(一) IO耐压问题

STM32是一款3.3V电压的芯片，IO输出是3.3V,但IO大部分都是可以容忍5V电压输入。一般在芯片手册的“引脚定义”章节可以查看到有FT标识表示该IO可以容忍5V电压输入。

二、在标准库中GPIO的模式

（一）模式汇总

输入模式：

l  浮空输入（GPIO_Mode_IN_FLOATING）：引脚电平是真实的外部连接器件电压，电平有不确定性

l  上拉输入 (GPIO_Mode_IPU)：默认通过电阻上拉到VCC,不接外部器件时可以读出高电平

l  下拉输入 (GPIO_Mode_IPD)：默认通过电阻下拉到GND,不接外部器件时可以读出低电平

l  模拟输入 (GPIO_Mode_AIN)：将外部信号直接传输到数模转换通道上

输出模式：

l  开漏输出(GPIO_Mode_Out_OD)：只能输出低电平，高电平由电阻上拉决定

l  开漏复用功能(GPIO_Mode_AF_OD)：用于外设功能使用

l  推挽式输出(GPIO_Mode_Out_PP)：可以输出强高和强低，通常使用该功能控制LED

l  推挽式复用功能(GPIO_Mode_AF_PP):用于外设功能使用

GPIO的基本结构：

TTL肖特基触发器其实可以理解为用肖特基管构成的施密特触发器，作用简单说就是将相对缓慢变化的模拟信号变成矩形（方波）信号，便于后面读取。这里有一个阈值电压的概念，比如从低到高达到多少才会导通，从高到底多少才会关闭。

(二)   浮空输入（GPIO_Mode_IN_FLOATING）

浮空就是逻辑器件与引脚即不接高电平，也不接低电平。由于逻辑器件的内部结构和外部引脚所接的器件决定电平状态。一般实际运用时，引脚不建议悬空，易受干扰。通俗讲就是浮空就是浮在空中，就相当于此端口在默认情况下什么都不接，呈高阻态，这种设置在数据传输时用的比较多。浮空最大的特点就是电压的不确定性，它可能是0V，页可能是VCC，还可能是介于两者之间的某个值（最有可能） 浮空一般用来做ADC输入用，这样可以减少上下拉电阻对结果的影响。

(三)  上拉输入 (GPIO_Mode_IPU)

上拉就是把点位拉高，比如拉到Vcc。上拉就是将不确定的信号通过一个电阻嵌位在高电平。电阻同时起到限流的作用。弱强只是上拉电阻的阻值不同，没有什么严格区分。

电阻通常为30-50KΩ

(四) 下拉输入 (GPIO_Mode_IPD)

下拉就是把点位拉低，比如拉到GND。下拉就是将不确定的信号通过一个电阻嵌位在低电平。电阻同时起到限流的作用。弱强只是下拉电阻的阻值不同，没有什么严格区分

(五) 模拟输入 (GPIO_Mode_AIN)

模拟输入是指传统方式的输入，数字输入是输入PCM数字信号，即0,1的二进制数字信号，通过数模转换，转换成模拟信号，经前级放大进入功率放大器，功率放大器还是模拟的

(六)  开漏输出(GPIO_Mode_Out_OD)

IO输出0接GND，IO输出1，悬空，需要外接上拉电阻，才能实现输出高电平。当输出为1时，IO口的状态由上拉电阻拉高电平，但由于是开漏输出模式，这样IO口也就可以由外部电路改变为低电平或不变。可以读IO输入电平变化，实现C51的IO双向功能。

只能输出强低电平。

(七) 开漏复用功能(GPIO_Mode_AF_OD)

用于外设使用

（八）推挽式输出(GPIO_Mode_Out_PP)

IO输出0-接GND， IO输出1 -接VCC。这是使用最多的了。控制LED基本都是使用这种模式。

可以输出强高低电平，连接外部数字器件

（九）推挽式复用功能(GPIO_Mode_AF_PP)

用于外设使用

三、配置输入输出IO

（一）输入

(1).   GPIO Pull-up/Pull-down：

IO上下拉配置

l  No pull-up and no pull-down，浮空输入，配置为不上拉和下拉

l  Pull-up，上拉输入

l  Pull-down，下拉输入

（二）输出

(1).   GPIO output level

l  Low：IO初始化默认输出低电平

l  High：IO初始化默认输出高电平

(2).   GPIO mode

l  Output Open Drain，开漏输出，可以输出低电平

l  Output Push Pull，推挽输出，可以输出低电平和高电平 

(3).   GPIO Pull-up/Pull-down：

IO上下拉配置

l  No pull-up and no pull-down，浮空输入，配置为不上拉和下拉

l  Pull-up，上拉输入

l  Pull-down，下拉输入

(4).   Maximum output speed

l  Low，GPIO速度为低速，通常为2MHZ

l  Medium，GPIO速度为中速，通常为10MHZ

l  High，GPIO速度为高速，通常为50MHZ

四、 输出编程

测试有GPIOA1和GPIOA2设置为输出测试

（一）CubeMx设置

 

（二） 初始化函数

宏定义

#define DONG_OUT_1_Pin GPIO_PIN_1
#define DONG_OUT_1_GPIO_Port GPIOA
#define DONG_OUT_2_Pin GPIO_PIN_2
#define DONG_OUT_2_GPIO_Port GPIOA

初始化函数是自动生成的

void MX_GPIO_Init(void)
{

  GPIO_InitTypeDef GPIO_InitStruct = {0};

  /* GPIO Ports Clock Enable */
  __HAL_RCC_GPIOC_CLK_ENABLE();
  __HAL_RCC_GPIOD_CLK_ENABLE();
  __HAL_RCC_GPIOA_CLK_ENABLE();//使能GPIOA时钟

  /*Configure GPIO pin Output Level */
  HAL_GPIO_WritePin(GPIOA, DONG_OUT_1_Pin|DONG_OUT_2_Pin, GPIO_PIN_RESET);//设置上电电平为低

  /*Configure GPIO pins : PAPin PAPin */
  GPIO_InitStruct.Pin = DONG_OUT_1_Pin|DONG_OUT_2_Pin;//两个GPIO_PIN
  GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;//推挽输出模式
  GPIO_InitStruct.Pull = GPIO_NOPULL;//浮空，不上拉也不下拉
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;//低速
  HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

}

（三）输出相关函数

设置或清除选定的数据端口位

void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)

参数：

GPIOx :其中x可以(A..G取决于所使用的设备)来选择GPIO外设

GPIO_Pin :指定要写入的端口位。此参数可以是GPIO_PIN_x之一，其中x可以是( 0..15 )。

PinState :指定要写入选定位的值。此参数可以是GPIO_PinState枚举值之一:

l  GPIO_PIN_RESET:清除端口Pin,低电平

l  GPIO_PIN_SET:设置端口Pin，高电平

例子：

HAL_GPIO_WritePin(GPIOA, DONG_OUT_1_Pin|DONG_OUT_2_Pin, GPIO_PIN_RESET);//两个设置为低电平
HAL_Delay(1000);//1s
HAL_GPIO_WritePin(GPIOA, DONG_OUT_1_Pin, GPIO_PIN_SET);//单独设置为高电平
HAL_GPIO_WritePin(GPIOA,DONG_OUT_2_Pin, GPIO_PIN_SET);//单独设置为高电平
HAL_Delay(1000);//1s

切换指定的GPIO pin

void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)

参数：

GPIOx :其中x可以(A..G取决于所使用的设备)来选择GPIO外设

GPIO_Pin :指定要写入的端口位。此参数可以是GPIO_PIN_x之一，其中x可以是(0..15 )。

例子：

HAL_GPIO_TogglePin(GPIOA, DONG_OUT_1_Pin|DONG_OUT_2_Pin);//两个输出电平取反
HAL_Delay(1000);//1s
HAL_GPIO_TogglePin(GPIOA, DONG_OUT_1_Pin);//单独输出电平取反
HAL_GPIO_TogglePin(GPIOA,DONG_OUT_2_Pin);//单独输出电平取反
HAL_Delay(1000);//1s

五、输入编程（轮询检测）

（一）CubeMX设置

 （二）初始化函数

宏定义

#define DONG_IN_1_Pin GPIO_PIN_3
#define DONG_IN_1_GPIO_Port GPIOA

初始化部分

GPIO_InitTypeDef GPIO_InitStruct = {0};//初始化结构体
__HAL_RCC_GPIOA_CLK_ENABLE();//GPIO时钟开启
GPIO_InitStruct.Pin = DONG_IN_1_Pin;//引脚
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;//输入模式
GPIO_InitStruct.Pull = GPIO_PULLUP;//上拉
HAL_GPIO_Init(DONG_IN_1_GPIO_Port, &GPIO_InitStruct);

（三）输入相关函数

读取指定的输入端口引脚

GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)

参数：

GPIOx :其中x可以(A..G取决于所使用的设备)来选择GPIO外设

GPIO_Pin :指定要写入的端口位。此参数可以是GPIO_PIN_x之一，其中x可以是(0..15 )

返回：

typedef enum
{
  GPIO_PIN_RESET = 0u,//低电平
  GPIO_PIN_SET//高电平
} GPIO_PinState;

例子：

GPIO_PinState res=HAL_GPIO_ReadPin(DONG_IN_1_GPIO_Port,DONG_IN_1_Pin);//读取电平
if(res==GPIO_PIN_RESET){
     HAL_GPIO_WritePin(GPIOA, DONG_OUT_1_Pin|DONG_OUT_2_Pin, GPIO_PIN_SET);//两个设置为高电平
}else{
     HAL_GPIO_WritePin(GPIOA, DONG_OUT_1_Pin|DONG_OUT_2_Pin, GPIO_PIN_RESET);//两个设置为低电平
}

六、输入编程（中断检测）

（一）CubeMX设置

 

GPIO mode:

l  上升沿触发检测的外部中断模式（External Interrupt Mode with Rising edge trigger detection）

l  下降沿触发检测的外部中断模式（External Interrupt Mode with Falling edge trigger detectiort）

l  上升/下降沿触发检测的外部中断模式（External Interrupt Mode with Risinq/Falling edge trigger detection）

l  上升沿触发检测的外部事件模式（External Event Mode with Rising edge trigger detection）

l  下降沿触发检测的外部事件模式（External Event Mode with Falling edge trigger detection）

l  上升/下降沿触发检测的外部事件模式（External Event Mode with Rising/Falling edge trigger detectiont）

中断和事件的区别：

l  中断是当IO达到中断条件后会向CPU产生中断请求

l  事件是事先设置好的任务，当单片机达到要求将通过硬件的方式处理事先设置好的任务，而不向CPU请求中断，比如DMA、AD转换等

（二）初始化函数

宏定义

#define KEY1_Pin GPIO_PIN_3
#define KEY1_GPIO_Port GPIOA
#define KEY1_EXTI_IRQn EXTI3_IRQn

初始化部分

__HAL_RCC_GPIOA_CLK_ENABLE();
GPIO_InitTypeDef GPIO_InitStruct = {0};
/*Configure GPIO pin : PtPin */
GPIO_InitStruct.Pin = KEY1_Pin;
GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING;
GPIO_InitStruct.Pull = GPIO_PULLUP;
HAL_GPIO_Init(KEY1_GPIO_Port, &GPIO_InitStruct);
/* EXTI interrupt init*/
HAL_NVIC_SetPriority(EXTI3_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(EXTI3_IRQn);

（三）中断输入相关函数

中断回调函数

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);

参数：

GPIO_Pin :指定连接EXTI线的引脚

例子：

//GPIO中断回调函数
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin){
//判断进入中断的GPIOs
if(KEY1_Pin==GPIO_Pin){
            HAL_GPIO_TogglePin(GPIOA, DONG_OUT_1_Pin);//单独输出电平取反
            HAL_GPIO_TogglePin(GPIOA,DONG_OUT_2_Pin);//单独输出电平取反
     }
}

其它

关于按键防抖的问题：

l  软件防抖可以检测到电平延时一段时间再确认电平，延时时间一般为10-20ms

l  硬件防抖可以在按键上并联一个电容，一般为0.1uf

---

 参考：

https://blog.csdn.net/baidu_37366055/article/details/80060962