嵌入式开发之 GPIO 详细解析（STM32 平台）

适用平台 : STM32F1 / STM32F4 / STM32H7 系列

开发环境 : STM32CubeIDE / Keil MDK / VS Code + PlatformIO
HAL 库版本: STM32Cube HAL / LL 库

1. GPIO 基础概念

1.1 什么是 GPIO？

GPIO（General Purpose Input/Output） ，即通用输入/输出端口，是微控制器与外部世界交互的最基本接口。通过 GPIO，MCU 可以：

输出信号：控制 LED、继电器、蜂鸣器等外设
输入信号：读取按键、传感器、开关等状态
复用功能：作为 UART、SPI、I2C、PWM 等外设的物理引脚

1.2 STM32 GPIO 命名规则

STM32 的 GPIO 按端口分组，每组最多 16 个引脚：

端口	引脚编号	示例
GPIOA	PA0 ~ PA15	PA5, PA9
GPIOB	PB0 ~ PB15	PB0, PB13
GPIOC	PC0 ~ PC15	PC13
GPIOD	PD0 ~ PD15	PD2
GPIOE	PE0 ~ PE15	PE5
GPIOF	PF0 ~ PF15	PF9
GPIOG	PG0 ~ PG15	PG14
GPIOH	PH0 ~ PH15	PH0
GPIOI	PI0 ~ PI15	PI1

注意：不同型号的 STM32 芯片，可用的 GPIO 端口和引脚数量不同。

2. GPIO 硬件结构

2.1 GPIO 内部结构框图

复制代码

                    ┌─────────────────────────────────────┐
                    │           GPIO 内部结构              │
                    └─────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
   ┌────▼────┐          ┌────▼────┐          ┌────▼────┐
   │  输入驱动  │          │  输出驱动  │          │  复用功能  │
   │ (Input)  │          │ (Output) │          │ (AF)     │
   └────┬────┘          └────┬────┘          └────┬────┘
        │                     │                     │
   ┌────▼────┐          ┌────▼────┐          ┌────▼────┐
   │  上拉/下拉 │          │  推挽/开漏 │          │  外设连接  │
   │  电阻    │          │  驱动    │          │ (UART等) │
   └────┬────┘          └────┬────┘          └────┬────┘
        │                     │                     │
        └─────────────────────┼─────────────────────┘
                              │
                        ┌─────▼─────┐
                        │  I/O 引脚  │
                        │  (PAD)   │
                        └───────────┘

2.2 关键组成部分

2.2.1 输入驱动器（Input Driver）

施密特触发器：将模拟信号转换为数字信号，具有迟滞特性，抗干扰能力强
输入数据寄存器（IDR）：存储引脚当前电平状态
模拟输入通道：直接连接到 ADC，不经过施密特触发器

2.2.2 输出驱动器（Output Driver）

输出数据寄存器（ODR）：控制输出电平
置位/复位寄存器（BSRR）：原子操作，避免读写竞争
推挽/开漏选择：决定输出驱动方式
输出速度控制：决定引脚翻转速度

2.2.3 复用功能选择器（Alternate Function）

AF 选择寄存器（AFR）：选择引脚复用的外设功能
每个引脚可映射到多个外设功能

3. GPIO 工作模式详解

3.1 输入模式（Input Mode）

3.1.1 浮空输入（Input Floating）

复制代码

        VDD
         │
         ▼
    ┌─────────┐
    │  上拉电阻  │───断开
    └────┬────┘
         │
    ┌────▼────┐
    │ 施密特触发器 │───► IDR
    └────┬────┘
         │
    ┌────▼────┐
    │  下拉电阻  │───断开
    └────┬────┘
         │
        GND

    I/O 引脚 ───────────► 外部信号

特点：引脚电平完全由外部电路决定
适用场景：外部已有明确上拉/下拉，或推挽输出驱动
风险：悬空时电平不确定，可能受干扰

