Merge branch 'change/esp_idf_ext1_unhold' into 'master'

Optimize parts of the sleep wake-up flow

See merge request espressif/esp-idf!47322

components/esp_hw_support/sleep_modes.c

@@ -1820,7 +1820,7 @@ esp_err_t esp_sleep_disable_wakeup_source(esp_sleep_source_t source)
         s_config.wakeup_triggers &= ~RTC_VBAT_UNDER_VOLT_TRIG_EN;
 #endif
     } else {
-        ESP_LOGE(TAG, "Incorrect wakeup source (%d) to disable.", (int) source);
+        ESP_EARLY_LOGE(TAG, "Incorrect wakeup source (%d) to disable.", (int) source);
         return ESP_ERR_INVALID_STATE;
     }
     return ESP_OK;

docs/en/api-reference/system/power_management.rst

@@ -48,6 +48,10 @@ Dynamic frequency scaling (DFS) and automatic Light-sleep can be enabled in an a
 
   In Light-sleep, peripherals are clock gated, and interrupts (from GPIOs and internal peripherals) will not be generated. A wakeup source described in the :doc:`sleep_modes` documentation can be used to trigger wakeup from the Light-sleep state.
 
+.. warning::
+
+  Automatic Light-sleep is implemented using timer wakeup. Do not manually configure the timer wakeup source.
+
 .. only:: SOC_PM_SUPPORT_EXT0_WAKEUP and SOC_PM_SUPPORT_EXT1_WAKEUP
 
   For example, the EXT0 and EXT1 wakeup sources can be used to wake up the chip via a GPIO.

docs/zh_CN/api-reference/system/power_management.rst

@@ -48,6 +48,9 @@ ESP-IDF 中集成的电源管理算法可以根据应用程序组件的需求，
 
   Light-sleep 状态下，外设设有时钟门控，不会产生来自 GPIO 和内部外设的中断。:doc:`sleep_modes` 文档中所提到的唤醒源可用于从 Light-sleep 状态触发唤醒。
 
+.. warning::
+  自动 Light-sleep 模式基于定时器唤醒实现，请勿手动配置定时器唤醒源。
+
 .. only:: SOC_PM_SUPPORT_EXT0_WAKEUP and SOC_PM_SUPPORT_EXT1_WAKEUP
 
   例如，EXT0 和 EXT1 唤醒源可以通过 GPIO 唤醒芯片。