3. PWM与模拟输出：LEDC库使用、呼吸灯实验、PWM频率与占空比调节、舵机控制基础

说到PWM，很多刚接触嵌入式的朋友会觉得它很神秘。其实说白了，PWM就是通过快速开关数字信号，让外设“感觉”到模拟电压的效果。ESP32的LEDC（LED Control）模块，就是专门干这个活的硬件外设。我最早用PWM的时候，总以为要外接DAC芯片才能做模拟输出，后来才发现，一个定时器加几个寄存器就能搞定。

3.1 PWM的基本原理

PWM的全称是Pulse Width Modulation，脉冲宽度调制。它的核心思想很简单：固定频率下，改变高电平持续的时间比例。这个比例就是占空比（Duty Cycle）。

• 频率（Frequency）：每秒内PWM信号重复的次数，单位Hz。
• 占空比（Duty Cycle）：高电平时间占整个周期的百分比。
• 分辨率（Resolution）：占空比可调节的精细程度，通常用位（bit）表示。

举个例子，一个1kHz的PWM信号，周期是1ms。如果占空比是50%，高电平持续0.5ms，低电平0.5ms。如果占空比是25%，高电平只有0.25ms。你想想看，LED灯如果以人眼无法察觉的频率闪烁，它看起来的亮度就取决于占空比——占空比越高，灯越亮。

3.2 ESP32 LEDC库详解

ESP32的LEDC模块比普通MCU的PWM要灵活得多。它内部有8个定时器，每个定时器可以绑定多个通道。我刚开始用的时候，被这个“定时器-通道”的映射关系绕晕过。后来总结了一个规律：定时器决定频率，通道决定占空比。

3.2.1 LEDC的配置流程

使用LEDC库，一般分三步走：

1. 配置定时器：设置频率和分辨率。
2. 绑定通道：将通道与定时器、GPIO引脚关联。
3. 输出PWM：通过改变占空比控制输出。

下面是一个典型的初始化代码：

#include <driver/ledc.h>

// LEDC通道配置结构体
ledc_channel_config_t ledc_channel = {
    .channel    = LEDC_CHANNEL_0,
    .duty       = 0,
    .gpio_num   = GPIO_NUM_2,
    .speed_mode = LEDC_HIGH_SPEED_MODE,
    .hpoint     = 0,
    .timer_sel  = LEDC_TIMER_0
};

// LEDC定时器配置结构体
ledc_timer_config_t ledc_timer = {
    .duty_resolution = LEDC_TIMER_13_BIT,  // 13位分辨率，0~8191
    .freq_hz    = 5000,                     // 5kHz频率
    .speed_mode = LEDC_HIGH_SPEED_MODE,
    .timer_num  = LEDC_TIMER_0
};

// 初始化定时器和通道
ledc_timer_config(&ledc_timer);
ledc_channel_config(&ledc_channel);

3.2.2 频率与分辨率的权衡

LEDC的频率和分辨率是相互制约的。ESP32的时钟源通常是80MHz或40MHz，经过分频后得到目标频率。分辨率越高，分频系数越小，能实现的最高频率就越低。

分辨率（位）	占空比范围	最大频率（80MHz时钟）	典型应用
8	0~255	312.5 kHz	舵机控制
10	0~1023	78.1 kHz	LED调光
13	0~8191	4.9 kHz	精细调光
16	0~65535	1.2 kHz	音频输出

我曾经在一个项目中需要同时控制LED和舵机，LED需要高分辨率调光，舵机需要50Hz的固定频率。我的做法是：用两个不同的定时器，一个配置为13位分辨率给LED，另一个配置为8位分辨率给舵机。这样互不干扰。

3.3 呼吸灯实验

呼吸灯是PWM入门的经典实验。它的原理很简单：让占空比从0逐渐增加到最大值，再从最大值逐渐减小到0，循环往复。人眼看到的效果就是LED灯由暗变亮、再由亮变暗，像呼吸一样。

3.3.1 软件实现

实现呼吸灯有两种常见方式：

• 线性调节：占空比每次增加/减少固定值。优点是简单，缺点是亮度变化不均匀——人眼对亮度的感知是对数的。
• 指数调节：占空比按指数曲线变化。亮度变化更自然，但计算稍复杂。

下面是一个线性呼吸灯的代码示例：

#include <driver/ledc.h>

#define LEDC_CHANNEL    LEDC_CHANNEL_0
#define LEDC_TIMER      LEDC_TIMER_0
#define LEDC_GPIO       GPIO_NUM_2
#define DUTY_MAX        8191  // 13位分辨率最大值

void setup() {
    // 配置定时器和通道（代码同上）
    // ...
}

