/* * SPDX-FileCopyrightText: 2019-2022 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: Apache-2.0 */ #include #include "esp_check.h" #include "freertos/FreeRTOS.h" #include "driver/rtc_io.h" #include "driver/dac_types_legacy.h" #include "soc/dac_periph.h" #include "hal/gpio_types.h" #include "hal/dac_ll.h" #include "clk_ctrl_os.h" extern portMUX_TYPE rtc_spinlock; //TODO: Will be placed in the appropriate position after the rtc module is finished. static __attribute__((unused)) const char *TAG = "DAC"; /*--------------------------------------------------------------- DAC ---------------------------------------------------------------*/ esp_err_t dac_pad_get_io_num(dac_channel_t channel, gpio_num_t *gpio_num) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); *gpio_num = (gpio_num_t)dac_periph_signal.dac_channel_io_num[channel]; return ESP_OK; } static esp_err_t dac_rtc_pad_init(dac_channel_t channel) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); gpio_num_t gpio_num = 0; dac_pad_get_io_num(channel, &gpio_num); rtc_gpio_init(gpio_num); rtc_gpio_set_direction(gpio_num, RTC_GPIO_MODE_DISABLED); rtc_gpio_pullup_dis(gpio_num); rtc_gpio_pulldown_dis(gpio_num); return ESP_OK; } esp_err_t dac_output_enable(dac_channel_t channel) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); dac_rtc_pad_init(channel); portENTER_CRITICAL(&rtc_spinlock); dac_ll_power_on(channel); dac_ll_rtc_sync_by_adc(false); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_output_disable(dac_channel_t channel) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); portENTER_CRITICAL(&rtc_spinlock); dac_ll_power_down(channel); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_output_voltage(dac_channel_t channel, uint8_t dac_value) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); portENTER_CRITICAL(&rtc_spinlock); dac_ll_update_output_value(channel, dac_value); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_out_voltage(dac_channel_t channel, uint8_t dac_value) { ESP_RETURN_ON_FALSE(channel < SOC_DAC_CHAN_NUM, ESP_ERR_INVALID_ARG, TAG, "DAC channel error"); portENTER_CRITICAL(&rtc_spinlock); dac_ll_update_output_value(channel, dac_value); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_cw_generator_enable(void) { portENTER_CRITICAL(&rtc_spinlock); periph_rtc_dig_clk8m_enable(); dac_ll_cw_generator_enable(); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_cw_generator_disable(void) { portENTER_CRITICAL(&rtc_spinlock); dac_ll_cw_generator_disable(); periph_rtc_dig_clk8m_disable(); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } esp_err_t dac_cw_generator_config(dac_cw_config_t *cw) { ESP_RETURN_ON_FALSE(cw, ESP_ERR_INVALID_ARG, TAG, "invalid clock configuration"); portENTER_CRITICAL(&rtc_spinlock); /* Enable the rtc8m clock temporary to get the correct frequency */ periph_rtc_dig_clk8m_enable(); uint32_t rtc_freq = periph_rtc_dig_clk8m_get_freq(); periph_rtc_dig_clk8m_disable(); dac_ll_cw_set_freq(cw->freq, rtc_freq); dac_ll_cw_set_atten(cw->en_ch, (dac_cosine_atten_t)cw->scale); dac_ll_cw_set_phase(cw->en_ch, (dac_cosine_phase_t)cw->phase); dac_ll_cw_set_dc_offset(cw->en_ch, cw->offset); dac_ll_cw_enable_channel(cw->en_ch, true); portEXIT_CRITICAL(&rtc_spinlock); return ESP_OK; } /** * @brief This function will be called during start up, to check that this legacy DAC driver is not running along with the new driver */ __attribute__((constructor)) static void check_dac_legacy_driver_conflict(void) { // This function was declared as weak here. The new DAC driver has one implementation. // So if the new DAC driver is not linked in, then `dac_priv_register_channel()` should be NULL at runtime. extern __attribute__((weak)) esp_err_t dac_priv_register_channel(dac_channel_t chan_id, const char *mode_name); if ((void *)dac_priv_register_channel != NULL) { ESP_EARLY_LOGE(TAG, "CONFLICT! The new DAC driver is not allowed to be used together with the legacy driver"); abort(); } ESP_EARLY_LOGW(TAG, "legacy driver is deprecated, please migrate to `driver/dac_oneshot.h`, `driver/dac_cosine.h` or `driver/dac_continuous.h` instead"); }