单片机与物联网 / 系统课时

使用 PWM 调光

使用 PWM 调光

PWM 不直接降低 GPIO 的高电平电压,而是快速切换高、低电平,用占空比改变 LED 在一个周期内的平均导通时间。本节使用 ESP32 的 LEDC 外设设置频率和分辨率,并实现可见上平滑的渐亮与渐暗。

学习目标

  • 理解 PWM 频率、分辨率和占空比对 LED 调光的影响
  • 使用 ledcAttach() 和 ledcWrite() 配置并输出 PWM
  • 实现连续渐亮、渐暗,并能定位无输出或亮度方向相反的问题

看懂占空比如何改变亮度

在频率保持不变时,占空比越高,一个 PWM 周期内保持高电平的时间越长,外接 LED 的平均电流通常越大。8 位分辨率把占空比划分为 0~255 共 256 个等级,其中 0 表示持续关闭,255 接近持续导通。

相同 PWM 频率下不同占空比与 LED 亮度关系

频率过低会产生可见闪烁;分辨率越高,亮度级别越细,但硬件定时器能达到的最高频率也会受限制。对普通指示 LED,5 kHz 和 8 位分辨率是一个容易验证的起点。

配置 LEDC 并实现平滑调光

将外接 LED 阳极通过 220~330 Ω 限流电阻连接到 GPIO18,阴极连接 GND。下面代码使用当前 Arduino-ESP32 的引脚式 LEDC API;ledcAttach() 会为该引脚分配通道,之后直接用 ledcWrite() 写入占空比。

cpp
#include <Arduino.h>

constexpr uint8_t LED_PIN = 18;
constexpr uint32_t PWM_FREQ = 5000;
constexpr uint8_t PWM_BITS = 8;
constexpr uint16_t PWM_MAX = (1U << PWM_BITS) - 1;

void fadeTo(int from, int to) {
  const int step = (from <= to) ? 1 : -1;

  // 每次只改变一个占空比等级,短延时让亮度变化连续可见。
  for (int duty = from; duty != to + step; duty += step) {
    ledcWrite(LED_PIN, duty);
    delay(8);
  }
}

void setup() {
  Serial.begin(115200);

  if (!ledcAttach(LED_PIN, PWM_FREQ, PWM_BITS)) {
    Serial.println("LEDC attach failed");
    while (true) {
      delay(1000);
    }
  }

  Serial.printf("PWM ready: %lu Hz, %u-bit\n",
                static_cast<unsigned long>(PWM_FREQ),
                static_cast<unsigned int>(PWM_BITS));
}

void loop() {
  fadeTo(0, PWM_MAX);
  Serial.println("fade up complete");
  delay(200);

  fadeTo(PWM_MAX, 0);
  Serial.println("fade down complete");
  delay(200);
}

预期输出:

text
PWM ready: 5000 Hz, 8-bit
fade up complete
fade down complete
fade up complete
fade down complete

同时可观察到 LED 周期性平滑渐亮和渐暗。若串口输出 LEDC attach failed,说明当前频率、分辨率或硬件资源组合没有成功配置,应先降低频率或分辨率并确认目标 GPIO 可用。

频率、分辨率和亮度步长怎么选

频率决定每秒重复多少个 PWM 周期,分辨率决定一个周期可以分成多少个占空比等级。8 位时最大值为 255;若改为 10 位,代码中的 PWM_MAX 会自动变为 1023,渐变步数也随之增加。

不要同时盲目追求极高频率和极高分辨率。LEDC 的定时器时钟资源有限,某些组合无法实现,ledcAttach() 会返回失败。对肉眼调光,先选一个不会闪烁的频率,再用足够的分辨率获得平滑步进,通常比追求参数极限更实用。

处理亮度不线性和极性问题

人眼对亮度的感知不是线性的,所以占空比从 20 增加到 40,与从 200 增加到 220 的主观变化并不相同。需要更自然的呼吸灯效果时,可以在写入 ledcWrite() 前加入伽马映射,但基础调光应先确认频率、占空比和接线正确。

如果 LED 是从 3.3 V 接到 GPIO、由 GPIO 下拉点亮,逻辑会变成低电平更亮,此时应把写入值改成 PWM_MAX - duty。无论使用哪种接法,都要保留限流电阻;PWM 只控制平均导通时间,不能替代电流限制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 PWM 调光

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通