单片机与物联网 / 系统课时
使用 PWM 调光
使用 PWM 调光
PWM 不直接降低 GPIO 的高电平电压,而是快速切换高、低电平,用占空比改变 LED 在一个周期内的平均导通时间。本节使用 ESP32 的 LEDC 外设设置频率和分辨率,并实现可见上平滑的渐亮与渐暗。
学习目标
- 理解 PWM 频率、分辨率和占空比对 LED 调光的影响
- 使用
ledcAttach()和ledcWrite()配置并输出 PWM - 实现连续渐亮、渐暗,并能定位无输出或亮度方向相反的问题
看懂占空比如何改变亮度
在频率保持不变时,占空比越高,一个 PWM 周期内保持高电平的时间越长,外接 LED 的平均电流通常越大。8 位分辨率把占空比划分为 0~255 共 256 个等级,其中 0 表示持续关闭,255 接近持续导通。

频率过低会产生可见闪烁;分辨率越高,亮度级别越细,但硬件定时器能达到的最高频率也会受限制。对普通指示 LED,5 kHz 和 8 位分辨率是一个容易验证的起点。
配置 LEDC 并实现平滑调光
将外接 LED 阳极通过 220~330 Ω 限流电阻连接到 GPIO18,阴极连接 GND。下面代码使用当前 Arduino-ESP32 的引脚式 LEDC API;ledcAttach() 会为该引脚分配通道,之后直接用 ledcWrite() 写入占空比。
#include <Arduino.h>
constexpr uint8_t LED_PIN = 18;
constexpr uint32_t PWM_FREQ = 5000;
constexpr uint8_t PWM_BITS = 8;
constexpr uint16_t PWM_MAX = (1U << PWM_BITS) - 1;
void fadeTo(int from, int to) {
const int step = (from <= to) ? 1 : -1;
// 每次只改变一个占空比等级,短延时让亮度变化连续可见。
for (int duty = from; duty != to + step; duty += step) {
ledcWrite(LED_PIN, duty);
delay(8);
}
}
void setup() {
Serial.begin(115200);
if (!ledcAttach(LED_PIN, PWM_FREQ, PWM_BITS)) {
Serial.println("LEDC attach failed");
while (true) {
delay(1000);
}
}
Serial.printf("PWM ready: %lu Hz, %u-bit\n",
static_cast<unsigned long>(PWM_FREQ),
static_cast<unsigned int>(PWM_BITS));
}
void loop() {
fadeTo(0, PWM_MAX);
Serial.println("fade up complete");
delay(200);
fadeTo(PWM_MAX, 0);
Serial.println("fade down complete");
delay(200);
}预期输出:
PWM ready: 5000 Hz, 8-bit
fade up complete
fade down complete
fade up complete
fade down complete同时可观察到 LED 周期性平滑渐亮和渐暗。若串口输出 LEDC attach failed,说明当前频率、分辨率或硬件资源组合没有成功配置,应先降低频率或分辨率并确认目标 GPIO 可用。
频率、分辨率和亮度步长怎么选
频率决定每秒重复多少个 PWM 周期,分辨率决定一个周期可以分成多少个占空比等级。8 位时最大值为 255;若改为 10 位,代码中的 PWM_MAX 会自动变为 1023,渐变步数也随之增加。
不要同时盲目追求极高频率和极高分辨率。LEDC 的定时器时钟资源有限,某些组合无法实现,ledcAttach() 会返回失败。对肉眼调光,先选一个不会闪烁的频率,再用足够的分辨率获得平滑步进,通常比追求参数极限更实用。
处理亮度不线性和极性问题
人眼对亮度的感知不是线性的,所以占空比从 20 增加到 40,与从 200 增加到 220 的主观变化并不相同。需要更自然的呼吸灯效果时,可以在写入 ledcWrite() 前加入伽马映射,但基础调光应先确认频率、占空比和接线正确。
如果 LED 是从 3.3 V 接到 GPIO、由 GPIO 下拉点亮,逻辑会变成低电平更亮,此时应把写入值改成 PWM_MAX - duty。无论使用哪种接法,都要保留限流电阻;PWM 只控制平均导通时间,不能替代电流限制。