专栏前言

上一篇我们完成了 DHT11温湿度传感器 + OLED屏幕 的多外设整合，实现了数据采集→解析→显示的完整链路，正式跨入模块化项目开发。
从本篇开始，我们进入嵌入式另一大核心能力：模拟输出。在此之前我们操作的GPIO只有0和1两种数字状态，而 PWM（脉冲宽度调制） 可以用数字信号模拟出连续的“模拟效果”，是嵌入式开发的分水岭级知识点。

小到呼吸灯、蜂鸣器、屏幕背光调节，大到电机调速、舵机控制、电源调压，全部依赖PWM技术。
本篇一次性讲透 ESP-IDF 下 PWM 的完整开发体系：
核心原理 → ESP32 LEDC控制器架构 → 呼吸灯实战 → 无源蜂鸣器音阶播放 → 工程参数选型
全程代码可直接编译烧录，零基础也能彻底理解模拟输出的本质。

---

一、PWM 核心基础（新手必懂）

1. 什么是PWM？

PWM 本质是周期性高低电平翻转的数字信号，通过调整高电平在一个周期内的占比，来模拟出不同的等效电压，从而实现“模拟输出”的效果。

三个核心参数：

• 周期：高低电平完成一次循环的时间，单位秒
• 频率：每秒循环的次数，单位Hz（频率 = 1/周期）
• 占空比：一个周期内高电平的时间占比，范围 0%~100%

核心结论：供电电压固定时，等效输出电压 = 供电电压 × 占空比。
占空比 0% = 完全熄灭/停止；占空比 100% = 最大亮度/全速运行；占空比 50% = 一半亮度/半速运行。

2. 为什么不用真正的模拟输出？

ESP32 没有自带DAC（数模转换）外设，而PWM用纯数字方式即可实现99%的模拟输出场景，成本低、精度可控、资源占用少，是工业界通用方案。

---

二、ESP32 LEDC 控制器架构详解

很多新手会疑惑：为什么ESP-IDF做PWM不用定时器，而叫LEDC？
ESP32 内置了专门的 LED PWM 控制器（简称LEDC），是专门为LED调光设计的硬件PWM引擎，比普通定时器PWM更稳定、资源更丰富、配置更标准化。

1. LEDC 核心资源

• 共 16路独立PWM通道，分为高速组和低速组各8路
• 配套 4个可编程定时器，可独立配置频率和分辨率
• 支持任意GPIO映射输出，无需固定硬件引脚
• 支持占空比自动渐变、相位偏移、硬件触发等高级功能

2. 标准配置三步法

所有PWM工程都遵循固定流程：

1. 配置定时器：设置PWM频率、占空比分辨率、时钟源
2. 配置通道：绑定目标GPIO、关联对应定时器、设置初始占空比
3. 动态更新：运行中修改占空比/频率，硬件自动更新输出

---

三、实战1：PWM 呼吸灯（最经典入门案例）

1. 硬件接线

LED 正极串 220Ω 限流电阻接 GPIO11，负极接 GND。

提示：和普通点灯接线完全一致，只是驱动方式从GPIO输出变成PWM输出。

2. 参数选型说明

• 频率：1kHz（人眼无频闪，适合LED调光）
• 分辨率：13位（占空比共 8192 级，渐变足够丝滑）
• 定时器：LEDC_TIMER_0
• 通道：LEDC_CHANNEL_0

3. 完整可编译源码

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

#define PWM_GPIO_PIN        GPIO_NUM_11
#define PWM_TIMER           LEDC_TIMER_0
#define PWM_CHANNEL         LEDC_CHANNEL_0
#define PWM_FREQ            1000    // 1kHz频率
#define PWM_RESOLUTION      LEDC_TIMER_13_BIT // 13位分辨率
#define PWM_MAX_DUTY        8191    // 2^13 - 1

void app_main(void)
{
    // 1. 配置LEDC定时器
    ledc_timer_config_t timer_cfg = {
        .speed_mode = LEDC_LOW_SPEED_MODE,
        .timer_num = PWM_TIMER,
        .freq_hz = PWM_FREQ,
        .duty_resolution = PWM_RESOLUTION,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_cfg);

    // 2. 配置LEDC通道
    ledc_channel_config_t channel_cfg = {
        .gpio_num = PWM_GPIO_PIN,
        .speed_mode = LEDC_LOW_SPEED_MODE,
        .channel = PWM_CHANNEL,
        .timer_sel = PWM_TIMER,
        .duty = 0, // 初始占空比0，熄灭
        .hpoint = 0
    };
    ledc_channel_config(&channel_cfg);

    uint32_t duty = 0;
    int8_t dir = 1; // 1=占空比增加，-1=占空比减小

    while(1)
    {
        // 更新占空比
        ledc_set_duty(LEDC_LOW_SPEED_MODE, PWM_CHANNEL, duty);
        ledc_update_duty(LEDC_LOW_SPEED_MODE, PWM_CHANNEL);

        // 渐变方向切换
        if(dir == 1)
        {
            duty += 20;
            if(duty >= PWM_MAX_DUTY) dir = -1;
        }
        else
        {
            duty -= 20;
            if(duty <= 0) dir = 1;
        }

        vTaskDelay(pdMS_TO_TICKS(10));
    }
}

4. 关键代码说明

