feat(esp_hw_support): support esp32p4 sleep cpu retention

components/esp_hw_support/include/esp_private/sleep_cpu.h

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -7,6 +7,9 @@
 #pragma once
 #include <stdint.h>
 #include "sdkconfig.h"
+#include "stdbool.h"
+#include "esp_err.h"
+#include "soc/soc_caps.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -18,8 +21,7 @@ extern "C" {
  * This file contains declarations of cpu retention related functions in light sleep mode.
  */
 
-#if SOC_PM_SUPPORT_CPU_PD
-
+#if CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP || SOC_PM_SUPPORT_CPU_PD
 /**
  * @brief Whether to allow the cpu power domain to be powered off.
  *
@@ -27,7 +29,9 @@ extern "C" {
  * for cpu retention, the cpu power domain can be powered off.
  */
 bool cpu_domain_pd_allowed(void);
+#endif
 
+#if CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
 /**
  * @brief Configure the parameters of the CPU domain during the sleep process
  *
@@ -38,10 +42,7 @@ bool cpu_domain_pd_allowed(void);
  */
 esp_err_t sleep_cpu_configure(bool light_sleep_enable);
 
-#endif
-
-#if SOC_PM_SUPPORT_CPU_PD && SOC_PM_CPU_RETENTION_BY_RTCCNTL
-
+#if SOC_PM_CPU_RETENTION_BY_RTCCNTL
 /**
  * @brief Enable cpu retention of some modules.
  *
@@ -57,16 +58,32 @@ void sleep_enable_cpu_retention(void);
  * retention of moudles such as CPU and I/D-cache tag memory.
  */
 void sleep_disable_cpu_retention(void);
+#endif // SOC_PM_CPU_RETENTION_BY_RTCCNTL
 
-#endif // SOC_PM_SUPPORT_CPU_PD && SOC_PM_CPU_RETENTION_BY_RTCCNTL
-
-
-#if SOC_PM_SUPPORT_CPU_PD && SOC_PM_CPU_RETENTION_BY_SW
-
+#if SOC_PM_CPU_RETENTION_BY_SW
 esp_err_t esp_sleep_cpu_retention(uint32_t (*goto_sleep)(uint32_t, uint32_t, uint32_t, bool),
         uint32_t wakeup_opt, uint32_t reject_opt, uint32_t lslp_mem_inf_fpu, bool dslp);
+#endif // SOC_PM_CPU_RETENTION_BY_SW
+#endif // CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
 
-#endif // SOC_PM_SUPPORT_CPU_PD && SOC_PM_CPU_RETENTION_BY_SW
+#if !CONFIG_FREERTOS_UNICORE && CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
+/**
+ * Do sleep prepare for other smp cores
+ */
+void sleep_smp_cpu_sleep_prepare(void);
+
+/**
+ * Do wakeup prepare for other smp cores
+ */
+void sleep_smp_cpu_wakeup_prepare(void);
+
+#if CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
+/**
+ * Notify the other core that this sleep does not require retention.
+ */
+void esp_sleep_cpu_skip_retention(void);
+#endif // CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
+#endif // !CONFIG_FREERTOS_UNICORE && CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
 
 #ifdef __cplusplus
 }

components/esp_hw_support/include/esp_sleep.h

@@ -713,7 +713,7 @@ void esp_default_wake_deep_sleep(void);
  */
 void esp_deep_sleep_disable_rom_logging(void);
 
-#ifdef SOC_PM_SUPPORT_CPU_PD
+#if CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
 
 #if SOC_PM_CPU_RETENTION_BY_RTCCNTL
 /**
@@ -752,7 +752,7 @@ esp_err_t esp_sleep_cpu_retention_init(void);
  * Release system retention memory.
  */
 esp_err_t esp_sleep_cpu_retention_deinit(void);
-#endif
+#endif // CONFIG_PM_POWER_DOWN_CPU_IN_LIGHT_SLEEP
 
 /**
  * @brief Configure to isolate all GPIO pins in sleep state