📚 课程目录第3章按键输入与中断

3. 按键输入与中断：数字输入、内部上拉/下拉电阻、软件消抖、硬件中断机制

按键，是嵌入式系统里最基础、也最容易被轻视的输入方式。你想想看，一个简单的按钮按下，背后却牵扯到电平检测、噪声抑制、实时响应等一系列问题。我在初学单片机时，就曾因为没处理好按键抖动，导致一个智能灯控项目在演示时疯狂误触发——嗯，场面一度非常尴尬。

这一章，我们就来彻底搞懂ESP32上的按键输入。从最基本的GPIO数字读取，到内部上拉/下拉电阻的巧妙运用，再到软件消抖的经典实现，最后深入硬件中断机制，让你的按键响应既精准又高效。

本章核心知识点

GPIO数字输入模式配置
内部上拉/下拉电阻的原理与使用
按键抖动的原因与软件消抖方法
ESP32中断机制与GPIO中断编程

3.1 数字输入：GPIO的基本读取

ESP32的GPIO引脚，默认是输入模式。但要想稳定读取外部电平，我们需要明确配置它。我个人习惯在初始化时，总是显式调用 gpio_set_direction()，哪怕默认就是输入——这样代码可读性更好，也方便后续维护。

#include "driver/gpio.h"

#define BUTTON_GPIO  0  // 开发板上的BOOT按键

void button_init(void) {
    gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
    // 读取电平
    int level = gpio_get_level(BUTTON_GPIO);
    printf("Button level: %d\n", level);
}

这里有个细节：gpio_get_level() 返回的是0或1。但实际电路中，按键按下时到底是高电平还是低电平？这取决于你的硬件连接方式。这就引出了下一个话题——上拉与下拉电阻。

3.2 内部上拉/下拉电阻

按键电路通常有两种接法：

接法	按下时电平	松开时电平	需要配置
按键接GND，引脚接上拉	低电平 (0)	高电平 (1)	内部上拉
按键接VCC，引脚接下拉	高电平 (1)	低电平 (0)	内部下拉

ESP32内部集成了上拉和下拉电阻，省去了外部电阻。我建议优先使用内部上拉，因为大多数开发板的按键（比如GPIO0的BOOT键）都是按下接GND的设计。

void button_init_with_pullup(void) {
    gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
    gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY);
    // 或者使用更底层的函数：
    // gpio_pullup_en(BUTTON_GPIO);
}

经验之谈： 内部上拉电阻的典型值在45kΩ左右。对于低速按键场景完全够用。但如果你的按键线缆很长（超过1米），我建议还是外加一个10kΩ的上拉电阻，抗干扰能力更强。

3.3 软件消抖：别让按键“说谎”

按键按下和松开的瞬间，机械触点会弹跳。这个弹跳时间通常持续5-20ms。如果不做处理，一次按下可能被误判为多次触发。我在一个智能家居面板项目中就吃过这个亏——用户按一次“开灯”，灯却闪了三下。后来加了消抖，问题才解决。

最经典的消抖方法就是“延时+多次采样”：

#define DEBOUNCE_TIME_MS  20  // 消抖延时

bool read_button_debounced(int gpio_num) {
    static uint8_t last_level = 1;  // 假设默认高电平
    static uint64_t last_change_time = 0;

    uint8_t current_level = gpio_get_level(gpio_num);
    uint64_t now = esp_timer_get_time() / 1000;  // 转为毫秒

    if (current_level != last_level) {
        if (now - last_change_time > DEBOUNCE_TIME_MS) {
            last_level = current_level;
            last_change_time = now;
            return true;  // 检测到有效变化
        }
    } else {
        last_change_time = now;
    }
    return false;
}

这段代码的核心逻辑是：只有电平稳定超过20ms，才认为是一次有效变化。你想想看，这其实就是个“低通滤波器”——把高频的抖动噪声滤掉。

注意： 不要在中断服务函数（ISR）里直接调用 esp_timer_get_time() 或 delay()。ISR要求快速执行，延时操作会阻塞系统。正确的做法是在ISR里只设置标志位，在主循环中处理消抖逻辑。

3.4 硬件中断机制：让CPU不再“空转”

