从0学起的esp-idf之旅——外设篇ledc（led pwm）

官方例程详细注释

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/ledc.h"
#include "esp_err.h"

/*
 * 关于这个例子
 *
 * 1. 从初始化 LEDC 模块开始:
 *    a. 首先设置LEDC的定时器，这决定了PWM的频率和分辨率。
 *    b. 然后设置您要使用的 LEDC 通道，并与其中一个定时器进行绑定。
 *
 * 2. 您需要先安装默认的渐变功能，然后才能使用渐变 API。
 *
 * 3. 您还可以直接设置目标占空比而不用渐变功能。
 *
 * 4. 本例使用 GPIO18/19/4/5 作为 LEDC 输出，它会反复改变占空比。
 * 	通过给这几个引脚接上led可以看到呼吸灯的效果
 *
 * 5. GPIO18/19 来自高速通道组。GPIO4/5 来自低速通道组。
 *    
 */
#define LEDC_HS_TIMER          LEDC_TIMER_0
#define LEDC_HS_MODE           LEDC_HIGH_SPEED_MODE
#define LEDC_HS_CH0_GPIO       (18)
#define LEDC_HS_CH0_CHANNEL    LEDC_CHANNEL_0
#define LEDC_HS_CH1_GPIO       (19)
#define LEDC_HS_CH1_CHANNEL    LEDC_CHANNEL_1
#define LEDC_LS_TIMER          LEDC_TIMER_1
#define LEDC_LS_MODE           LEDC_LOW_SPEED_MODE

#define LEDC_LS_CH2_GPIO       (4)
#define LEDC_LS_CH2_CHANNEL    LEDC_CHANNEL_2
#define LEDC_LS_CH3_GPIO       (5)
#define LEDC_LS_CH3_CHANNEL    LEDC_CHANNEL_3

#define LEDC_TEST_CH_NUM       (4)
#define LEDC_TEST_DUTY         (4000)
#define LEDC_TEST_FADE_TIME    (3000)