3.1.2 上拉输入（Input Pull-up）

特点：内部上拉电阻（约 30~50kΩ）连接到 VDD
默认状态：无外部信号时，引脚为高电平
适用场景：按键一端接地，另一端接 GPIO

3.1.3 下拉输入（Input Pull-down）

特点：内部下拉电阻（约 30~50kΩ）连接到 GND
默认状态：无外部信号时，引脚为低电平
适用场景：按键一端接 VDD，另一端接 GPIO

3.1.4 模拟输入（Analog Mode）

特点：直接连接到 ADC 输入通道，不经过数字电路
适用场景：ADC 采样、DAC 输出、比较器输入
注意：模拟模式下，施密特触发器关闭，降低功耗

3.2 输出模式（Output Mode）

3.2.1 推挽输出（Output Push-Pull）

复制代码

         VDD
          │
    ┌─────▼─────┐
    │   PMOS    │───┐
    │  (上管)   │   │
    └─────┬─────┘   │
          │         │
    ──────┼─────────┼──────► I/O 引脚
          │         │
    ┌─────▼─────┐   │
    │   NMOS    │───┘
    │  (下管)   │
    └─────┬─────┘
          │
         GND

特点：
- 输出高电平时，PMOS 导通，NMOS 截止，引脚连接到 VDD
- 输出低电平时，NMOS 导通，PMOS 截止，引脚连接到 GND
- 驱动能力强，电平切换速度快
适用场景：驱动 LED、控制继电器、数字通信等
优点：输出电平明确，驱动电流大（最大 25mA，但建议不超过 8mA）

3.2.2 开漏输出（Output Open-Drain）

复制代码

         VDD
          │
    ┌─────▼─────┐
    │   PMOS    │───断开（或不存在）
    │  (上管)   │
    └─────┬─────┘
          │
    ──────┼──────────────► I/O 引脚
          │         │
    ┌─────▼─────┐   │
    │   NMOS    │───┘
    │  (下管)   │
    └─────┬─────┘
          │
         GND

特点：
- 只能输出低电平或高阻态
- 输出高电平时，需要外部上拉电阻
- 多个开漏输出可以"线与"连接
适用场景：I2C 总线、电平转换、外部上拉的应用
优点：
- 支持"线与"逻辑（多个设备共享总线）
- 可以实现电平转换（外部上拉到不同电压）

3.3 复用功能模式（Alternate Function）

AF 推挽输出：外设（如 UART_TX）使用推挽方式输出
AF 开漏输出：外设（如 I2C_SDA）使用开漏方式输出
特点：引脚由外设控制，而非 GPIO 寄存器

3.4 模式总结表

模式	类型	方向	上拉/下拉	典型应用
浮空输入	数字输入	输入	无	外部已上拉的信号
上拉输入	数字输入	输入	上拉	按键（一端接地）
下拉输入	数字输入	输入	下拉	按键（一端接 VDD）
模拟输入	模拟输入	输入	无	ADC 采样
推挽输出	数字输出	输出	无	LED 驱动
开漏输出	数字输出	输出	可选	I2C 总线
复用推挽	数字输出	输出	无	UART_TX、SPI_MOSI
复用开漏	数字输出	输出	可选	I2C_SDA、I2C_SCL

4. GPIO 配置详解

4.1 输出速度配置

STM32 的 GPIO 输出速度决定了引脚的翻转速度和驱动能力：

速度等级	STM32F1	STM32F4/H7	典型应用
Low	2 MHz	2 MHz	低速控制、LED
Medium	10 MHz	25 MHz	普通数字信号
High	50 MHz	50 MHz	SPI、高速通信
Very High	-	100 MHz	SDIO、高速 SPI

注意：速度越高，功耗越大，EMI 干扰越强。在满足时序要求的前提下，尽量选择低速。

4.2 HAL 库 GPIO 配置结构体

复制代码

