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

3. 按键输入与中断：数字输入原理、按键消抖、外部中断配置、中断服务函数编写

按键，是嵌入式系统里最基础、也最容易出问题的输入方式。你想想看，一个简单的开关动作，背后却藏着电平跳变、机械抖动、实时响应这些硬骨头。我刚开始做项目时，就因为在按键处理上偷了懒，结果产品在用户手里频繁误触发，被售后追着跑了三个版本才改好。

这一章，咱们就把按键这件事彻底讲透。从数字输入原理，到消抖的几种方案，再到ESP32强大的中断系统，最后写出可靠的中断服务函数。学完这章，你写的按键代码就不会再“抖”了。

3.1 数字输入原理：GPIO怎么读按键

ESP32的GPIO引脚，在输入模式下可以读取外部电平。按键按下时，通常会把引脚拉到GND（低电平）或VCC（高电平）。

最常见的接法有两种：

上拉输入：按键一端接GND，另一端接GPIO。GPIO内部或外部上拉电阻接VCC。按键松开时，GPIO读到高电平；按下时，读到低电平。
下拉输入：按键一端接VCC，另一端接GPIO。GPIO内部或外部下拉电阻接GND。按键松开时，GPIO读到低电平；按下时，读到高电平。

我个人习惯用上拉输入，因为大多数开发板默认就配了内部上拉电阻，省事。

关键点：ESP32的GPIO在输入模式下，内部可以启用上拉或下拉电阻。但要注意，不是所有GPIO都支持内部上拉/下拉，具体查数据手册。

读取按键的代码很简单：

// 配置GPIO为输入模式，启用内部上拉
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_0),
    .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 = gpio_get_level(GPIO_NUM_0);
if (level == 0) {
    // 按键按下
} else {
    // 按键松开
}

3.2 按键消抖：为什么需要消抖？

机械按键在按下和松开的瞬间，触点会弹跳几次，产生一连串的脉冲信号。这个过程通常持续5-20ms。如果不做处理，程序会误认为按键被按了多次。

我曾经在一个智能家居面板项目里，就因为没做消抖，用户按一次“开灯”，灯却闪了三下。客户投诉说“这灯有鬼”。

消抖的常用方法有三种：

方法	原理	优点	缺点
硬件消抖	RC低通滤波器 + 施密特触发器	不占CPU，实时性好	增加BOM成本，不灵活
软件延时消抖	检测到电平变化后，延时10-20ms再读一次	实现简单，零成本	阻塞CPU，不适合多任务
软件状态机消抖	用定时器轮询，连续多次采样一致才确认	非阻塞，适合RTOS	代码稍复杂

在实际项目中，我推荐用状态机消抖。它不阻塞CPU，还能顺便处理长按、短按、双击等复杂逻辑。

我的经验：延时消抖虽然简单，但在FreeRTOS里千万别用vTaskDelay(20)来消抖——这会让高优先级任务饿死。用状态机 + 定时器才是正道。

3.3 外部中断配置：ESP32的中断系统

轮询读取按键，CPU得一直盯着GPIO，效率太低。外部中断可以做到：按键按下时，CPU才响应，平时该干嘛干嘛。

ESP32的GPIO中断支持以下触发方式：

上升沿触发：电平从低变高时触发
下降沿触发：电平从高变低时触发
任意沿触发：电平变化时触发
低电平触发：电平为低时持续触发
高电平触发：电平为高时持续触发

配置外部中断的步骤：

配置GPIO为输入模式
设置中断类型（如下降沿触发）
注册中断服务函数
使能中断

代码示例：

// 配置GPIO中断
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_0),
    .mode = GPIO_MODE_INPUT,
    .pull_up_en = GPIO_PULLUP_ENABLE,
    .intr_type = GPIO_INTR_NEGEDGE  // 下降沿触发
};
gpio_config(&io_conf);

// 安装GPIO中断服务
gpio_install_isr_service(0);

// 注册中断处理函数
gpio_isr_handler_add(GPIO_NUM_0, button_isr_handler, NULL);

注意：ESP32的GPIO中断服务函数必须在IRAM中运行。如果函数定义在Flash里，中断触发时会崩溃。解决办法是在函数前加 IRAM_ATTR 属性。

3.4 中断服务函数编写：ISR的黄金法则

中断服务函数（ISR）是运行在中断上下文中的特殊函数。写ISR时，有几条铁律必须遵守：

快进快出：ISR里不要做复杂运算，不要调用printf、malloc等阻塞函数
避免延时：不要在ISR里用delay或vTaskDelay
使用volatile：ISR和主循环共享的变量，必须用volatile修饰
通知任务：ISR里通常只做标记，真正的处理交给任务线程

一个典型的按键ISR写法：

static volatile uint32_t g_button_press_count = 0;
static volatile bool g_button_pressed = false;

// IRAM_ATTR 确保函数在IRAM中运行
static void IRAM_ATTR button_isr_handler(void* arg) {
    // 记录中断发生
    g_button_press_count++;
    g_button_pressed = true;
    
    // 通知任务处理（FreeRTOS方式）
    BaseType_t xHigherPriorityTaskWoken = pdFALSE;
    vTaskNotifyGiveFromISR(button_task_handle, &xHigherPriorityTaskWoken);
    portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}

然后在任务线程里处理按键逻辑：

void button_task(void* pvParameters) {
    uint32_t ulNotificationValue;
    while (1) {
        // 等待中断通知
        ulNotificationValue = ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
        
        if (ulNotificationValue > 0) {
            // 这里做消抖和按键处理
            vTaskDelay(pdMS_TO_TICKS(20));  // 简单消抖
            if (gpio_get_level(GPIO_NUM_0) == 0) {
                // 确认按键按下
                printf("Button pressed! Count: %lu\n", g_button_press_count);
            }
        }
    }
}

核心思想：ISR只做最轻量的事——置标志位、发通知。真正的业务逻辑交给任务线程。这样既保证了中断响应速度，又避免了ISR里做复杂操作导致系统崩溃。

3.5 知识体系：按键输入与中断全景图

下面这张图，把本章的知识点串起来了。从物理按键到CPU响应，再到任务处理，整个链路一目了然。

3.6 实战要点：一个可靠的按键驱动

把上面的知识点整合起来，一个可靠的按键驱动应该包含：

中断触发：下降沿触发，响应按键按下动作
ISR处理：只做标志位设置和任务通知
任务消抖：在任务线程里延时20ms后再次确认电平
状态机：支持短按、长按、双击等不同动作
防抖容错：连续多次采样一致才认为有效

我的习惯：我会在按键任务里加一个“连续按下”的计数器。如果1秒内中断次数超过10次，就认为是干扰，直接清零。这个技巧帮我解决过不少电磁干扰导致的误触发问题。

嗯，按键输入看似简单，但要做好真不容易。从电平读取到消抖，从中断配置到ISR编写，每一步都有坑。但只要你按照本章的思路来设计，你的按键代码就能在各种恶劣环境下稳定工作。