相同频率下ESP32-C3 PWM分辨率降低为何周期变短？如何计算？

我使用ESP32-C3开发板，编写了如下Rust代码：

let pwm_pin = peripherals.pins.gpio10.into_output().unwrap();
let config = TimerConfig::default().frequency((50.Hz()).into()).resolution(Resolution::Bits13);
let timer = Timer::new(peripherals.ledc.timer0, &config)?;
let mut channel = Channel::new(peripherals.ledc.channel0, &timer, pwm_pin)?;

// set duty cycle to 50%
let percent = 50;
let duty = ((channel.get_max_duty() as f64 / 100.0) * percent as f64) as u32;
channel.set_duty(duty);

设置频率为50Hz、分辨率为Resolution::Bits13时，PWM周期为20ms，符合预期；但将分辨率降至Resolution::Bits8后，周期变为250us，远偏离50Hz对应的20ms。我原以为周期仅由频率决定，与分辨率无关，现想了解如何结合频率和分辨率计算PWM实际周期，网上仅能找到未考虑分辨率的period = 1/frequency公式。

ESP32的LEDC（LED Controller）模块的PWM周期并非完全由你设置的frequency参数单独决定，而是由**时钟源频率、分频系数、分辨率（计数器位数）**三者共同决定。你使用的Rust驱动（如esp-idf-hal）会根据你设置的期望频率和分辨率自动计算分频系数，但如果两者的组合超出硬件限制，实际周期就会偏离预期值。

核心计算公式 #

LEDC的实际周期计算公式为：

周期 = (分频系数 × 2^分辨率位数) / 时钟源频率

对应实际输出频率为：

实际频率 = 时钟源频率 / (分频系数 × 2^分辨率位数)

其中：

• 时钟源频率：ESP32-C3的LEDC默认使用APB_CLK，频率为80MHz（可通过配置修改，默认值为80MHz）
• 分频系数：由驱动根据期望频率和分辨率计算得出，必须是1~1024之间的整数（ESP32 LEDC硬件限制）

结合你的案例验证 #

案例1：Resolution::Bits13 + 期望50Hz

• 2^13 = 8192
• 理论分频系数：80MHz / (50Hz × 8192) = 195.3125
• 驱动取最接近的整数分频系数195，此时实际周期为：
  (195 × 8192) / 80000000 ≈ 0.019968s ≈ 20ms
  和你观测到的结果一致，接近期望的50Hz。

案例2：Resolution::Bits8 + 期望50Hz

• 2^8 = 256
• 理论分频系数：80MHz / (50Hz × 256) = 6250
• 这个值远超LEDC硬件支持的最大分频系数1024，驱动无法满足50Hz的期望，会自动调整到硬件允许的参数组合。此时实际使用的分频系数和分辨率的组合会让输出频率落在硬件支持范围内（305Hz~312500Hz），你观测到的250us周期对应4kHz频率，就是驱动调整后的结果。

总结 #

1. 设置的frequency只是驱动的期望目标，实际值受分辨率和硬件分频系数范围的限制，无法强制实现超出硬件能力的组合。
2. 计算实际PWM周期的步骤：
   • 确认LEDC使用的时钟源频率（ESP32-C3默认80MHz）
   • 获取驱动实际配置的分频系数（可通过ESP-IDF调试接口或驱动的相关API查询）
   • 代入公式周期 = (分频系数 × 2^分辨率位数) / 时钟源频率计算
3. 如果需要严格保证周期，先验证期望频率和分辨率的组合是否在硬件允许范围内：

   最小支持频率 = 时钟源频率 / (最大分频系数 × 2^分辨率位数)
   最大支持频率 = 时钟源频率 / (最小分频系数 × 2^分辨率位数)
   

   只有期望频率落在这个区间内，驱动才能实现接近预期的周期。

内容的提问来源于stack exchange，提问作者Tino