tests: power_residency_time: Tests the residency time of each power state

This test evaluates the residency time of different power states
on the stm32l562e_dk board and calculates the
RMS (Root Mean Square) current for every detected state.

Signed-off-by: Arkadiusz Cholewinski <arkadiuszx.cholewinski@intel.com>

Author: gbarkadiusz

tests/subsys/pm/power_residency_time/CMakeLists.txt

@@ -0,0 +1,9 @@
+# Copyright (c) 2025 Intel Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(power_residency_time)
+
+FILE(GLOB app_sources src/*.c)
+target_sources(app PRIVATE ${app_sources})

tests/subsys/pm/power_residency_time/boards/stm32l562e_dk.overlay

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2025 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&stop0{
+	compatible = "zephyr,power-state";
+	power-state-name = "suspend-to-idle";
+	substate-id = <1>;
+	min-residency-us = <500000>;
+};
+&stop1{
+	compatible = "zephyr,power-state";
+	power-state-name = "suspend-to-idle";
+	substate-id = <2>;
+	min-residency-us = <1000000>;
+};
+&stop2{
+	compatible = "zephyr,power-state";
+	power-state-name = "suspend-to-idle";
+	substate-id = <3>;
+	min-residency-us = <1500000>;
+};

tests/subsys/pm/power_residency_time/prj.conf

@@ -0,0 +1,4 @@
+# Copyright (c) 2025 Intel Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+CONFIG_PM=y

tests/subsys/pm/power_residency_time/src/main.c

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2025 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/kernel.h>
+#include <zephyr/devicetree.h>
+
+#define DIFF_RESIDENCY_TIME_STATE_0 600
+#define DIFF_RESIDENCY_TIME_STATE_1 600
+#define DIFF_RESIDENCY_TIME_STATE_2 600
+
+int main(void)
+{
+
+	int stop0_min_residency_time = DT_PROP(DT_NODELABEL(stop0), min_residency_us);
+	int stop1_min_residency_time = DT_PROP(DT_NODELABEL(stop1), min_residency_us);
+	int stop2_min_residency_time = DT_PROP(DT_NODELABEL(stop2), min_residency_us);
+
+	while (1) {
+		printk("\nSleep time < min_residency_time of state 0\n");
+		k_usleep(stop0_min_residency_time - DIFF_RESIDENCY_TIME_STATE_0);
+		printk("\nSleep time = min_residency_time of state 0\n");
+		k_usleep(stop0_min_residency_time);
+		printk("\nSleep time < min_residency_time of state 1\n");
+		k_usleep(stop1_min_residency_time - DIFF_RESIDENCY_TIME_STATE_1);
+		printk("\nSleep time = min_residency_time of state 1\n");
+		k_usleep(stop1_min_residency_time);
+		printk("\nSleep time < min_residency_time of state 2\n");
+		k_usleep(stop2_min_residency_time - DIFF_RESIDENCY_TIME_STATE_2);
+		printk("\nSleep time = min_residency_time of state 2\n");
+		k_usleep(stop2_min_residency_time);
+		printk("\nWakeup.\n");
+
+		/**
+		 * Keeping alive loop
+		 */
+		while (1) {
+			arch_nop();
+		}
+	}
+	return 0;
+}

tests/subsys/pm/power_residency_time/testcase.yaml

@@ -0,0 +1,50 @@
+# Copyright (c) 2025 Intel Corporation
+# SPDX-License-Identifier: Apache-2.0
+
+common:
+  harness: power
+  harness_config:
+    fixture: pm_probe
+    pytest_dut_scope: session
+    power_measurements:
+      elements_to_trim: 100
+      min_peak_distance: 40
+      min_peak_height: 0.008
+      peak_padding: 40
+      measurement_duration: 8
+      num_of_transitions: 6
+      expected_rms_values: [56.0, 4.0, 4.0, 1.4, 1.4, 0.26, 91]
+      tolerance_percentage: 10
+
+tests:
+  pm.power_residency_time:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+
+  pm.power_residency_time.pm_device:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+    extra_args:
+      - CONFIG_PM_DEVICE=y
+
+  pm.power_residency_time.pm_device_runtime:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+    extra_args:
+      - CONFIG_PM_DEVICE=y
+      - CONFIG_PM_DEVICE_RUNTIME=y
+
+  pm.power_residency_time.pm_device_system_managed:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+    extra_args:
+      - CONFIG_PM_DEVICE=y
+      - CONFIG_PM_DEVICE_SYSTEM_MANAGED=y