// STM32 HAL 库 GPIO 初始化结构体
typedef struct {
    uint32_t Pin;        // 引脚号：GPIO_PIN_0 ~ GPIO_PIN_15
    uint32_t Mode;       // 工作模式
    uint32_t Pull;       // 上拉/下拉配置
    uint32_t Speed;      // 输出速度
    uint32_t Alternate;  // 复用功能（AF0 ~ AF15）
} GPIO_InitTypeDef;

4.3 各参数详细说明

4.3.1 Pin（引脚选择）

复制代码

// 可以一次选择多个引脚（按位或）
GPIO_PIN_0    // PA0 / PB0 / ...
GPIO_PIN_1    // PA1 / PB1 / ...
GPIO_PIN_5    // PA5 / PB5 / ...
GPIO_PIN_ALL  // 端口所有引脚

// 示例：同时初始化 PA5 和 PA6
GPIO_InitStruct.Pin = GPIO_PIN_5 | GPIO_PIN_6;

4.3.2 Mode（工作模式）

复制代码

// STM32 HAL 库模式定义
GPIO_MODE_INPUT              // 浮空输入
GPIO_MODE_OUTPUT_PP          // 推挽输出
GPIO_MODE_OUTPUT_OD          // 开漏输出
GPIO_MODE_AF_PP              // 复用推挽输出
GPIO_MODE_AF_OD              // 复用开漏输出
GPIO_MODE_ANALOG             // 模拟输入
GPIO_MODE_IT_RISING          // 外部中断：上升沿触发
GPIO_MODE_IT_FALLING         // 外部中断：下降沿触发
GPIO_MODE_IT_RISING_FALLING  // 外部中断：双边沿触发
GPIO_MODE_EVT_RISING         // 外部事件：上升沿触发
GPIO_MODE_EVT_FALLING        // 外部事件：下降沿触发
GPIO_MODE_EVT_RISING_FALLING // 外部事件：双边沿触发

4.3.3 Pull（上拉/下拉）

复制代码

GPIO_NOPULL    // 无上拉/下拉
GPIO_PULLUP    // 内部上拉
GPIO_PULLDOWN  // 内部下拉

4.3.4 Speed（输出速度）

复制代码

// STM32F1 系列
GPIO_SPEED_FREQ_LOW      // 2 MHz
GPIO_SPEED_FREQ_MEDIUM   // 10 MHz
GPIO_SPEED_FREQ_HIGH     // 50 MHz

// STM32F4/H7 系列
GPIO_SPEED_FREQ_LOW      // 2 MHz
GPIO_SPEED_FREQ_MEDIUM   // 25 MHz
GPIO_SPEED_FREQ_HIGH     // 50 MHz
GPIO_SPEED_FREQ_VERY_HIGH // 100 MHz

4.3.5 Alternate（复用功能）

复制代码

// 复用功能编号 AF0 ~ AF15
GPIO_AF0_MCO       // 时钟输出
GPIO_AF1_TIM1      // TIM1
GPIO_AF2_TIM3      // TIM3
GPIO_AF3_TIM8      // TIM8
GPIO_AF4_I2C1      // I2C1
GPIO_AF5_SPI1      // SPI1
GPIO_AF6_SPI3      // SPI3
GPIO_AF7_USART1    // USART1
GPIO_AF8_USART6    // USART6
GPIO_AF9_CAN1      // CAN1
GPIO_AF10_OTG_FS   // USB OTG FS
GPIO_AF11_ETH      // 以太网
GPIO_AF12_FSMC     // FSMC
GPIO_AF13_DCMI     // DCMI
GPIO_AF14_LTDC     // LTDC
GPIO_AF15_EVENTOUT // 事件输出

4.4 完整配置流程

复制代码

// ============================================
// GPIO 初始化完整流程（以 PA5 推挽输出为例）
// ============================================

#include "stm32f4xx_hal.h"

void GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // Step 1: 使能 GPIO 时钟（必须先使能时钟！）
    __HAL_RCC_GPIOA_CLK_ENABLE();

    // Step 2: 配置 GPIO 参数
    GPIO_InitStruct.Pin = GPIO_PIN_5;           // 选择 PA5
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
    GPIO_InitStruct.Pull = GPIO_NOPULL;         // 无上拉/下拉
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; // 低速（2MHz）

    // Step 3: 调用初始化函数
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

5. GPIO 常用 API 函数

5.1 HAL 库 GPIO API

5.1.1 初始化函数

复制代码

// GPIO 初始化
void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);

// GPIO 反初始化（恢复默认状态）
void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin);

5.1.2 读写函数

复制代码

// 设置引脚输出电平（高/低）
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

// 翻转引脚电平
void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

// 读取引脚输入电平
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

// 锁定引脚配置（防止后续修改）
HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

5.1.3 外部中断函数

复制代码

// 外部中断回调函数（需要用户实现）
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);

// 外部中断服务函数（HAL 库已定义，通常不需要修改）
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);

5.2 LL 库 GPIO API（低层库）

LL 库提供更直接的寄存器操作，效率更高：

复制代码

#include "stm32f4xx_ll_gpio.h"

// 设置引脚输出高电平
LL_GPIO_SetOutputPin(GPIOA, LL_GPIO_PIN_5);

// 设置引脚输出低电平
LL_GPIO_ResetOutputPin(GPIOA, LL_GPIO_PIN_5);

// 翻转引脚电平
LL_GPIO_TogglePin(GPIOA, LL_GPIO_PIN_5);

// 读取引脚输入状态
uint32_t state = LL_GPIO_IsInputPinSet(GPIOA, LL_GPIO_PIN_5);

// 读取引脚输出状态
uint32_t out_state = LL_GPIO_IsOutputPinSet(GPIOA, LL_GPIO_PIN_5);

5.3 寄存器直接操作

复制代码

// 直接操作寄存器（最高效，但可移植性差）

// 设置 PA5 输出高电平
GPIOA->BSRR = GPIO_BSRR_BS5;  // 置位寄存器

// 设置 PA5 输出低电平
GPIOA->BSRR = GPIO_BSRR_BR5;  // 复位寄存器

// 或者使用 ODR 寄存器
GPIOA->ODR |= GPIO_ODR_OD5;   // 置位
GPIOA->ODR &= ~GPIO_ODR_OD5;  // 复位

// 读取 PA5 输入状态
uint8_t state = (GPIOA->IDR & GPIO_IDR_ID5) ? 1 : 0;

BSRR 寄存器的优势：置位和复位是原子操作，不会出现读写竞争问题。

6. 实战示例

6.1 示例一：LED 闪烁（推挽输出）

硬件连接：

LED 正极 → PA5（通过 330Ω 限流电阻）

LED 负极 → GND

#include "stm32f4xx_hal.h"

// LED 引脚定义
#define LED_GPIO_PORT GPIOA
#define LED_GPIO_PIN GPIO_PIN_5

void LED_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};

复制代码

  // 使能 GPIOA 时钟
  __HAL_RCC_GPIOA_CLK_ENABLE();

  // 配置 PA5 为推挽输出
  GPIO_InitStruct.Pin = LED_GPIO_PIN;
  GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
  GPIO_InitStruct.Pull = GPIO_NOPULL;
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;

  HAL_GPIO_Init(LED_GPIO_PORT, &GPIO_InitStruct);

  // 初始状态：LED 熄灭（输出低电平）
  HAL_GPIO_WritePin(LED_GPIO_PORT, LED_GPIO_PIN, GPIO_PIN_RESET);

}

void LED_On(void)
{
HAL_GPIO_WritePin(LED_GPIO_PORT, LED_GPIO_PIN, GPIO_PIN_SET);
}