• ledc_set_duty：仅设置占空比缓存，不立即生效
• ledc_update_duty：硬件更新占空比，输出立即变化
• 分辨率与最大占空比对应：n位分辨率 → 最大值 = 2ⁿ - 1

---

四、实战2：无源蜂鸣器驱动 + 音阶播放

1. 有源 vs 无源蜂鸣器

类型	驱动方式	特点	适用场景
有源蜂鸣器	直接高低电平驱动	通电就响、音调固定	简单提示音、报警
无源蜂鸣器	PWM方波驱动	音调可控、可播放音乐	音效、旋律提示、电子琴

2. 硬件接线

无源蜂鸣器正极接 GPIO12，负极接 GND。

新手实验可直接驱动，量产建议增加三极管放大电路，避免GPIO电流不足导致音量偏小。

3. 音阶频率对应表（简谱基础）

简谱	频率(Hz)
低1 Do	262
低2 Re	294
低3 Mi	330
低4 Fa	349
低5 Sol	392
低6 La	440
低7 Si	494
中1 Do	523

4. 完整音阶播放源码

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

#define BEEP_GPIO_PIN       GPIO_NUM_12
#define BEEP_TIMER          LEDC_TIMER_1
#define BEEP_CHANNEL        LEDC_CHANNEL_1
#define BEEP_RESOLUTION     LEDC_TIMER_10_BIT
#define BEEP_DUTY           512 // 50%占空比，音量最大

// 音阶频率表
uint16_t tone_freq[] = {262, 294, 330, 349, 392, 440, 494, 523};

// 播放单个音符
void beep_play_tone(uint16_t freq, uint32_t duration_ms)
{
    // 设置频率
    ledc_set_freq(LEDC_LOW_SPEED_MODE, BEEP_TIMER, freq);
    // 开启输出（设置占空比）
    ledc_set_duty(LEDC_LOW_SPEED_MODE, BEEP_CHANNEL, BEEP_DUTY);
    ledc_update_duty(LEDC_LOW_SPEED_MODE, BEEP_CHANNEL);

    vTaskDelay(pdMS_TO_TICKS(duration_ms));

    // 停止输出
    ledc_set_duty(LEDC_LOW_SPEED_MODE, BEEP_CHANNEL, 0);
    ledc_update_duty(LEDC_LOW_SPEED_MODE, BEEP_CHANNEL);
    vTaskDelay(pdMS_TO_TICKS(50)); // 音符间隔
}

void app_main(void)
{
    // 定时器初始化（初始频率随便设，后面动态改）
    ledc_timer_config_t timer_cfg = {
        .speed_mode = LEDC_LOW_SPEED_MODE,
        .timer_num = BEEP_TIMER,
        .freq_hz = 1000,
        .duty_resolution = BEEP_RESOLUTION,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_cfg);

    // 通道初始化
    ledc_channel_config_t channel_cfg = {
        .gpio_num = BEEP_GPIO_PIN,
        .speed_mode = LEDC_LOW_SPEED_MODE,
        .channel = BEEP_CHANNEL,
        .timer_sel = BEEP_TIMER,
        .duty = 0,
        .hpoint = 0
    };
    ledc_channel_config(&channel_cfg);

    vTaskDelay(pdMS_TO_TICKS(1000));

    // 循环播放音阶
    while(1)
    {
        for(int i=0; i<8; i++)
        {
            beep_play_tone(tone_freq[i], 300);
        }
        vTaskDelay(pdMS_TO_TICKS(2000));
    }
}

---

五、工程参数选型：频率与分辨率的权衡

很多新手配置PWM失败，核心原因是频率和分辨率不匹配。
PWM有一个铁律：频率越高，占空比分辨率就越低，二者此消彼长。

应用场景	推荐频率	推荐分辨率	核心需求
LED调光/呼吸灯	1kHz~20kHz	10~13位	高分辨率、渐变丝滑、无频闪
无源蜂鸣器	200Hz~10kHz	8~10位	频率精准、音调可控
直流电机调速	10kHz~30kHz	8~10位	高频低噪、足够调速档位
舵机控制	50Hz	16位	周期精准、角度分辨率高

快速验证：如果调用 ledc_timer_config 返回错误，优先降低分辨率或降低频率，基本都能解决。

---

六、新手高频踩坑汇总

1. PWM完全没输出？

   • 检查GPIO是否配置正确、是否被其他外设复用
   • 确认占空比不为0、是否调用了 ledc_update_duty 生效
   • 频率与分辨率组合非法，超出硬件上限

2. 呼吸灯渐变卡顿、不丝滑？

   • 步长太大，减小每次增减的占空比数值
   • 延时太长，缩短渐变间隔
   • 分辨率太低，增加位数提升档位数量

3. 蜂鸣器声音很小？

   • 无源蜂鸣器必须用方波驱动，50%占空比音量最大
   • GPIO驱动能力有限，量产增加三极管放大电路
   • 频率偏离蜂鸣器谐振频率，音量会明显变小

4. 修改频率后占空比失效？

   • 分辨率随频率变化，最大占空比数值会改变
   • 修改频率后建议重新设置占空比，避免越界

---

下一篇预告（09篇）

ESP-IDF保姆级入门09｜ADC模拟量采集实战：电位器调压 + 光敏传感器 + OLED数值显示，打通模拟输入→数字转换→界面显示的完整链路，彻底吃透“模拟世界→数字世界”的桥梁！