第4章基础外设驱动

4、基础外设驱动：GPIO控制LED、PWM调光原理与实现、按键输入检测与消抖

好，咱们进入实战环节。这一章讲的是最基础、但也最核心的外设驱动。你想想看，智能照明产品，说白了就是「控制灯」和「感知按键」。如果这两块搞不定，后面云平台对接得再漂亮，灯不亮或者按键乱跳，那产品就是废的。

我个人习惯，拿到一个新MCU平台，第一件事就是先点亮一颗LED，再搞定一个按键。这就像学编程先写"Hello World"一样，是检验硬件和软件环境是否正常的金标准。

4.1 GPIO控制LED：从点亮到熄灭的哲学

GPIO，全称是General Purpose Input Output，通用输入输出口。MCU通过它输出高电平或低电平，就能控制LED的亮灭。

这里有个常见的坑：LED的驱动方式。我刚开始做项目时，直接拿GPIO推挽输出去驱动一个大功率LED，结果芯片发热严重，IO口直接烧了。后来才明白，GPIO的驱动能力通常只有几毫安到二十毫安，驱动普通指示灯没问题，但驱动大功率LED必须加三极管或MOS管。

⚠️ 避坑指南： 我曾经在一个量产项目中，因为GPIO直接驱动LED（限流电阻算错了），导致批量返工。记住：GPIO不是电源，它只是个信号。驱动LED一定要串限流电阻，阻值根据LED的额定电流计算：R = (Vcc - Vf) / If。

来看一个典型的LED驱动代码（以ESP32为例）：

#include <driver/gpio.h>

#define LED_GPIO_PIN   GPIO_NUM_2  // 板载LED通常接GPIO2

void led_init(void) {
    gpio_reset_pin(LED_GPIO_PIN);
    gpio_set_direction(LED_GPIO_PIN, GPIO_MODE_OUTPUT);
}

void led_on(void) {
    gpio_set_level(LED_GPIO_PIN, 1);  // 高电平点亮
}

void led_off(void) {
    gpio_set_level(LED_GPIO_PIN, 0);  // 低电平熄灭
}

void led_toggle(void) {
    int level = gpio_get_level(LED_GPIO_PIN);
    gpio_set_level(LED_GPIO_PIN, !level);
}

嗯，这里要注意：不同开发板的LED极性可能不同。有的板子是低电平点亮，高电平熄灭。所以写代码前，先看原理图确认一下。

4.2 PWM调光原理与实现：让灯光温柔起来

单纯的亮灭太粗暴了。智能照明需要调光，而PWM（脉冲宽度调制）就是最常用的调光手段。

说白了，PWM就是让GPIO以极高的频率快速开关。人眼有视觉暂留效应，只要频率够高（通常大于100Hz），我们就感觉不到闪烁，只看到平均亮度。占空比越高，灯越亮。

占空比	效果	应用场景
0%	全灭	关闭灯光
25%	微光	夜间小夜灯
50%	半亮	阅读辅助光
75%	较亮	日常照明
100%	全亮	最大亮度

我在项目中遇到过一个问题：用软件延时做PWM，结果CPU被占死，其他任务全卡住了。所以，一定要用硬件PWM。现代MCU基本都有硬件PWM外设，配置好定时器后，CPU只需要设置占空比寄存器，剩下的硬件自动完成。

💡 核心要点： PWM调光的三个关键参数：

频率：建议1kHz~10kHz。太低会闪烁，太高可能引起LED驱动器啸叫。
分辨率：8位（0-255）够用，10位（0-1023）更细腻。
占空比：直接决定亮度，注意非线性校正（人眼对亮度感知是对数的）。

来看ESP32的硬件PWM实现：

#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_8_BIT  // 8位分辨率
#define LEDC_FREQUENCY  5000               // 5kHz

