📚 课程目录第3章 GPIO与基础外设控制

3. GPIO与基础外设控制：GPIO配置与操作、LED灯控制实战、按键输入与消抖、PWM输出与呼吸灯

GPIO 是嵌入式开发最基础、也最绕不开的模块。说白了，它就是芯片和外界打交道的最基本通道。我刚开始用 ESP-IDF 时，觉得 GPIO 不就是拉高拉低嘛，有什么好学的？结果真到项目里，踩的坑一个接一个——按键抖动没处理好，设备一上电就误触发；PWM 频率没算对，LED 呼吸灯效果跟抽风似的。嗯，这一章咱们就把这些基础外设控制彻底捋清楚。

3.1 GPIO 配置与操作

ESP32 的 GPIO 引脚功能很灵活。一个引脚可以配置成输入、输出、开漏、上拉、下拉，甚至还能映射到内部外设。我个人习惯，在写任何外设驱动之前，先把 GPIO 的配置结构体搞清楚。

ESP-IDF 里配置 GPIO 的核心结构体是 gpio_config_t。看下面这个例子：

#include "driver/gpio.h"

#define LED_GPIO_PIN  GPIO_NUM_2
#define BUTTON_GPIO   GPIO_NUM_0

void gpio_example_init(void)
{
    // 配置 LED 输出
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO_PIN),
        .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);

    // 配置按键输入，带上拉
    io_conf.pin_bit_mask = (1ULL << BUTTON_GPIO);
    io_conf.mode = GPIO_MODE_INPUT;
    io_conf.pull_up_en = GPIO_PULLUP_ENABLE;
    gpio_config(&io_conf);
}

这里有几个要点：

pin_bit_mask：用位掩码指定要配置的引脚，支持一次配置多个引脚。比如 (1ULL<<GPIO_NUM_2) | (1ULL<<GPIO_NUM_4)。
mode：除了输入输出，还有 GPIO_MODE_OUTPUT_OD（开漏输出），I2C 总线就用这个模式。
pull_up_en / pull_down_en：内部上拉/下拉电阻。注意，ESP32 内部上拉电阻约 45kΩ，下拉约 45kΩ，驱动能力有限。外部干扰强的场合，我建议外加 10kΩ 上拉。

我的习惯：每次配置 GPIO 后，我都会调用 gpio_set_level() 把输出引脚初始化为确定电平。否则上电瞬间引脚可能是高阻态，外设可能误动作。我在一个电机驱动项目里就吃过这个亏——上电瞬间 GPIO 浮空，MOSFET 栅极被耦合噪声打开，电机猛地转了一下。从那以后，初始化顺序我格外小心。

3.2 LED 灯控制实战

控制 LED 无非就是拉高拉低。但实际项目中，LED 往往不是直接接在 GPIO 上的。你想想看，GPIO 的驱动能力有限，ESP32 单个 GPIO 最大输出电流约 40mA，直接驱动高亮 LED 可能会烧引脚。

正确的做法是加一个限流电阻。以 5mm 红色 LED 为例，正向压降约 2V，工作电流 10mA，用 3.3V 供电：

R = (3.3V - 2V) / 0.01A = 130Ω，实际取 150Ω 或 220Ω 都行。

下面是一个简单的 LED 闪烁示例：

