2、GPIO外设驱动：GPIO的输入输出模式，按键消抖与LED呼吸灯实战

各位同学，欢迎来到第二章。上一章我们把ESP32的开发环境搭好了，也跑了第一个点灯程序。但说真的，那个点灯只是让GPIO输出高低电平，太基础了。这一章我们来点真格的——把GPIO的输入输出模式吃透，再搞定两个经典实战：按键消抖和呼吸灯。

我个人习惯，学外设驱动一定要先看数据手册里的GPIO章节。ESP32的GPIO功能很丰富，但咱们先抓住核心：输出模式和输入模式。搞懂这两个，后面I2C、SPI那些复用功能才好上手。

2.1 GPIO工作模式详解

ESP32的GPIO引脚，说白了就是一个多功能开关。你可以把它配置成输出，去驱动LED、蜂鸣器；也可以配成输入，去读取按键、传感器信号。每个引脚内部都有多个寄存器控制它的行为。

模式	功能描述	典型应用
输出模式	引脚输出高电平(3.3V)或低电平(0V)	LED控制、继电器驱动
输入模式	读取引脚上的电平状态	按键检测、传感器信号读取
开漏输出	只能输出低电平，高电平靠外部上拉	I2C总线、电平转换
上下拉输入	内部使能上拉或下拉电阻	按键输入、浮空引脚防抖动

嗯，这里要注意：ESP32的GPIO默认状态是浮空输入。如果你直接读一个浮空引脚，电平是不确定的。我在项目中遇到过，有同事没配置上下拉就去读按键，结果按键没按下时电平乱跳，程序逻辑全乱套了。

2.2 按键输入与消抖实战

按键是最常见的输入设备。但机械按键有个毛病——抖动。你按下去的一瞬间，金属触点会弹跳几次，产生多个脉冲。如果不处理，程序会误判成按了好多次。

我个人推荐软件消抖，成本低、效果好。做法很简单：第一次检测到电平变化后，等10-20ms再读一次，如果电平一致，就确认按键动作。

// 按键消抖示例代码
#define KEY_GPIO 0  // BOOT按键在GPIO0

void key_scan(void) {
    if (gpio_get_level(KEY_GPIO) == 0) {  // 检测到按下（低电平）
        vTaskDelay(pdMS_TO_TICKS(20));     // 延时20ms消抖
        if (gpio_get_level(KEY_GPIO) == 0) {  // 再次确认
            // 按键有效，执行动作
            printf("Key pressed!\n");
            // 等待按键释放，防止重复触发
            while (gpio_get_level(KEY_GPIO) == 0);
        }
    }
}

2.3 LED呼吸灯实战

呼吸灯，说白了就是让LED的亮度从暗到亮、再从亮到暗，像呼吸一样。这需要用到PWM（脉冲宽度调制）。ESP32的LEDC控制器就是专门干这个的。

你想想看，人眼有视觉暂留效应。如果LED以极快的频率亮灭，只要调整亮的时间占比（占空比），人眼就会觉得亮度变了。占空比0%就是全灭，100%就是最亮。

占空比	视觉亮度	PWM波形示意
0%	全灭	一直低电平
25%	微亮	高电平占1/4周期
50%	半亮	高电平占1/2周期
75%	较亮	高电平占3/4周期
100%	最亮	一直高电平

ESP32的LEDC配置分三步：设置定时器、绑定通道、连接GPIO。我习惯把PWM频率设在1kHz左右，呼吸效果最平滑。

// 呼吸灯核心代码片段
#define LED_GPIO 2
#define LEDC_TIMER LEDC_TIMER_0
#define LEDC_CHANNEL LEDC_CHANNEL_0
#define LEDC_RESOLUTION 10  // 10位分辨率，占空比0-1023

void breath_led_init(void) {
    // 配置定时器
    ledc_timer_config_t timer_conf = {
        .duty_resolution = LEDC_RESOLUTION,
        .freq_hz = 1000,
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .timer_num = LEDC_TIMER
    };
    ledc_timer_config(&timer_conf);

    // 配置通道
    ledc_channel_config_t channel_conf = {
        .channel = LEDC_CHANNEL,
        .duty = 0,
        .gpio_num = LED_GPIO,
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .timer_sel = LEDC_TIMER
    };
    ledc_channel_config(&channel_conf);
}

void breath_effect(void) {
    // 渐亮
    for (int duty = 0; duty <= 1023; duty += 5) {
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        vTaskDelay(pdMS_TO_TICKS(5));
    }
    // 渐暗
    for (int duty = 1023; duty >= 0; duty -= 5) {
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        vTaskDelay(pdMS_TO_TICKS(5));
    }
}

2.4 本章知识体系

下面这张图把本章的核心逻辑串起来了。从GPIO模式选择，到按键输入和PWM输出，再到两个实战案例，你可以看到整个知识脉络。

2.5 避坑指南与经验总结

做GPIO驱动开发，有几个坑我几乎每次培训都会强调：

• 引脚复用冲突：ESP32很多GPIO有默认功能（比如下载用的GPIO0、GPIO2）。我建议避开这些特殊引脚，或者确认你的电路不会干扰下载。
• 驱动能力不足：ESP32的GPIO最大输出电流约12mA，直接驱动大功率LED或继电器会烧引脚。记得加三极管或MOS管驱动。
• 电平匹配：ESP32是3.3V逻辑，如果接5V传感器，必须加电平转换或分压电阻。我曾经直接接5V信号，烧了一个GPIO口，教训深刻。