[nrf noup] soc/nordic/nrf54h/pm_s2ram: S2RAM resume hardening

Added support for hardening decision on resume from
S2RAM by MCUboot bootloader.
Application sets additional variable to MCUBOOT_S2RAM_RESUME_MAGIC
which allows the bootloader to doublecheck.

Signed-off-by: Andrzej Puzdrowski <[email protected]>
(cherry picked from commit d4bb1c6)

Author: nvlsianpu

boards/nordic/nrf54h20dk/nrf54h20dk_nrf54h20_cpuapp.dts

@@ -366,14 +366,21 @@ zephyr_udc0: &usbhs {
 		};
 
 		/* temporary stack for S2RAM resume logic */
-		pm_s2ram_stack: cpuapp_s2ram_stack@22007fd0 {
+		pm_s2ram_stack: cpuapp_s2ram_stack@22007fcc {
 			compatible = "zephyr,memory-region", "mmio-sram";
-			reg = <0x22007fd0 16>;
+			reg = <0x22007fcc 16>;
 			zephyr,memory-region = "pm_s2ram_stack";
 		};
 
+		/* run-time common mcuboot S2RAM support section */
+		mcuboot_s2ram: cpuapp_s2ram@22007fdc {
+			compatible = "zephyr,memory-region", "mmio-sram";
+			reg = <0x22007fdc 4>;
+			zephyr,memory-region = "mcuboot_s2ram_context";
+		};
+
 		/* run-time common S2RAM cpu context RAM */
-		pm_s2ram: cpuapp_s2ram@22007fe0  {
+		pm_s2ram: cpuapp_s2ram@22007fe0 {
 			compatible = "zephyr,memory-region", "mmio-sram";
 			reg = <0x22007fe0 32>;
 			zephyr,memory-region = "pm_s2ram_context";

soc/nordic/nrf54h/pm_s2ram.c

@@ -77,11 +77,25 @@ static void fpu_power_up(void)
 }
 #endif /* defined(CONFIG_FPU) */
 
+#if DT_NODE_EXISTS(DT_NODELABEL(mcuboot_s2ram)) &&\
+	DT_NODE_HAS_COMPAT(DT_NODELABEL(mcuboot_s2ram), zephyr_memory_region)
+/* Linker section name is given by `zephyr,memory-region` property of
+ * `zephyr,memory-region` compatible DT node with nodelabel `mcuboot_s2ram`.
+ */
+__attribute__((section(DT_PROP(DT_NODELABEL(mcuboot_s2ram), zephyr_memory_region))))
+volatile struct mcuboot_resume_s _mcuboot_resume;
+
+#define SET_MCUBOOT_RESUME_MAGIC() _mcuboot_resume.magic = MCUBOOT_S2RAM_RESUME_MAGIC
+#else
+#define SET_MCUBOOT_RESUME_MAGIC()
+#endif
+
 int soc_s2ram_suspend(pm_s2ram_system_off_fn_t system_off)
 {
 	int ret;
 
 	z_arm_save_scb_context(&backup_data.scb_context);
+	SET_MCUBOOT_RESUME_MAGIC();
 #if defined(CONFIG_FPU)
 #if !defined(CONFIG_FPU_SHARING)
 	z_arm_save_fp_context(&backup_data.fpu_context);

soc/nordic/nrf54h/pm_s2ram.h

@@ -10,6 +10,12 @@
 #ifndef _ZEPHYR_SOC_ARM_NORDIC_NRF_PM_S2RAM_H_
 #define _ZEPHYR_SOC_ARM_NORDIC_NRF_PM_S2RAM_H_
 
+#define MCUBOOT_S2RAM_RESUME_MAGIC 0x75832419
+
+struct mcuboot_resume_s {
+	uint32_t magic; /* magic value to identify valid structure */
+};
+
 /**
  * @brief Save CPU state on suspend
  *