想让一颗LED不是死板的亮和灭,而是慢慢变亮、再慢慢变暗,靠的就是PWM。我最近在补ESP32的基础知识,翻到Random Nerd Tutorials这篇PWM教程,把analogWrite和LEDC两套写法对着官方文档逐条理了一遍,参数和代码也都核过原文。这篇就当我的学习笔记,写给同样刚入坑、看到英文教程就头大的朋友。
先把名词说人话。PWM全称脉冲宽度调制(Pulse Width Modulation),拆开看不吓人:引脚用非常快的速度不停开和关,"开"的时间占整个周期的比例,就叫占空比。占空比越高,LED看上去越亮。呼吸灯、调光台灯,本质都是在调这个比例。

先认识ESP32里的LED PWM控制器
ESP32芯片里专门有一块LED PWM控制器。原文给的说法是:可以配置出6到16个独立通道,具体几个取决于你手上是哪款ESP32——这点官方没给统一数字,就得分型号看了。跟老款Arduino UNO比,这个数量慷慨不少,UNO上只有少数几个引脚支持PWM,而ESP32上所有能当输出用的引脚,都能拿来做PWM输出。
写法上分两条路。一条是analogWrite函数,跟在Arduino板上的用法一样,写起来最省事;另一条是ESP32专属的LEDC API,可以自己指定通道、频率和分辨率,控制粒度更细。两条路做出来的呼吸灯效果是一样的,下面都过一遍,你挑顺手的用。
路线一:analogWrite,跟Arduino一个写法
analogWrite只收两个参数:引脚号和占空比值,占空比范围是0到255。函数长这样:
void analogWrite(uint8_t pin, int value);比如要在GPIO 2上输出一个占空比180的信号,一行就够:
void analogWrite(2, 180);想调得更细还有两个配套函数:analogWriteResolution负责改分辨率,analogWriteFrequency负责改频率,参数都是先给引脚、再给数值。
void analogWriteResolution(uint8_t pin, uint8_t resolution);void analogWriteFrequency(uint8_t pin, uint32_t freq);对呼吸灯来说,默认参数已经够用,这两个函数先混个脸熟就行。以后玩到对频率敏感的场景再回来细抠也不迟。
路线二:LEDC API,ledcAttach配通道、ledcWrite管亮度
LEDC是ESP32那块PWM控制器的接口。第一步用ledcAttach把引脚挂上PWM,参数依次是引脚、频率、分辨率,LEDC通道会自动分配:
bool ledcAttach(uint8_t pin, uint32_t freq, uint8_t resolution);配置成功返回true;返回false就说明出错了,通道不会被配置。想自己指定通道号,就换成ledcAttachChannel,末尾多一个channel参数:
bool ledcAttachChannel(uint8_t pin, uint32_t freq, uint8_t resolution, uint8_t channel);引脚配好之后,调亮度就交给ledcWrite,参数同样是引脚和占空比:
void ledcWrite(uint8_t pin, uint32_t duty);我一开始犯嘀咕:analogWrite和ledcWrite长得这么像,留两个干嘛?对着官方文档看完才反应过来,analogWrite是照顾Arduino老用户的兼容写法,LEDC才是ESP32自己的原生接口。两个都能用,新手从哪个进都不算错。
接线:LED接GPIO16,串一颗330欧电阻
硬件清单很短:一块ESP32开发板(原文用的是DOIT DEVKIT V1,30个引脚的版本)、一颗5mm LED、一颗330欧电阻(阻值接近的都行)、面包板和杜邦线。都是入门套件里的常客,不用另外下单。
接法一句话说完:GPIO 16先串330欧电阻,接到LED正极(长脚那端),LED负极接GND。电阻在这里起限流作用,别为了省事直接把LED怼到引脚上。原文电路图如下,画的是30脚DEVKIT V1;你手上要是别的板型,接之前先对照自己板子的引脚图。

