Merge branch 'feature/support_esp32p4_dcdc_always_on_v5.3' into 'release/v5.3'

feat(esp_hw_support): support esp32p4 dcdc always on during lightsleep (v5.3)

See merge request espressif/esp-idf!31681

Author: jack0c

components/esp_hw_support/Kconfig

@@ -325,6 +325,8 @@ menu "Hardware Settings"
 
     endmenu
 
+    orsource "./port/$IDF_TARGET/Kconfig.dcdc"
+
     orsource "./port/$IDF_TARGET/Kconfig.ldo"
 
     # Invisible bringup bypass options for esp_hw_support component

components/esp_hw_support/include/esp_private/esp_pmu.h

@@ -270,7 +270,7 @@ void pmu_sleep_shutdown_dcdc(void);
  * @brief DCDC has taken over power supply, shut down LDO to save power consumption
  */
 void pmu_sleep_shutdown_ldo(void);
-#endif
+#endif // SOC_DCDC_SUPPORTED
 
 /**
  * @brief Enter deep or light sleep mode
@@ -302,9 +302,10 @@ uint32_t pmu_sleep_start(uint32_t wakeup_opt, uint32_t reject_opt, uint32_t lslp
 
 /**
  * @brief   Finish sleep process settings and get sleep reject status
+ * @param   dslp True if sleep requests id deep-sleep
  * @return  return sleep reject status
  */
-bool pmu_sleep_finish(void);
+bool pmu_sleep_finish(bool dslp);
 
 /**
  * @brief Initialize PMU related power/clock/digital parameters and functions

components/esp_hw_support/lowpower/cpu_retention/port/esp32c5/sleep_cpu.c

@@ -435,7 +435,7 @@ static IRAM_ATTR esp_err_t do_cpu_retention(sleep_cpu_entry_cb_t goto_sleep,
     }
 #endif
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
 esp_err_t IRAM_ATTR esp_sleep_cpu_retention(uint32_t (*goto_sleep)(uint32_t, uint32_t, uint32_t, bool),

components/esp_hw_support/lowpower/cpu_retention/port/esp32c6/sleep_cpu.c

@@ -475,7 +475,7 @@ static IRAM_ATTR esp_err_t do_cpu_retention(sleep_cpu_entry_cb_t goto_sleep,
     }
 #endif
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
 esp_err_t IRAM_ATTR esp_sleep_cpu_retention(uint32_t (*goto_sleep)(uint32_t, uint32_t, uint32_t, bool),

components/esp_hw_support/lowpower/cpu_retention/port/esp32h2/sleep_cpu.c

@@ -475,7 +475,7 @@ static IRAM_ATTR esp_err_t do_cpu_retention(sleep_cpu_entry_cb_t goto_sleep,
     }
 #endif
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
 esp_err_t IRAM_ATTR esp_sleep_cpu_retention(uint32_t (*goto_sleep)(uint32_t, uint32_t, uint32_t, bool),

components/esp_hw_support/lowpower/cpu_retention/port/esp32p4/sleep_cpu.c

@@ -429,7 +429,7 @@ static TCM_IRAM_ATTR esp_err_t do_cpu_retention(sleep_cpu_entry_cb_t goto_sleep,
     }
 #endif
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
 esp_err_t TCM_IRAM_ATTR esp_sleep_cpu_retention(uint32_t (*goto_sleep)(uint32_t, uint32_t, uint32_t, bool),

components/esp_hw_support/port/esp32c5/pmu_sleep.c

@@ -274,11 +274,12 @@ uint32_t pmu_sleep_start(uint32_t wakeup_opt, uint32_t reject_opt, uint32_t lslp
         ;
     }
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
-bool pmu_sleep_finish(void)
+bool pmu_sleep_finish(bool dslp)
 {
+    (void)dslp;
     return pmu_ll_hp_is_sleep_reject(PMU_instance()->hal->dev);
 }
 

components/esp_hw_support/port/esp32c6/pmu_sleep.c

@@ -341,11 +341,12 @@ uint32_t pmu_sleep_start(uint32_t wakeup_opt, uint32_t reject_opt, uint32_t lslp
         ;
     }
 
-    return pmu_sleep_finish();
+    return pmu_sleep_finish(dslp);
 }
 
-bool pmu_sleep_finish(void)
+bool pmu_sleep_finish(bool dslp)
 {
+    (void)dslp;
     return pmu_ll_hp_is_sleep_reject(PMU_instance()->hal->dev);
 }
 

components/esp_hw_support/port/esp32h2/pmu_sleep.c

@@ -258,11 +258,12 @@ uint32_t pmu_sleep_start(uint32_t wakeup_opt, uint32_t reject_opt, uint32_t lslp
         ;
     }
 
-    return ESP_OK;
+    return pmu_sleep_finish(dslp);
 }
 
-bool pmu_sleep_finish(void)
+bool pmu_sleep_finish(bool dslp)
 {
+    (void)dslp;
     return pmu_ll_hp_is_sleep_reject(PMU_instance()->hal->dev);
 }
 

components/esp_hw_support/port/esp32p4/Kconfig.dcdc

@@ -0,0 +1,30 @@
+menu "DCDC Regulator Configurations"
+    depends on SOC_GP_LDO_SUPPORTED
+
+    config ESP_SLEEP_KEEP_DCDC_ALWAYS_ON
+        bool "Keep DC-DC power always on during light-sleep"
+        default y
+        help
+            ESP32P4 will switch the power supply to LDO before sleeping, and switch to DCDC after waking up.
+            These two processes take a long time and may bring some risks for some short duration
+            light sleep. (DCDC -> LDO: 2.5ms (max), LDO -> DCDC: 1.2 ms)
+            Enabling this option will make chip powered by DCDC during light sleep to reduce some power switch
+            risks, this will also increase the power consumption during the light sleep.
+
+            DO NOT DISABLE UNLESS YOU KNOW WHAT YOU ARE DOING.
+
+    config ESP_SLEEP_DCM_VSET_VAL_IN_SLEEP
+        int "DCDC voltage parameter during sleep"
+        default 14
+        range 0 31
+        depends on ESP_SLEEP_KEEP_DCDC_ALWAYS_ON
+        help
+            This value determines the voltage of the DCDC chip during sleep. The same parameter value may
+            correspond to different voltage values on different models of DCDC chips. Please update this
+            value according to the model of external DCDC selected in your hardware solution.
+
+            For the DCDC chip model recommended by ESP, the recommended configuration
+            values are listed below:
+
+            - TI-TLV62569/TLV62569P: 14
+endmenu