STM32 GPIO配置及使用超详细教程（附代码示例）

摘要：本文以STM32为例，深入讲解GPIO的配置方法及使用技巧，提供HAL库和标准库两种实现代码，并附带LED和按键的实战例程。适合STM32初学者快速掌握GPIO操作。

一、GPIO基础概念

1.1 什么是GPIO？

GPIO（General Purpose Input Output）即通用输入输出端口，是MCU与外部设备进行数字信号交互的核心接口。STM32的每个GPIO引脚可通过编程配置为多种工作模式。

1.2 GPIO主要功能

二、GPIO配置详解

2.1 配置步骤（基于HAL库）

2.1.1 使能时钟

__HAL_RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA时钟

重点提示：STM32外设使用前必须使能时钟！这是新手最常忽略的问题！

2.1.2 初始化结构体配置

GPIO_InitTypeDef GPIO_InitStruct = {0};

// 以PA5配置为推挽输出为例：
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

2.2 工作模式详解

三、实战例程

3.1 LED闪烁实验（PA5）

// 初始化函数
void LED_Init(void)
{
  __HAL_RCC_GPIOA_CLK_ENABLE();
  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_HIGH;
  HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

// 主循环
while(1)
{
  HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // 电平翻转
  HAL_Delay(500); // 500ms延时
}

3.2 按键检测实验（PC13）

// 按键初始化
void KEY_Init(void)
{
  __HAL_RCC_GPIOC_CLK_ENABLE();
  GPIO_InitTypeDef GPIO_InitStruct = {0};
  GPIO_InitStruct.Pin = GPIO_PIN_13;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;    // 输入模式
  GPIO_InitStruct.Pull = GPIO_PULLUP;        // 上拉电阻
  HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
}

// 检测按键按下
if(HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET)
{
  while(HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET); // 等待释放
  // 执行按键操作
}

四、常见问题FAQ

Q1：为什么我的IO口无法输出正确电平？
A1：检查以下三点：

1. 是否使能了对应GPIO端口的时钟

2. 输出模式是否配置正确（推挽/开漏）

3. 引脚是否被其他外设复用

Q2：按键检测出现抖动怎么解决？
A2：建议添加软件消抖：

if(KEY_Pressed()) 
{
  HAL_Delay(20); // 延时20ms跳过抖动
  if(KEY_Pressed()) 
  {
    // 确认按键按下
  }
}

五、进阶技巧

#define LED_PIN    BITBAND_GPIO(GPIOA, 5)
LED_PIN = 1; // 直接操作位带地址

总结：掌握GPIO配置是STM32开发的基石。建议结合开发板实际测试文中的代码示例，通过示波器观察引脚波形加深理解。后续可继续学习中断配置、外设复用等高级功能。

创作不易，如果本文对你有帮助，请点赞收藏支持！关于GPIO的其他问题欢迎在评论区留言讨论~

作者：DOMINICHZL