void LED_Off(void)
{
HAL_GPIO_WritePin(LED_GPIO_PORT, LED_GPIO_PIN, GPIO_PIN_RESET);
}

void LED_Toggle(void)
{
HAL_GPIO_TogglePin(LED_GPIO_PORT, LED_GPIO_PIN);
}

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

复制代码

  while (1)
  {
      LED_Toggle();           // LED 状态翻转
      HAL_Delay(500);         // 延时 500ms
  }

}

6.2 示例二：按键检测（上拉输入 + 外部中断）

硬件连接：

按键一端 → PA0
按键另一端 → GND

6.2.1 轮询方式检测

复制代码

#include "stm32f4xx_hal.h"

#define KEY_GPIO_PORT   GPIOA
#define KEY_GPIO_PIN    GPIO_PIN_0

void KEY_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();

    // 配置 PA0 为上拉输入
    GPIO_InitStruct.Pin = KEY_GPIO_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull = GPIO_PULLUP;  // 按键按下时为低电平
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;

    HAL_GPIO_Init(KEY_GPIO_PORT, &GPIO_InitStruct);
}

// 按键消抖检测（轮询方式）
uint8_t KEY_Scan(void)
{
    // 检测按键是否按下（低电平有效）
    if (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_GPIO_PIN) == GPIO_PIN_RESET)
    {
        HAL_Delay(20);  // 消抖延时 20ms

        // 再次确认按键状态
        if (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_GPIO_PIN) == GPIO_PIN_RESET)
        {
            // 等待按键释放
            while (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_GPIO_PIN) == GPIO_PIN_RESET);
            HAL_Delay(20);  // 释放消抖
            return 1;  // 按键有效按下
        }
    }
    return 0;  // 按键未按下
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    KEY_Init();
    LED_Init();  // 假设 LED 已初始化

    while (1)
    {
        if (KEY_Scan())
        {
            LED_Toggle();  // 按键按下，切换 LED 状态
        }
    }
}

6.2.2 中断方式检测

复制代码

#include "stm32f4xx_hal.h"

#define KEY_GPIO_PORT   GPIOA
#define KEY_GPIO_PIN    GPIO_PIN_0

void KEY_EXTI_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 使能 GPIOA 和 SYSCFG 时钟
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_SYSCFG_CLK_ENABLE();

    // 配置 PA0 为外部中断输入
    GPIO_InitStruct.Pin = KEY_GPIO_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING;  // 下降沿触发（按键按下）
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;

    HAL_GPIO_Init(KEY_GPIO_PORT, &GPIO_InitStruct);

    // 配置 NVIC 中断优先级
    HAL_NVIC_SetPriority(EXTI0_IRQn, 2, 0);
    HAL_NVIC_EnableIRQ(EXTI0_IRQn);
}

// EXTI0 中断服务函数
void EXTI0_IRQHandler(void)
{
    HAL_GPIO_EXTI_IRQHandler(KEY_GPIO_PIN);
}

// 外部中断回调函数（用户实现）
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    if (GPIO_Pin == KEY_GPIO_PIN)
    {
        // 消抖处理（简单延时，实际项目建议用定时器）
        HAL_Delay(20);

        if (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_GPIO_PIN) == GPIO_PIN_RESET)
        {
            LED_Toggle();  // 切换 LED 状态
        }
    }
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    KEY_EXTI_Init();
    LED_Init();

    while (1)
    {
        // 主循环可以做其他事情
        // 按键处理在中断中完成
    }
}

6.3 示例三：多位 GPIO 同时操作

复制代码

// 同时控制 PA5、PA6、PA7 三个引脚