void loop() {
    // 渐亮
    for (int duty = 0; duty < DUTY_MAX; duty += 50) {
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        delay(10);
    }
    // 渐暗
    for (int duty = DUTY_MAX; duty >= 0; duty -= 50) {
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        delay(10);
    }
}

3.3.2 指数呼吸灯优化

为了让呼吸效果更自然，我推荐使用指数曲线。公式很简单：duty = (exp(alpha * i / N) - 1) / (exp(alpha) - 1) * DUTY_MAX。其中alpha控制曲线陡峭程度，一般取3~5效果不错。

#include <math.h>

void exponential_breath() {
    const float alpha = 4.0;
    const int steps = 200;
    
    // 渐亮
    for (int i = 0; i < steps; i++) {
        float ratio = (exp(alpha * i / steps) - 1) / (exp(alpha) - 1);
        uint32_t duty = (uint32_t)(ratio * DUTY_MAX);
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        delay(15);
    }
    // 渐暗（反向）
    for (int i = steps; i >= 0; i--) {
        float ratio = (exp(alpha * i / steps) - 1) / (exp(alpha) - 1);
        uint32_t duty = (uint32_t)(ratio * DUTY_MAX);
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, LEDC_CHANNEL);
        delay(15);
    }
}

实际对比一下，线性呼吸灯在低亮度区域变化太快，高亮度区域变化太慢。指数呼吸灯则均匀得多，看起来更舒服。

3.4 舵机控制基础

舵机是PWM应用的另一个典型场景。标准的模拟舵机通过50Hz的PWM信号控制角度，占空比范围通常在1ms~2ms之间，对应0°~180°。

3.4.1 舵机PWM参数

角度	脉宽（ms）	占空比（50Hz，8位分辨率）
0°	1.0	51
90°	1.5	77
180°	2.0	102

注意，不同品牌的舵机脉宽范围可能略有差异。我遇到过一些便宜的舵机，0°对应的脉宽是0.5ms，180°对应2.5ms。所以拿到舵机后，最好先用示波器或者逻辑分析仪确认一下实际范围。

3.4.2 舵机控制代码

#include <driver/ledc.h>

#define SERVO_GPIO      GPIO_NUM_13
#define SERVO_CHANNEL   LEDC_CHANNEL_1
#define SERVO_TIMER     LEDC_TIMER_1

// 舵机角度转占空比
// 脉宽范围：1.0ms ~ 2.0ms，对应占空比 51 ~ 102（8位分辨率）
uint32_t angle_to_duty(int angle) {
    // 角度范围 0~180
    float pulse_width = 1.0 + (angle / 180.0) * 1.0;  // 单位ms
    // 50Hz周期 = 20ms，8位分辨率最大值255
    uint32_t duty = (uint32_t)(pulse_width / 20.0 * 255);
    return duty;
}

void setup() {
    // 配置定时器：50Hz，8位分辨率
    ledc_timer_config_t timer_conf = {
        .duty_resolution = LEDC_TIMER_8_BIT,
        .freq_hz    = 50,
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .timer_num  = SERVO_TIMER
    };
    ledc_timer_config(&timer_conf);
    
    // 配置通道
    ledc_channel_config_t channel_conf = {
        .channel    = SERVO_CHANNEL,
        .duty       = 77,  // 初始90°
        .gpio_num   = SERVO_GPIO,
        .speed_mode = LEDC_HIGH_SPEED_MODE,
        .hpoint     = 0,
        .timer_sel  = SERVO_TIMER
    };
    ledc_channel_config(&channel_conf);
}

void loop() {
    // 从0°转到180°，步进10°
    for (int angle = 0; angle <= 180; angle += 10) {
        uint32_t duty = angle_to_duty(angle);
        ledc_set_duty(LEDC_HIGH_SPEED_MODE, SERVO_CHANNEL, duty);
        ledc_update_duty(LEDC_HIGH_SPEED_MODE, SERVO_CHANNEL);
        delay(500);
    }
}

3.5 本章知识体系

下面这张图总结了PWM与LEDC的核心知识结构，方便你快速回顾：

3.6 常见问题与调试技巧

在实际开发中，PWM相关的问题往往出在配置细节上。我整理了几个高频问题：

• PWM输出没有波形：检查GPIO引脚是否被其他外设占用，或者是否调用了ledc_update_duty()。
• LED亮度不均匀：试试指数呼吸算法，或者提高PWM频率到1kHz以上，避免人眼感知到闪烁。
• 舵机抖动：通常是电源供电不足，或者PWM频率不准确。用示波器确认一下实际脉宽。
• 多个通道互相干扰：确保不同功能的通道绑定到不同的定时器上。同一个定时器的通道共享频率设置。