ESP32-S3 PWM实战基于LEDC外设实现呼吸灯效果最近在玩ESP32-S3开发板想做个呼吸灯效果来装饰一下我的小项目。很多刚接触嵌入式的小伙伴可能觉得PWM脉宽调制听起来有点复杂其实它的原理特别直观用ESP32-S3的LEDC外设来实现更是简单。今天我就手把手带你从零开始用两种方法在ESP32-S3上实现一个平滑的呼吸灯顺便把PWM那点事儿彻底讲明白。1. PWM到底是什么一个开关的故事咱们先别被“脉宽调制”这个词吓到。你可以把它想象成一个速度极快的电灯开关。假设你面前有一个LED灯和一个开关。如果你用肉眼无法看清的速度在一秒钟内快速地开关、再开关重复成千上万次。那么LED灯就会亮一半时间灭一半时间。由于开关速度太快人眼根本看不到闪烁只会觉得灯的亮度只有全亮时的一半。这就是PWM最核心的思想通过控制一个周期内“开”的时间比例来模拟出不同的“平均”电压或功率。再进一步如果你让开关大部分时间都处于“开”的状态那么LED看起来就会更亮。如果你让开关大部分时间都处于“关”的状态那么LED看起来就会更暗。这个“开”的时间占整个周期的比例就是我们常说的“占空比”。PWM信号本身仍然是数字信号要么5V要么0V但通过调节占空比我们就能“欺骗”电路让它表现出类似1.3V、3.3V这样的模拟效果从而无级调节LED亮度、电机转速等。2. 玩转PWM必须搞懂的三个参数要配置好PWM就像调收音机一样得知道几个关键旋钮。对于PWM来说主要是这三个频率指一秒钟内完成多少次完整的“开-关”循环单位是赫兹Hz。比如1000 Hz表示一秒内开关1000次。频率太低人眼会看到闪烁频率太高可能超出硬件或负载的处理能力。对于控制LED亮度通常80Hz以上就看不到闪烁了。占空比这是PWM的“灵魂参数”。它指在一个周期内高电平“开”时间所占的百分比。50%占空比意味着“开”和“关”的时间各占一半10%占空比意味着只有10%的时间是“开”的。分辨率这个参数决定了你能多精细地调节占空比。ESP32-S3的LEDC外设支持很高的分辨率。举个例子如果分辨率是8位bit那么占空比就可以被划分为2^8 256个等级从0到255。你可以设置占空比为0/2550%、128/255约50%、255/255100%等等。分辨率越高亮度变化就越平滑。3. ESP32-S3的PWM外设LEDC vs MCPWMESP32-S3芯片内部有两个可以产生PWM信号的硬件模块它们各有专长可别用错了外设模块主要用途特点适用场景LED PWM控制器 (LEDC)控制LED亮度、生成音频信号分辨率高可达16位输出平滑支持最多8个通道可绑定到任意GPIO引脚LED调光、呼吸灯、蜂鸣器发声电机控制PWM (MCPWM)控制直流电机、步进电机、伺服电机支持复杂控制模式正反转、刹车、死区时间防止短路、信号捕获机器人、无人机、精密电机驱动注意做呼吸灯、调光这类活儿用LEDC就对了它简单易用精度也完全够。本章我们的呼吸灯实战就基于LEDC。4. 两种方法实现PWM呼吸灯咱们的硬件连接非常简单就用ESP32-S3开发板上最常见的板载LED它通常连接在GPIO48引脚上。如果你的板子LED接在其他引脚修改代码中的引脚号即可。接下来我分享两种编程方法第一种超级简单第二种更灵活强大。4.1 方法一用Arduino的analogWrite函数快速上手如果你是Arduino用户那对analogWrite一定不陌生。在ESP32-S3的Arduino核心库中这个函数背后其实调用了LEDC。用起来非常简单// 定义LED连接的引脚 #define LED_PIN 48 void setup() { // 将引脚设置为输出模式 pinMode(LED_PIN, OUTPUT); } void loop() { // 实现渐亮效果占空比从0增加到255 for(int brightness 0; brightness 256; brightness) { analogWrite(LED_PIN, brightness); // 写入占空比值 (0-255) delay(10); // 短暂延时控制呼吸速度 } // 实现渐灭效果占空比从255减小到0 for(int brightness 255; brightness 0; brightness--) { analogWrite(LED_PIN, brightness); delay(10); } }代码解读analogWrite(LED_PIN, brightness)这个函数一手包办了LEDC通道的配置和输出。你只需要告诉它用哪个引脚LED_PIN和亮度值brightness范围0-255它内部会自动帮你分配一个LEDC通道并以默认频率通常是500Hz或1kHz和8位分辨率输出PWM。for循环让brightness这个变量从0逐步增加到255再逐步减少到0从而产生亮度平滑变化的效果。delay(10)每次改变亮度后等待10毫秒。这个值决定了呼吸一次的快慢你可以调大或调小来改变呼吸节奏。提示这种方法优点是极其简单适合快速验证和简单应用。缺点是频率、分辨率等参数是库默认的不方便自定义。4.2 方法二使用LEDC专用API推荐更专业当你想更精细地控制PWM比如设置特定的频率、更高的分辨率时就需要直接使用LEDC库函数了。这才是ESP32-S3 PWM编程的“完全体”。配置流程主要分三步建立LEDC通道使用ledcAttach()函数告诉芯片哪个引脚要输出PWM以及频率和分辨率是多少。输出PWM信号在循环中使用ledcWrite()函数动态改变该通道的占空比值。下面是完整的呼吸灯代码// 定义PWM参数 #define PWM_FREQ 2000 // PWM频率设为2000Hz #define PWM_RESOLUTION 8 // 分辨率8位 (占空比范围0-255) #define LED_PIN 48 // LED连接的GPIO引脚 void setup() { // 关键一步建立LEDC通道绑定引脚、设置频率和分辨率 ledcAttach(LED_PIN, PWM_FREQ, PWM_RESOLUTION); } void loop() { // 呼吸灯效果 - 渐亮 for (int duty 0; duty pow(2, PWM_RESOLUTION); duty) { ledcWrite(LED_PIN, duty); // 写入当前的占空比值 delay(5); // 延时控制变化速度 } // 呼吸灯效果 - 渐灭 for (int duty pow(2, PWM_RESOLUTION) - 1; duty 0; duty--) { ledcWrite(LED_PIN, duty); delay(5); } }关键函数和代码解析ledcAttach(uint8_t pin, uint32_t freq, uint8_t resolution)作用初始化一个LEDC通道并将其绑定到指定的GPIO引脚。参数pin你希望输出PWM信号的引脚号这里填48。freqPWM信号的频率单位Hz。这里设为2000即2kHz远高于人眼识别范围。resolutionPWM的分辨率单位bit。这里设为8意味着占空比有256个等级2^8。ledcWrite(uint8_t pin, uint32_t duty)作用设置指定引脚对应LEDC通道的PWM占空比。参数pin与ledcAttach绑定的引脚号。duty要设置的占空比值。范围是0到 (2^resolution - 1)。本例中分辨率是8所以duty范围是0-255。0代表完全关闭0%占空比255代表完全开启100%占空比。pow(2, PWM_RESOLUTION)这是一个数学计算用来根据分辨率算出占空比的最大值。PWM_RESOLUTION为8时pow(2, 8)等于256。所以循环中duty从0到255变化。两种方法怎么选想快速测试、图省事用analogWrite。想做实际项目需要精确控制频率和分辨率或者后续想玩多路PWM、更高精度调光务必掌握ledcAttachledcWrite这套方法。5. 效果验证与调试心得将上面的任意一段代码记得检查LED_PIN是否是你的板子LED实际连接的引脚上传到ESP32-S3开发板你应该就能看到板载LED开始柔和地渐亮渐灭像呼吸一样了。几个调试小技巧呼吸太快或太慢调整代码中delay()函数的参数。增大延时值如改成delay(20)呼吸变慢减小延时值呼吸变快。亮度变化不平滑有跳跃感这可能是分辨率设置太低或者delay延时太短导致占空比变化步进太大。可以尝试提高PWM_RESOLUTION比如改成10或12并适当增加delay时间。LED完全不亮或常亮首先确认GPIO引脚号是否正确。不是所有板子的板载LED都接在GPIO48。检查硬件连接如果是外接LED别忘了串联一个限流电阻如220Ω。用万用表或逻辑分析仪测量一下引脚看是否有PWM波形输出。掌握了ESP32-S3的LEDC PWM你就能轻松控制LED亮度、无级调速小风扇甚至驱动舵机。这个外设非常实用建议你多动手改改频率、分辨率这些参数亲自看看效果有什么不同理解会更深刻。
9. ESP32-S3 PWM实战：基于LEDC外设实现呼吸灯效果
发布时间：2026/7/17 5:04:13
ESP32-S3 PWM实战基于LEDC外设实现呼吸灯效果最近在玩ESP32-S3开发板想做个呼吸灯效果来装饰一下我的小项目。很多刚接触嵌入式的小伙伴可能觉得PWM脉宽调制听起来有点复杂其实它的原理特别直观用ESP32-S3的LEDC外设来实现更是简单。今天我就手把手带你从零开始用两种方法在ESP32-S3上实现一个平滑的呼吸灯顺便把PWM那点事儿彻底讲明白。1. PWM到底是什么一个开关的故事咱们先别被“脉宽调制”这个词吓到。你可以把它想象成一个速度极快的电灯开关。假设你面前有一个LED灯和一个开关。如果你用肉眼无法看清的速度在一秒钟内快速地开关、再开关重复成千上万次。那么LED灯就会亮一半时间灭一半时间。由于开关速度太快人眼根本看不到闪烁只会觉得灯的亮度只有全亮时的一半。这就是PWM最核心的思想通过控制一个周期内“开”的时间比例来模拟出不同的“平均”电压或功率。再进一步如果你让开关大部分时间都处于“开”的状态那么LED看起来就会更亮。如果你让开关大部分时间都处于“关”的状态那么LED看起来就会更暗。这个“开”的时间占整个周期的比例就是我们常说的“占空比”。PWM信号本身仍然是数字信号要么5V要么0V但通过调节占空比我们就能“欺骗”电路让它表现出类似1.3V、3.3V这样的模拟效果从而无级调节LED亮度、电机转速等。2. 玩转PWM必须搞懂的三个参数要配置好PWM就像调收音机一样得知道几个关键旋钮。对于PWM来说主要是这三个频率指一秒钟内完成多少次完整的“开-关”循环单位是赫兹Hz。比如1000 Hz表示一秒内开关1000次。频率太低人眼会看到闪烁频率太高可能超出硬件或负载的处理能力。对于控制LED亮度通常80Hz以上就看不到闪烁了。占空比这是PWM的“灵魂参数”。它指在一个周期内高电平“开”时间所占的百分比。50%占空比意味着“开”和“关”的时间各占一半10%占空比意味着只有10%的时间是“开”的。分辨率这个参数决定了你能多精细地调节占空比。ESP32-S3的LEDC外设支持很高的分辨率。举个例子如果分辨率是8位bit那么占空比就可以被划分为2^8 256个等级从0到255。你可以设置占空比为0/2550%、128/255约50%、255/255100%等等。分辨率越高亮度变化就越平滑。3. ESP32-S3的PWM外设LEDC vs MCPWMESP32-S3芯片内部有两个可以产生PWM信号的硬件模块它们各有专长可别用错了外设模块主要用途特点适用场景LED PWM控制器 (LEDC)控制LED亮度、生成音频信号分辨率高可达16位输出平滑支持最多8个通道可绑定到任意GPIO引脚LED调光、呼吸灯、蜂鸣器发声电机控制PWM (MCPWM)控制直流电机、步进电机、伺服电机支持复杂控制模式正反转、刹车、死区时间防止短路、信号捕获机器人、无人机、精密电机驱动注意做呼吸灯、调光这类活儿用LEDC就对了它简单易用精度也完全够。本章我们的呼吸灯实战就基于LEDC。4. 两种方法实现PWM呼吸灯咱们的硬件连接非常简单就用ESP32-S3开发板上最常见的板载LED它通常连接在GPIO48引脚上。如果你的板子LED接在其他引脚修改代码中的引脚号即可。接下来我分享两种编程方法第一种超级简单第二种更灵活强大。4.1 方法一用Arduino的analogWrite函数快速上手如果你是Arduino用户那对analogWrite一定不陌生。在ESP32-S3的Arduino核心库中这个函数背后其实调用了LEDC。用起来非常简单// 定义LED连接的引脚 #define LED_PIN 48 void setup() { // 将引脚设置为输出模式 pinMode(LED_PIN, OUTPUT); } void loop() { // 实现渐亮效果占空比从0增加到255 for(int brightness 0; brightness 256; brightness) { analogWrite(LED_PIN, brightness); // 写入占空比值 (0-255) delay(10); // 短暂延时控制呼吸速度 } // 实现渐灭效果占空比从255减小到0 for(int brightness 255; brightness 0; brightness--) { analogWrite(LED_PIN, brightness); delay(10); } }代码解读analogWrite(LED_PIN, brightness)这个函数一手包办了LEDC通道的配置和输出。你只需要告诉它用哪个引脚LED_PIN和亮度值brightness范围0-255它内部会自动帮你分配一个LEDC通道并以默认频率通常是500Hz或1kHz和8位分辨率输出PWM。for循环让brightness这个变量从0逐步增加到255再逐步减少到0从而产生亮度平滑变化的效果。delay(10)每次改变亮度后等待10毫秒。这个值决定了呼吸一次的快慢你可以调大或调小来改变呼吸节奏。提示这种方法优点是极其简单适合快速验证和简单应用。缺点是频率、分辨率等参数是库默认的不方便自定义。4.2 方法二使用LEDC专用API推荐更专业当你想更精细地控制PWM比如设置特定的频率、更高的分辨率时就需要直接使用LEDC库函数了。这才是ESP32-S3 PWM编程的“完全体”。配置流程主要分三步建立LEDC通道使用ledcAttach()函数告诉芯片哪个引脚要输出PWM以及频率和分辨率是多少。输出PWM信号在循环中使用ledcWrite()函数动态改变该通道的占空比值。下面是完整的呼吸灯代码// 定义PWM参数 #define PWM_FREQ 2000 // PWM频率设为2000Hz #define PWM_RESOLUTION 8 // 分辨率8位 (占空比范围0-255) #define LED_PIN 48 // LED连接的GPIO引脚 void setup() { // 关键一步建立LEDC通道绑定引脚、设置频率和分辨率 ledcAttach(LED_PIN, PWM_FREQ, PWM_RESOLUTION); } void loop() { // 呼吸灯效果 - 渐亮 for (int duty 0; duty pow(2, PWM_RESOLUTION); duty) { ledcWrite(LED_PIN, duty); // 写入当前的占空比值 delay(5); // 延时控制变化速度 } // 呼吸灯效果 - 渐灭 for (int duty pow(2, PWM_RESOLUTION) - 1; duty 0; duty--) { ledcWrite(LED_PIN, duty); delay(5); } }关键函数和代码解析ledcAttach(uint8_t pin, uint32_t freq, uint8_t resolution)作用初始化一个LEDC通道并将其绑定到指定的GPIO引脚。参数pin你希望输出PWM信号的引脚号这里填48。freqPWM信号的频率单位Hz。这里设为2000即2kHz远高于人眼识别范围。resolutionPWM的分辨率单位bit。这里设为8意味着占空比有256个等级2^8。ledcWrite(uint8_t pin, uint32_t duty)作用设置指定引脚对应LEDC通道的PWM占空比。参数pin与ledcAttach绑定的引脚号。duty要设置的占空比值。范围是0到 (2^resolution - 1)。本例中分辨率是8所以duty范围是0-255。0代表完全关闭0%占空比255代表完全开启100%占空比。pow(2, PWM_RESOLUTION)这是一个数学计算用来根据分辨率算出占空比的最大值。PWM_RESOLUTION为8时pow(2, 8)等于256。所以循环中duty从0到255变化。两种方法怎么选想快速测试、图省事用analogWrite。想做实际项目需要精确控制频率和分辨率或者后续想玩多路PWM、更高精度调光务必掌握ledcAttachledcWrite这套方法。5. 效果验证与调试心得将上面的任意一段代码记得检查LED_PIN是否是你的板子LED实际连接的引脚上传到ESP32-S3开发板你应该就能看到板载LED开始柔和地渐亮渐灭像呼吸一样了。几个调试小技巧呼吸太快或太慢调整代码中delay()函数的参数。增大延时值如改成delay(20)呼吸变慢减小延时值呼吸变快。亮度变化不平滑有跳跃感这可能是分辨率设置太低或者delay延时太短导致占空比变化步进太大。可以尝试提高PWM_RESOLUTION比如改成10或12并适当增加delay时间。LED完全不亮或常亮首先确认GPIO引脚号是否正确。不是所有板子的板载LED都接在GPIO48。检查硬件连接如果是外接LED别忘了串联一个限流电阻如220Ω。用万用表或逻辑分析仪测量一下引脚看是否有PWM波形输出。掌握了ESP32-S3的LEDC PWM你就能轻松控制LED亮度、无级调速小风扇甚至驱动舵机。这个外设非常实用建议你多动手改改频率、分辨率这些参数亲自看看效果有什么不同理解会更深刻。
