tests: power_wakeup_timer: Tests the RTC alarm’s ability to wake the CPU

As above, the test verify the ability to wake up CPU
from the lowest power state. The test has been
prepared for stm32l562e_dk board.

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

Author: gbarkadiusz

tests/subsys/pm/power_wakeup_timer/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_wakeup_timer)
+
+FILE(GLOB app_sources src/*.c)
+target_sources(app PRIVATE ${app_sources})

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

@@ -0,0 +1,15 @@
+/*
+ * Copyright (c) 2025 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&rtc {
+	compatible = "st,stm32-rtc";
+	reg = < 0x40002800 0xc00 >;
+	interrupts = < 0x2 0x0 >;
+	clocks = < &rcc 0x58 0x400 >, < &rcc 0x2 0x16890 >;
+	prescaler = < 0x8000 >;
+	status = "okay";
+	wakeup-source;
+};

tests/subsys/pm/power_wakeup_timer/prj.conf

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

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

@@ -0,0 +1,94 @@
+/*
+ * Copyright (c) 2025 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/kernel.h>
+#include <zephyr/drivers/rtc.h>
+
+#define RTC_ALARM_FIELDS                                                                           \
+	(RTC_ALARM_TIME_MASK_SECOND | RTC_ALARM_TIME_MASK_MINUTE | RTC_ALARM_TIME_MASK_HOUR)
+
+static const struct device *rtc = DEVICE_DT_GET(DT_NODELABEL(rtc));
+
+static k_tid_t my_tid;
+
+#define MY_STACK_SIZE 500
+#define MY_PRIORITY   5
+
+struct k_thread my_thread_data;
+K_THREAD_STACK_DEFINE(my_stack_area, MY_STACK_SIZE);
+
+void my_entry_point(void *, void *, void *)
+{
+	printk("Going sleep.\n");
+	k_msleep(3000);
+}
+
+/* Fri Jan 01 2021 13:29:50 GMT+0000 */
+static const struct rtc_time rtc_time = {
+	.tm_sec = 50,
+	.tm_min = 29,
+	.tm_hour = 13,
+	.tm_mday = 1,
+	.tm_mon = 0,
+	.tm_year = 121,
+	.tm_wday = 5,
+	.tm_yday = 1,
+	.tm_isdst = -1,
+	.tm_nsec = 0,
+};
+
+/* Fri Jan 01 2021 13:29:51 GMT+0000 */
+static const struct rtc_time alarm_time = {
+	.tm_sec = 51,
+	.tm_min = 29,
+	.tm_hour = 13,
+	.tm_mday = 1,
+	.tm_mon = 0,
+	.tm_year = 121,
+	.tm_wday = 5,
+	.tm_yday = 1,
+	.tm_isdst = -1,
+	.tm_nsec = 0,
+};
+
+static void wakeup_cb(const struct device *dev, uint16_t id, void *user_data)
+{
+	printk("Wake up by alarm.\n");
+	k_thread_abort(my_tid);
+}
+
+int main(void)
+{
+	int ret;
+	uint16_t mask = RTC_ALARM_FIELDS;
+
+	ret = rtc_set_time(rtc, &rtc_time);
+	if (ret < 0) {
+		return 0;
+	}
+
+	ret = rtc_alarm_set_time(rtc, 0, mask, &alarm_time);
+	if (ret < 0) {
+		return 0;
+	}
+
+	ret = rtc_alarm_set_callback(rtc, 0, wakeup_cb, NULL);
+	if (ret < 0) {
+		return 0;
+	}
+
+	printk("Created the thread.\n");
+	my_tid = k_thread_create(&my_thread_data, my_stack_area,
+				 K_THREAD_STACK_SIZEOF(my_stack_area), my_entry_point, NULL, NULL,
+				 NULL, MY_PRIORITY, 0, K_NO_WAIT);
+
+	k_thread_join(my_tid, K_FOREVER);
+
+	while (1) {
+		arch_nop();
+	}
+	return 0;
+}

tests/subsys/pm/power_wakeup_timer/testcase.yaml

@@ -0,0 +1,32 @@
+# 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: 2
+      num_of_transitions: 1
+      expected_rms_values: [0.26, 140]
+      tolerance_percentage: 10
+
+tests:
+  pm.power_wakeup_timer:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+
+  pm.power_wakeup_timer.pm_device:
+    platform_allow:
+      - stm32l562e_dk
+    tags:
+      - pm
+    extra_args:
+      - CONFIG_PM_DEVICE=y