void app_main(void)
{
    int ch;

    /*
     * 设置LEDC的定时器的配置
     */
    ledc_timer_config_t ledc_timer_ls = {
        .duty_resolution = LEDC_TIMER_13_BIT, // 设置分辨率,最大为2^13-1
        .freq_hz = 5000,                      // PWM信号频率
        .speed_mode = LEDC_LS_MODE,           // 定时器模式（“高速”或“低速”）
        .timer_num = LEDC_LS_TIMER,            // 设置定时器源（0-3）
        .clk_cfg = LEDC_AUTO_CLK,              // 配置LEDC时钟源（这里是自动选择）
    };
    // 初始化ledc的定时器配置
    ledc_timer_config(&ledc_timer_hs);
    ledc_timer_config_t ledc_timer_hs= {
        .duty_resolution = LEDC_TIMER_13_BIT, // 设置分辨率,最大为2^13-1
        .freq_hz = 5000,                      // PWM信号频率
        .speed_mode = LEDC_HS_MODE,           // 定时器模式（“高速”或“低速”）
        .timer_num = LEDC_HS_TIMER,            // 设置定时器源（0-3）
        .clk_cfg = LEDC_AUTO_CLK,              // 配置LEDC时钟源（这里是自动选择）
    };
    ledc_timer_config(&ledc_timer_hs);
    /*
     * 通过选择为 LEDC 控制器的每个通道准备单独的配置：
     * - 控制器的通道号
     * - 输出占空比，初始设置为 0
     * - LEDC 连接到的 GPIO 编号
     * - 速度模式，高或低
     * - 为LEDC通道指定定时器
     *   注意: 如果不同通道使用一个定时器，那么这些通道的频率和占空比分辨率将相同
     */
    ledc_channel_config_t ledc_channel[LEDC_TEST_CH_NUM] = {
        {
            .channel    = LEDC_HS_CH0_CHANNEL, 	// LEDC通道(0-7)
            .duty       = 0,					// 初始化占空比
            .gpio_num   = LEDC_HS_CH0_GPIO,		// pwm输出的gpio
            .speed_mode = LEDC_HS_MODE,			// 高速还是低速模式
            .hpoint     = 0,					// LEDC通道hpoint值
            .timer_sel  = LEDC_HS_TIMER			// LEDC依赖的定时器
        },
        {
            .channel    = LEDC_HS_CH1_CHANNEL,
            .duty       = 0,
            .gpio_num   = LEDC_HS_CH1_GPIO,
            .speed_mode = LEDC_HS_MODE,
            .hpoint     = 0,
            .timer_sel  = LEDC_HS_TIMER
        },
        {
            .channel    = LEDC_LS_CH2_CHANNEL,
            .duty       = 0,
            .gpio_num   = LEDC_LS_CH2_GPIO,
            .speed_mode = LEDC_LS_MODE,
            .hpoint     = 0,
            .timer_sel  = LEDC_LS_TIMER
        },
        {
            .channel    = LEDC_LS_CH3_CHANNEL,
            .duty       = 0,
            .gpio_num   = LEDC_LS_CH3_GPIO,
            .speed_mode = LEDC_LS_MODE,
            .hpoint     = 0,
            .timer_sel  = LEDC_LS_TIMER
        },
    };

    // 初始化ledc的通道
    for (ch = 0; ch < LEDC_TEST_CH_NUM; ch++) {
        ledc_channel_config(&ledc_channel[ch]);
    }

    // 安装渐变功能
    ledc_fade_func_install(0);

    while (1) {
        printf("1. LEDC fade up to duty = %d\n", LEDC_TEST_DUTY);
        for (ch = 0; ch < LEDC_TEST_CH_NUM; ch++) 
        {
        	// 设置LEDC渐变功能
            ledc_set_fade_with_time(ledc_channel[ch].speed_mode,ledc_channel[ch].channel, LEDC_TEST_DUTY, LEDC_TEST_FADE_TIME);
            // 开始执行渐变功能
            ledc_fade_start(ledc_channel[ch].speed_mode,ledc_channel[ch].channel, LEDC_FADE_NO_WAIT);
        }
        vTaskDelay(LEDC_TEST_FADE_TIME / portTICK_PERIOD_MS);

        printf("2. LEDC fade down to duty = 0\n");
        for (ch = 0; ch < LEDC_TEST_CH_NUM; ch++) 
        {
        	// 设置LEDC占空比渐变到0									
            ledc_set_fade_with_time(ledc_channel[ch].speed_mode,ledc_channel[ch].channel, 0, LEDC_TEST_FADE_TIME);
            ledc_fade_start(ledc_channel[ch].speed_mode,ledc_channel[ch].channel, LEDC_FADE_NO_WAIT);
        }
        vTaskDelay(LEDC_TEST_FADE_TIME / portTICK_PERIOD_MS);

        printf("3. LEDC set duty = %d without fade\n", LEDC_TEST_DUTY);
        for (ch = 0; ch < LEDC_TEST_CH_NUM; ch++) 
        {
        	// 直接改变占空比
            ledc_set_duty(ledc_channel[ch].speed_mode, ledc_channel[ch].channel, LEDC_TEST_DUTY);
            ledc_update_duty(ledc_channel[ch].speed_mode, ledc_channel[ch].channel);
        }
        vTaskDelay(1000 / portTICK_PERIOD_MS);

        printf("4. LEDC set duty = 0 without fade\n");
        for (ch = 0; ch < LEDC_TEST_CH_NUM; ch++) 
        {
            ledc_set_duty(ledc_channel[ch].speed_mode, ledc_channel[ch].channel, 0);
            ledc_update_duty(ledc_channel[ch].speed_mode, ledc_channel[ch].channel);
        }
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

注意

关于这个pwm，乐鑫搞出了两个。led pwm区别于mcpwm，一个是用于ledc的简单的pwm生成器，另一个mcpwm则是用于电机的pwm生成器，分别对两种不同的情况有着不同的优化。比如led pwm中就加入了渐变的功能，可以方便的制作呼吸灯。频率越高，分别率也就越低。这个看个人需要去配置，乐鑫最高支持 40 MHz的pwm，但是只能实现百分之50占空比的方波，也就是duty_resolution = 2^1-1。官方的例子中支持了esp32c3和esp32s2导致代码比较多，这里做了删减只支持eps32

解析官方例子

整个过程基本就是先配置底层的定时器，然后配置通道，最后如果需要渐变的功能就安装渐变功能的驱动。然后就进行整体的调用，整个代码用到了宏，关键的信息我们可以通过宏去直接修改。这里对于他的通道还有个疑问就是hpoint是什么？

这里是官方手册里的图上面的一直上升的信号指的是定时器，定时器一直递增的基数，计数到溢出。这里hpoint指的是一个周期内上升沿的时间点。通过占空比和hpoint实际上lpoint是能算出来的，故没有接口去设置，实际上在大多数情况下一个周期内什么时候开始上升沿并不重要。所以一般情况都是0。

总结

相关官方资料

ledc例程：https://github.com/espressif/esp-idf/tree/release/v4.3/examples/peripherals/ledc
ledc相关：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/api-reference/peripherals/ledc.html
技术参考手册：https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_cn.pdf