void Multi_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();

    // 同时初始化多个引脚
    GPIO_InitStruct.Pin = GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
    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 Set_Multi_Pin(uint8_t value)
{
    // 使用 BSRR 寄存器原子操作
    // value 的 bit0 控制 PA5，bit1 控制 PA6，bit2 控制 PA7

    uint32_t bsrr = 0;

    // 计算置位和复位值
    if (value & 0x01) bsrr |= GPIO_BSRR_BS5;  else bsrr |= GPIO_BSRR_BR5;
    if (value & 0x02) bsrr |= GPIO_BSRR_BS6;  else bsrr |= GPIO_BSRR_BR6;
    if (value & 0x04) bsrr |= GPIO_BSRR_BS7;  else bsrr |= GPIO_BSRR_BR7;

    GPIOA->BSRR = bsrr;
}

// 使用 HAL 库函数
void Set_Multi_Pin_HAL(uint8_t value)
{
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, (value & 0x01) ? GPIO_PIN_SET : GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_6, (value & 0x02) ? GPIO_PIN_SET : GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_7, (value & 0x04) ? GPIO_PIN_SET : GPIO_PIN_RESET);
}

6.4 示例四：GPIO 复用功能配置（UART）

复制代码

#include "stm32f4xx_hal.h"

// USART1 引脚：PA9(TX) / PA10(RX)

void USART1_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_USART1_CLK_ENABLE();

    // 配置 PA9 (USART1_TX) 为复用推挽输出
    GPIO_InitStruct.Pin = GPIO_PIN_9;
    GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF7_USART1;  // 选择 USART1 复用功能
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 配置 PA10 (USART1_RX) 为复用输入
    GPIO_InitStruct.Pin = GPIO_PIN_10;
    GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;  // RX 也可以用 AF_PP
    GPIO_InitStruct.Pull = GPIO_PULLUP;     // 建议上拉
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

// USART1 初始化
void USART1_Init(void)
{
    USART1_GPIO_Init();

    UART_HandleTypeDef huart1;
    huart1.Instance = USART1;
    huart1.Init.BaudRate = 115200;
    huart1.Init.WordLength = UART_WORDLENGTH_8B;
    huart1.Init.StopBits = UART_STOPBITS_1;
    huart1.Init.Parity = UART_PARITY_NONE;
    huart1.Init.Mode = UART_MODE_TX_RX;
    huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
    huart1.Init.OverSampling = UART_OVERSAMPLING_16;

    HAL_UART_Init(&huart1);
}

6.5 示例五：模拟输入配置（ADC）

复制代码

#include "stm32f4xx_hal.h"

// ADC1 通道 5 -> PA5

void ADC_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();

    // 配置 PA5 为模拟输入
    GPIO_InitStruct.Pin = GPIO_PIN_5;
    GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;  // 模拟模式
    GPIO_InitStruct.Pull = GPIO_NOPULL;       // 模拟输入不需要上拉/下拉

    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

void ADC1_Init(void)
{
    ADC_GPIO_Init();

    __HAL_RCC_ADC1_CLK_ENABLE();

    ADC_HandleTypeDef hadc1;
    hadc1.Instance = ADC1;
    hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4;
    hadc1.Init.Resolution = ADC_RESOLUTION_12B;
    hadc1.Init.ScanConvMode = DISABLE;
    hadc1.Init.ContinuousConvMode = DISABLE;
    hadc1.Init.DiscontinuousConvMode = DISABLE;
    hadc1.Init.ExternalTrigConvEdge = ADC_EXTERNALTRIGCONVEDGE_NONE;
    hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
    hadc1.Init.NbrOfConversion = 1;

    HAL_ADC_Init(&hadc1);

    // 配置通道
    ADC_ChannelConfTypeDef sConfig = {0};
    sConfig.Channel = ADC_CHANNEL_5;  // PA5 对应 ADC1 通道 5
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_3CYCLES;

    HAL_ADC_ConfigChannel(&hadc1, &sConfig);
}

// 读取 ADC 值
uint16_t ADC_Read(void)
{
    HAL_ADC_Start(&hadc1);
    HAL_ADC_PollForConversion(&hadc1, 100);
    uint16_t adc_value = HAL_ADC_GetValue(&hadc1);
    HAL_ADC_Stop(&hadc1);

    return adc_value;
}

