ESP32 PWM 输出做 LED 呼吸灯教程

2026-11-13 13:20:14 98阅读 所属项目:ESP32 开发板

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

ESP32 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 PWM 接线示意

用哪块引脚都可以,只要它能当输出口用。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 灯全灭

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

占空比 50 半亮

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

占空比 75 更亮

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

占空比 100 全亮

占空比拉满,LED 全亮。把这几档连起来播放,就是呼吸灯一个周期里发生的事。

几个容易踩的坑

一、频率别设太低。PWM 频率低于人眼闪炼融合频率时,灯会看出抖动。教程给的 5kHz 完全够用,调低到几百赫兹以下,有些灯会出现可见的频闪。

二、分辨率和占空比上限要配套。8 位分辨率对应 0 到 255;如果改成 10 位,占空比上限就是 1023,还按 255 写就只有四分之一亮度。这是新手最常犯的错。

三、接线时限流电阻别省。GPIO 单脚电流能力有限,长期直驱大电流会伤芯片,330 欧姆是稳妥值。

四、旧版代码对不上。网上早年的 ESP32 教程多用 ledcSetup 加 ledcAttachPin 这对老函数,新版 arduino-esp32 库已经改成 ledcAttach 这套,函数签名完全不同。照着新代码抄,报错先检查库版本。

呼吸灯跑通之后,往远处延伸一步就是风扇调速、台灯调光,再进阶就是同时驱动多路 PWM。LEDC 那 6 到 16 个通道就是为这种多路场景准备的,值得玩熟。


作者:菜鸟也想玩
链接:https://www.aiddithome.com/p/720238e270f9d.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
板砖搬不动
1楼 · 2026-11-13 13:20:40

占空比那几张对比图很直观,50 的时候看起来没想象中亮,确实是人眼的缘故。

拆开看看再说
2楼 · 2026-11-13 13:20:40

GPIO 16 不挑的这点好评,我拿 GPIO 25 一样跑,接线自由多了。

隔壁工位的好奇宝
3楼 · 2026-11-13 13:20:40

5kHz 完全不闪,之前用 200Hz 做呼吸灯能看出抖,换成几 k 赫兹就丝滑了。

电烙铁爱好者
4楼 · 2026-11-13 13:20:39

上次照着旧教程抄 ledcSetup 直接编译报错,卡了半天才知道新版库改成 ledcAttach 这套了,这篇把版本坑讲明白了。呼吸灯我调过 delay(15),觉得节奏偏快,改成 delay(30) 更像那种慢慢吐气的感觉,大家可以试试。另外补充一点,8 位分辨率下 dutyCycle 上限就是 255,想要更细腻的渐变可以上 10 位,上限变成 1023,渐变肉眼基本看不出台阶。