📚 课程目录第3章 GPIO驱动开发

3. GPIO驱动开发：从硬件原理到中断实现

GPIO，说白了就是芯片的「手脚」——用来对外输出高低电平，或者读取外部信号。我做了这么多年驱动，接触过的项目里十有八九都离不开GPIO。它虽然简单，但恰恰是嵌入式开发的基石。你想想看，从点个LED灯，到读取按键状态，再到响应外部中断，哪样离得开它？

这一章，我们就从硬件原理讲起，一步步把HAL层的GPIO接口搭起来，然后实现输出、输入和中断三种模式。嗯，这里要注意，我讲的不是某个特定芯片的GPIO，而是通用的HAL抽象思路——你学会了这套方法，换任何平台都能快速上手。

3.1 GPIO硬件原理：你得知道芯片在干什么

GPIO的全称是General-Purpose Input/Output，通用输入输出口。每个GPIO引脚内部，其实是一堆寄存器和逻辑电路在配合工作。

核心硬件要素：

方向寄存器：决定引脚是输入还是输出
数据寄存器：输出时写数据，输入时读数据
上拉/下拉电阻：引脚悬空时保持确定电平
施密特触发器：输入信号整形，消除抖动
复用选择器：引脚可配置为GPIO或其他外设功能

我在项目中遇到过一个问题：某款MCU的GPIO默认是浮空输入，结果板子一上电，引脚电平乱跳，导致外设误动作。后来查手册才发现，必须显式配置上拉或下拉。所以，永远不要相信引脚的默认状态。

3.2 HAL GPIO接口设计：抽象出通用操作

HAL层的GPIO接口，说白了就是定义一组函数，让上层应用不用关心底层寄存器怎么操作。我个人习惯把接口分成三类：配置、读写、中断。

接口分类	函数原型	说明
配置	`HAL_GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_Init)`	初始化引脚模式、速度、上下拉
输出	`HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)`	设置引脚高低电平
输入	`GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)`	读取引脚电平状态
中断	`void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)`	外部中断回调函数

我的设计习惯：把GPIO的端口号和引脚号封装成一个结构体，比如 GPIO_HandleTypeDef，这样传参更清晰，也方便扩展。别小看这个封装，项目大了你就知道好处了。

3.3 GPIO输出模式实现：让引脚听话

输出模式是最常用的。说白了就是往数据寄存器里写0或1，引脚就输出对应的电平。但这里有个坑——推挽输出和开漏输出的区别。

推挽输出：既能输出高电平，也能输出低电平，驱动能力强。适合驱动LED、蜂鸣器等。
开漏输出：只能输出低电平，高电平要靠外部上拉电阻。适合I2C总线这种需要线与的场景。

我曾经在一个项目中，用开漏输出驱动LED，结果灯死活不亮。查了半天才发现，忘了加上拉电阻。嗯，从那以后我每次配置输出模式，都会先确认一下是推挽还是开漏。

下面是一个典型的HAL GPIO输出实现代码片段：

// 初始化GPIO为推挽输出
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1;
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_0, GPIO_PIN_SET);

// 设置引脚输出低电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);

// 翻转引脚电平
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0);

避坑指南：我曾经在高速SPI通信中，把GPIO速度配成了LOW，结果波形上升沿太慢，导致数据错位。GPIO速度要根据实际应用来配，不是越低越好，也不是越高越好——高了会增加功耗和EMI。

3.4 GPIO输入模式实现：读取外部信号

输入模式相对简单，就是读引脚电平。但这里有个关键点——输入模式下的上下拉配置。

你想想看，如果引脚悬空，读到的电平是不确定的。所以按键检测这种场景，通常要配上拉电阻，按键按下时引脚接地，读到低电平；松开时引脚被上拉至高电平。

// 初始化GPIO为输入模式，带上拉
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_2;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;      // 输入模式
GPIO_InitStruct.Pull = GPIO_PULLUP;          // 上拉
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 读取引脚电平
GPIO_PinState state = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2);
if (state == GPIO_PIN_RESET) {
    // 按键按下
} else {
    // 按键松开
}

我的经验：读取输入时，最好加一个简单的软件去抖。比如检测到电平变化后，延时10ms再读一次。别小看这10ms，能省掉你很多排查「按键误触发」的时间。

3.5 中断模式实现：让CPU不再傻等

轮询读输入，CPU得一直盯着引脚，效率太低。中断模式就是让引脚电平变化时，主动通知CPU。说白了，就是给GPIO配一个「门铃」。

中断模式的实现步骤：

配置GPIO为中断模式，指定触发边沿（上升沿、下降沿或双边沿）
配置NVIC（嵌套向量中断控制器），使能对应的中断线
编写中断服务函数，调用HAL的回调接口

// 配置GPIO为外部中断，下降沿触发
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_3;
GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING; // 下降沿触发中断
GPIO_InitStruct.Pull = GPIO_PULLUP;          // 上拉，确保按键松开时为高电平
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 使能NVIC中断
HAL_NVIC_SetPriority(EXTI3_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(EXTI3_IRQn);

// 中断服务函数
void EXTI3_IRQHandler(void) {
    HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_3);
}

// 回调函数——你只需要实现这个
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) {
    if (GPIO_Pin == GPIO_PIN_3) {
        // 按键被按下，执行对应操作
    }
}

我曾经踩过的坑：中断服务函数里千万别做耗时操作，比如延时、打印。中断讲究「快进快出」，你可以在回调里只设置一个标志位，然后在主循环里处理。否则，轻则系统卡顿，重则中断嵌套导致栈溢出。

3.6 GPIO驱动知识体系总览

下面这张图，把GPIO驱动的核心知识点串起来了。你可以把它当作一个快速索引，遇到问题回来对照一下。

GPIO驱动看似简单，但每个细节都藏着坑。我见过太多工程师在输出模式选错、中断回调里做延时、输入没配上下拉这些地方翻车。你只要把这一章的内容吃透，以后遇到GPIO相关的问题，基本都能快速定位。