6.6 示例六：位带操作（Bit-Banding）

STM32 支持位带操作，可以直接对单个位进行原子读写：

复制代码

// 位带地址计算（以 SRAM 和外设为例）
// 外设位带区:  0x4000_0000 ~ 0x400F_FFFF
// 外设位带别名区: 0x4200_0000 ~ 0x43FF_FFFF

// 位带别名地址计算公式
// addr = bit_band_base + (byte_offset × 32) + (bit_number × 4)

#define BITBAND_ADDR(addr, bitnum) (((addr) & 0xF0000000) + 0x02000000 + \
                                    (((addr) & 0x000FFFFF) << 5) + ((bitnum) << 2))

#define MEM_ADDR(addr) *((volatile unsigned long *)(addr))

// 使用位带操作控制 PA5
#define PA5_OUT  MEM_ADDR(BITBAND_ADDR((uint32_t)&GPIOA->ODR, 5))
#define PA5_IN   MEM_ADDR(BITBAND_ADDR((uint32_t)&GPIOA->IDR, 5))

void BitBand_Example(void)
{
    // 设置 PA5 输出高电平（原子操作）
    PA5_OUT = 1;

    // 设置 PA5 输出低电平（原子操作）
    PA5_OUT = 0;

    // 读取 PA5 输入状态
    uint8_t state = PA5_IN;
}

7. 常见问题与调试技巧

7.1 常见问题

问题 1：GPIO 没有反应

可能原因：

未使能时钟 ：忘记调用 __HAL_RCC_GPIOx_CLK_ENABLE()
引脚冲突：该引脚被其他外设占用
模式配置错误：输入/输出模式选择错误
硬件连接问题：虚焊、短路、限流电阻过大

排查方法：

复制代码

// 检查 GPIO 时钟是否使能
if (__HAL_RCC_GPIOA_IS_CLK_ENABLED())
{
    // 时钟已使能
}

// 检查 GPIO 模式配置
uint32_t mode = (GPIOA->MODER >> (5 * 2)) & 0x03;  // 读取 PA5 模式
// mode = 0: 输入, 1: 输出, 2: 复用, 3: 模拟

问题 2：GPIO 输出电平不正确

可能原因：

开漏输出未接上拉：开漏输出只能输出低电平，需要外部上拉
驱动能力不足：负载电流超过 GPIO 最大驱动能力（建议不超过 8mA）
速度配置不当：高速信号需要配置为高速模式

问题 3：按键抖动

解决方案：

复制代码

// 软件消抖
uint8_t KEY_Scan_With_Debounce(void)
{
    static uint32_t last_tick = 0;
    static uint8_t key_state = 0;

    if (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_GPIO_PIN) == GPIO_PIN_RESET)
    {
        if (HAL_GetTick() - last_tick > 20)  // 20ms 消抖
        {
            if (key_state == 0)
            {
                key_state = 1;
                last_tick = HAL_GetTick();
                return 1;
            }
        }
    }
    else
    {
        key_state = 0;
        last_tick = HAL_GetTick();
    }
    return 0;
}

问题 4：外部中断不触发

可能原因：

NVIC 未使能 ：忘记调用 HAL_NVIC_EnableIRQ()
优先级配置错误：中断优先级配置不当
SYSCFG 时钟未使能：外部中断需要 SYSCFG 时钟
引脚模式错误 ：需要使用 GPIO_MODE_IT_xxx 模式

7.2 调试技巧

技巧 1：使用示波器观察波形

检查 GPIO 输出波形是否符合预期
测量上升/下降时间，评估速度配置是否合理
观察是否存在毛刺或抖动

技巧 2：使用调试器查看寄存器

复制代码

