ESP32C3 LED PWM控制器的使用方法
目前对于遥控双发差速小飞机计划采用如下架构：
遥控小飞机框图
esp32c3 做主控，兼具遥控收发和飞行控制锂电池供电，带电量检测双发，720 空心杯电机，55mm 桨，带电流检测mpu6050 加速度计和陀螺仪预留 4 个控制信号输出马达控制要用到 pwm，今天把 esp32c3 的 pwm 跑一下。
简介esp32c3 中把 pwm 外设称为“led pwm 控制器”，共有 6 个通道，可分配到任意 gpio 管脚：
四个独立定时器，可实现小数分频波形的周期和占空比可配置，占空比精确度可达 14 位pwm 输出信号相位可调节可在 light-sleep 模式下工作多种时钟源选择，包括 apb 总线时钟、外置主晶振时钟支持硬件自动步进式地增加或减少占空比，可用于 led rgb 彩色梯度发生器占空比自动渐变是一个特色功能，用于呼吸灯或其它 led 灯效会很方便，在官方文档特意介绍说是 led pwm 控制器。
使用方法
led pwm控制器架构
4 个定时器可独立配置（可配置时钟分频器和计数器最大值），每个定时器内部有一个时基计数器（即基于基准时钟周期计数的计数器）。每个 pwm 生成器在四个定时器中择一，以该定时器的计数值为基准生成 pwm 信号。
下图为定时器和 pwm 生成器的主要功能块。
定时器和pwm生成器功能块
led pwm 控制器的每个定时器内部都有一个时基计数器。上图中时基计数器使用的时钟信号称为ref_pulsex。所有定时器使用同一个时钟源信号ledc_clkx，该时钟源信号经分频器分频后产生ref_pulsex供计数器使用。
设置 ledc 通道分三步完成。注意，与 esp32 不同，esp32-c3 仅支持设置通道为低速模式。
定时器配置，指定 pwm 信号的频率和占空比分辨率。通道配置，绑定定时器和输出 pwm 信号的 gpio。改变 pwm 信号，输出 pwm 信号来驱动 led。可通过软件控制或使用硬件渐变功能来改变 led 的亮度。另一个可选步骤是可以在渐变终端设置一个中断。
led pwm 控制器 api 的关键配置
首次 ledc 配置时，最好先配置定时器（调用函数 ledc_timer_config()），再配置通道（调用函数 ledc_channel_config()）。这样可以确保 io 脚上的 pwm 信号自有输出开始其频率就是正确的。
定时器配置要设置定时器，可调用函数 ledc_timer_config()，并将包括如下配置参数的数据结构 ledc_timer_config_t 传递给该函数：
速度模式（值必须为 ledc_low_speed_mode）定时器索引 ledc_timer_tpwm 信号频率（hz）pwm 占空比分辨率时钟源 ledc_clk_cfg_t频率和占空比分辨率相互关联。pwm 频率越高，占空比分辨率越低，反之亦然。如果 api 不是用来改变 led 亮度，而是用于其它目的，这种相互关系可能会很重要。时钟源同样可以限制 pwm 频率。选择的时钟源频率越高，可以配置的 pwm 频率上限就越高。
esp32c3 ledc时钟源特性
备注
1.如果 esp32-c3 的定时器选用了 rc_fast_clk 作为其时钟源，驱动会通过内部校准来得知这个时钟源的实际频率。这样确保了输出 pwm 信号频率的精准性。
esp32-c3 的所有定时器共用一个时钟源。因此 esp32-c3 不支持给不同的定时器配置不同的时钟源。当一个定时器不再被任何通道所需要时，可以通过调用相同的函数 ledc_timer_config() 来重置这个定时器。此时，函数入参的配置结构体需要指定：
ledc_timer_config_t::speed_mode 重置定时器的所属速度模式 （ledc_mode_t）ledc_timer_config_t::timer_num 重置定时器的索引 （ledc_timer_t）ledc_timer_config_t::deconfigure 将指定定时器重置必须配置此项为 true通道配置定时器设置好后，请配置所需的通道（ledc_channel_t 之一）。配置通道需调用函数 ledc_channel_config()。
通道的配置与定时器设置类似，需向通道配置函数传递包括通道配置参数的结构体 ledc_channel_config_t 。
此时，通道会按照 ledc_channel_config_t 的配置开始运作，并在选定的 gpio 上生成由定时器设置指定的频率和占空比的 pwm 信号。在通道运作过程中，可以随时通过调用函数 ledc_stop() 将其暂停。
改变 pwm 占空比调用函数 ledc_set_duty() 可以设置新的占空比。之后，调用函数 ledc_update_duty() 使新配置生效。要查看当前设置的占空比，可使用 _get_ 函数 ledc_get_duty()。
另外一种设置占空比和其他通道参数的方式是调用 通道配置 一节提到的函数 ledc_channel_config()。
传递给函数的占空比数值范围取决于选定的 duty_resolution，应为 0 至 (2 ** duty_resolution) - 1。例如，如选定的占空比分辨率为 10，则占空比的数值范围为 0 至 1023。此时分辨率为 ~0.1%。
常用配置频率及精度
实例/* ledc (led controller) basic example this example code is in the public domain (or cc0 licensed, at your option.) unless required by applicable law or agreed to in writing, this software is distributed on an as is basis, without warranties or conditions of any kind, either express or implied.*/#include #include driver/ledc.h#include esp_err.h#define ledc_output_io (5) // define the output gpio#define ledc_duty (4095) // set duty to 50%. ((2 ** 13) - 1) * 50% = 4095#define ledc_frequency (5000) // frequency in hertz. set frequency at 5 khzstatic void example_ledc_init(void){ // prepare and then apply the ledc pwm timer configuration ledc_timer_config_t ledc_timer = { .speed_mode = ledc_low_speed_mode, .timer_num = ledc_timer_0, .duty_resolution = ledc_timer_13_bit, .freq_hz = ledc_frequency, // set output frequency at 5 khz .clk_cfg = ledc_auto_clk }; esp_error_check(ledc_timer_config(&ledc_timer)); // prepare and then apply the ledc pwm channel configuration ledc_channel_config_t ledc_channel = { .speed_mode = ledc_low_speed_mode, .channel = ledc_channel_0, .timer_sel = ledc_timer_0, .intr_type = ledc_intr_disable, .gpio_num = ledc_output_io, .duty = 0, // set duty to 0% .hpoint = 0 }; esp_error_check(ledc_channel_config(&ledc_channel));}void app_main(void){ // set the ledc peripheral configuration example_ledc_init(); // set duty to 50% esp_error_check(ledc_set_duty(ledc_low_speed_mode, ledc_channel_0, ledc_duty)); // update duty to apply the new value esp_error_check(ledc_update_duty(ledc_low_speed_mode, ledc_channel_0));}编译后运行，捕捉如下波形：
5khz 50%占空比
修改下占空比：
esp_error_check(ledc_set_duty(ledc_low_speed_mode, ledc_channel_0, ledc_duty-400));编译后运行，捕捉如下波形：
5khz 45.1%占空比
Bsquare调查：很少有工业组织使用先进的分析技术来洞察物联网数据
麦道90机载变速恒频发电系统的谐波分析
1000小时高温老化试验怎么进行，高温老化试验怎么办理
实测数据分析 PCIe 4.0固态硬盘性能如何
某雷达天线方向图自动测试系统的软硬件原理详解
ESP32C3 LED PWM控制器的使用方法
提速降费政策更进一步 取消流量“漫游”费为5G铺路
对于VR技术，它到底是财富还是泡沫
可穿戴缺氧监控电路设计图
JD-BQX2便携式自动气象站技术参数有哪些
求一种基于51单片机的太阳能路灯控制系统设计方案
飞行试验颤振数据实时监控系统
使用CNN进行2D路径规划
InfraScan推出下一代手持式颅内血肿检测器
乐天移动将推出一种安全的基于AI的身份验证系统
工信部加快5G推进步伐！ 5G商用牌照到底会花落谁家？
运放补偿电容
冰箱十大排名_冰箱外壳发烫正常吗？冰箱有冰怎么办？冰箱怎样快速除臭？
关于ST-Link的实际编程和调试应用的场景分析
三星跳过4nm制程转向3nm制程量产，要真正反超台积电存在诸多挑战
遥控小飞机框图
esp32c3 做主控，兼具遥控收发和飞行控制锂电池供电，带电量检测双发，720 空心杯电机，55mm 桨，带电流检测mpu6050 加速度计和陀螺仪预留 4 个控制信号输出马达控制要用到 pwm，今天把 esp32c3 的 pwm 跑一下。
简介esp32c3 中把 pwm 外设称为“led pwm 控制器”，共有 6 个通道，可分配到任意 gpio 管脚：
四个独立定时器，可实现小数分频波形的周期和占空比可配置，占空比精确度可达 14 位pwm 输出信号相位可调节可在 light-sleep 模式下工作多种时钟源选择，包括 apb 总线时钟、外置主晶振时钟支持硬件自动步进式地增加或减少占空比，可用于 led rgb 彩色梯度发生器占空比自动渐变是一个特色功能，用于呼吸灯或其它 led 灯效会很方便，在官方文档特意介绍说是 led pwm 控制器。
使用方法
led pwm控制器架构
4 个定时器可独立配置（可配置时钟分频器和计数器最大值），每个定时器内部有一个时基计数器（即基于基准时钟周期计数的计数器）。每个 pwm 生成器在四个定时器中择一，以该定时器的计数值为基准生成 pwm 信号。
下图为定时器和 pwm 生成器的主要功能块。
定时器和pwm生成器功能块
led pwm 控制器的每个定时器内部都有一个时基计数器。上图中时基计数器使用的时钟信号称为ref_pulsex。所有定时器使用同一个时钟源信号ledc_clkx，该时钟源信号经分频器分频后产生ref_pulsex供计数器使用。
设置 ledc 通道分三步完成。注意，与 esp32 不同，esp32-c3 仅支持设置通道为低速模式。
定时器配置，指定 pwm 信号的频率和占空比分辨率。通道配置，绑定定时器和输出 pwm 信号的 gpio。改变 pwm 信号，输出 pwm 信号来驱动 led。可通过软件控制或使用硬件渐变功能来改变 led 的亮度。另一个可选步骤是可以在渐变终端设置一个中断。
led pwm 控制器 api 的关键配置
首次 ledc 配置时，最好先配置定时器（调用函数 ledc_timer_config()），再配置通道（调用函数 ledc_channel_config()）。这样可以确保 io 脚上的 pwm 信号自有输出开始其频率就是正确的。
定时器配置要设置定时器，可调用函数 ledc_timer_config()，并将包括如下配置参数的数据结构 ledc_timer_config_t 传递给该函数：
速度模式（值必须为 ledc_low_speed_mode）定时器索引 ledc_timer_tpwm 信号频率（hz）pwm 占空比分辨率时钟源 ledc_clk_cfg_t频率和占空比分辨率相互关联。pwm 频率越高，占空比分辨率越低，反之亦然。如果 api 不是用来改变 led 亮度，而是用于其它目的，这种相互关系可能会很重要。时钟源同样可以限制 pwm 频率。选择的时钟源频率越高，可以配置的 pwm 频率上限就越高。
esp32c3 ledc时钟源特性
备注
1.如果 esp32-c3 的定时器选用了 rc_fast_clk 作为其时钟源，驱动会通过内部校准来得知这个时钟源的实际频率。这样确保了输出 pwm 信号频率的精准性。
esp32-c3 的所有定时器共用一个时钟源。因此 esp32-c3 不支持给不同的定时器配置不同的时钟源。当一个定时器不再被任何通道所需要时，可以通过调用相同的函数 ledc_timer_config() 来重置这个定时器。此时，函数入参的配置结构体需要指定：
ledc_timer_config_t::speed_mode 重置定时器的所属速度模式 （ledc_mode_t）ledc_timer_config_t::timer_num 重置定时器的索引 （ledc_timer_t）ledc_timer_config_t::deconfigure 将指定定时器重置必须配置此项为 true通道配置定时器设置好后，请配置所需的通道（ledc_channel_t 之一）。配置通道需调用函数 ledc_channel_config()。
通道的配置与定时器设置类似，需向通道配置函数传递包括通道配置参数的结构体 ledc_channel_config_t 。
此时，通道会按照 ledc_channel_config_t 的配置开始运作，并在选定的 gpio 上生成由定时器设置指定的频率和占空比的 pwm 信号。在通道运作过程中，可以随时通过调用函数 ledc_stop() 将其暂停。
改变 pwm 占空比调用函数 ledc_set_duty() 可以设置新的占空比。之后，调用函数 ledc_update_duty() 使新配置生效。要查看当前设置的占空比，可使用 _get_ 函数 ledc_get_duty()。
另外一种设置占空比和其他通道参数的方式是调用 通道配置 一节提到的函数 ledc_channel_config()。
传递给函数的占空比数值范围取决于选定的 duty_resolution，应为 0 至 (2 ** duty_resolution) - 1。例如，如选定的占空比分辨率为 10，则占空比的数值范围为 0 至 1023。此时分辨率为 ~0.1%。
常用配置频率及精度
实例/* ledc (led controller) basic example this example code is in the public domain (or cc0 licensed, at your option.) unless required by applicable law or agreed to in writing, this software is distributed on an as is basis, without warranties or conditions of any kind, either express or implied.*/#include #include driver/ledc.h#include esp_err.h#define ledc_output_io (5) // define the output gpio#define ledc_duty (4095) // set duty to 50%. ((2 ** 13) - 1) * 50% = 4095#define ledc_frequency (5000) // frequency in hertz. set frequency at 5 khzstatic void example_ledc_init(void){ // prepare and then apply the ledc pwm timer configuration ledc_timer_config_t ledc_timer = { .speed_mode = ledc_low_speed_mode, .timer_num = ledc_timer_0, .duty_resolution = ledc_timer_13_bit, .freq_hz = ledc_frequency, // set output frequency at 5 khz .clk_cfg = ledc_auto_clk }; esp_error_check(ledc_timer_config(&ledc_timer)); // prepare and then apply the ledc pwm channel configuration ledc_channel_config_t ledc_channel = { .speed_mode = ledc_low_speed_mode, .channel = ledc_channel_0, .timer_sel = ledc_timer_0, .intr_type = ledc_intr_disable, .gpio_num = ledc_output_io, .duty = 0, // set duty to 0% .hpoint = 0 }; esp_error_check(ledc_channel_config(&ledc_channel));}void app_main(void){ // set the ledc peripheral configuration example_ledc_init(); // set duty to 50% esp_error_check(ledc_set_duty(ledc_low_speed_mode, ledc_channel_0, ledc_duty)); // update duty to apply the new value esp_error_check(ledc_update_duty(ledc_low_speed_mode, ledc_channel_0));}编译后运行，捕捉如下波形：
5khz 50%占空比
修改下占空比：
esp_error_check(ledc_set_duty(ledc_low_speed_mode, ledc_channel_0, ledc_duty-400));编译后运行，捕捉如下波形：
5khz 45.1%占空比
Bsquare调查：很少有工业组织使用先进的分析技术来洞察物联网数据
麦道90机载变速恒频发电系统的谐波分析
1000小时高温老化试验怎么进行，高温老化试验怎么办理
实测数据分析 PCIe 4.0固态硬盘性能如何
某雷达天线方向图自动测试系统的软硬件原理详解
ESP32C3 LED PWM控制器的使用方法
提速降费政策更进一步 取消流量“漫游”费为5G铺路
对于VR技术，它到底是财富还是泡沫
可穿戴缺氧监控电路设计图
JD-BQX2便携式自动气象站技术参数有哪些
求一种基于51单片机的太阳能路灯控制系统设计方案
飞行试验颤振数据实时监控系统
使用CNN进行2D路径规划
InfraScan推出下一代手持式颅内血肿检测器
乐天移动将推出一种安全的基于AI的身份验证系统
工信部加快5G推进步伐！ 5G商用牌照到底会花落谁家？
运放补偿电容
冰箱十大排名_冰箱外壳发烫正常吗？冰箱有冰怎么办？冰箱怎样快速除臭？
关于ST-Link的实际编程和调试应用的场景分析
三星跳过4nm制程转向3nm制程量产，要真正反超台积电存在诸多挑战