// Copyright 2015-2019 Espressif Systems (Shanghai) PTE LTD // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // The HAL layer for ADC (ESP32-S2 specific part) #include "sdkconfig.h" #include "hal/adc_hal.h" #include "hal/adc_types.h" #include "hal/adc_hal_conf.h" /*--------------------------------------------------------------- Digital controller setting ---------------------------------------------------------------*/ void adc_hal_digi_deinit(void) { adc_ll_digi_trigger_disable(); // boss adc_ll_digi_dma_disable(); adc_ll_digi_clear_pattern_table(ADC_NUM_1); adc_ll_digi_clear_pattern_table(ADC_NUM_2); adc_ll_digi_filter_reset(ADC_NUM_1); adc_ll_digi_filter_reset(ADC_NUM_2); adc_ll_digi_reset(); adc_ll_digi_controller_clk_disable(); } void adc_hal_digi_controller_config(const adc_digi_config_t *cfg) { /* Single channel mode or multi channel mode. */ adc_ll_digi_set_convert_mode(cfg->conv_mode); if (cfg->conv_mode & ADC_CONV_SINGLE_UNIT_1) { if (cfg->adc1_pattern_len) { adc_ll_digi_clear_pattern_table(ADC_NUM_1); adc_ll_digi_set_pattern_table_len(ADC_NUM_1, cfg->adc1_pattern_len); for (uint32_t i = 0; i < cfg->adc1_pattern_len; i++) { adc_ll_digi_set_pattern_table(ADC_NUM_1, i, cfg->adc1_pattern[i]); } } } if (cfg->conv_mode & ADC_CONV_SINGLE_UNIT_2) { if (cfg->adc2_pattern_len) { adc_ll_digi_clear_pattern_table(ADC_NUM_2); adc_ll_digi_set_pattern_table_len(ADC_NUM_2, cfg->adc2_pattern_len); for (uint32_t i = 0; i < cfg->adc2_pattern_len; i++) { adc_ll_digi_set_pattern_table(ADC_NUM_2, i, cfg->adc2_pattern[i]); } } } if (cfg->conv_mode & ADC_CONV_SINGLE_UNIT_1) { adc_ll_set_controller(ADC_NUM_1, ADC_CTRL_DIG); } if (cfg->conv_mode & ADC_CONV_SINGLE_UNIT_2) { adc_ll_set_controller(ADC_NUM_2, ADC_CTRL_DIG); } adc_ll_digi_set_output_format(cfg->format); if (cfg->conv_limit_en) { adc_ll_digi_set_convert_limit_num(cfg->conv_limit_num); adc_ll_digi_convert_limit_enable(); } else { adc_ll_digi_convert_limit_disable(); } adc_ll_digi_set_trigger_interval(cfg->interval); adc_hal_digi_clk_config(&cfg->dig_clk); adc_ll_digi_dma_set_eof_num(cfg->dma_eof_num); } /** * Set ADC digital controller clock division factor. The clock divided from `APLL` or `APB` clock. * Enable clock and select clock source for ADC digital controller. * Expression: controller_clk = (`APLL` or `APB`) / (div_num + div_a / div_b + 1). * * @note ADC and DAC digital controller share the same frequency divider. * Please set a reasonable frequency division factor to meet the sampling frequency of the ADC and the output frequency of the DAC. * * @param clk Refer to ``adc_digi_clk_t``. */ void adc_hal_digi_clk_config(const adc_digi_clk_t *clk) { adc_ll_digi_controller_clk_div(clk->div_num, clk->div_b, clk->div_a); adc_ll_digi_controller_clk_enable(clk->use_apll); } /** * Enable digital controller to trigger the measurement. */ void adc_hal_digi_enable(void) { adc_ll_digi_dma_enable(); adc_ll_digi_trigger_enable(); } /** * Disable digital controller to trigger the measurement. */ void adc_hal_digi_disable(void) { adc_ll_digi_trigger_disable(); adc_ll_digi_dma_disable(); } /** * Config monitor of adc digital controller. * * @note The monitor will monitor all the enabled channel data of the each ADC unit at the same time. * @param adc_n ADC unit. * @param config Refer to ``adc_digi_monitor_t``. */ void adc_hal_digi_monitor_config(adc_ll_num_t adc_n, adc_digi_monitor_t *config) { adc_ll_digi_monitor_set_mode(adc_n, config->mode); adc_ll_digi_monitor_set_thres(adc_n, config->threshold); }