// 在调试时查看关键寄存器值
volatile uint32_t moder = GPIOA->MODER;   // 模式寄存器
volatile uint32_t otyper = GPIOA->OTYPER; // 输出类型寄存器
volatile uint32_t ospeedr = GPIOA->OSPEEDR; // 速度寄存器
volatile uint32_t pupdr = GPIOA->PUPDR;   // 上拉/下拉寄存器
volatile uint32_t idr = GPIOA->IDR;       // 输入数据寄存器
volatile uint32_t odr = GPIOA->ODR;       // 输出数据寄存器
volatile uint32_t bsrr = GPIOA->BSRR;     // 置位/复位寄存器
volatile uint32_t afrl = GPIOA->AFR[0];   // 复用功能低寄存器
volatile uint32_t afrh = GPIOA->AFR[1];   // 复用功能高寄存器

技巧 3：使用逻辑分析仪

捕获 GPIO 时序，分析信号完整性
检查多引脚同步操作是否一致

技巧 4：代码审查清单

复制代码

□ GPIO 时钟是否已使能？
□ 引脚号是否正确？
□ 模式配置是否符合需求？
□ 上拉/下拉配置是否正确？
□ 输出速度是否满足时序要求？
□ 复用功能编号是否正确？
□ 是否有引脚冲突？
□ 中断优先级是否合理？
□ 消抖处理是否完善？

8. 总结

8.1 GPIO 配置要点

要点	说明
时钟使能	必须先使能对应 GPIO 端口的时钟
模式选择	根据应用场景选择输入/输出/复用/模拟
上拉/下拉	输入模式下必须配置，避免浮空
输出速度	在满足时序的前提下，选择最低速度以降低功耗和 EMI
驱动能力	注意 GPIO 最大驱动电流，必要时使用驱动芯片
原子操作	多任务环境下，使用 BSRR 进行原子置位/复位

8.2 最佳实践

使用宏定义管理引脚：提高代码可读性和可维护性
统一初始化函数：将 GPIO 初始化封装在独立函数中
避免浮空输入：输入模式必须配置上拉或下拉
合理使用中断：对于实时性要求高的场景，使用中断而非轮询
注意消抖处理：按键等机械开关必须做消抖处理
检查引脚冲突：使用 CubeMX 等工具检查引脚复用冲突

8.3 参考资源

官方文档：STM32F4xx 参考手册（RM0090）
HAL 库文档：STM32CubeF4 HAL 库用户手册
开发工具：STM32CubeMX（图形化配置 GPIO）
社区资源：ST 官方论坛、GitHub 开源项目

嵌入式开发之 GPIO 详细解析（STM32 平台）

适用平台 : STM32F1 / STM32F4 / STM32H7 系列

目录

1. GPIO 基础概念

1.1 什么是 GPIO？

1.2 STM32 GPIO 命名规则

2. GPIO 硬件结构

2.1 GPIO 内部结构框图

2.2 关键组成部分

3. GPIO 工作模式详解

3.1 输入模式（Input Mode）

3.2 输出模式（Output Mode）

3.3 复用功能模式（Alternate Function）

3.4 模式总结表

4. GPIO 配置详解

4.1 输出速度配置

4.2 HAL 库 GPIO 配置结构体

4.3 各参数详细说明

4.4 完整配置流程

5. GPIO 常用 API 函数

5.1 HAL 库 GPIO API

5.2 LL 库 GPIO API（低层库）

5.3 寄存器直接操作

6. 实战示例

6.1 示例一：LED 闪烁（推挽输出）

6.2 示例二：按键检测（上拉输入 + 外部中断）

6.3 示例三：多位 GPIO 同时操作

6.4 示例四：GPIO 复用功能配置（UART）

6.5 示例五：模拟输入配置（ADC）

6.6 示例六：位带操作（Bit-Banding）

7. 常见问题与调试技巧

7.1 常见问题

7.2 调试技巧

8. 总结

8.1 GPIO 配置要点

8.2 最佳实践

8.3 参考资源