📚 课程目录第3章 PWM与呼吸灯

3. PWM与呼吸灯：LEDC外设详解，实现呼吸灯效果

PWM，说白了就是通过快速开关信号，让负载感受到一个「平均电压」。你想想看，LED灯如果以极快的速度亮灭，人眼根本反应不过来，看到的就只是一个稳定的亮度。这个亮暗比例，就是占空比。

ESP32的LEDC（LED Control）外设，就是专门干这个的。它不光能控制LED，还能驱动舵机、蜂鸣器、甚至做简易DAC。我个人习惯把它叫做「万能调压器」。

3.1 LEDC外设核心概念

LEDC模块本质上是一个16通道的PWM发生器。每个通道可以独立配置频率、占空比和定时器。我刚开始用的时候，最容易被「通道」和「定时器」的关系搞晕。

简单来说：定时器决定PWM的周期和分辨率，通道决定哪个引脚输出这个PWM信号。一个定时器可以绑定多个通道，但所有绑定的通道共享同一个频率和分辨率。

参数	说明	典型值
频率	PWM信号每秒的周期数	50Hz（舵机）、1kHz（LED）
占空比	高电平时间占整个周期的比例	0% ~ 100%
分辨率	占空比调节的精细程度（位数）	8位（0~255）、10位（0~1023）
通道数	可独立输出的PWM信号数量	8个高速通道 + 8个低速通道

关键公式：频率 = 时钟源频率 / (2^分辨率 × 分频系数)

分辨率越高，占空比调节越细腻，但能达到的最高频率就越低。做呼吸灯用8位分辨率足够了，但如果你要驱动50Hz的舵机，建议用10位甚至12位。

3.2 LEDC的配置流程

配置LEDC其实就三步：配定时器、配通道、开始输出。我习惯把这三步写成独立函数，方便复用。

配置定时器：选择定时器编号、频率、分辨率
配置通道：绑定定时器、指定GPIO引脚
设置占空比：写入目标占空比值，开始输出

嗯，这里要注意：ESP32的LEDC有两种模式——高速模式和低速模式。高速模式用APB时钟（80MHz），适合高频应用；低速模式用RTC时钟，可以在睡眠模式下继续工作。做呼吸灯用高速模式就行。

3.3 代码实现：从固定亮度到呼吸灯

先来个最简单的——让LED以固定50%亮度点亮。这能帮你验证硬件连接和配置是否正确。

#include <driver/ledc.h>

#define LEDC_TIMER      LEDC_TIMER_0
#define LEDC_CHANNEL    LEDC_CHANNEL_0
#define LEDC_GPIO       2
#define LEDC_FREQ       5000  // 5kHz，对人眼足够快
#define LEDC_RESOLUTION LEDC_TIMER_8_BIT  // 8位分辨率，0~255

void ledc_init(void) {
    // 1. 配置定时器
    ledc_timer_config_t timer_conf = {
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .timer_num = LEDC_TIMER,
        .duty_resolution = LEDC_RESOLUTION,
        .freq_hz = LEDC_FREQ,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_conf);

    // 2. 配置通道
    ledc_channel_config_t channel_conf = {
        .gpio_num = LEDC_GPIO,
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .channel = LEDC_CHANNEL,
        .timer_sel = LEDC_TIMER,
        .duty = 128,  // 50%占空比
        .hpoint = 0
    };
    ledc_channel_config(&channel_conf);
}

void app_main(void) {
    ledc_init();
    // 此时LED以50%亮度常亮
}

小技巧：如果你发现LED亮度变化不平滑，试试把频率提高到1kHz以上。频率太低时，人眼能感知到闪烁。我曾经在调试一个项目时，用了100Hz的频率做呼吸灯，结果被客户投诉说「灯在抖」——其实就是频闪。

固定亮度太简单了？那我们来做个真正的呼吸灯。呼吸灯的核心就是让占空比按照正弦波或三角波变化。我个人喜欢用三角波，因为计算简单，效果也很自然。

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

#define LEDC_TIMER      LEDC_TIMER_0
#define LEDC_CHANNEL    LEDC_CHANNEL_0
#define LEDC_GPIO       2
#define LEDC_FREQ       5000
#define LEDC_RESOLUTION LEDC_TIMER_8_BIT

