📚 课程目录第2章 GPIO外设驱动

GPIO 外设驱动：从概念到实战

GPIO，全称 General Purpose Input/Output，通用输入输出口。说白了，就是芯片上那些可以编程控制的引脚。你可以让它输出高电平点亮 LED，也可以读取它上面的电平判断按键是否按下。这是嵌入式开发最基础、也最常用的外设。

我个人习惯把 GPIO 比作芯片的「手脚」——对外界输出动作，或者感知外界状态。今天我们就从基本概念讲起，一步步深入到 ESP32 特有的 GPIO 矩阵，再到实际驱动代码和中断处理。

GPIO 基本概念

先理清几个关键概念。这些是基础，但很多人容易搞混。

概念	说明	典型应用
电平	高电平（3.3V）或低电平（0V）	LED 亮灭、逻辑判断
推挽输出	既能输出高电平，也能输出低电平	驱动 LED、蜂鸣器
开漏输出	只能输出低电平，高电平需外接上拉	I²C 总线、多设备共享线
上拉/下拉	内部电阻将引脚拉到 VCC 或 GND	按键输入防浮空
中断	引脚电平变化时触发 CPU 响应	按键响应、边沿检测

嗯，这里要注意：ESP32 的 GPIO 默认是输入模式，而且内部没有上拉。我刚开始用的时候，直接读引脚发现电平乱跳，后来才想起来要配置上拉电阻。

ESP32 GPIO 矩阵

这是 ESP32 最特别的地方。传统 MCU 的 GPIO 功能是固定的——比如 PA0 只能做串口 TX，不能做别的。但 ESP32 不一样，它有一个 GPIO 矩阵，可以把几乎所有外设信号映射到任意 GPIO 引脚上。

GPIO 矩阵的核心思想： 外设功能与物理引脚解耦。你想把 UART TX 放在 GPIO4 还是 GPIO17？都可以，软件配一下就行。

我在项目中遇到过一块 PCB 布局不合理的情况，串口引脚被大电容挡住了。换做传统 MCU 只能改板，但 ESP32 我直接改一行代码，把 TX 映射到另一个空闲引脚，问题就解决了。

GPIO 矩阵的配置涉及两个关键寄存器：

GPIO_FUNCx_OUT_SEL：选择哪个外设信号输出到引脚 x
GPIO_FUNCx_IN_SEL：选择引脚 x 的输入信号连接到哪个外设

说白了，就是一根「信号总线」，外设和引脚都在上面，你想怎么连就怎么连。

GPIO 输出驱动 LED

先来个最简单的——点亮 LED。这是嵌入式界的「Hello World」。

硬件连接：LED 正极接 GPIO2，负极串联 220Ω 电阻到 GND。

#include "driver/gpio.h"

#define LED_GPIO   GPIO_NUM_2

void app_main(void)
{
    // 配置 GPIO 为推挽输出
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO),
        .mode = GPIO_MODE_OUTPUT,
        .pull_up_en = GPIO_PULLUP_DISABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&io_conf);

    while (1) {
        gpio_set_level(LED_GPIO, 1);  // 点亮
        vTaskDelay(1000 / portTICK_PERIOD_MS);
        gpio_set_level(LED_GPIO, 0);  // 熄灭
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

小技巧： 用 gpio_set_level() 控制单个引脚，效率很高。如果需要同时操作多个引脚，可以用 gpio_set_level() 批量设置，减少函数调用开销。

你想想看，这段代码其实就做了三件事：配置模式、写电平、延时。但背后 GPIO 矩阵已经把 GPIO2 这个引脚和输出信号连上了。

GPIO 输入读取按键

按键输入比输出稍微复杂一点，主要问题是「抖动」。机械按键按下和释放时，电平会快速跳变几次，这就是抖动。

硬件连接：按键一端接 GPIO0，另一端接 GND。内部上拉使能，这样没按下时是高电平，按下后是低电平。

#include "driver/gpio.h"

#define BUTTON_GPIO  GPIO_NUM_0

void app_main(void)
{
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << BUTTON_GPIO),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,   // 内部上拉
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&io_conf);

    int level;
    while (1) {
        level = gpio_get_level(BUTTON_GPIO);
        if (level == 0) {
            printf("按键按下\n");
        }
        vTaskDelay(50 / portTICK_PERIOD_MS);  // 简单消抖
    }
}

注意： 上面的延时消抖只适合演示。实际产品中，我建议用状态机加定时器做消抖，或者用硬件去抖电路。我曾经在一个产品里只用软件延时消抖，结果按键响应时快时慢，用户体验很差。

读取按键电平本身很简单，就是 gpio_get_level()。但真正决定系统稳定性的，是消抖策略和后续的中断处理。

中断处理

轮询读取按键太浪费 CPU 了。更好的方式是中断——按键按下时，CPU 暂停当前任务，跳转到中断服务函数处理。

ESP32 的 GPIO 中断支持四种触发方式：

中断类型	触发条件	适用场景
上升沿触发	电平从低变高	按键释放检测
下降沿触发	电平从高变低	按键按下检测
任意沿触发	电平变化即触发	边沿计数、编码器
低电平触发	电平持续为低	唤醒、紧急停止

来看一个完整的中断示例：

#include "driver/gpio.h"

#define BUTTON_GPIO  GPIO_NUM_0
#define LED_GPIO     GPIO_NUM_2

static void IRAM_ATTR gpio_isr_handler(void* arg)
{
    uint32_t gpio_num = (uint32_t) arg;
    if (gpio_num == BUTTON_GPIO) {
        // 注意：中断里不要做 printf 等耗时操作
        gpio_set_level(LED_GPIO, !gpio_get_level(LED_GPIO));
    }
}

void app_main(void)
{
    // 配置 LED 输出
    gpio_config_t led_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO),
        .mode = GPIO_MODE_OUTPUT,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&led_conf);

    // 配置按键输入 + 下降沿中断
    gpio_config_t btn_conf = {
        .pin_bit_mask = (1ULL << BUTTON_GPIO),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,
        .intr_type = GPIO_INTR_NEGEDGE  // 下降沿触发
    };
    gpio_config(&btn_conf);

    // 安装 GPIO 中断服务
    gpio_install_isr_service(0);
    gpio_isr_handler_add(BUTTON_GPIO, gpio_isr_handler, (void*) BUTTON_GPIO);

    while (1) {
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

关键点： 中断服务函数必须用 IRAM_ATTR 修饰，放在 IRAM 中运行。否则 flash 访问延迟会导致中断响应变慢甚至丢失。我踩过这个坑——中断函数没加 IRAM_ATTR，结果按键偶尔没反应，查了两天才发现。

另外，gpio_install_isr_service() 只需要调用一次，它会为所有 GPIO 中断统一管理。之后用 gpio_isr_handler_add() 注册具体引脚的处理函数。

中断里不要做复杂操作。我的习惯是：中断里只设置标志位或翻转 GPIO，真正的业务逻辑放在主循环或任务里处理。这样既保证了响应速度，又避免了中断嵌套带来的问题。

好了，GPIO 的基本操作就这些。从概念到矩阵，从输出到输入，再到中断，每一步都有它的设计逻辑。你动手写代码的时候，多想想「这个引脚现在是什么模式？」「中断里能不能做这件事？」——慢慢就会形成肌肉记忆。