From d488bb7bacca80e6089bdf070bb1e10324d31dbb Mon Sep 17 00:00:00 2001 From: krzychb Date: Mon, 23 Oct 2017 05:32:47 +0200 Subject: [PATCH] Provided more meaningful parameter names by renaming 'bit_num' to 'duty_resolution' and 'div_num' to 'clock_divider' --- components/driver/include/driver/ledc.h | 105 +++++++++--------- components/driver/ledc.c | 56 +++++----- .../soc/esp32/include/soc/ledc_struct.h | 12 +- docs/_static/ledc-api-settings.jpg | Bin 28623 -> 28910 bytes docs/api-reference/peripherals/ledc.rst | 28 ++--- .../peripherals/ledc/main/ledc_example_main.c | 8 +- .../peripherals/pcnt/main/pcnt_example_main.c | 8 +- 7 files changed, 109 insertions(+), 108 deletions(-) diff --git a/components/driver/include/driver/ledc.h b/components/driver/include/driver/ledc.h index 55c0c8d2a..f004ae64a 100644 --- a/components/driver/include/driver/ledc.h +++ b/components/driver/include/driver/ledc.h @@ -30,7 +30,7 @@ extern "C" { typedef enum { LEDC_HIGH_SPEED_MODE = 0, /*!< LEDC high speed speed_mode */ - LEDC_LOW_SPEED_MODE, /*!< LEDC low speed speed_mode */ + LEDC_LOW_SPEED_MODE, /*!< LEDC low speed speed_mode */ LEDC_SPEED_MODE_MAX, /*!< LEDC speed limit */ } ledc_mode_t; @@ -45,15 +45,15 @@ typedef enum { } ledc_duty_direction_t; typedef enum { - LEDC_REF_TICK = 0, /*!< LEDC timer clock divided from reference tick(1Mhz) */ - LEDC_APB_CLK, /*!< LEDC timer clock divided from APB clock(80Mhz)*/ + LEDC_REF_TICK = 0, /*!< LEDC timer clock divided from reference tick (1Mhz) */ + LEDC_APB_CLK, /*!< LEDC timer clock divided from APB clock (80Mhz) */ } ledc_clk_src_t; typedef enum { - LEDC_TIMER_0 = 0, /*!< LEDC source timer TIMER0 */ - LEDC_TIMER_1, /*!< LEDC source timer TIMER1 */ - LEDC_TIMER_2, /*!< LEDC source timer TIMER2 */ - LEDC_TIMER_3, /*!< LEDC source timer TIMER3 */ + LEDC_TIMER_0 = 0, /*!< LEDC timer 0 */ + LEDC_TIMER_1, /*!< LEDC timer 1 */ + LEDC_TIMER_2, /*!< LEDC timer 2 */ + LEDC_TIMER_3, /*!< LEDC timer 3 */ } ledc_timer_t; typedef enum { @@ -69,46 +69,47 @@ typedef enum { } ledc_channel_t; typedef enum { - LEDC_TIMER_10_BIT = 10, /*!< LEDC PWM depth 10Bit */ - LEDC_TIMER_11_BIT = 11, /*!< LEDC PWM depth 11Bit */ - LEDC_TIMER_12_BIT = 12, /*!< LEDC PWM depth 12Bit */ - LEDC_TIMER_13_BIT = 13, /*!< LEDC PWM depth 13Bit */ - LEDC_TIMER_14_BIT = 14, /*!< LEDC PWM depth 14Bit */ - LEDC_TIMER_15_BIT = 15, /*!< LEDC PWM depth 15Bit */ + LEDC_TIMER_10_BIT = 10, /*!< LEDC PWM duty resolution of 10 bits */ + LEDC_TIMER_11_BIT = 11, /*!< LEDC PWM duty resolution of 11 bits */ + LEDC_TIMER_12_BIT = 12, /*!< LEDC PWM duty resolution of 12 bits */ + LEDC_TIMER_13_BIT = 13, /*!< LEDC PWM duty resolution of 13 bits */ + LEDC_TIMER_14_BIT = 14, /*!< LEDC PWM duty resolution of 14 bits */ + LEDC_TIMER_15_BIT = 15, /*!< LEDC PWM duty resolution of 15 bits */ } ledc_timer_bit_t; typedef enum { LEDC_FADE_NO_WAIT = 0, /*!< LEDC fade function will return immediately */ - LEDC_FADE_WAIT_DONE, /*!< LEDC fade function will block until fading to the target duty*/ + LEDC_FADE_WAIT_DONE, /*!< LEDC fade function will block until fading to the target duty */ LEDC_FADE_MAX, } ledc_fade_mode_t; + /** * @brief Configuration parameters of LEDC channel for ledc_channel_config function */ typedef struct { - int gpio_num; /*!< the LEDC output gpio_num, if you want to use gpio16, gpio_num = 16*/ - ledc_mode_t speed_mode; /*!< LEDC speed speed_mode, high-speed mode or low-speed mode*/ - ledc_channel_t channel; /*!< LEDC channel(0 - 7)*/ - ledc_intr_type_t intr_type; /*!< configure interrupt, Fade interrupt enable or Fade interrupt disable*/ - ledc_timer_t timer_sel; /*!< Select the timer source of channel (0 - 3)*/ - uint32_t duty; /*!< LEDC channel duty, the duty range is [0, (2**bit_num) - 1], */ + int gpio_num; /*!< the LEDC output gpio_num, if you want to use gpio16, gpio_num = 16 */ + ledc_mode_t speed_mode; /*!< LEDC speed speed_mode, high-speed mode or low-speed mode */ + ledc_channel_t channel; /*!< LEDC channel (0 - 7) */ + ledc_intr_type_t intr_type; /*!< configure interrupt, Fade interrupt enable or Fade interrupt disable */ + ledc_timer_t timer_sel; /*!< Select the timer source of channel (0 - 3) */ + uint32_t duty; /*!< LEDC channel duty, the range of duty setting is [0, (2**duty_resolution) - 1] */ } ledc_channel_config_t; /** * @brief Configuration parameters of LEDC Timer timer for ledc_timer_config function */ typedef struct { - ledc_mode_t speed_mode; /*!< LEDC speed speed_mode, high-speed mode or low-speed mode*/ - ledc_timer_bit_t bit_num; /*!< LEDC channel duty depth*/ - ledc_timer_t timer_num; /*!< The timer source of channel (0 - 3)*/ - uint32_t freq_hz; /*!< LEDC timer frequency(Hz)*/ + ledc_mode_t speed_mode; /*!< LEDC speed speed_mode, high-speed mode or low-speed mode */ + ledc_timer_bit_t duty_resolution; /*!< LEDC channel duty resolution */ + ledc_timer_t timer_num; /*!< The timer source of channel (0 - 3) */ + uint32_t freq_hz; /*!< LEDC timer frequency (Hz) */ } ledc_timer_config_t; typedef intr_handle_t ledc_isr_handle_t; /** * @brief LEDC channel configuration - * Configure LEDC channel with the given channel/output gpio_num/interrupt/source timer/frequency(Hz)/LEDC depth + * Configure LEDC channel with the given channel/output gpio_num/interrupt/source timer/frequency(Hz)/LEDC duty resolution * * @param ledc_conf Pointer of LEDC channel configure struct * @@ -120,14 +121,14 @@ esp_err_t ledc_channel_config(const ledc_channel_config_t* ledc_conf); /** * @brief LEDC timer configuration - * Configure LEDC timer with the given source timer/frequency(Hz)/bit_num + * Configure LEDC timer with the given source timer/frequency(Hz)/duty_resolution * * @param timer_conf Pointer of LEDC timer configure struct * * @return * - ESP_OK Success * - ESP_ERR_INVALID_ARG Parameter error - * - ESP_FAIL Can not find a proper pre-divider number base on the given frequency and the current bit_num. + * - ESP_FAIL Can not find a proper pre-divider number base on the given frequency and the current duty_resolution. */ esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf); @@ -137,7 +138,7 @@ esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf); * After ledc_set_duty, ledc_set_fade, we need to call this function to update the settings. * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, - * @param channel LEDC channel(0-7), select from ledc_channel_t + * @param channel LEDC channel (0-7), select from ledc_channel_t * * @return * - ESP_OK Success @@ -151,7 +152,7 @@ esp_err_t ledc_update_duty(ledc_mode_t speed_mode, ledc_channel_t channel); * Disable LEDC output, and set idle level * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param channel LEDC channel(0-7), select from ledc_channel_t + * @param channel LEDC channel (0-7), select from ledc_channel_t * @param idle_level Set output idle level after LEDC stops. * * @return @@ -161,24 +162,24 @@ esp_err_t ledc_update_duty(ledc_mode_t speed_mode, ledc_channel_t channel); esp_err_t ledc_stop(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t idle_level); /** - * @brief LEDC set channel frequency(Hz) + * @brief LEDC set channel frequency (Hz) * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_num LEDC timer index(0-3), select from ledc_timer_t + * @param timer_num LEDC timer index (0-3), select from ledc_timer_t * @param freq_hz Set the LEDC frequency * * @return * - ESP_OK Success * - ESP_ERR_INVALID_ARG Parameter error - * - ESP_FAIL Can not find a proper pre-divider number base on the given frequency and the current bit_num. + * - ESP_FAIL Can not find a proper pre-divider number base on the given frequency and the current duty_resolution. */ esp_err_t ledc_set_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num, uint32_t freq_hz); /** - * @brief LEDC get channel frequency(Hz) + * @brief LEDC get channel frequency (Hz) * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_num LEDC timer index(0-3), select from ledc_timer_t + * @param timer_num LEDC timer index (0-3), select from ledc_timer_t * * @return * - 0 error @@ -191,8 +192,8 @@ uint32_t ledc_get_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num); * Only after calling ledc_update_duty will the duty update. * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param channel LEDC channel(0-7), select from ledc_channel_t - * @param duty Set the LEDC duty, the duty range is [0, (2**bit_num) - 1] + * @param channel LEDC channel (0-7), select from ledc_channel_t + * @param duty Set the LEDC duty, the range of duty setting is [0, (2**duty_resolution) - 1] * * @return * - ESP_OK Success @@ -204,7 +205,7 @@ esp_err_t ledc_set_duty(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t * @brief LEDC get duty * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param channel LEDC channel(0-7), select from ledc_channel_t + * @param channel LEDC channel (0-7), select from ledc_channel_t * * @return * - LEDC_ERR_DUTY if parameter error @@ -217,8 +218,8 @@ uint32_t ledc_get_duty(ledc_mode_t speed_mode, ledc_channel_t channel); * Set LEDC gradient, After the function calls the ledc_update_duty function, the function can take effect. * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param channel LEDC channel(0-7), select from ledc_channel_t - * @param duty Set the start of the gradient duty, the duty range is [0, (2**bit_num) - 1] + * @param channel LEDC channel (0-7), select from ledc_channel_t + * @param duty Set the start of the gradient duty, the range of duty setting is [0, (2**duty_resolution) - 1] * @param gradule_direction Set the direction of the gradient * @param step_num Set the number of the gradient * @param duty_cyle_num Set how many LEDC tick each time the gradient lasts @@ -253,22 +254,22 @@ esp_err_t ledc_isr_register(void (*fn)(void*), void * arg, int intr_alloc_flags, * @brief Configure LEDC settings * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_sel Timer index(0-3), there are 4 timers in LEDC module - * @param div_num Timer clock divide number, the timer clock is divided from the selected clock source - * @param bit_num The count number of one period, counter range is 0 ~ ((2 ** bit_num) - 1) + * @param timer_sel Timer index (0-3), there are 4 timers in LEDC module + * @param clock_divider Timer clock divide value, the timer clock is divided from the selected clock source + * @param duty_resolution Resolution of duty setting in number of bits. The range of duty values is [0, (2**duty_resolution) - 1] * @param clk_src Select LEDC source clock. * * @return * - (-1) Parameter error * - Other Current LEDC duty */ -esp_err_t ledc_timer_set(ledc_mode_t speed_mode, ledc_timer_t timer_sel, uint32_t div_num, uint32_t bit_num, ledc_clk_src_t clk_src); +esp_err_t ledc_timer_set(ledc_mode_t speed_mode, ledc_timer_t timer_sel, uint32_t clock_divider, uint32_t duty_resolution, ledc_clk_src_t clk_src); /** * @brief Reset LEDC timer * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_sel LEDC timer index(0-3), select from ledc_timer_t + * @param timer_sel LEDC timer index (0-3), select from ledc_timer_t * * @return * - ESP_ERR_INVALID_ARG Parameter error @@ -280,7 +281,7 @@ esp_err_t ledc_timer_rst(ledc_mode_t speed_mode, uint32_t timer_sel); * @brief Pause LEDC timer counter * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_sel LEDC timer index(0-3), select from ledc_timer_t + * @param timer_sel LEDC timer index (0-3), select from ledc_timer_t * * @return * - ESP_ERR_INVALID_ARG Parameter error @@ -293,7 +294,7 @@ esp_err_t ledc_timer_pause(ledc_mode_t speed_mode, uint32_t timer_sel); * @brief Resume LEDC timer * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param timer_sel LEDC timer index(0-3), select from ledc_timer_t + * @param timer_sel LEDC timer index (0-3), select from ledc_timer_t * * @return * - ESP_ERR_INVALID_ARG Parameter error @@ -305,8 +306,8 @@ esp_err_t ledc_timer_resume(ledc_mode_t speed_mode, uint32_t timer_sel); * @brief Bind LEDC channel with the selected timer * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode - * @param channel LEDC channel index(0-7), select from ledc_channel_t - * @param timer_idx LEDC timer index(0-3), select from ledc_timer_t + * @param channel LEDC channel index (0-7), select from ledc_channel_t + * @param timer_idx LEDC timer index (0-3), select from ledc_timer_t * * @return * - ESP_ERR_INVALID_ARG Parameter error @@ -319,8 +320,8 @@ esp_err_t ledc_bind_channel_timer(ledc_mode_t speed_mode, uint32_t channel, uint * Call ledc_fade_start() after this to start fading. * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, - * @param channel LEDC channel index(0-7), select from ledc_channel_t - * @param target_duty Target duty of fading.( 0 - (2 ** bit_num - 1))) + * @param channel LEDC channel index (0-7), select from ledc_channel_t + * @param target_duty Target duty of fading [0, (2**duty_resolution) - 1] * @param scale Controls the increase or decrease step scale. * @param cycle_num increase or decrease the duty every cycle_num cycles * @@ -337,8 +338,8 @@ esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel * Call ledc_fade_start() after this to start fading. * * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, - * @param channel LEDC channel index(0-7), select from ledc_channel_t - * @param target_duty Target duty of fading.( 0 - (2 ** bit_num - 1))) + * @param channel LEDC channel index (0-7), select from ledc_channel_t + * @param target_duty Target duty of fading.( 0 - (2 ** duty_resolution - 1))) * @param max_fade_time_ms The maximum time of the fading ( ms ). * * @return diff --git a/components/driver/ledc.c b/components/driver/ledc.c index 309ea63c7..49b9e1ecf 100644 --- a/components/driver/ledc.c +++ b/components/driver/ledc.c @@ -74,15 +74,15 @@ static IRAM_ATTR void ledc_ls_channel_update(ledc_mode_t speed_mode, ledc_channe } } -esp_err_t ledc_timer_set(ledc_mode_t speed_mode, ledc_timer_t timer_sel, uint32_t div_num, uint32_t bit_num, +esp_err_t ledc_timer_set(ledc_mode_t speed_mode, ledc_timer_t timer_sel, uint32_t clock_divider, uint32_t duty_resolution, ledc_clk_src_t clk_src) { LEDC_CHECK(speed_mode < LEDC_SPEED_MODE_MAX, LEDC_MODE_ERR_STR, ESP_ERR_INVALID_ARG); LEDC_CHECK(timer_sel <= LEDC_TIMER_3, LEDC_TIMER_ERR_STR, ESP_ERR_INVALID_ARG); portENTER_CRITICAL(&ledc_spinlock); - LEDC.timer_group[speed_mode].timer[timer_sel].conf.div_num = div_num; + LEDC.timer_group[speed_mode].timer[timer_sel].conf.clock_divider = clock_divider; LEDC.timer_group[speed_mode].timer[timer_sel].conf.tick_sel = clk_src; - LEDC.timer_group[speed_mode].timer[timer_sel].conf.bit_num = bit_num; + LEDC.timer_group[speed_mode].timer[timer_sel].conf.duty_resolution = duty_resolution; ledc_ls_timer_update(speed_mode, timer_sel); portEXIT_CRITICAL(&ledc_spinlock); return ESP_OK; @@ -183,13 +183,13 @@ esp_err_t ledc_isr_register(void (*fn)(void*), void * arg, int intr_alloc_flags, esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf) { int freq_hz = timer_conf->freq_hz; - int bit_num = timer_conf->bit_num; + int duty_resolution = timer_conf->duty_resolution; int timer_num = timer_conf->timer_num; int speed_mode = timer_conf->speed_mode; LEDC_CHECK(speed_mode < LEDC_SPEED_MODE_MAX, LEDC_MODE_ERR_STR, ESP_ERR_INVALID_ARG); periph_module_enable(PERIPH_LEDC_MODULE); - if (freq_hz == 0 || bit_num == 0 || bit_num > LEDC_TIMER_15_BIT) { - ESP_LOGE(LEDC_TAG, "freq_hz=%u bit_num=%u", freq_hz, bit_num); + if (freq_hz == 0 || duty_resolution == 0 || duty_resolution > LEDC_TIMER_15_BIT) { + ESP_LOGE(LEDC_TAG, "freq_hz=%u duty_resolution=%u", freq_hz, duty_resolution); return ESP_ERR_INVALID_ARG; } if (timer_num > LEDC_TIMER_3) { @@ -197,14 +197,14 @@ esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf) return ESP_ERR_INVALID_ARG; } esp_err_t ret = ESP_OK; - uint32_t precision = ( 0x1 << bit_num ); // 2**depth + uint32_t precision = ( 0x1 << duty_resolution ); // 2**depth // Try calculating divisor based on LEDC_APB_CLK ledc_clk_src_t timer_clk_src = LEDC_APB_CLK; // div_param is a Q10.8 fixed point value uint64_t div_param = ( (uint64_t) LEDC_APB_CLK_HZ << 8 ) / freq_hz / precision; if (div_param < 256) { // divisor is too low - ESP_LOGE(LEDC_TAG, "requested frequency and bit depth can not be achieved, try reducing freq_hz or bit_num. div_param=%d", + ESP_LOGE(LEDC_TAG, "requested frequency and duty resolution can not be achieved, try reducing freq_hz or duty_resolution. div_param=%d", (uint32_t ) div_param); ret = ESP_FAIL; } @@ -213,7 +213,7 @@ esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf) timer_clk_src = LEDC_REF_TICK; div_param = ((uint64_t) LEDC_REF_CLK_HZ << 8) / freq_hz / precision; if (div_param < 256 || div_param > LEDC_DIV_NUM_HSTIMER0_V) { - ESP_LOGE(LEDC_TAG, "requested frequency and bit depth can not be achieved, try increasing freq_hz or bit_num. div_param=%d", + ESP_LOGE(LEDC_TAG, "requested frequency and duty resolution can not be achieved, try increasing freq_hz or duty_resolution. div_param=%d", (uint32_t ) div_param); ret = ESP_FAIL; } @@ -224,7 +224,7 @@ esp_err_t ledc_timer_config(const ledc_timer_config_t* timer_conf) } } // set timer parameters - ledc_timer_set(speed_mode, timer_num, div_param, bit_num, timer_clk_src); + ledc_timer_set(speed_mode, timer_num, div_param, duty_resolution, timer_clk_src); // reset timer ledc_timer_rst(speed_mode, timer_num); return ret; @@ -261,7 +261,7 @@ esp_err_t ledc_channel_config(const ledc_channel_config_t* ledc_conf) esp_err_t ret = ESP_OK; /*set channel parameters*/ /* channel parameters decide how the waveform looks like in one period*/ - /* set channel duty, duty range is (0 ~ ((2 ** bit_num) - 1))*/ + /* set channel duty, duty range is (0 ~ ((2 ** duty_resolution) - 1))*/ ledc_set_duty(speed_mode, ledc_channel, duty); /*update duty settings*/ ledc_update_duty(speed_mode, ledc_channel); @@ -364,20 +364,20 @@ esp_err_t ledc_set_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num, uint32_t LEDC_CHECK(speed_mode < LEDC_SPEED_MODE_MAX, LEDC_MODE_ERR_STR, ESP_ERR_INVALID_ARG); portENTER_CRITICAL(&ledc_spinlock); esp_err_t ret = ESP_OK; - uint32_t div_num = 0; - uint32_t bit_num = LEDC.timer_group[speed_mode].timer[timer_num].conf.bit_num; + uint32_t clock_divider = 0; + uint32_t duty_resolution = LEDC.timer_group[speed_mode].timer[timer_num].conf.duty_resolution; uint32_t timer_source_clk = LEDC.timer_group[speed_mode].timer[timer_num].conf.tick_sel; - uint32_t precision = (0x1 << bit_num); + uint32_t precision = (0x1 << duty_resolution); if (timer_source_clk == LEDC_APB_CLK) { - div_num = ((uint64_t) LEDC_APB_CLK_HZ << 8) / freq_hz / precision; + clock_divider = ((uint64_t) LEDC_APB_CLK_HZ << 8) / freq_hz / precision; } else { - div_num = ((uint64_t) LEDC_REF_CLK_HZ << 8) / freq_hz / precision; + clock_divider = ((uint64_t) LEDC_REF_CLK_HZ << 8) / freq_hz / precision; } - if (div_num <= 256 || div_num > LEDC_DIV_NUM_HSTIMER0) { - ESP_LOGE(LEDC_TAG, "div param err,div_param=%u", div_num); + if (clock_divider <= 256 || clock_divider > LEDC_DIV_NUM_HSTIMER0) { + ESP_LOGE(LEDC_TAG, "div param err,div_param=%u", clock_divider); ret = ESP_FAIL; } - LEDC.timer_group[speed_mode].timer[timer_num].conf.div_num = div_num; + LEDC.timer_group[speed_mode].timer[timer_num].conf.clock_divider = clock_divider; portEXIT_CRITICAL(&ledc_spinlock); return ret; } @@ -388,13 +388,13 @@ uint32_t ledc_get_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num) portENTER_CRITICAL(&ledc_spinlock); uint32_t freq = 0; uint32_t timer_source_clk = LEDC.timer_group[speed_mode].timer[timer_num].conf.tick_sel; - uint32_t bit_num = LEDC.timer_group[speed_mode].timer[timer_num].conf.bit_num; - uint32_t div_num = LEDC.timer_group[speed_mode].timer[timer_num].conf.div_num; - uint32_t precision = (0x1 << bit_num); + uint32_t duty_resolution = LEDC.timer_group[speed_mode].timer[timer_num].conf.duty_resolution; + uint32_t clock_divider = LEDC.timer_group[speed_mode].timer[timer_num].conf.clock_divider; + uint32_t precision = (0x1 << duty_resolution); if (timer_source_clk == LEDC_APB_CLK) { - freq = ((uint64_t) LEDC_APB_CLK_HZ << 8) / precision / div_num; + freq = ((uint64_t) LEDC_APB_CLK_HZ << 8) / precision / clock_divider; } else { - freq = ((uint64_t) LEDC_REF_CLK_HZ << 8) / precision / div_num; + freq = ((uint64_t) LEDC_REF_CLK_HZ << 8) / precision / clock_divider; } portEXIT_CRITICAL(&ledc_spinlock); return freq; @@ -504,7 +504,7 @@ esp_err_t ledc_set_fade_with_time(ledc_mode_t speed_mode, ledc_channel_t channel LEDC_CHECK(ledc_fade_channel_init_check(speed_mode, channel) == ESP_OK , LEDC_FADE_INIT_ERROR_STR, ESP_FAIL); int timer_sel = LEDC.channel_group[speed_mode].channel[channel].conf0.timer_sel; - uint32_t max_duty = (1 << (LEDC.timer_group[speed_mode].timer[timer_sel].conf.bit_num)) - 1; + uint32_t max_duty = (1 << (LEDC.timer_group[speed_mode].timer[timer_sel].conf.duty_resolution)) - 1; LEDC_CHECK(target_duty <= max_duty, LEDC_FADE_TARGET_ERR_STR, ESP_ERR_INVALID_ARG); uint32_t freq = ledc_get_freq(speed_mode, timer_sel); uint32_t duty_cur = LEDC.channel_group[speed_mode].channel[channel].duty_rd.duty_read >> LEDC_DUTY_DECIMAL_BIT_NUM; @@ -535,7 +535,7 @@ esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel LEDC_CHECK(ledc_fade_channel_init_check(speed_mode, channel) == ESP_OK , LEDC_FADE_INIT_ERROR_STR, ESP_FAIL); int timer_sel = LEDC.channel_group[speed_mode].channel[channel].conf0.timer_sel; - uint32_t max_duty = (1 << (LEDC.timer_group[speed_mode].timer[timer_sel].conf.bit_num)) - 1; + uint32_t max_duty = (1 << (LEDC.timer_group[speed_mode].timer[timer_sel].conf.duty_resolution)) - 1; LEDC_CHECK(target_duty <= max_duty, LEDC_FADE_TARGET_ERR_STR, ESP_ERR_INVALID_ARG); //disable the interrupt, so the operation will not mess up ledc_enable_intr_type(speed_mode, channel, LEDC_INTR_DISABLE); @@ -579,8 +579,8 @@ esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel s_ledc_fade_rec[speed_mode][channel]->cycle_num, s_ledc_fade_rec[speed_mode][channel]->scale ); - int bit_num_ch0 = (speed_mode == LEDC_HIGH_SPEED_MODE) ? LEDC_DUTY_CHNG_END_HSCH0_INT_ENA_S : LEDC_DUTY_CHNG_END_LSCH0_INT_ENA_S; - LEDC.int_clr.val |= BIT(bit_num_ch0 + channel); + int duty_resolution_ch0 = (speed_mode == LEDC_HIGH_SPEED_MODE) ? LEDC_DUTY_CHNG_END_HSCH0_INT_ENA_S : LEDC_DUTY_CHNG_END_LSCH0_INT_ENA_S; + LEDC.int_clr.val |= BIT(duty_resolution_ch0 + channel); ledc_enable_intr_type(speed_mode, channel, LEDC_INTR_FADE_END); return ESP_OK; } diff --git a/components/soc/esp32/include/soc/ledc_struct.h b/components/soc/esp32/include/soc/ledc_struct.h index dd3c364bd..f90c3cb9d 100644 --- a/components/soc/esp32/include/soc/ledc_struct.h +++ b/components/soc/esp32/include/soc/ledc_struct.h @@ -69,13 +69,13 @@ typedef volatile struct { struct { union { struct { - uint32_t bit_num: 5; /*This register controls the range of the counter in high speed timer. the counter range is [0 2**reg_hstimer0_lim] the max bit width for counter is 20.*/ - uint32_t div_num: 18; /*This register is used to configure parameter for divider in high speed timer the least significant eight bits represent the decimal part.*/ - uint32_t pause: 1; /*This bit is used to pause the counter in high speed timer*/ - uint32_t rst: 1; /*This bit is used to reset high speed timer the counter will be 0 after reset.*/ - uint32_t tick_sel: 1; /*This bit is used to choose apb_clk or ref_tick for high speed timer. 1'b1:apb_clk 0:ref_tick*/ + uint32_t duty_resolution: 5; /*This register controls resolution of PWN duty by defining the bith width of timer's counter. The max bit width of the counter is 20.*/ + uint32_t clock_divider: 18; /*This register is used to configure the divider of clock at the entry of timer. The least significant eight bits represent the decimal part.*/ + uint32_t pause: 1; /*This bit is used to pause the counter in high speed timer*/ + uint32_t rst: 1; /*This bit is used to reset high speed timer the counter will be 0 after reset.*/ + uint32_t tick_sel: 1; /*This bit is used to choose apb_clk or ref_tick for high speed timer. 1'b1:apb_clk 0:ref_tick*/ uint32_t low_speed_update: 1; /*This bit is only useful for low speed timer channels, reserved for high speed timers*/ - uint32_t reserved26: 5; + uint32_t reserved26: 5; }; uint32_t val; } conf; diff --git a/docs/_static/ledc-api-settings.jpg b/docs/_static/ledc-api-settings.jpg index 06c0b10ad9920f14233f34b47d2e9c117325fcbb..92f0545ab194624bf128a0fa9c7ece27b43c5d2b 100644 GIT binary patch delta 25869 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 delta 25661 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 diff --git a/docs/api-reference/peripherals/ledc.rst b/docs/api-reference/peripherals/ledc.rst index a92b07af7..9b22f1b5d 100644 --- a/docs/api-reference/peripherals/ledc.rst +++ b/docs/api-reference/peripherals/ledc.rst @@ -38,9 +38,9 @@ Configure Timer Setting of the timer is done by calling function :cpp:func:`ledc_timer_config`. This function should be provided with a data structure :cpp:type:`ledc_timer_config_t` that contains the following configuration settings: * The timer number :cpp:type:`ledc_timer_t` and a speed mode :cpp:type:`ledc_mode_t`. - * The PWM signal's frequency and a "bit number". The later represents a resolution of PWM's duty value changes. + * The PWM signal's frequency and resolution of PWM's duty value changes. -The frequency and the bit values are interdependent. The higher the PWM frequency, the lower bit number is available and vice versa. This relationship may became important, if you are planning to use this API for purposes other that changing intensity of LEDs. Check section :ref:`ledc-api-supported-range-frequency-bit-number` for more details. +The frequency and the duty resolution are interdependent. The higher the PWM frequency, the lower duty resolution is available and vice versa. This relationship may became important, if you are planning to use this API for purposes other that changing intensity of LEDs. Check section :ref:`ledc-api-supported-range-frequency-duty-resolution` for more details. .. _ledc-api-configure-channel: @@ -70,7 +70,7 @@ Setting of the duty is done by first calling dedicated function :cpp:func:`ledc_ Another way to set the duty, and some other channel parameters as well, is by calling :cpp:func:`ledc_channel_config` discussed in the previous section. -The range of the duty value entered into functions depends on selected bit number (`` bit_num``) and should be from 0 to (2 ** bit_num) - 1. For example, if selected bit number is 10, then the duty range is from 0 to 1023. This provides the duty resolution of ~0.1%. +The range of the duty value entered into functions depends on selected ``duty_resolution`` and should be from 0 to (2 ** duty_resolution) - 1. For example, if selected duty resolution is 10, then the duty range is from 0 to 1023. This provides the resolution of ~0.1%. Change PWM Duty with Hardware Fading @@ -96,7 +96,7 @@ The LEDC API provides several means to change the PWM frequency "on the fly". * One of options is to call :cpp:func:`ledc_set_freq`. There is a corresponding function :cpp:func:`ledc_get_freq` to check what frequency is currently set. - * Another option to change the frequency, and the bit number as well, is by calling :cpp:func:`ledc_bind_channel_timer` to bind other timer to the channel. + * Another option to change the frequency, and the duty resolution as well, is by calling :cpp:func:`ledc_bind_channel_timer` to bind other timer to the channel. * Finally the channel's timer may be changed by calling :cpp:func:`ledc_channel_config`. @@ -134,32 +134,32 @@ The advantage of the high speed mode is h/w supported, glitch-free changeover of For additional details regarding speed modes please refer to `ESP32 Technical Reference Manual `_ (PDF). Note that support for ``SLOW_CLOCK`` mentioned in this manual is not implemented in the LEDC API. -.. _ledc-api-supported-range-frequency-bit-number: +.. _ledc-api-supported-range-frequency-duty-resolution: -Supported Range of Frequency and Bit Number -------------------------------------------- +Supported Range of Frequency and Duty Resolution +------------------------------------------------ -The LED PWM Controller is designed primarily to drive LEDs and provides wide resolution of PWM duty settings. The resolution (or granularity) of the PWM duty is determined by the "bit number". For instance for the PWM frequency at 5 kHz, the maximum bit number is 13 bits. It means that the duty may be set anywhere from 0 to 100% with resolution of ~0.012% (13 ** 2 = 8192 discrete levels of the LED intensity). +The LED PWM Controller is designed primarily to drive LEDs and provides wide resolution of PWM duty settings. For instance for the PWM frequency at 5 kHz, the maximum duty resolution is 13 bits. It means that the duty may be set anywhere from 0 to 100% with resolution of ~0.012% (13 ** 2 = 8192 discrete levels of the LED intensity). The LEDC may be used for providing signals at much higher frequencies to clock other devices, e.g. a digital camera module. In such a case the maximum available frequency is 40 MHz with duty resolution of 1 bit. This means that duty is fixed at 50% and cannot be adjusted. -The API is designed to report an error when trying to set a frequency and a bit number that is out of the range of LEDC's hardware. For example, an attempt to set the frequency at 20 MHz and the bit number of 3 bits will result in the following error reported on a serial monitor: +The API is designed to report an error when trying to set a frequency and a duty resolution that is out of the range of LEDC's hardware. For example, an attempt to set the frequency at 20 MHz and the duty resolution of 3 bits will result in the following error reported on a serial monitor: .. highlight:: none :: - E (196) ledc: requested frequency and bit number can not be achieved, try reducing freq_hz or bit_num. div_param=128 + E (196) ledc: requested frequency and duty resolution can not be achieved, try reducing freq_hz or duty_resolution. div_param=128 -In such a case either the bit number or the frequency should be reduced. For example setting the bit number at 2 will resolve this issue and provide possibility to set the duty with 25% steps, i.e. at 25%, 50% or 75%. +In such a case either the duty resolution or the frequency should be reduced. For example setting the duty resolution at 2 will resolve this issue and provide possibility to set the duty with 25% steps, i.e. at 25%, 50% or 75%. -The LEDC API will also capture and report an attempt to configure frequency / bit number combination that is below the supported minimum, e.g.: +The LEDC API will also capture and report an attempt to configure frequency / duty resolution combination that is below the supported minimum, e.g.: :: - E (196) ledc: requested frequency and bit depth can not be achieved, try increasing freq_hz or bit_num. div_param=128000000 + E (196) ledc: requested frequency and duty resolution can not be achieved, try increasing freq_hz or duty_resolution. div_param=128000000 -Setting of the bit number is normally done using :cpp:type:`ledc_timer_bit_t`. This enumeration covers the range from 10 to 15 bits. If a smaller bit number is required (below 10 down to 1), enter the equivalent numeric values directly. +Setting of the duty resolution is normally done using :cpp:type:`ledc_timer_bit_t`. This enumeration covers the range from 10 to 15 bits. If a smaller duty resolution is required (below 10 down to 1), enter the equivalent numeric values directly. Application Example diff --git a/examples/peripherals/ledc/main/ledc_example_main.c b/examples/peripherals/ledc/main/ledc_example_main.c index 9f5def1fd..05547fb20 100644 --- a/examples/peripherals/ledc/main/ledc_example_main.c +++ b/examples/peripherals/ledc/main/ledc_example_main.c @@ -60,10 +60,10 @@ void app_main() * that will be used by LED Controller */ ledc_timer_config_t ledc_timer = { - .bit_num = LEDC_TIMER_13_BIT, // resolution of PWM duty - .freq_hz = 5000, // frequency of PWM signal - .speed_mode = LEDC_HS_MODE, // timer mode - .timer_num = LEDC_HS_TIMER // timer index + .duty_resolution = LEDC_TIMER_13_BIT, // resolution of PWM duty + .freq_hz = 5000, // frequency of PWM signal + .speed_mode = LEDC_HS_MODE, // timer mode + .timer_num = LEDC_HS_TIMER // timer index }; // Set configuration of timer0 for high speed channels ledc_timer_config(&ledc_timer); diff --git a/examples/peripherals/pcnt/main/pcnt_example_main.c b/examples/peripherals/pcnt/main/pcnt_example_main.c index 68b36e45f..2a4b3695c 100644 --- a/examples/peripherals/pcnt/main/pcnt_example_main.c +++ b/examples/peripherals/pcnt/main/pcnt_example_main.c @@ -96,10 +96,10 @@ static void ledc_init(void) { // Prepare and then apply the LEDC PWM timer configuration ledc_timer_config_t ledc_timer; - ledc_timer.speed_mode = LEDC_HIGH_SPEED_MODE; - ledc_timer.timer_num = LEDC_TIMER_1; - ledc_timer.bit_num = LEDC_TIMER_10_BIT; - ledc_timer.freq_hz = 1; // set output frequency at 1 Hz + ledc_timer.speed_mode = LEDC_HIGH_SPEED_MODE; + ledc_timer.timer_num = LEDC_TIMER_1; + ledc_timer.duty_resolution = LEDC_TIMER_10_BIT; + ledc_timer.freq_hz = 1; // set output frequency at 1 Hz ledc_timer_config(&ledc_timer); // Prepare and then apply the LEDC PWM channel configuration