deep sleep: set pin configuration right before entering deep sleep
This change allows setting pin configuration for EXT1 wakeup depending on the state of RTC_PERIPH power domain: - if peripherals are enabled (due to another wakeup mode, or due to esp_deep_sleep_pd_config call), we can keep internal pullups/pulldowns enabled - if peripherals are disabled, pullups and pulldowns need to be disabled as well Also add comments about the purpose of registers being configured.
This commit is contained in:
parent
609d852834
commit
370f4b8556
2 changed files with 149 additions and 56 deletions
|
@ -29,21 +29,33 @@
|
||||||
#include "rtc.h"
|
#include "rtc.h"
|
||||||
#include "sdkconfig.h"
|
#include "sdkconfig.h"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Internal structure which holds all requested deep sleep parameters
|
||||||
|
*/
|
||||||
|
typedef struct {
|
||||||
|
esp_deep_sleep_pd_option_t pd_options[ESP_PD_DOMAIN_MAX];
|
||||||
|
uint64_t sleep_duration;
|
||||||
|
uint32_t wakeup_triggers : 11;
|
||||||
|
uint32_t ext1_trigger_mode : 1;
|
||||||
|
uint32_t ext1_rtc_gpio_mask : 18;
|
||||||
|
uint32_t ext0_trigger_level : 1;
|
||||||
|
uint32_t ext0_rtc_gpio_num : 5;
|
||||||
|
} deep_sleep_config_t;
|
||||||
|
|
||||||
|
static deep_sleep_config_t s_config = {
|
||||||
|
.pd_options = { ESP_PD_OPTION_AUTO, ESP_PD_OPTION_AUTO, ESP_PD_OPTION_AUTO },
|
||||||
|
.wakeup_triggers = 0
|
||||||
|
};
|
||||||
|
|
||||||
/* Updating RTC_MEMORY_CRC_REG register via set_rtc_memory_crc()
|
/* Updating RTC_MEMORY_CRC_REG register via set_rtc_memory_crc()
|
||||||
is not thread-safe. */
|
is not thread-safe. */
|
||||||
static _lock_t lock_rtc_memory_crc;
|
static _lock_t lock_rtc_memory_crc;
|
||||||
static uint32_t s_wakeup_options = 0;
|
|
||||||
static uint64_t s_sleep_duration = 0;
|
|
||||||
|
|
||||||
static const char* TAG = "deepsleep";
|
static const char* TAG = "deepsleep";
|
||||||
static esp_deep_sleep_pd_option_t s_pd_options[ESP_PD_DOMAIN_MAX] = {
|
|
||||||
ESP_PD_OPTION_AUTO,
|
|
||||||
ESP_PD_OPTION_AUTO,
|
|
||||||
ESP_PD_OPTION_AUTO,
|
|
||||||
};
|
|
||||||
|
|
||||||
static uint32_t get_power_down_flags();
|
static uint32_t get_power_down_flags();
|
||||||
|
static void ext0_wakeup_prepare();
|
||||||
|
static void ext1_wakeup_prepare();
|
||||||
|
|
||||||
/* Wake from deep sleep stub
|
/* Wake from deep sleep stub
|
||||||
See esp_deepsleep.h esp_wake_deep_sleep() comments for details.
|
See esp_deepsleep.h esp_wake_deep_sleep() comments for details.
|
||||||
|
@ -80,6 +92,8 @@ void RTC_IRAM_ATTR esp_default_wake_deep_sleep(void) {
|
||||||
// ROM code has not started yet, so we need to set delay factor
|
// ROM code has not started yet, so we need to set delay factor
|
||||||
// used by ets_delay_us first.
|
// used by ets_delay_us first.
|
||||||
ets_update_cpu_frequency(ets_get_detected_xtal_freq() / 1000000);
|
ets_update_cpu_frequency(ets_get_detected_xtal_freq() / 1000000);
|
||||||
|
// This delay is configured in menuconfig, it can be used to give
|
||||||
|
// the flash chip some time to become ready.
|
||||||
ets_delay_us(CONFIG_ESP32_DEEP_SLEEP_WAKEUP_DELAY);
|
ets_delay_us(CONFIG_ESP32_DEEP_SLEEP_WAKEUP_DELAY);
|
||||||
#endif
|
#endif
|
||||||
}
|
}
|
||||||
|
@ -94,8 +108,20 @@ void esp_deep_sleep(uint64_t time_in_us)
|
||||||
|
|
||||||
void IRAM_ATTR esp_deep_sleep_start()
|
void IRAM_ATTR esp_deep_sleep_start()
|
||||||
{
|
{
|
||||||
|
// Decide which power domains can be powered down
|
||||||
uint32_t pd_flags = get_power_down_flags();
|
uint32_t pd_flags = get_power_down_flags();
|
||||||
|
|
||||||
|
// Configure pins for external wakeup
|
||||||
|
if (s_config.wakeup_triggers & EXT_EVENT0_TRIG_EN) {
|
||||||
|
ext0_wakeup_prepare();
|
||||||
|
}
|
||||||
|
if (s_config.wakeup_triggers & EXT_EVENT1_TRIG_EN) {
|
||||||
|
ext1_wakeup_prepare();
|
||||||
|
}
|
||||||
|
// TODO: move timer wakeup configuration into a similar function
|
||||||
|
// once rtc_sleep is opensourced.
|
||||||
|
|
||||||
|
// Flush UARTs so that output is not lost due to APB frequency change
|
||||||
uart_tx_wait_idle(0);
|
uart_tx_wait_idle(0);
|
||||||
uart_tx_wait_idle(1);
|
uart_tx_wait_idle(1);
|
||||||
uart_tx_wait_idle(2);
|
uart_tx_wait_idle(2);
|
||||||
|
@ -107,12 +133,18 @@ void IRAM_ATTR esp_deep_sleep_start()
|
||||||
rtc_set_cpu_freq(CPU_XTAL);
|
rtc_set_cpu_freq(CPU_XTAL);
|
||||||
uint32_t cycle_h = 0;
|
uint32_t cycle_h = 0;
|
||||||
uint32_t cycle_l = 0;
|
uint32_t cycle_l = 0;
|
||||||
if (s_sleep_duration > 0) {
|
// For timer wakeup, calibrate clock source against main XTAL
|
||||||
|
// This is hardcoded to use 150kHz internal oscillator for now
|
||||||
|
if (s_config.sleep_duration > 0) {
|
||||||
uint32_t period = rtc_slowck_cali(CALI_RTC_MUX, 128);
|
uint32_t period = rtc_slowck_cali(CALI_RTC_MUX, 128);
|
||||||
rtc_usec2rtc(s_sleep_duration >> 32, s_sleep_duration & 0xffffffff, period, &cycle_h, &cycle_l);
|
rtc_usec2rtc(s_config.sleep_duration >> 32, s_config.sleep_duration & UINT32_MAX,
|
||||||
|
period, &cycle_h, &cycle_l);
|
||||||
}
|
}
|
||||||
|
// Enter deep sleep
|
||||||
rtc_slp_prep_lite(pd_flags, 0);
|
rtc_slp_prep_lite(pd_flags, 0);
|
||||||
rtc_sleep(cycle_h, cycle_l, s_wakeup_options, 0);
|
rtc_sleep(cycle_h, cycle_l, s_config.wakeup_triggers, 0);
|
||||||
|
// Because RTC is in a slower clock domain than the CPU, it
|
||||||
|
// can take several CPU cycles for the sleep mode to start.
|
||||||
while (1) {
|
while (1) {
|
||||||
;
|
;
|
||||||
}
|
}
|
||||||
|
@ -123,7 +155,7 @@ void system_deep_sleep(uint64_t) __attribute__((alias("esp_deep_sleep")));
|
||||||
esp_err_t esp_deep_sleep_enable_ulp_wakeup()
|
esp_err_t esp_deep_sleep_enable_ulp_wakeup()
|
||||||
{
|
{
|
||||||
#ifdef CONFIG_ULP_COPROC_ENABLED
|
#ifdef CONFIG_ULP_COPROC_ENABLED
|
||||||
s_wakeup_options |= RTC_SAR_TRIG_EN;
|
s_config.wakeup_triggers |= RTC_SAR_TRIG_EN;
|
||||||
return ESP_OK;
|
return ESP_OK;
|
||||||
#else
|
#else
|
||||||
return ESP_ERR_INVALID_STATE;
|
return ESP_ERR_INVALID_STATE;
|
||||||
|
@ -132,8 +164,8 @@ esp_err_t esp_deep_sleep_enable_ulp_wakeup()
|
||||||
|
|
||||||
esp_err_t esp_deep_sleep_enable_timer_wakeup(uint64_t time_in_us)
|
esp_err_t esp_deep_sleep_enable_timer_wakeup(uint64_t time_in_us)
|
||||||
{
|
{
|
||||||
s_wakeup_options |= RTC_TIMER_EXPIRE_EN;
|
s_config.wakeup_triggers |= RTC_TIMER_EXPIRE_EN;
|
||||||
s_sleep_duration = time_in_us;
|
s_config.sleep_duration = time_in_us;
|
||||||
return ESP_OK;
|
return ESP_OK;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -145,15 +177,33 @@ esp_err_t esp_deep_sleep_enable_ext0_wakeup(gpio_num_t gpio_num, int level)
|
||||||
if (!RTC_GPIO_IS_VALID_GPIO(gpio_num)) {
|
if (!RTC_GPIO_IS_VALID_GPIO(gpio_num)) {
|
||||||
return ESP_ERR_INVALID_ARG;
|
return ESP_ERR_INVALID_ARG;
|
||||||
}
|
}
|
||||||
const rtc_gpio_desc_t* desc = &rtc_gpio_desc[gpio_num];
|
s_config.ext0_rtc_gpio_num = rtc_gpio_desc[gpio_num].rtc_num;
|
||||||
REG_SET_FIELD(RTC_IO_EXT_WAKEUP0_REG, RTC_IO_EXT_WAKEUP0_SEL, desc->rtc_num);
|
s_config.ext0_trigger_level = level;
|
||||||
SET_PERI_REG_BITS(RTC_CNTL_EXT_WAKEUP_CONF_REG, 0x1, level, RTC_CNTL_EXT_WAKEUP0_LV_S);
|
s_config.wakeup_triggers |= RTC_EXT_EVENT0_TRIG_EN;
|
||||||
REG_SET_BIT(desc->reg, desc->slpsel);
|
|
||||||
REG_SET_BIT(desc->reg, desc->slpie);
|
|
||||||
s_wakeup_options |= RTC_EXT_EVENT0_TRIG_EN;
|
|
||||||
return ESP_OK;
|
return ESP_OK;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
static void ext0_wakeup_prepare()
|
||||||
|
{
|
||||||
|
int rtc_gpio_num = s_config.ext0_rtc_gpio_num;
|
||||||
|
// Set GPIO to be used for wakeup
|
||||||
|
REG_SET_FIELD(RTC_IO_EXT_WAKEUP0_REG, RTC_IO_EXT_WAKEUP0_SEL, rtc_gpio_num);
|
||||||
|
// Set level which will trigger wakeup
|
||||||
|
SET_PERI_REG_BITS(RTC_CNTL_EXT_WAKEUP_CONF_REG, 0x1,
|
||||||
|
s_config.ext0_trigger_level, RTC_CNTL_EXT_WAKEUP0_LV_S);
|
||||||
|
// Find GPIO descriptor in the rtc_gpio_desc table and configure the pad
|
||||||
|
for (size_t gpio_num = 0; gpio_num < GPIO_PIN_COUNT; ++gpio_num) {
|
||||||
|
const rtc_gpio_desc_t* desc = &rtc_gpio_desc[gpio_num];
|
||||||
|
if (desc->rtc_num == rtc_gpio_num) {
|
||||||
|
REG_SET_BIT(desc->reg, desc->mux);
|
||||||
|
SET_PERI_REG_BITS(desc->reg, 0x3, 0, desc->func);
|
||||||
|
REG_SET_BIT(desc->reg, desc->slpsel);
|
||||||
|
REG_SET_BIT(desc->reg, desc->slpie);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_t mode)
|
esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_t mode)
|
||||||
{
|
{
|
||||||
if (mode > ESP_EXT1_WAKEUP_ANY_HIGH) {
|
if (mode > ESP_EXT1_WAKEUP_ANY_HIGH) {
|
||||||
|
@ -169,24 +219,53 @@ esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_
|
||||||
ESP_LOGE(TAG, "Not an RTC IO: GPIO%d", gpio);
|
ESP_LOGE(TAG, "Not an RTC IO: GPIO%d", gpio);
|
||||||
return ESP_ERR_INVALID_ARG;
|
return ESP_ERR_INVALID_ARG;
|
||||||
}
|
}
|
||||||
const rtc_gpio_desc_t* desc = &rtc_gpio_desc[gpio];
|
rtc_gpio_mask |= BIT(rtc_gpio_desc[gpio].rtc_num);
|
||||||
int rtc_pin = desc->rtc_num;
|
|
||||||
rtc_gpio_mask |= BIT(rtc_pin);
|
|
||||||
REG_SET_BIT(desc->reg, desc->ie);
|
|
||||||
REG_SET_BIT(desc->reg, desc->slpsel);
|
|
||||||
REG_SET_BIT(desc->reg, desc->slpie);
|
|
||||||
REG_CLR_BIT(desc->reg, desc->pulldown);
|
|
||||||
REG_CLR_BIT(desc->reg, desc->pullup);
|
|
||||||
REG_SET_BIT(desc->reg, desc->mux);
|
|
||||||
REG_SET_BIT(RTC_CNTL_HOLD_FORCE_REG, desc->hold);
|
|
||||||
}
|
}
|
||||||
REG_SET_BIT(RTC_CNTL_EXT_WAKEUP1_REG, RTC_CNTL_EXT_WAKEUP1_STATUS_CLR);
|
s_config.ext1_rtc_gpio_mask = rtc_gpio_mask;
|
||||||
REG_SET_FIELD(RTC_CNTL_EXT_WAKEUP1_REG, RTC_CNTL_EXT_WAKEUP1_SEL, rtc_gpio_mask);
|
s_config.ext1_trigger_mode = mode;
|
||||||
SET_PERI_REG_BITS(RTC_CNTL_EXT_WAKEUP_CONF_REG, 0x1, mode, RTC_CNTL_EXT_WAKEUP1_LV_S);
|
s_config.wakeup_triggers |= RTC_EXT_EVENT1_TRIG_EN;
|
||||||
s_wakeup_options |= RTC_EXT_EVENT1_TRIG_EN;
|
|
||||||
return ESP_OK;
|
return ESP_OK;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
static void ext1_wakeup_prepare()
|
||||||
|
{
|
||||||
|
// Configure all RTC IOs selected as ext1 wakeup inputs
|
||||||
|
uint32_t rtc_gpio_mask = s_config.ext1_rtc_gpio_mask;
|
||||||
|
for (int gpio = 0; gpio < GPIO_PIN_COUNT && rtc_gpio_mask != 0; ++gpio) {
|
||||||
|
int rtc_pin = rtc_gpio_desc[gpio].rtc_num;
|
||||||
|
if ((rtc_gpio_mask & BIT(rtc_pin)) == 0) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
const rtc_gpio_desc_t* desc = &rtc_gpio_desc[gpio];
|
||||||
|
// Route pad to RTC
|
||||||
|
REG_SET_BIT(desc->reg, desc->mux);
|
||||||
|
SET_PERI_REG_BITS(desc->reg, 0x3, 0, desc->func);
|
||||||
|
// Pad configuration depends on RTC_PERIPH state in sleep mode
|
||||||
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_PERIPH] == ESP_PD_OPTION_ON) {
|
||||||
|
// set input enable in sleep mode
|
||||||
|
REG_SET_BIT(desc->reg, desc->slpie);
|
||||||
|
// allow sleep status signal to control IE/SLPIE mux
|
||||||
|
REG_SET_BIT(desc->reg, desc->slpsel);
|
||||||
|
} else {
|
||||||
|
// RTC_PERIPH will be disabled, so need to enable input and
|
||||||
|
// lock pad configuration. Pullups/pulldowns also need to be disabled.
|
||||||
|
REG_SET_BIT(desc->reg, desc->ie);
|
||||||
|
REG_CLR_BIT(desc->reg, desc->pulldown);
|
||||||
|
REG_CLR_BIT(desc->reg, desc->pullup);
|
||||||
|
REG_SET_BIT(RTC_CNTL_HOLD_FORCE_REG, desc->hold);
|
||||||
|
}
|
||||||
|
// Keep track of pins which are processed to bail out early
|
||||||
|
rtc_gpio_mask &= ~BIT(rtc_pin);
|
||||||
|
}
|
||||||
|
// Clear state from previous wakeup
|
||||||
|
REG_SET_BIT(RTC_CNTL_EXT_WAKEUP1_REG, RTC_CNTL_EXT_WAKEUP1_STATUS_CLR);
|
||||||
|
// Set pins to be used for wakeup
|
||||||
|
REG_SET_FIELD(RTC_CNTL_EXT_WAKEUP1_REG, RTC_CNTL_EXT_WAKEUP1_SEL, s_config.ext1_rtc_gpio_mask);
|
||||||
|
// Set logic function (any low, all high)
|
||||||
|
SET_PERI_REG_BITS(RTC_CNTL_EXT_WAKEUP_CONF_REG, 0x1,
|
||||||
|
s_config.ext1_trigger_mode, RTC_CNTL_EXT_WAKEUP1_LV_S);
|
||||||
|
}
|
||||||
|
|
||||||
uint64_t esp_deep_sleep_get_ext1_wakeup_status()
|
uint64_t esp_deep_sleep_get_ext1_wakeup_status()
|
||||||
{
|
{
|
||||||
int wakeup_reason = REG_GET_FIELD(RTC_CNTL_WAKEUP_STATE_REG, RTC_CNTL_WAKEUP_CAUSE);
|
int wakeup_reason = REG_GET_FIELD(RTC_CNTL_WAKEUP_STATE_REG, RTC_CNTL_WAKEUP_CAUSE);
|
||||||
|
@ -196,7 +275,7 @@ uint64_t esp_deep_sleep_get_ext1_wakeup_status()
|
||||||
uint32_t status = REG_GET_FIELD(RTC_CNTL_EXT_WAKEUP1_STATUS_REG, RTC_CNTL_EXT_WAKEUP1_STATUS);
|
uint32_t status = REG_GET_FIELD(RTC_CNTL_EXT_WAKEUP1_STATUS_REG, RTC_CNTL_EXT_WAKEUP1_STATUS);
|
||||||
// Translate bit map of RTC IO numbers into the bit map of GPIO numbers
|
// Translate bit map of RTC IO numbers into the bit map of GPIO numbers
|
||||||
uint64_t gpio_mask = 0;
|
uint64_t gpio_mask = 0;
|
||||||
for (int gpio = 0; gpio < 40; ++gpio) {
|
for (int gpio = 0; gpio < GPIO_PIN_COUNT; ++gpio) {
|
||||||
if (!RTC_GPIO_IS_VALID_GPIO(gpio)) {
|
if (!RTC_GPIO_IS_VALID_GPIO(gpio)) {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
@ -215,7 +294,7 @@ esp_err_t esp_deep_sleep_pd_config(esp_deep_sleep_pd_domain_t domain,
|
||||||
if (domain >= ESP_PD_DOMAIN_MAX || option > ESP_PD_OPTION_AUTO) {
|
if (domain >= ESP_PD_DOMAIN_MAX || option > ESP_PD_OPTION_AUTO) {
|
||||||
return ESP_ERR_INVALID_ARG;
|
return ESP_ERR_INVALID_ARG;
|
||||||
}
|
}
|
||||||
s_pd_options[domain] = option;
|
s_config.pd_options[domain] = option;
|
||||||
return ESP_OK;
|
return ESP_OK;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -225,9 +304,9 @@ static uint32_t get_power_down_flags()
|
||||||
|
|
||||||
// RTC_SLOW_MEM is needed only for the ULP.
|
// RTC_SLOW_MEM is needed only for the ULP.
|
||||||
// If RTC_SLOW_MEM is Auto, and ULP wakeup isn't enabled, power down RTC_SLOW_MEM.
|
// If RTC_SLOW_MEM is Auto, and ULP wakeup isn't enabled, power down RTC_SLOW_MEM.
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] == ESP_PD_OPTION_AUTO) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] == ESP_PD_OPTION_AUTO) {
|
||||||
if (s_wakeup_options & RTC_SAR_TRIG_EN) {
|
if (s_config.wakeup_triggers & RTC_SAR_TRIG_EN) {
|
||||||
s_pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] = ESP_PD_OPTION_ON;
|
s_config.pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] = ESP_PD_OPTION_ON;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -236,37 +315,36 @@ static uint32_t get_power_down_flags()
|
||||||
// can run.
|
// can run.
|
||||||
// In the new chip revision, deep sleep stub will be optional,
|
// In the new chip revision, deep sleep stub will be optional,
|
||||||
// and this can be changed.
|
// and this can be changed.
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] == ESP_PD_OPTION_AUTO) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] == ESP_PD_OPTION_AUTO) {
|
||||||
s_pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] = ESP_PD_OPTION_ON;
|
s_config.pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] = ESP_PD_OPTION_ON;
|
||||||
}
|
}
|
||||||
|
|
||||||
// RTC_PERIPH is needed for EXT0 wakeup and for ULP.
|
// RTC_PERIPH is needed for EXT0 wakeup and for ULP.
|
||||||
// If RTC_PERIPH is auto, and both EXT0 and ULP aren't enabled,
|
// If RTC_PERIPH is auto, and both EXT0 and ULP aren't enabled,
|
||||||
// power down RTC_PERIPH.
|
// power down RTC_PERIPH.
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_PERIPH] == ESP_PD_OPTION_AUTO) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_PERIPH] == ESP_PD_OPTION_AUTO) {
|
||||||
if (s_wakeup_options &
|
if (s_config.wakeup_triggers &
|
||||||
(RTC_SAR_TRIG_EN | RTC_EXT_EVENT0_TRIG_EN)) {
|
(RTC_SAR_TRIG_EN | RTC_EXT_EVENT0_TRIG_EN)) {
|
||||||
s_pd_options[ESP_PD_DOMAIN_RTC_PERIPH] = ESP_PD_OPTION_ON;
|
s_config.pd_options[ESP_PD_DOMAIN_RTC_PERIPH] = ESP_PD_OPTION_ON;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
const char* option_str[] = {"OFF", "ON", "OFF" /* Auto works as OFF */};
|
const char* option_str[] = {"OFF", "ON", "AUTO(OFF)" /* Auto works as OFF */};
|
||||||
ESP_LOGD(TAG, "RTC_PERIPH: %s, RTC_SLOW_MEM: %s, RTC_FAST_MEM: %s",
|
ESP_LOGD(TAG, "RTC_PERIPH: %s, RTC_SLOW_MEM: %s, RTC_FAST_MEM: %s",
|
||||||
option_str[s_pd_options[ESP_PD_DOMAIN_RTC_PERIPH]],
|
option_str[s_config.pd_options[ESP_PD_DOMAIN_RTC_PERIPH]],
|
||||||
option_str[s_pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM]],
|
option_str[s_config.pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM]],
|
||||||
option_str[s_pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM]]);
|
option_str[s_config.pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM]]);
|
||||||
|
|
||||||
// Prepare flags based on the selected options
|
// Prepare flags based on the selected options
|
||||||
uint32_t pd_flags = DEEP_SLEEP_PD_NORMAL;
|
uint32_t pd_flags = DEEP_SLEEP_PD_NORMAL;
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] != ESP_PD_OPTION_ON) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_FAST_MEM] != ESP_PD_OPTION_ON) {
|
||||||
pd_flags |= DEEP_SLEEP_PD_RTC_FAST_MEM;
|
pd_flags |= DEEP_SLEEP_PD_RTC_FAST_MEM;
|
||||||
}
|
}
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] != ESP_PD_OPTION_ON) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_SLOW_MEM] != ESP_PD_OPTION_ON) {
|
||||||
pd_flags |= DEEP_SLEEP_PD_RTC_SLOW_MEM;
|
pd_flags |= DEEP_SLEEP_PD_RTC_SLOW_MEM;
|
||||||
}
|
}
|
||||||
if (s_pd_options[ESP_PD_DOMAIN_RTC_PERIPH] != ESP_PD_OPTION_ON) {
|
if (s_config.pd_options[ESP_PD_DOMAIN_RTC_PERIPH] != ESP_PD_OPTION_ON) {
|
||||||
pd_flags |= DEEP_SLEEP_PD_RTC_PERIPH;
|
pd_flags |= DEEP_SLEEP_PD_RTC_PERIPH;
|
||||||
}
|
}
|
||||||
ESP_LOGD(TAG, "power down flags: %02x", pd_flags);
|
|
||||||
return pd_flags;
|
return pd_flags;
|
||||||
}
|
}
|
||||||
|
|
|
@ -84,12 +84,17 @@ esp_err_t esp_deep_sleep_enable_timer_wakeup(uint64_t time_in_us);
|
||||||
* This feature can monitor any pin which is an RTC IO. Once the pin transitions
|
* This feature can monitor any pin which is an RTC IO. Once the pin transitions
|
||||||
* into the state given by level argument, the chip will be woken up.
|
* into the state given by level argument, the chip will be woken up.
|
||||||
*
|
*
|
||||||
|
* @note This function does not modify pin configuration. The pin is
|
||||||
|
* configured in esp_deep_sleep_start, immediately before
|
||||||
|
* entering deep sleep.
|
||||||
|
*
|
||||||
* @param gpio_num GPIO number used as wakeup source. Only GPIOs which are have RTC
|
* @param gpio_num GPIO number used as wakeup source. Only GPIOs which are have RTC
|
||||||
* functionality can be used: 0,2,4,12-15,25-27,32-39.
|
* functionality can be used: 0,2,4,12-15,25-27,32-39.
|
||||||
* @param level input level which will trigger wakeup (0=low, 1=high)
|
* @param level input level which will trigger wakeup (0=low, 1=high)
|
||||||
* @return
|
* @return
|
||||||
* - ESP_OK on success
|
* - ESP_OK on success
|
||||||
* - ESP_ERR_INVALID_ARG if either of the arguments is out of range
|
* - ESP_ERR_INVALID_ARG if the selected GPIO is not an RTC GPIO,
|
||||||
|
* or the mode is invalid
|
||||||
*/
|
*/
|
||||||
esp_err_t esp_deep_sleep_enable_ext0_wakeup(gpio_num_t gpio_num, int level);
|
esp_err_t esp_deep_sleep_enable_ext0_wakeup(gpio_num_t gpio_num, int level);
|
||||||
|
|
||||||
|
@ -100,9 +105,18 @@ esp_err_t esp_deep_sleep_enable_ext0_wakeup(gpio_num_t gpio_num, int level);
|
||||||
* It will work even if RTC peripherals are shut down during deep sleep.
|
* It will work even if RTC peripherals are shut down during deep sleep.
|
||||||
*
|
*
|
||||||
* This feature can monitor any number of pins which are in RTC IOs.
|
* This feature can monitor any number of pins which are in RTC IOs.
|
||||||
* Once any of the selected pins goes into the state given by level argument,
|
* Once any of the selected pins goes into the state given by mode argument,
|
||||||
* the chip will be woken up.
|
* the chip will be woken up.
|
||||||
*
|
*
|
||||||
|
* @note This function does not modify pin configuration. The pins are
|
||||||
|
* configured in esp_deep_sleep_start, immediately before
|
||||||
|
* entering deep sleep.
|
||||||
|
*
|
||||||
|
* @note internal pullups and pulldowns don't work when RTC peripherals are
|
||||||
|
* shut down. In this case, external resistors need to be added.
|
||||||
|
* Alternatively, RTC peripherals (and pullups/pulldowns) may be
|
||||||
|
* kept enabled using esp_deep_sleep_pd_config function.
|
||||||
|
*
|
||||||
* @param mask bit mask of GPIO numbers which will cause wakeup. Only GPIOs
|
* @param mask bit mask of GPIO numbers which will cause wakeup. Only GPIOs
|
||||||
* which are have RTC functionality can be used in this bit map:
|
* which are have RTC functionality can be used in this bit map:
|
||||||
* 0,2,4,12-15,25-27,32-39.
|
* 0,2,4,12-15,25-27,32-39.
|
||||||
|
@ -111,7 +125,8 @@ esp_err_t esp_deep_sleep_enable_ext0_wakeup(gpio_num_t gpio_num, int level);
|
||||||
* - ESP_EXT1_WAKEUP_ANY_HIGH: wake up when any of the selected GPIOs is high
|
* - ESP_EXT1_WAKEUP_ANY_HIGH: wake up when any of the selected GPIOs is high
|
||||||
* @return
|
* @return
|
||||||
* - ESP_OK on success
|
* - ESP_OK on success
|
||||||
* - ESP_ERR_INVALID_ARG if either of the arguments is out of range
|
* - ESP_ERR_INVALID_ARG if any of the selected GPIOs is not an RTC GPIO,
|
||||||
|
* or mode is invalid
|
||||||
*/
|
*/
|
||||||
esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_t mode);
|
esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_t mode);
|
||||||
|
|
||||||
|
@ -126,7 +141,7 @@ esp_err_t esp_deep_sleep_enable_ext1_wakeup(uint64_t mask, esp_ext1_wakeup_mode_
|
||||||
uint64_t esp_deep_sleep_get_ext1_wakeup_status();
|
uint64_t esp_deep_sleep_get_ext1_wakeup_status();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Set if specific power domain has to be powered down in deep sleep
|
* @brief Set power down mode for an RTC power domain in deep sleep
|
||||||
*
|
*
|
||||||
* If not set set using this API, all power domains default to ESP_PD_OPTION_AUTO.
|
* If not set set using this API, all power domains default to ESP_PD_OPTION_AUTO.
|
||||||
*
|
*
|
||||||
|
|
Loading…
Reference in a new issue