很多新手第一次想做的效果不是闪灯,是呼吸灯——亮度慢慢起来再慢慢落下去。灯一闪一闪用 digitalWrite 就够了,但呼吸这种"由暗到亮的连续变化",得靠 PWM 模拟输出。这篇用 ESP32 加 Arduino IDE,把两种写法都走一遍:一种是最省事的 analogWrite,一种是 ESP32 专属的 LEDC API(ledcAttach 配合 ledcWrite)。代码取自 Random Nerd Tutorials 的 PWM 教程页,原样搬来,接线烧录步骤一并说清。

先弄懂 PWM 和占空比
PWM 全称脉冲宽度调制,听起来玄,其实思路很朴素:GPIO 只能输出高电平和低电平,没法直接输出 1.5V 这种中间值。那就快速地开和关,开的时间占比多一点,灯就亮一点;占比少一点,灯就暗一点。这个"开的时间占比",就叫占空比(duty cycle)。
只要开关切换得够快,肉眼是看不出闪烁的,只会感觉亮度在连续变化。呼吸灯、风扇调速、舵机信号,本质上都是这一招。ESP32 芯片里专门有个 LED PWM 控制器干这个活,按型号不同有 6 到 16 个独立通道,每个通道都能配自己的频率和分辨率,互不打架。
在 Arduino 环境里驱动它有两条路:一条是 Arduino 通用的 analogWrite,写法简单;另一条是 ESP32 自己的 LEDC 函数,能精细控制频率和分辨率。两种效果一样,下面都会讲到。
准备材料与接线
照着教程做,需要这些东西:
- ESP32 开发板(教程用的是 DOIT DEVKIT V1,30 引脚版)
- 3 只 5mm LED
- 3 个 330 欧姆电阻(阻值相近的也行)
- 面包板和杜邦线
LED 其实一只就能做实验,多备几只方便同时点亮对比亮度。接线很简单:LED 正极(长脚)串一个 330 欧姆电阻接到 GPIO 16,负极(短脚)接 GND。电阻是限流用的,别省。

用哪块引脚都可以,只要它能当输出口用。ESP32 上所有能输出 GPIO 的引脚都支持 PWM,不必死守 GPIO 16。要注意的是不同板型的引脚排布不一样,烧录前对照一下自己板子的 pinout 图。
写法一:analogWrite,最省事
analogWrite 是 Arduino 家族的通用函数,传两个参数:引脚号和占空比值,占空比范围 0 到 255(8 位分辨率)。0 是全灭,255 是全亮,180 就是七成亮度。代码完整贴在这里,一个字符都没改:
/*
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);
}
}逻辑拆开看:setup 里把 LED 引脚设成输出;loop 里两个 for 循环接力,第一个循环把占空比从 0 一步一步加到 255,灯越来越亮;第二个循环再从 255 减回 0,灯越来越暗。每步之间 delay(15) 毫秒,控制呼吸的快慢。想让呼吸更慢,把这个数字调大就行。
analogWrite 的默认频率和分辨率是库里定好的。如果想改,还有两个配套函数:analogWriteResolution(pin, resolution) 设分辨率,analogWriteFrequency(pin, freq) 设频率,用法都是传引脚加数值。
写法二:LEDC API,参数自己说了算
这是 arduino-esp32 库里的官方写法,流程分三步:先用 ledcAttach 把引脚绑定到某个 PWM 通道并配好频率和分辨率,再用 ledcWrite 写占空比。看代码:
/*
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);
}
}和写法一的区别全在 setup 里。这里设了两个常量:freq 是 5000,也就是 5kHz 的 PWM 频率;resolution 是 8,表示 8 位分辨率,占空比同样用 0 到 255。ledcAttach(ledPin, freq, resolution) 三个参数一起传,通道号由库自动分配。配置成功返回 true,失败返回 false——所以认真项目里最好接一下返回值。
如果想指定用哪个通道,把 ledcAttach 换成 ledcAttachChannel,多传一个通道号当第四个参数,代码里注释掉的那行就是示范。之后 loop 里用 ledcWrite(ledPin, dutyCycle) 写占空比,形参和 analogWrite 一样,用起来几乎无感。
两种写法选哪个?做灯这类小实验,analogWrite 三行搞定,够用;要精确控频率和分辨率,或者一块板上要出多路互不干扰的 PWM(比如同时驱动几路不同调光),LEDC 才是正路。
烧录与效果验证
两种代码任选一种,烧录前在 Arduino IDE 里确认开发板型号和串口选对了。上传完成,接在 GPIO 16 上的 LED 就会开始呼吸:缓缓变亮再缓缓变暗,循环往复。
占空比不同亮度差多少?看这组对比最直观。

占空比 0,LED 完全不亮,这时候 GPIO 输出的 PWM 信号里高电平时间占比为零。

占空比给到 50,亮度大概只有一半。人眼对低亮度更敏感,所以 50 的时候看起来比想象中亮不了多少,这是正常的。

占空比 75,亮度继续往上走,但和满亮的差距在缩小——亮度感知和占空比并不是严格线性关系。

占空比拉满,LED 全亮。把这几档连起来播放,就是呼吸灯一个周期里发生的事。
几个容易踩的坑
一、频率别设太低。PWM 频率低于人眼闪炼融合频率时,灯会看出抖动。教程给的 5kHz 完全够用,调低到几百赫兹以下,有些灯会出现可见的频闪。
二、分辨率和占空比上限要配套。8 位分辨率对应 0 到 255;如果改成 10 位,占空比上限就是 1023,还按 255 写就只有四分之一亮度。这是新手最常犯的错。
三、接线时限流电阻别省。GPIO 单脚电流能力有限,长期直驱大电流会伤芯片,330 欧姆是稳妥值。
四、旧版代码对不上。网上早年的 ESP32 教程多用 ledcSetup 加 ledcAttachPin 这对老函数,新版 arduino-esp32 库已经改成 ledcAttach 这套,函数签名完全不同。照着新代码抄,报错先检查库版本。
呼吸灯跑通之后,往远处延伸一步就是风扇调速、台灯调光,再进阶就是同时驱动多路 PWM。LEDC 那 6 到 16 个通道就是为这种多路场景准备的,值得玩熟。











占空比那几张对比图很直观,50 的时候看起来没想象中亮,确实是人眼的缘故。
GPIO 16 不挑的这点好评,我拿 GPIO 25 一样跑,接线自由多了。
5kHz 完全不闪,之前用 200Hz 做呼吸灯能看出抖,换成几 k 赫兹就丝滑了。
上次照着旧教程抄 ledcSetup 直接编译报错,卡了半天才知道新版库改成 ledcAttach 这套了,这篇把版本坑讲明白了。呼吸灯我调过 delay(15),觉得节奏偏快,改成 delay(30) 更像那种慢慢吐气的感觉,大家可以试试。另外补充一点,8 位分辨率下 dutyCycle 上限就是 255,想要更细腻的渐变可以上 10 位,上限变成 1023,渐变肉眼基本看不出台阶。