2021-08-05 15:35:07 +00:00
|
|
|
/*
|
2022-01-12 06:53:47 +00:00
|
|
|
* SPDX-FileCopyrightText: 2020-2022 Espressif Systems (Shanghai) CO LTD
|
2021-08-05 15:35:07 +00:00
|
|
|
*
|
|
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
|
|
*/
|
2020-11-23 07:35:09 +00:00
|
|
|
|
|
|
|
#include <freertos/FreeRTOS.h>
|
2022-01-12 06:53:47 +00:00
|
|
|
#include "clk_ctrl_os.h"
|
2022-12-01 12:48:27 +00:00
|
|
|
#include "soc/rtc.h"
|
2023-04-23 07:49:59 +00:00
|
|
|
#include "esp_private/esp_clk_tree_common.h"
|
2021-12-02 12:24:19 +00:00
|
|
|
#include "esp_check.h"
|
2020-11-23 07:35:09 +00:00
|
|
|
|
|
|
|
static portMUX_TYPE periph_spinlock = portMUX_INITIALIZER_UNLOCKED;
|
|
|
|
|
|
|
|
static uint8_t s_periph_ref_counts = 0;
|
2022-12-01 12:48:27 +00:00
|
|
|
static uint32_t s_rc_fast_freq = 0; // Frequency of the RC_FAST clock in Hz
|
2021-12-02 12:24:19 +00:00
|
|
|
#if SOC_CLK_APLL_SUPPORTED
|
|
|
|
static const char *TAG = "clk_ctrl_os";
|
|
|
|
// Current APLL frequency, in HZ. Zero if APLL is not enabled.
|
|
|
|
static uint32_t s_cur_apll_freq = 0;
|
|
|
|
static int s_apll_ref_cnt = 0;
|
|
|
|
#endif
|
|
|
|
|
2020-11-23 07:35:09 +00:00
|
|
|
|
|
|
|
bool periph_rtc_dig_clk8m_enable(void)
|
|
|
|
{
|
|
|
|
portENTER_CRITICAL(&periph_spinlock);
|
|
|
|
if (s_periph_ref_counts == 0) {
|
|
|
|
rtc_dig_clk8m_enable();
|
2022-12-01 12:48:27 +00:00
|
|
|
#if SOC_CLK_RC_FAST_SUPPORT_CALIBRATION
|
2023-04-23 07:49:59 +00:00
|
|
|
s_rc_fast_freq = esp_clk_tree_rc_fast_get_freq_hz(ESP_CLK_TREE_SRC_FREQ_PRECISION_EXACT);
|
2022-12-01 12:48:27 +00:00
|
|
|
if (s_rc_fast_freq == 0) {
|
2022-12-28 07:04:51 +00:00
|
|
|
rtc_dig_clk8m_disable();
|
2020-11-23 07:35:09 +00:00
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
return false;
|
|
|
|
}
|
2022-12-01 12:48:27 +00:00
|
|
|
#endif //SOC_CLK_RC_FAST_SUPPORT_CALIBRATION
|
2020-11-23 07:35:09 +00:00
|
|
|
}
|
|
|
|
s_periph_ref_counts++;
|
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
uint32_t periph_rtc_dig_clk8m_get_freq(void)
|
|
|
|
{
|
2022-12-01 12:48:27 +00:00
|
|
|
#if !SOC_CLK_RC_FAST_SUPPORT_CALIBRATION
|
|
|
|
/* Workaround: CLK8M calibration cannot be performed, we can only return its theoretic value */
|
2022-04-21 10:24:03 +00:00
|
|
|
return SOC_CLK_RC_FAST_FREQ_APPROX;
|
2022-02-09 04:50:19 +00:00
|
|
|
#else
|
2022-12-01 12:48:27 +00:00
|
|
|
return s_rc_fast_freq;
|
2022-02-09 04:50:19 +00:00
|
|
|
#endif
|
2020-11-23 07:35:09 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void periph_rtc_dig_clk8m_disable(void)
|
|
|
|
{
|
|
|
|
portENTER_CRITICAL(&periph_spinlock);
|
|
|
|
assert(s_periph_ref_counts > 0);
|
|
|
|
s_periph_ref_counts--;
|
|
|
|
if (s_periph_ref_counts == 0) {
|
2022-12-01 12:48:27 +00:00
|
|
|
s_rc_fast_freq = 0;
|
2020-11-23 07:35:09 +00:00
|
|
|
rtc_dig_clk8m_disable();
|
|
|
|
}
|
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
}
|
2021-12-02 12:24:19 +00:00
|
|
|
|
|
|
|
#if SOC_CLK_APLL_SUPPORTED
|
|
|
|
void periph_rtc_apll_acquire(void)
|
|
|
|
{
|
|
|
|
portENTER_CRITICAL(&periph_spinlock);
|
|
|
|
s_apll_ref_cnt++;
|
|
|
|
if (s_apll_ref_cnt == 1) {
|
|
|
|
// For the first time enable APLL, need to set power up
|
|
|
|
rtc_clk_apll_enable(true);
|
|
|
|
}
|
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
}
|
|
|
|
|
|
|
|
void periph_rtc_apll_release(void)
|
|
|
|
{
|
|
|
|
portENTER_CRITICAL(&periph_spinlock);
|
|
|
|
assert(s_apll_ref_cnt > 0);
|
|
|
|
s_apll_ref_cnt--;
|
|
|
|
if (s_apll_ref_cnt == 0) {
|
|
|
|
// If there is no peripheral using APLL, shut down the power
|
|
|
|
s_cur_apll_freq = 0;
|
|
|
|
rtc_clk_apll_enable(false);
|
|
|
|
}
|
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
}
|
|
|
|
|
|
|
|
esp_err_t periph_rtc_apll_freq_set(uint32_t expt_freq, uint32_t *real_freq)
|
|
|
|
{
|
|
|
|
uint32_t o_div = 0;
|
|
|
|
uint32_t sdm0 = 0;
|
|
|
|
uint32_t sdm1 = 0;
|
|
|
|
uint32_t sdm2 = 0;
|
|
|
|
// Guarantee 'periph_rtc_apll_acquire' has been called before set apll freq
|
|
|
|
assert(s_apll_ref_cnt > 0);
|
|
|
|
uint32_t apll_freq = rtc_clk_apll_coeff_calc(expt_freq, &o_div, &sdm0, &sdm1, &sdm2);
|
|
|
|
|
|
|
|
ESP_RETURN_ON_FALSE(apll_freq, ESP_ERR_INVALID_ARG, TAG, "APLL coefficients calculate failed");
|
|
|
|
bool need_config = true;
|
|
|
|
portENTER_CRITICAL(&periph_spinlock);
|
|
|
|
/* If APLL is not in use or only one peripheral in use, its frequency can be changed as will
|
|
|
|
* But when more than one peripheral refers APLL, its frequency is not allowed to change once it is set */
|
|
|
|
if (s_cur_apll_freq == 0 || s_apll_ref_cnt < 2) {
|
|
|
|
s_cur_apll_freq = apll_freq;
|
|
|
|
} else {
|
|
|
|
apll_freq = s_cur_apll_freq;
|
|
|
|
need_config = false;
|
|
|
|
}
|
|
|
|
portEXIT_CRITICAL(&periph_spinlock);
|
|
|
|
*real_freq = apll_freq;
|
|
|
|
|
|
|
|
if (need_config) {
|
|
|
|
ESP_LOGD(TAG, "APLL will working at %d Hz with coefficients [sdm0] %d [sdm1] %d [sdm2] %d [o_div] %d",
|
|
|
|
apll_freq, sdm0, sdm1, sdm2, o_div);
|
|
|
|
/* Set coefficients for APLL, notice that it doesn't mean APLL will start */
|
|
|
|
rtc_clk_apll_coeff_set(o_div, sdm0, sdm1, sdm2);
|
|
|
|
} else {
|
|
|
|
return ESP_ERR_INVALID_STATE;
|
|
|
|
}
|
|
|
|
|
|
|
|
return ESP_OK;
|
|
|
|
}
|
2021-08-18 11:45:51 +00:00
|
|
|
#endif // SOC_CLK_APLL_SUPPORTED
|