如果没有中断，CPU就得不断轮询按键电平——这叫“忙等待”，说白了就是浪费算力。中断机制允许按键在按下时主动“通知”CPU，CPU可以去做其他事情。

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

触发方式	宏定义	适用场景
上升沿触发	GPIO_INTR_POSEDGE	按键松开时触发
下降沿触发	GPIO_INTR_NEGEDGE	按键按下时触发
任意沿触发	GPIO_INTR_ANYEDGE	按下和松开都触发
低电平触发	GPIO_INTR_LOW_LEVEL	持续低电平有效
高电平触发	GPIO_INTR_HIGH_LEVEL	持续高电平有效

我个人最常用的是下降沿触发——按键按下时响应，松开时不管。这样配合内部上拉，逻辑最清晰。

static void IRAM_ATTR button_isr_handler(void* arg) {
    // ISR中只做最轻量级的事情
    uint32_t gpio_num = (uint32_t) arg;
    xQueueSendFromISR(button_evt_queue, &gpio_num, NULL);
}

void button_interrupt_init(void) {
    // 1. 配置GPIO
    gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
    gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY);

    // 2. 配置中断
    gpio_set_intr_type(BUTTON_GPIO, GPIO_INTR_NEGEDGE);

    // 3. 创建队列用于ISR与主任务通信
    button_evt_queue = xQueueCreate(10, sizeof(uint32_t));

    // 4. 安装GPIO中断服务
    gpio_install_isr_service(0);
    gpio_isr_handler_add(BUTTON_GPIO, button_isr_handler, (void*)BUTTON_GPIO);
}

// 在主任务中处理
void button_task(void *pvParameters) {
    uint32_t io_num;
    while (1) {
        if (xQueueReceive(button_evt_queue, &io_num, portMAX_DELAY)) {
            // 这里可以加软件消抖
            vTaskDelay(pdMS_TO_TICKS(20));
            if (gpio_get_level(io_num) == 0) {
                printf("Button %ld pressed!\n", io_num);
            }
        }
    }
}

关键设计原则：

ISR函数必须用 IRAM_ATTR 修饰，放在IRAM中运行
ISR内禁止调用 printf()、delay() 等阻塞函数
使用队列（Queue）或信号量（Semaphore）将事件传递给任务上下文
消抖逻辑放在任务中，而不是ISR中

3.5 综合实战：一个完整的按键驱动

把上面的知识点串起来，写一个可复用的按键驱动模块。嗯，这里我给出一个我项目里常用的框架：

typedef struct {
    uint8_t gpio_num;
    uint8_t active_level;  // 0: 低电平有效, 1: 高电平有效
    uint32_t debounce_ms;
    void (*on_press)(void);
    void (*on_release)(void);
} button_config_t;

void button_driver_init(button_config_t *cfg) {
    gpio_set_direction(cfg->gpio_num, GPIO_MODE_INPUT);
    if (cfg->active_level == 0) {
        gpio_set_pull_mode(cfg->gpio_num, GPIO_PULLUP_ONLY);
        gpio_set_intr_type(cfg->gpio_num, GPIO_INTR_NEGEDGE);
    } else {
        gpio_set_pull_mode(cfg->gpio_num, GPIO_PULLDOWN_ONLY);
        gpio_set_intr_type(cfg->gpio_num, GPIO_INTR_POSEDGE);
    }
    // ... 注册ISR和队列
}

这个结构体封装了按键的所有属性：引脚号、有效电平、消抖时间、回调函数。你只需要实例化一个配置，调用初始化函数，剩下的交给中断和任务去处理。

避坑指南： 我曾经在一个产品中同时使用了GPIO0和GPIO2作为按键输入。结果发现GPIO0在下载程序时会被拉低，导致误触发。后来我查了ESP32的管脚说明，才知道GPIO0是下载模式选择引脚，不建议作为普通按键输入。所以，选引脚前一定要看数据手册的“Strapping Pin”说明。

好了，这一章的内容就到这里。按键看似简单，但背后涉及的知识点其实不少。从电平配置到消抖算法，再到中断机制，每一步都影响着系统的稳定性和实时性。希望你能动手把代码跑一遍，亲自感受一下按下按键时，CPU是如何优雅地响应你的每一次操作的。