STM32 GPIO HAL库常用函数

GPIO是通用输入输出端口（General-purpose input/output）的英文简写，是所有的微控制器必不可少的外设之一，可以由STM32直接驱动从而实现与外部设备通信、控制以及采集和捕获的功能。引脚电平：0V~3.3V，部分引脚可容忍5V。

|--------|------|------------------------------------------------------------------------|
| 浮空输入 | 数字输入 | IO的电平状态是不确定的，完全由外部输入决定 |
| 上拉输入 | 数字输入 | IO口在无输入的情况下，保持高电平 |
| 下拉输入 | 数字输入 | IO口在无输入的情况下，保持低电平 |
| 模拟输入 | 模拟输入 | 输入信号不经施密特触发器直接接入，输入信号为模拟量，其余输入方式输入数字量 |
| 开漏输出 | 数字输出 | 只能输出低电平 |
| 推挽输出 | 数字输出 | 可以输出高、低电平 |
| 复用开漏输出 | 数字输出 | 输出低电平 |
| 复用推挽输出 | 数字输出 | 此时 IO 受内部外设控制，比如定时器的 PWM，比如 SPI 的 MOSI ，MISO 等。而普通的推挽输出，则 IO 受 ODR 控制 |

GPIO常用HAL库函数

HAL_GPIO_Init

初始化GPIO引脚，配置模式、上下拉、速度等参数。

c 复制代码

void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);

内部通过结构体来配置

Pin : 指定需要初始化的 GPIO 引脚，可以是单个引脚或组合（如 GPIO_PIN_0 | GPIO_PIN_1）。
Mode : 设置引脚模式，包括输入、输出、复用功能或模拟模式（如 GPIO_MODE_OUTPUT_PP 推挽输出）。
Pull : 配置上拉/下拉电阻，可选无上拉下拉（GPIO_NOPULL）、上拉（GPIO_PULLUP）或下拉（GPIO_PULLDOWN）。
Speed : 定义引脚输出速度，如低速（GPIO_SPEED_FREQ_LOW）、中速或高速。
Alternate: 当引脚用于复用功能时，指定具体的复用功能编号（如 USART、SPI 等）。

c 复制代码

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_5;                // 选择引脚5
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;       // 推挽输出模式
GPIO_InitStruct.Pull = GPIO_NOPULL;               // 无上拉下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;     // 高速模式
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);           // 初始化GPIOA

HAL_GPIO_ReadPin

读取指定引脚的电平状态。

c 复制代码

GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

返回值为GPIO_PIN_SET（高电平）或GPIO_PIN_RESET（低电平）。

HAL_GPIO_WritePin

设置指定引脚输出高电平或低电平。

c 复制代码

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

PinState：GPIO_PIN_SET（高电平）或GPIO_PIN_RESET（低电平）。

HAL_GPIO_TogglePin

翻转指定引脚的电平状态（高变低或低变高）

c 复制代码

void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

HAL_GPIO_EXTI_Callback

外部中断回调函数，用户需重写此函数实现中断处理逻辑。

c 复制代码

__weak void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);

需在stm32xx_it.c中调用HAL_GPIO_EXTI_IRQHandler触发此回调。

HAL_GPIO_EXTI_IRQHandler

处理外部中断请求，清除中断标志并调用回调函数。

c 复制代码

void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);

配置示例

以下代码演示如何配置PA5为推挽输出并控制电平：

c 复制代码

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_5;
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);

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);  // 输出高电平
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);               // 翻转电平

注意事项

时钟使能 ：使用GPIO前需通过__HAL_RCC_GPIOx_CLK_ENABLE()开启端口时钟。
中断优先级：若使用外部中断，需配置NVIC优先级。
弱函数 ：HAL_GPIO_EXTI_Callback是弱定义函数，用户需在代码中重新实现。

串联示例使用

c 复制代码

#include "stm32f4xx_hal.h"

/* 函数声明 */
void SystemClock_Config(void);
static void MX_GPIO_Init(void);

int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();

  while (1)
  {
    // 使用WritePin点亮LED
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
    HAL_Delay(500);
    
    // 使用TogglePin切换LED状态
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
    HAL_Delay(500);
  }
}

/* 外部中断处理函数 */
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
{
  if(GPIO_Pin == GPIO_PIN_13)
  {
    HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_13);
  }
}

/* 外部中断回调函数 */
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
  if(GPIO_Pin == GPIO_PIN_13)
  {
    // 按键按下时切换LED
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
  }
}

/* GPIO初始化函数 */
static void MX_GPIO_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  __HAL_RCC_GPIOA_CLK_ENABLE();
  __HAL_RCC_GPIOC_CLK_ENABLE();

  /* LED引脚配置 */
  GPIO_InitStruct.Pin = GPIO_PIN_5;
  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);

  /* 按键引脚配置 */
  GPIO_InitStruct.Pin = GPIO_PIN_13;
  GPIO_InitStruct.Mode = GPIO_MODE_IT_RISING;  // 上升沿触发中断
  GPIO_InitStruct.Pull = GPIO_PULLDOWN;
  HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

  /* 中断优先级配置 */
  HAL_NVIC_SetPriority(EXTI15_10_IRQn, 0, 0);
  HAL_NVIC_EnableIRQ(EXTI15_10_IRQn);
}

复制代码

STM32 GPIO HAL库常用函数

GPIO常用HAL库函数

HAL_GPIO_Init

HAL_GPIO_WritePin

​​​HAL_GPIO_TogglePin

​​HAL_GPIO_EXTI_Callback

HAL_GPIO_EXTI_IRQHandler

配置示例

串联示例使用

HAL_GPIO_TogglePin

HAL_GPIO_EXTI_Callback