GPIO 接口与驱动开发：从原理到实战

GPIO，说白了就是芯片的「手脚」——用来对外输出高低电平，或者读取外部信号。我刚开始学 STM32 时，觉得 GPIO 太简单了，不就是置 1 清 0 嘛。后来做项目才发现，输出模式选错、上下拉没配好，轻则功能异常，重则烧引脚。嗯，这一章咱们就把 GPIO 彻底吃透。

GPIO 工作原理：一个引脚背后的电路

每个 GPIO 引脚内部其实是一套完整的模拟/数字混合电路。我画了个简化的框图，帮你理解信号是怎么从内核走到引脚上的。

从图上你能看到，GPIO 的核心路径分两条：输出路径和输入路径。输出时，数据从内核写到输出数据寄存器（ODR），经过输出控制模块，再通过推挽或开漏电路送到引脚。输入时，引脚电平经过上下拉电阻、输入控制模块，最终到达输入数据寄存器（IDR）。

推挽输出 vs 开漏输出：到底怎么选？

这是 GPIO 配置里最容易踩坑的地方。我见过不少新手把开漏当推挽用，结果输出高电平死活上不去。

推挽输出：内部用两个 MOS 管交替导通，一个推高、一个拉低。输出高电平时，上管导通直接连 VDD；输出低电平时，下管导通直接连 GND。速度快、驱动强，日常用最多。

开漏输出：只有下管，没有上管。输出低电平时下管导通；输出高电平时下管断开，引脚处于高阻态，电平由外部上拉电阻决定。为什么要这么麻烦？因为多个开漏输出可以「线与」——任何一个拉低，总线就是低电平。I²C 就是靠这个工作的。

上下拉输入配置：别让引脚「悬空」

输入模式下，引脚如果什么都不接，电平是不确定的——这叫「浮空」。浮空引脚读到的值随机跳变，按键检测会失灵，外部中断会乱触发。

解决办法就是加上拉或下拉电阻。STM32 内部已经集成了上下拉电阻，通过寄存器配置即可，省掉外部电阻。

• 上拉输入：默认高电平，外部拉低时读到 0。适合按键（按键一端接 GND）。
• 下拉输入：默认低电平，外部拉高时读到 1。适合按键（按键一端接 VDD）。
• 浮空输入：无上下拉，电平由外部决定。适合外部电路已经提供明确电平的场景。

寄存器操作与 HAL 库封装

直接操作寄存器是理解 GPIO 本质的最好方式。HAL 库虽然方便，但出了问题你得知道底层在干什么。

关键寄存器一览

举个例子，配置 PA5 为推挽输出、速度中速、无上下拉：

// 直接寄存器操作
RCC->AHB1ENR |= (1 << 0);          // 使能 GPIOA 时钟
GPIOA->MODER  &= ~(0x3 << 10);    // 清除 PA5 模式位
GPIOA->MODER  |=  (0x1 << 10);    // 设为输出模式 (01)
GPIOA->OTYPER &= ~(0x1 << 5);     // 推挽输出 (0)
GPIOA->OSPEEDR &= ~(0x3 << 10);  // 清除速度位
GPIOA->OSPEEDR |=  (0x1 << 10);   // 中速 (01)
GPIOA->PUPDR  &= ~(0x3 << 10);   // 无上下拉 (00)

// 输出高电平
GPIOA->BSRR = (1 << 5);            // 原子操作置位
// 输出低电平
GPIOA->BSRR = (1 << (5 + 16));    // 原子操作复位

用 HAL 库封装后，代码更简洁：

// HAL 库配置
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();

GPIO_InitStruct.Pin   = GPIO_PIN_5;
GPIO_InitStruct.Mode  = GPIO_MODE_OUTPUT_PP;     // 推挽输出
GPIO_InitStruct.Pull  = GPIO_NOPULL;             // 无上下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_MEDIUM;  // 中速
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

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

实战：按键中断控制 LED

理论讲完了，咱们来个完整的例子。用按键触发外部中断，控制 LED 亮灭。这是嵌入式开发最经典的入门实战，但细节不少。

硬件连接

• LED：PA5，推挽输出，串 220Ω 电阻到 GND
• 按键：PC13，上拉输入，按键另一端接 GND

代码实现

// 1. 配置 LED 引脚（PA5 推挽输出）
void LED_Init(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    __HAL_RCC_GPIOA_CLK_ENABLE();

    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_RESET); // 初始灭
}

// 2. 配置按键引脚（PC13 上拉输入 + 外部中断）
void KEY_Init(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    __HAL_RCC_GPIOC_CLK_ENABLE();
    __HAL_RCC_SYSCFG_CLK_ENABLE();  // 使能 SYSCFG，用于中断线配置

    GPIO_InitStruct.Pin   = GPIO_PIN_13;
    GPIO_InitStruct.Mode  = GPIO_MODE_IT_FALLING;  // 下降沿触发
    GPIO_InitStruct.Pull  = GPIO_PULLUP;           // 内部上拉
    HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

    // 配置中断优先级并使能
    HAL_NVIC_SetPriority(EXTI15_10_IRQn, 2, 0);
    HAL_NVIC_EnableIRQ(EXTI15_10_IRQn);
}

// 3. 中断服务函数（在 stm32f4xx_it.c 中）
void EXTI15_10_IRQHandler(void) {
    if (__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_13) != RESET) {
        __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_13);  // 清中断标志

        // 消抖处理：延时 20ms 后再次检测
        HAL_Delay(20);
        if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET) {
            HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);  // 翻转 LED
        }
    }
}

// 4. 主函数
int main(void) {
    HAL_Init();
    LED_Init();
    KEY_Init();

    while (1) {
        // 主循环可以干别的事，LED 由中断控制
        // 低功耗场景可在此进入睡眠模式
    }
}

中断流程总结

1. 按键按下，PC13 电平从高变低（下降沿）
2. SYSCFG 将 PC13 连接到 EXTI13 中断线
3. EXTI 检测到下降沿，置位挂起标志位
4. NVIC 响应中断，跳转到 EXTI15_10_IRQHandler
5. 软件清标志、消抖、翻转 LED
6. 中断返回，继续执行主循环

你看，整个流程从硬件到软件，每个环节都离不开 GPIO 的配置。理解了 GPIO，你就掌握了 STM32 与外界的「对话方式」。