引脚不挑,原文专门说明:只要能当输出用的GPIO,都可以做PWM。新手第一遍建议照抄GPIO 16,跑通之后再换脚玩。
两份完整代码,烧进去就是呼吸灯
先看analogWrite版,逻辑特别直白:loop里放两个for循环,第一个把占空比从0一路加到255,第二个再从255减回0,每步之间delay(15)毫秒。亮度连续变化,人眼看过去就是"呼吸"。
/*
Rui Santos & Sara Santos - Random Nerd Tutorials
Complete project details at https://RandomNerdTutorials.com/esp32-pwm-arduino-ide/
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
*/
// the number of the LED pin
const int ledPin = 16; // 16 corresponds to GPIO 16
void setup() {
// set the LED as an output
pinMode(ledPin, OUTPUT);
}
void loop(){
// increase the LED brightness
for(int dutyCycle = 0; dutyCycle <= 255; dutyCycle++){
// changing the LED brightness with PWM
analogWrite(ledPin, dutyCycle);
delay(15);
}
// decrease the LED brightness
for(int dutyCycle = 255; dutyCycle >= 0; dutyCycle--){
// changing the LED brightness with PWM
analogWrite(ledPin, dutyCycle);
delay(15);
}
}LEDC版思路一模一样,区别全在setup里。先定义PWM属性:频率5000Hz,分辨率8位。8位分辨率对应0到255的占空比范围,正好跟analogWrite那套对得上。
// setting PWM properties
const int freq = 5000;
const int resolution = 8;完整代码如下。setup里一行ledcAttach就配完了;想手动指定通道,把注释里的ledcAttachChannel那行换上去即可,末尾的0就是通道号。
/*
Rui Santos & Sara Santos - Random Nerd Tutorials
Complete project details at https://RandomNerdTutorials.com/esp32-pwm-arduino-ide/
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
*/
// the number of the LED pin
const int ledPin = 16; // 16 corresponds to GPIO16
// setting PWM properties
const int freq = 5000;
const int resolution = 8;
void setup(){
// configure LED PWM
ledcAttach(ledPin, freq, resolution);
// if you want to attach a specific channel, use the following instead
//ledcAttachChannel(ledPin, freq, resolution, 0);
}
void loop(){
// increase the LED brightness
for(int dutyCycle = 0; dutyCycle <= 255; dutyCycle++){
// changing the LED brightness with PWM
ledcWrite(ledPin, dutyCycle);
delay(15);
}
// decrease the LED brightness
for(int dutyCycle = 255; dutyCycle >= 0; dutyCycle--){
// changing the LED brightness with PWM
ledcWrite(ledPin, dutyCycle);
delay(15);
}
}烧录时在Arduino IDE里选对板子和COM口,别的没什么可设的。烧完盯着电路看:LED亮度缓缓升上去,再缓缓降下来,循环往复,呼吸灯就跑起来了。
亮度差到底长什么样,原文贴了不同占空比下的实拍图:占空比给0,LED直接熄灭;给50,亮度明显偏暗;75再亮一档;到100的时候,看上去已经是全亮了。




收个尾。这篇把ESP32的PWM两条路都过了一遍:图省事用analogWrite,想细控通道、频率、分辨率就上LEDC API。同一套思路换个引脚、改改占空比的变化速度,就能给别的输出做调光调速。顺带提醒一句,WS2812那种数字灯珠走的是另一套驱动协议,跟这里的硬件PWM不是一回事,别混着看。教程里的参数和代码我都是逐条对着原文核过的,照着搭应该能一次跑通。











LEDC这套才是ESP32的正经玩法,analogWrite就当入门过渡用。
330欧电阻真别省,我之前裸接LED,亮了一下就差点送走它。
delay(15)这个步进看着刚好,调太快呼吸感就没了,慢一点反而舒服。
正好在学ESP32,之前一直抄analogWrite,看了这篇才知道底层还有个LEDC控制器,ledcAttach能自己挑频率和分辨率,写法比老Arduino自由多了。那个8位分辨率对应0到255占空比的说法也算解了我一个疑惑,之前一直不明白为什么占空比最大偏偏是255。周末照着GPIO16接个LED试试呼吸灯。