/* LEDC tested by PCNT in some case * PCNT can get the LEDC waveform frequency * * test environment of UT_T1_LEDC: * 1. connect GPIO18 with GPIO4 * 2. connect GPIO5 to 3.3v (in case of it is pulled down by default) * * some calculation related with duty: * real duty = duty/2^duty_resolution */ #include #include #include #include #include #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "freertos/semphr.h" #include "freertos/queue.h" #include "freertos/xtensa_api.h" #include "unity.h" #include "soc/ledc_periph.h" #include "esp_system.h" #include "driver/pcnt.h" #include "driver/ledc.h" #include "driver/gpio.h" #define PULSE_IO 18 #define PCNT_INPUT_IO 4 #define PCNT_CTRL_FLOATING_IO 5 #define HIGHEST_LIMIT 10000 #define LOWEST_LIMIT -10000 #ifdef CONFIG_IDF_TARGET_ESP32 #define TEST_SPEED_MODE LEDC_HIGH_SPEED_MODE #elif defined CONFIG_IDF_TARGET_ESP32S2 #define TEST_SPEED_MODE LEDC_LOW_SPEED_MODE #endif #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2) //no runners // use PCNT to test the waveform of LEDC static int16_t wave_count(int last_time) { int16_t test_counter; pcnt_config_t pcnt_config = { .pulse_gpio_num = PCNT_INPUT_IO, .ctrl_gpio_num = PCNT_CTRL_FLOATING_IO, .channel = PCNT_CHANNEL_0, .unit = PCNT_UNIT_0, .pos_mode = PCNT_COUNT_INC, .neg_mode = PCNT_COUNT_DIS, .lctrl_mode = PCNT_MODE_REVERSE, .hctrl_mode = PCNT_MODE_KEEP, .counter_h_lim = HIGHEST_LIMIT, .counter_l_lim = LOWEST_LIMIT, }; TEST_ESP_OK(pcnt_unit_config(&pcnt_config)); // initialize first TEST_ESP_OK(pcnt_counter_pause(PCNT_UNIT_0)); TEST_ESP_OK(pcnt_counter_clear(PCNT_UNIT_0)); vTaskDelay(100 / portTICK_RATE_MS); TEST_ESP_OK(pcnt_counter_resume(PCNT_UNIT_0)); TEST_ESP_OK(pcnt_get_counter_value(PCNT_UNIT_0, &test_counter)); vTaskDelay(last_time / portTICK_RATE_MS); TEST_ESP_OK(pcnt_get_counter_value(PCNT_UNIT_0, &test_counter)); return test_counter; } // the PCNT will count the frequency of it static void frequency_set_get(ledc_mode_t speed_mode, ledc_timer_t timer, uint32_t freq_hz, int16_t real_freq, int16_t error) { int16_t count; TEST_ESP_OK(ledc_set_freq(speed_mode, timer, freq_hz)); count = wave_count(1000); TEST_ASSERT_INT16_WITHIN(error, count, real_freq); TEST_ASSERT_EQUAL_INT32(ledc_get_freq(speed_mode, timer), real_freq); } static void timer_frequency_test(ledc_channel_t channel, ledc_timer_bit_t timer_bit, ledc_timer_t timer, ledc_mode_t speed_mode) { ledc_channel_config_t ledc_ch_config = { .gpio_num = PULSE_IO, .speed_mode = speed_mode, .channel = channel, .intr_type = LEDC_INTR_DISABLE, .timer_sel = timer, .duty = 4000, .hpoint = 0, }; ledc_timer_config_t ledc_time_config = { .speed_mode = speed_mode, .duty_resolution = timer_bit, .timer_num = timer, .freq_hz = 5000, .clk_cfg = LEDC_USE_APB_CLK, }; TEST_ESP_OK(ledc_channel_config(&ledc_ch_config)); TEST_ESP_OK(ledc_timer_config(&ledc_time_config)); frequency_set_get(ledc_ch_config.speed_mode, ledc_ch_config.timer_sel, 100, 100, 2); frequency_set_get(ledc_ch_config.speed_mode, ledc_ch_config.timer_sel, 5000, 5000, 5); frequency_set_get(ledc_ch_config.speed_mode, ledc_ch_config.timer_sel, 9000, 9025, 5); } static void fade_setup(void) { ledc_channel_config_t ledc_ch_config = { .gpio_num = PULSE_IO, .speed_mode = TEST_SPEED_MODE, .channel = LEDC_CHANNEL_0, .intr_type = LEDC_INTR_DISABLE, .timer_sel = LEDC_TIMER_0, .duty = 0, .hpoint = 0, }; ledc_timer_config_t ledc_time_config = { .speed_mode = TEST_SPEED_MODE, .duty_resolution = LEDC_TIMER_13_BIT, .timer_num = LEDC_TIMER_0, .freq_hz = 2000, .clk_cfg = LEDC_USE_APB_CLK, }; TEST_ESP_OK(ledc_channel_config(&ledc_ch_config)); TEST_ESP_OK(ledc_timer_config(&ledc_time_config)); vTaskDelay(5 / portTICK_PERIOD_MS); //initialize fade service TEST_ESP_OK(ledc_fade_func_install(0)); } static void timer_duty_set_get(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t duty) { TEST_ESP_OK(ledc_set_duty(speed_mode, channel, duty)); TEST_ESP_OK(ledc_update_duty(speed_mode, channel)); vTaskDelay(100 / portTICK_RATE_MS); TEST_ASSERT_EQUAL_INT32(duty, ledc_get_duty(speed_mode, channel)); } // use logic analyzer to view static void timer_duty_test(ledc_channel_t channel, ledc_timer_bit_t timer_bit, ledc_timer_t timer, ledc_mode_t speed_mode) { ledc_channel_config_t ledc_ch_config = { .gpio_num = PULSE_IO, .speed_mode = speed_mode, .channel = channel, .intr_type = LEDC_INTR_DISABLE, .timer_sel = timer, .duty = 4000, .hpoint = 0, }; ledc_timer_config_t ledc_time_config = { .speed_mode = speed_mode, .duty_resolution = timer_bit, .timer_num = timer, .freq_hz = 5000, .clk_cfg = LEDC_USE_APB_CLK, }; TEST_ESP_OK(ledc_channel_config(&ledc_ch_config)); TEST_ESP_OK(ledc_timer_config(&ledc_time_config)); // duty ratio: (2^duty)/(2^timer_bit) timer_duty_set_get(ledc_ch_config.speed_mode, ledc_ch_config.channel, 0); timer_duty_set_get(ledc_ch_config.speed_mode, ledc_ch_config.channel, 1); timer_duty_set_get(ledc_ch_config.speed_mode, ledc_ch_config.channel, 1 << 12); // 50% duty timer_duty_set_get(ledc_ch_config.speed_mode, ledc_ch_config.channel, (1 << 13) - 1); timer_duty_set_get(ledc_ch_config.speed_mode, ledc_ch_config.channel, (1 << 13) - 2); } TEST_CASE("LEDC error log channel and timer config", "[ledc][test_env=UT_T1_LEDC]") { #ifdef CONFIG_IDF_TARGET_ESP32 const ledc_mode_t test_speed_mode = LEDC_HIGH_SPEED_MODE; #elif defined CONFIG_IDF_TARGET_ESP32S2 const ledc_mode_t test_speed_mode = LEDC_LOW_SPEED_MODE; #endif //channel configuration test ledc_channel_config_t ledc_ch_config = { .gpio_num = PULSE_IO, .speed_mode = test_speed_mode, .channel = LEDC_CHANNEL_0, .intr_type = LEDC_INTR_DISABLE, .timer_sel = LEDC_TIMER_0, .duty = 4000, .hpoint = 0, }; // basic right parameter test ledc_channel_config_t temp_ch_config = ledc_ch_config; TEST_ESP_OK(ledc_channel_config(&ledc_ch_config)); // with wrong GPIO using ledc_ch_config.gpio_num = GPIO_NUM_MAX; TEST_ASSERT(ledc_channel_config(&ledc_ch_config) == ESP_ERR_INVALID_ARG); // with wrong speed ledc_ch_config = temp_ch_config; ledc_ch_config.speed_mode = LEDC_SPEED_MODE_MAX; TEST_ASSERT(ledc_channel_config(&ledc_ch_config) == ESP_ERR_INVALID_ARG); // with wrong channel ledc_ch_config = temp_ch_config; ledc_ch_config.channel = LEDC_CHANNEL_MAX; TEST_ASSERT(ledc_channel_config(&ledc_ch_config) == ESP_ERR_INVALID_ARG); // with wrong interruption type ledc_ch_config = temp_ch_config; ledc_ch_config.intr_type = 2; TEST_ASSERT_FALSE((void *)ledc_channel_config(&ledc_ch_config)); // with wrong timer ledc_ch_config = temp_ch_config; ledc_ch_config.timer_sel = 4; TEST_ASSERT(ledc_channel_config(&ledc_ch_config) == ESP_ERR_INVALID_ARG); ledc_ch_config = temp_ch_config; ledc_ch_config.duty = 12000; TEST_ASSERT_FALSE((void *)ledc_channel_config(&ledc_ch_config)); // timer configuration test ledc_timer_config_t ledc_time_config; ledc_time_config.speed_mode = test_speed_mode; ledc_time_config.duty_resolution = LEDC_TIMER_13_BIT; ledc_time_config.timer_num = LEDC_TIMER_0; ledc_time_config.freq_hz = 5000; ledc_time_config.clk_cfg = LEDC_USE_APB_CLK; ledc_timer_config_t temp_timer_config = ledc_time_config; TEST_ESP_OK(ledc_timer_config(&ledc_time_config)); ledc_time_config.speed_mode = LEDC_SPEED_MODE_MAX; TEST_ASSERT(ledc_timer_config(&ledc_time_config) == ESP_ERR_INVALID_ARG); // wrong duty_resolution ledc_time_config = temp_timer_config; ledc_time_config.duty_resolution = LEDC_TIMER_BIT_MAX; TEST_ASSERT(ledc_timer_config(&ledc_time_config) == ESP_ERR_INVALID_ARG); // wrong timer ledc_time_config = temp_timer_config; ledc_time_config.timer_num = 4; TEST_ASSERT(ledc_timer_config(&ledc_time_config) == ESP_ERR_INVALID_ARG); uint32_t current_level = LEDC.channel_group[test_speed_mode].channel[LEDC_CHANNEL_0].conf0.idle_lv; TEST_ESP_OK(ledc_stop(test_speed_mode, LEDC_CHANNEL_0, !current_level)); vTaskDelay(1000 / portTICK_RATE_MS); TEST_ASSERT_EQUAL_INT32( LEDC.channel_group[test_speed_mode].channel[LEDC_CHANNEL_0].conf0.idle_lv, !current_level); } TEST_CASE("LEDC normal channel and timer config", "[ledc][test_env=UT_T1_LEDC]") { ledc_channel_config_t ledc_ch_config = { .gpio_num = PULSE_IO, .channel = LEDC_CHANNEL_0, .intr_type = LEDC_INTR_DISABLE, .timer_sel = LEDC_TIMER_0, .duty = 4000, .hpoint = 0, }; ledc_channel_config_t temp_ch_config = ledc_ch_config; ledc_timer_config_t ledc_time_config = { .duty_resolution = LEDC_TIMER_13_BIT, .timer_num = LEDC_TIMER_0, .freq_hz = 5000, .clk_cfg = LEDC_USE_APB_CLK, }; ledc_timer_config_t temp_time_config = ledc_time_config; // use all kinds of speed mode, channel, timer combination to test all of possible configuration #ifdef CONFIG_IDF_TARGET_ESP32 ledc_mode_t speed_mode[LEDC_SPEED_MODE_MAX] = {LEDC_HIGH_SPEED_MODE, LEDC_LOW_SPEED_MODE}; #elif defined CONFIG_IDF_TARGET_ESP32S2 ledc_mode_t speed_mode[LEDC_SPEED_MODE_MAX] = {LEDC_LOW_SPEED_MODE}; #endif ledc_channel_t channel_type[8] = {LEDC_CHANNEL_0, LEDC_CHANNEL_1, LEDC_CHANNEL_2, LEDC_CHANNEL_3, LEDC_CHANNEL_4, LEDC_CHANNEL_5, LEDC_CHANNEL_6, LEDC_CHANNEL_7}; ledc_timer_t timer_select[4] = {LEDC_TIMER_0, LEDC_TIMER_1, LEDC_TIMER_2, LEDC_TIMER_3}; for (int i = 0; i < LEDC_SPEED_MODE_MAX; i++) { ledc_ch_config.speed_mode = speed_mode[i]; ledc_time_config.speed_mode = speed_mode[i]; for (int j = 0; j < 8; j++) { ledc_ch_config.channel = channel_type[j]; for (int k = 0; k < 4; k++) { ledc_ch_config.timer_sel = timer_select[k]; ledc_time_config.timer_num = timer_select[k]; TEST_ESP_OK(ledc_channel_config(&ledc_ch_config)); TEST_ESP_OK(ledc_timer_config(&ledc_time_config)); ledc_ch_config = temp_ch_config; ledc_time_config = temp_time_config; } } } } // set it ignore: need to debug TEST_CASE("LEDC set and get frequency", "[ledc][test_env=UT_T1_LEDC][timeout=60][ignore]") { #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2) timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_0, LEDC_HIGH_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_1, LEDC_HIGH_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_2, LEDC_HIGH_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_3, LEDC_HIGH_SPEED_MODE); #endif timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_0, LEDC_LOW_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_1, LEDC_LOW_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_2, LEDC_LOW_SPEED_MODE); timer_frequency_test(LEDC_CHANNEL_0, LEDC_TIMER_13_BIT, LEDC_TIMER_3, LEDC_LOW_SPEED_MODE); } // duty should be manually checked from the waveform using a logic analyzer // this test is enabled only for testting the settings TEST_CASE("LEDC set and get duty", "[ledc]") { ledc_timer_t timer_list[4] = {LEDC_TIMER_0, LEDC_TIMER_1, LEDC_TIMER_2, LEDC_TIMER_3}; #ifdef CONFIG_IDF_TARGET_ESP32 ledc_mode_t speed_mode_list[LEDC_SPEED_MODE_MAX] = {LEDC_HIGH_SPEED_MODE, LEDC_LOW_SPEED_MODE}; #elif defined CONFIG_IDF_TARGET_ESP32S2 ledc_mode_t speed_mode_list[LEDC_SPEED_MODE_MAX] = {LEDC_LOW_SPEED_MODE}; #endif for(int i=0; i