void pwm_init(void) {
    ledc_timer_config_t timer_conf = {
        .speed_mode       = LEDC_MODE,
        .timer_num        = LEDC_TIMER,
        .duty_resolution  = LEDC_DUTY_RES,
        .freq_hz          = LEDC_FREQUENCY,
        .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 pwm_set_brightness(uint8_t brightness) {
    ledc_set_duty(LEDC_MODE, LEDC_CHANNEL, brightness);
    ledc_update_duty(LEDC_MODE, LEDC_CHANNEL);
}

调用 pwm_set_brightness(128) 就能让LED半亮。是不是很简单？

4.3 按键输入检测与消抖：别让按键乱跳

按键是用户与设备交互最直接的方式。但按键有个天生的毛病：机械抖动。你按下去的一瞬间，金属触点会弹跳几次，导致电平在几毫秒内反复变化。如果不处理，一次按键会被误判成几十次。

为什么会这样？因为机械开关的物理特性决定的。我见过一个产品，因为没做消抖，用户按一下调光键，灯光直接跳了三档。用户投诉说「这灯有鬼」。

🛠️ 我的经验： 消抖有两种主流方式：

硬件消抖：加RC滤波电路（电阻+电容），简单可靠，适合量产。
软件消抖：延时10-20ms后再次检测，灵活但占用CPU。

我个人习惯，能用硬件就用硬件。软件消抖虽然省成本，但遇到干扰强的环境（比如电机附近），还是可能误触发。

来看一个经典的软件消抖实现：

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

#define BUTTON_GPIO_PIN  GPIO_NUM_0  // 板载按键通常接GPIO0

void button_init(void) {
    gpio_reset_pin(BUTTON_GPIO_PIN);
    gpio_set_direction(BUTTON_GPIO_PIN, GPIO_MODE_INPUT);
    gpio_set_pull_mode(BUTTON_GPIO_PIN, GPIO_PULLUP_ONLY);  // 内部上拉
}

int button_read_debounced(void) {
    if (gpio_get_level(BUTTON_GPIO_PIN) == 0) {  // 检测到按下（低电平）
        vTaskDelay(pdMS_TO_TICKS(20));           // 延时20ms消抖
        if (gpio_get_level(BUTTON_GPIO_PIN) == 0) {
            return 1;  // 确认按下
        }
    }
    return 0;  // 未按下或抖动
}

嗯，这里要注意：延时20ms是经验值。不同按键的抖动时间不同，便宜的按键可能抖30ms，好的按键可能只抖5ms。我建议在项目初期用示波器抓一下按键波形，确认抖动时间再定延时值。

⚠️ 避坑指南： 我曾经在一个项目中，用了 vTaskDelay(10) 做消抖，结果在低温环境下按键失灵。后来发现，低温导致按键机械特性变化，抖动时间变长了。所以，消抖延时建议留余量，20-30ms比较安全。

4.4 实战组合：按键控制PWM调光

把上面三个知识点串起来，做一个完整的例子：短按按键切换亮度档位，长按按键开关灯。

#define BRIGHTNESS_STEPS 5
uint8_t brightness_levels[BRIGHTNESS_STEPS] = {0, 64, 128, 192, 255};
uint8_t current_level = 0;

void app_main(void) {
    led_init();
    pwm_init();
    button_init();

    uint32_t press_start_time = 0;
    uint8_t button_state = 0;

    while (1) {
        if (button_read_debounced()) {
            if (button_state == 0) {
                press_start_time = xTaskGetTickCount();
                button_state = 1;
            }
        } else {
            if (button_state == 1) {
                uint32_t press_duration = xTaskGetTickCount() - press_start_time;
                if (press_duration > pdMS_TO_TICKS(1000)) {
                    // 长按：开关灯
                    if (brightness_levels[current_level] > 0) {
                        current_level = 0;  // 关灯
                    } else {
                        current_level = 2;  // 开灯到中档
                    }
                } else {
                    // 短按：切换亮度
                    current_level = (current_level + 1) % BRIGHTNESS_STEPS;
                }
                pwm_set_brightness(brightness_levels[current_level]);
                button_state = 0;
            }
        }
        vTaskDelay(pdMS_TO_TICKS(10));
    }
}

这个代码虽然简单，但已经是一个完整的智能照明控制逻辑了。你想想看，后面对接云平台时，无非就是把按键触发换成云端指令，把本地亮度切换换成远程调光。

📌 本章核心总结：

GPIO控制LED：注意驱动能力和限流电阻
PWM调光：用硬件PWM，频率1-10kHz，分辨率8-10位
按键消抖：延时20-30ms，或加RC硬件滤波
实战组合：按键控制PWM调光，是智能照明的基础框架