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

GPIO 外设驱动：从点灯到按键检测

GPIO，全称 General Purpose Input Output，通用输入输出口。说白了，就是芯片上那些可以编程控制的引脚。你可以让它输出高电平或低电平，也可以读取外部信号是高还是低。

我刚开始接触嵌入式时，觉得 GPIO 太简单了，不就是置 1 清 0 嘛。后来做项目多了才发现，越是基础的东西，坑越多。比如上电瞬间的电平不确定、按键抖动、驱动能力不够…… 这一章，我们就从最经典的 LED 控制和按键检测入手，把 GPIO 用明白。

GPIO 的基本概念

在 ESP32 中，大部分 GPIO 引脚都是多功能复用的。除了作为普通 IO，还能配置成 SPI、I2C、UART 等外设接口。但这一章，我们只关注它的基本输入输出功能。

配置一个 GPIO，你需要决定三件事：

方向：输入还是输出？
上下拉：内部上拉、下拉，还是浮空？
中断：是否使能中断？什么边沿触发？

我个人习惯，在初始化时就把这些参数明确写出来，哪怕用默认值。这样代码可读性好，也方便后来人维护。

关键提醒：ESP32 的 GPIO6~GPIO11 默认连接了 SPI Flash，一般不建议作为普通 IO 使用。我在项目中见过有人误用了这些引脚，导致程序下载正常但运行异常，排查了半天才发现是引脚冲突。

LED 灯控制实战

点灯是嵌入式界的 "Hello World"。但别小看它，这里面藏着 GPIO 输出模式的核心配置。

硬件连接

假设我们用一个 GPIO 引脚控制一个 LED，正极通过限流电阻接 GPIO，负极接地。这是最常见的低电平驱动方式。

元件	连接
LED 正极	→ 220Ω 电阻 → GPIO2
LED 负极	→ GND

代码实现

在 ESP-IDF 中，GPIO 操作通过 driver/gpio.h 提供的 API 完成。下面是一个完整的 LED 闪烁示例：

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"

#define LED_GPIO   GPIO_NUM_2

void app_main(void)
{
    // 1. 配置 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);

    // 2. 开始闪烁
    while (1) {
        gpio_set_level(LED_GPIO, 1);   // 点亮
        vTaskDelay(500 / portTICK_PERIOD_MS);
        gpio_set_level(LED_GPIO, 0);   // 熄灭
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

小技巧：用 gpio_set_level() 控制电平，也可以用 gpio_set_direction() 动态切换方向。我曾在调试一个低功耗项目时，把不用的 GPIO 全部设为输入+下拉，省了几十微安的电流。

按键输入检测实战

按键检测比点灯复杂一些。核心问题就一个：消抖。

机械按键在按下和释放的瞬间，会产生多次电平跳变，这就是抖动。如果不处理，一次按下可能被误判成多次。

硬件消抖 vs 软件消抖

方式	原理	优缺点
硬件消抖	并联电容（0.1μF）+ 施密特触发器	可靠，但增加 BOM 成本
软件消抖	检测到电平变化后，延时 10~20ms 再读一次	零成本，灵活，推荐使用

我个人更倾向软件消抖。原因很简单——省一个电容，少一个焊接点，生产良率就高一点。

代码实现：带消抖的按键检测

#include "driver/gpio.h"

#define BUTTON_GPIO  GPIO_NUM_0   // BOOT 按键

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 prev_state = 1;  // 默认高电平（未按下）
    while (1) {
        int cur_state = gpio_get_level(BUTTON_GPIO);
        if (cur_state == 0 && prev_state == 1) {
            // 检测到下降沿，延时消抖
            vTaskDelay(20 / portTICK_PERIOD_MS);
            if (gpio_get_level(BUTTON_GPIO) == 0) {
                printf("按键按下！\n");
            }
        }
        prev_state = cur_state;
        vTaskDelay(10 / portTICK_PERIOD_MS);
    }
}

避坑指南：我曾经在一个量产项目中，按键消抖延时只写了 5ms，结果有 3% 的机器出现按键双击误触发。后来改成 20ms，问题消失。不同按键的抖动时间不同，建议实际测试一下你的按键，再确定延时值。

GPIO 中断：更高效的方式

轮询方式虽然简单，但浪费 CPU。如果按键需要实时响应，建议用 GPIO 中断。

配置中断的步骤：

在 gpio_config_t 中设置 intr_type，比如 GPIO_INTR_NEGEDGE（下降沿触发）。
调用 gpio_install_isr_service(0) 安装中断服务。
调用 gpio_isr_handler_add() 注册中断处理函数。

中断处理函数里，尽量只做标记，不要做耗时操作。真正的业务逻辑放到任务里处理。

经验之谈：中断里用 printf() 是大忌。printf 本身可能阻塞，而且会占用大量时间。我一般用队列或事件组把中断信号传递给任务，这样既实时又安全。

常见问题与排查思路

现象	可能原因	排查方法
LED 不亮	GPIO 未配置为输出 / 引脚错误	用万用表测引脚电压
按键无反应	内部上拉未使能 / 引脚被复用	检查 gpio_config 参数
按键误触发	消抖时间太短 / 外部干扰	增加延时或加硬件滤波
中断不触发	未安装 ISR 服务 / 中断标志未清除	检查 gpio_install_isr_service 返回值