void led_blink_task(void *pvParameter)
{
    while (1) {
        gpio_set_level(LED_GPIO_PIN, 1);
        vTaskDelay(500 / portTICK_PERIOD_MS);
        gpio_set_level(LED_GPIO_PIN, 0);
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

这里用 vTaskDelay() 而不是 delay()，因为 FreeRTOS 下阻塞延时会让出 CPU 给其他任务。这是 ESP-IDF 编程的基本素养。

  LED 驱动方式对比：
  
    
      方式
      优点
      缺点
      适用场景
    

      GPIO 直驱
      电路简单，成本低
      驱动电流小，不能带大功率 LED
      指示灯、小功率 LED
    

      三极管驱动
      可驱动几百 mA
      需要额外元件
      高亮 LED、LED 灯带
    

      MOSFET 驱动
      效率高，适合 PWM 调光
      选型需注意 Vgs 阈值
      大功率 LED、恒流驱动
    

方式	优点	缺点	适用场景
GPIO 直驱	电路简单，成本低	驱动电流小，不能带大功率 LED	指示灯、小功率 LED
三极管驱动	可驱动几百 mA	需要额外元件	高亮 LED、LED 灯带
MOSFET 驱动	效率高，适合 PWM 调光	选型需注意 Vgs 阈值	大功率 LED、恒流驱动

3.3 按键输入与消抖

按键输入看起来简单，但抖动问题不处理好，产品就没法用。机械按键按下和释放时，触点会弹跳 5~20ms，产生多个脉冲。如果不做消抖，一次按键可能被识别成十几次。

消抖有两种主流方法：

硬件消抖：在按键两端并联 0.1μF 电容，或者用 RC 低通滤波 + 施密特触发器。优点是 CPU 零开销，缺点是增加 BOM 成本。
软件消抖：检测到电平变化后，延时 20~50ms 再读一次。确认电平稳定后再判定。零成本，但占用 CPU 时间。

我个人更倾向软件消抖，因为灵活。下面是我在项目中常用的消抖代码：

#define DEBOUNCE_TIME_MS  30

typedef enum {
    BUTTON_IDLE,
    BUTTON_PRESSED,
    BUTTON_CONFIRMED
} button_state_t;

button_state_t button_debounce(uint8_t gpio_num)
{
    static button_state_t state = BUTTON_IDLE;
    static TickType_t last_tick = 0;
    uint8_t level = gpio_get_level(gpio_num);

    switch (state) {
        case BUTTON_IDLE:
            if (level == 0) {  // 按下（低电平有效）
                state = BUTTON_PRESSED;
                last_tick = xTaskGetTickCount();
            }
            break;

        case BUTTON_PRESSED:
            if ((xTaskGetTickCount() - last_tick) > pdMS_TO_TICKS(DEBOUNCE_TIME_MS)) {
                if (gpio_get_level(gpio_num) == 0) {
                    state = BUTTON_CONFIRMED;
                    return BUTTON_CONFIRMED;
                } else {
                    state = BUTTON_IDLE;  // 抖动干扰，复位
                }
            }
            break;

        case BUTTON_CONFIRMED:
            if (level == 1) {  // 释放
                state = BUTTON_IDLE;
            }
            break;
    }
    return state;
}

我曾经踩过的坑：在低功耗产品中，我用软件延时消抖，直接调了 vTaskDelay(30)。结果按键响应特别迟钝，用户体验很差。后来改成状态机 + 时间戳轮询，既不阻塞任务，又能准确消抖。记住：不要在中断或关键任务里用阻塞延时做消抖。

3.4 PWM 输出与呼吸灯

PWM（脉冲宽度调制）是通过快速切换 GPIO 电平，改变占空比来模拟不同电压。ESP32 的 LEDC 外设专门做 PWM，有 8 个通道，16 位精度，频率可调。

呼吸灯的原理很简单：让 PWM 占空比从 0% 逐渐增加到 100%，再逐渐减小到 0%，循环往复。人眼对亮度变化不是线性的，所以最好用指数曲线来映射占空比，效果更自然。

下面是一个呼吸灯示例：

#include "driver/ledc.h"

#define LEDC_TIMER      LEDC_TIMER_0
#define LEDC_MODE       LEDC_LOW_SPEED_MODE
#define LEDC_CHANNEL    LEDC_CHANNEL_0
#define LEDC_DUTY_RES   LEDC_TIMER_13_BIT   // 13位分辨率，0~8191
#define LEDC_FREQ_HZ    5000                // 5kHz PWM 频率

void breath_led_init(void)
{
    ledc_timer_config_t timer_conf = {
        .speed_mode = LEDC_MODE,
        .timer_num = LEDC_TIMER,
        .duty_resolution = LEDC_DUTY_RES,
        .freq_hz = LEDC_FREQ_HZ,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_conf);

    ledc_channel_config_t channel_conf = {
        .gpio_num = LED_GPIO_PIN,
        .speed_mode = LEDC_MODE,
        .channel = LEDC_CHANNEL,
        .timer_sel = LEDC_TIMER,
        .duty = 0,
        .hpoint = 0
    };
    ledc_channel_config(&channel_conf);
}

void breath_led_task(void *pvParameter)
{
    uint32_t duty_max = (1 << 13) - 1;  // 8191
    uint32_t duty = 0;
    int8_t direction = 1;

    while (1) {
        ledc_set_duty(LEDC_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_MODE, LEDC_CHANNEL);

        duty += direction * 50;  // 步进值
        if (duty >= duty_max) {
            duty = duty_max;
            direction = -1;
        } else if (duty <= 0) {
            duty = 0;
            direction = 1;
        }

        vTaskDelay(pdMS_TO_TICKS(10));
    }
}

这里有几个关键参数：

频率：5kHz 以上人眼就看不到闪烁了。但频率太高（比如 40kHz），LED 驱动电路的开关损耗会增大。我一般取 1kHz~10kHz。
分辨率：13 位对应 8192 级亮度，呼吸效果已经很平滑了。如果追求极致细腻，可以用 16 位（65536 级），但频率上限会降低。
步进值：50 步进 + 10ms 延时，一个呼吸周期约 3.2 秒。你可以根据产品调性调整——快呼吸显科技感，慢呼吸显柔和。

让呼吸更自然的小技巧：人眼对亮度的感知是对数关系。你可以用查表法，把线性增长的占空比映射成指数曲线。比如 duty = (uint32_t)(pow(2, (float)i / 100 * 13) - 1)，这样暗部变化慢、亮部变化快，看起来就像真正在呼吸。

本章知识体系

下面这张图把 GPIO 配置、LED 控制、按键消抖、PWM 呼吸灯的核心流程串起来了。你可以把它当作本章的思维导图：

这一章的内容，说白了就是嵌入式开发的「基本功」。GPIO 配置是骨架，LED 控制是入门实操，按键消抖是避坑必修课，PWM 呼吸灯则是把理论变成「看得见的效果」。我建议你拿到开发板后，先把这四个实验逐个跑通，再试着组合起来——比如用按键切换呼吸灯的模式。动手做一遍，比看十遍文档都管用。