入门MicroPython+ESP32：PWM呼吸灯

原创于 2025-08-04 15:41:13 发布 · 711 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#IT项目网 #ESP32

ESP32+MicroPython 专栏收录该内容

36 篇文章

订阅专栏

前言：呼吸灯背后的奇妙世界

在现代电子设备中，你是否注意到那些缓缓明灭的指示灯？从手机通知到智能家居，这种模拟人类呼吸节奏的灯光效果（呼吸灯）不仅美观，更能传递丰富的状态信息。本文将带你深入了解PWM技术原理，并用MicroPython在ESP32开发板上实现这一酷炫效果。

1. 什么是呼吸灯？

如下图中的蓝色LED灯，不再是简单的亮灭交替，而是呈现出如同呼吸般的平滑亮度变化——这就是呼吸灯的魅力所在。

PWM

生活中常见的呼吸灯应用：

2. 呼吸灯的实现核心：PWM技术

2.1 PWM的定义与应用

PWM（Pulse Width Modulation）即脉宽调制，是一种通过数字信号控制模拟电路的高效技术。它通过快速开关信号（方波）的占空比变化，实现对电压、电流等模拟量的精确控制，广泛应用于电机调速、灯光控制、音频合成等领域。

1652927725150

2.2 频率：PWM信号的"心跳"

频率指单位时间内PWM方波重复的次数，单位为赫兹（Hz）。对于LED控制，常用频率范围为500Hz-2kHz，既能避免肉眼闪烁，又能保证控制精度。

2.3 占空比：亮度的"调节器"

占空比是一个周期内高电平持续时间与总周期的比值（0%-100%）。在呼吸灯应用中，占空比的连续变化直接表现为LED亮度的平滑过渡。

1652927899250

2.4 面积等效原则：PWM的底层逻辑

1652927994971

为了更好理解，我们可以做个类比：

如果在一本每页只有单幅图像的书中插入10张空白页，快速翻动时图像会变暗；插入100张空白页，图像几乎不可见。占空比越高，等效亮度越高——这就是PWM控制亮度的核心原理。

3. MicroPython控制PWM实战

3.1 官方基础示例

MicroPython官方文档提供了简洁的PWM控制接口（http://docs.micropython.org/en/latest/esp32/quickref.html）：

from machine import Pin, PWM

pwm0 = PWM(Pin(0))  # 创建PWM对象，指定GPIO0引脚
freq = pwm0.freq()  # 获取当前频率（默认5kHz）
pwm0.freq(1000)     # 设置频率为1kHz（1Hz-40MHz可调）

duty = pwm0.duty()  # 获取当前占空比（0-1023，默认512即50%）
pwm0.duty(256)      # 设置占空比为256（约25%亮度）

3.2 关键注意事项

GPIO选择：需使用支持PWM功能的引脚（ESP32通常标记为PWMx）
占空比范围：0-1023对应0%-100%亮度
频率设置：过高可能导致驱动电路效率下降，过低会产生可见闪烁

4. 单步实践：从固定亮度到呼吸效果

4.1 固定亮度控制

以ESP32内置LED（通常连接GPIO2）为例，设置10%亮度：

# 导入硬件控制模块
from machine import Pin, PWM
import time

# 初始化PWM控制
led = PWM(Pin(2))       # 创建PWM对象，控制GPIO2
led.freq(1000)          # 设置频率为1kHz
led.duty(100)           # 设置占空比100（约9.8%亮度）

time.sleep(3)           # 持续3秒
led.deinit()            # 释放PWM资源
print("PWM已释放，程序结束")

当占空比改为1000时（约97.7%亮度），LED会明显变亮。

4.2 呼吸灯完整实现

通过循环渐变占空比实现呼吸效果：

from machine import Pin, PWM
import time

led2 = PWM(Pin(2))      # 初始化GPIO2引脚的PWM
led2.freq(1000)         # 设置1kHz频率

try:
    while True:
        # 亮度渐增：0→1023（约2秒完成一个周期）
        for i in range(0, 1024):
            led2.duty(i)
            time.sleep_ms(1)  # 1ms延时控制渐变速度
            
        # 亮度渐减：1023→0
        for i in range(1023, -1, -1):
            led2.duty(i)
            time.sleep_ms(1)
            
except KeyboardInterrupt:
    led2.deinit()       # 停止程序时释放资源
    print("程序已终止，PWM资源已释放")