void ledc_init(void) {
    ledc_timer_config_t timer_conf = {
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .timer_num = LEDC_TIMER,
        .duty_resolution = LEDC_RESOLUTION,
        .freq_hz = LEDC_FREQ,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_conf);

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

void breath_task(void *arg) {
    int duty = 0;
    int step = 1;

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

        duty += step;
        if (duty >= 255) {
            step = -1;
        } else if (duty <= 0) {
            step = 1;
        }

        vTaskDelay(pdMS_TO_TICKS(10));  // 每10ms调整一次
    }
}

void app_main(void) {
    ledc_init();
    xTaskCreate(breath_task, "breath", 2048, NULL, 5, NULL);
}

注意：调用 ledc_set_duty() 之后，必须调用 ledc_update_duty() 才能生效。这是ESP32 LEDC的一个「坑」——它采用了双缓冲机制，防止在PWM周期中间更新占空比导致信号异常。我刚开始不知道这个，调了半天发现占空比怎么改都没反应……

3.4 呼吸灯效果优化

上面的代码虽然能工作，但呼吸效果其实不够「丝滑」。为什么？因为人眼对亮度的感知不是线性的。你想想看，从0到10的亮度变化，和从200到210的变化，人眼感受到的差异是完全不同的。

这就是所谓的伽马校正。简单说，我们需要让占空比的变化曲线更符合人眼的感知特性。我一般用指数曲线或者查表法来实现。

// 预计算的伽马校正表（8位分辨率）
const uint8_t gamma_table[256] = {
    0, 1, 2, 3, 5, 7, 10, 13, 17, 21, 26, 31, 37, 43, 50, 57,
    65, 73, 82, 91, 101, 111, 122, 133, 145, 157, 170, 183, 197, 211, 226, 241,
    // ... 实际使用时应生成完整的256项
};

void breath_task_gamma(void *arg) {
    int index = 0;
    int step = 1;

    while (1) {
        int duty = gamma_table[index];
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);

        index += step;
        if (index >= 255) step = -1;
        else if (index <= 0) step = 1;

        vTaskDelay(pdMS_TO_TICKS(15));
    }
}

经验之谈：伽马校正表可以用Python离线生成，然后直接复制到C代码里。公式是：gamma_table[i] = (int)(pow(i / 255.0, 2.2) * 255)。2.2是显示行业的标准伽马值，用在LED呼吸灯上效果已经很好了。

3.5 LEDC知识体系总览

说了这么多，我们来画个图，把LEDC的整个知识体系串起来。这样你以后遇到PWM相关的问题，脑子里能快速定位到是哪个环节出了问题。

3.6 常见问题与避坑

做PWM驱动，尤其是呼吸灯，有几个坑我踩过，写出来给你提个醒。

占空比更新不及时：忘了调 ledc_update_duty()，这是最常犯的错误。ESP32的LEDC用了双缓冲，不改这个函数，占空比永远不变。
频率太低导致闪烁：做呼吸灯时，PWM频率建议不低于1kHz。如果频率只有几十Hz，你能肉眼看到LED在「抖」。
分辨率与频率的矛盾：想要高分辨率（比如16位），频率就上不去。做呼吸灯8位足够，做音频DAC才需要高分辨率。
GPIO引脚冲突：有些引脚在芯片内部已经被其他外设占用了。比如GPIO6~11通常用于Flash，别拿来接LED。
任务阻塞：呼吸灯任务里用了 vTaskDelay 而不是 delay()，否则整个系统都会被卡住。

曾经有一次，我在一个量产项目里用了LEDC驱动LED指示灯，结果发现部分设备上电后LED不亮。排查了半天，发现是GPIO引脚在芯片启动阶段被拉低了。解决方案是在 ledc_channel_config() 之前，先把GPIO配置成浮空输入，等LEDC初始化完成后再接管。这种硬件时序问题，软件层面很难复现，但一旦遇到就很头疼。

好了，这一章的内容就到这里。PWM和呼吸灯看似简单，但里面涉及的知识点——定时器配置、通道绑定、占空比控制、伽马校正——都是嵌入式开发中非常基础且重要的技能。把这些搞透了，后面做舵机控制、电机驱动、甚至音频输出，都会轻松很多。