ESP32 PWM:ledcWrite做LED呼吸灯与调光

2026-11-17 13:34:04 47阅读 所属项目:ESP32 开发板

想让一颗LED不是死板的亮和灭,而是慢慢变亮、再慢慢变暗,靠的就是PWM。我最近在补ESP32的基础知识,翻到Random Nerd Tutorials这篇PWM教程,把analogWrite和LEDC两套写法对着官方文档逐条理了一遍,参数和代码也都核过原文。这篇就当我的学习笔记,写给同样刚入坑、看到英文教程就头大的朋友。

先把名词说人话。PWM全称脉冲宽度调制(Pulse Width Modulation),拆开看不吓人:引脚用非常快的速度不停开和关,"开"的时间占整个周期的比例,就叫占空比。占空比越高,LED看上去越亮。呼吸灯、调光台灯,本质都是在调这个比例。

ESP32 PWM Arduino IDE 模拟输出调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;你手上要是别的板型,接之前先对照自己板子的引脚图。

ESP32 DEVKIT V1 GPIO16接LED的PWM电路图

引脚不挑,原文专门说明:只要能当输出用的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占空比0时LED熄灭实拍

ESP32 PWM占空比50时LED偏暗实拍

ESP32 PWM占空比75时LED亮度实拍

ESP32 PWM占空比100时LED全亮实拍

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


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


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

LEDC这套才是ESP32的正经玩法,analogWrite就当入门过渡用。

调参到凌晨
2楼 · 2026-11-17 13:35:29

330欧电阻真别省,我之前裸接LED,亮了一下就差点送走它。

隔壁工位的好奇宝
3楼 · 2026-11-17 13:35:29

delay(15)这个步进看着刚好,调太快呼吸感就没了,慢一点反而舒服。

老张装机
4楼 · 2026-11-17 13:35:28

正好在学ESP32,之前一直抄analogWrite,看了这篇才知道底层还有个LEDC控制器,ledcAttach能自己挑频率和分辨率,写法比老Arduino自由多了。那个8位分辨率对应0到255占空比的说法也算解了我一个疑惑,之前一直不明白为什么占空比最大偏偏是255。周末照着GPIO16接个LED试试呼吸灯。