tests: benchmarks: multicore: Remote GDF switching

Add test cases for fast counter, pwm, spim, uarte
instances where global domain frequency is changed
from remote application. Use solution for
synchronization of host and remote core like in
idle_pwm_loopback case.

Signed-off-by: Piotr Krzyzanowski <piotr.krzyzanowski@nordicsemi.no>

Author: nordic-pikr

tests/benchmarks/multicore/common/remote_gdf_switching/CMakeLists.txt

@@ -0,0 +1,12 @@
+#
+# Copyright (c) 2025 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(remote_sleep_forever)
+
+target_sources(app PRIVATE src/main.c)

tests/benchmarks/multicore/common/remote_gdf_switching/boards/nrf54h20dk_nrf54h20_cpurad.overlay

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+/ {
+	aliases {
+		led = &led1;
+	};
+
+	leds {
+		compatible = "gpio-leds";
+		led1: led_1 {
+			gpios = <&gpio9 1 GPIO_ACTIVE_HIGH>;
+			label = "Green LED 1";
+		};
+	};
+};
+
+&gpio9 {
+	status = "okay";
+};
+
+&gpiote130 {
+	status = "okay";
+};
+
+&uart135 {
+	status = "disabled";
+	/delete-property/memory-regions;
+};

tests/benchmarks/multicore/common/remote_gdf_switching/prj.conf

@@ -0,0 +1,9 @@
+CONFIG_CLOCK_CONTROL=y
+
+CONFIG_PM=y
+CONFIG_POWEROFF=y
+CONFIG_CONSOLE=n
+CONFIG_UART_CONSOLE=n
+CONFIG_SERIAL=n
+CONFIG_GPIO=y
+CONFIG_BOOT_BANNER=n

tests/benchmarks/multicore/common/remote_gdf_switching/src/main.c

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+#include <zephyr/cache.h>
+#include <zephyr/drivers/gpio.h>
+#include <zephyr/devicetree/clocks.h>
+#include <zephyr/drivers/clock_control/nrf_clock_control.h>
+#include <zephyr/kernel.h>
+
+#define REMOTE_IS_READY	(2)
+#define SHM_START_ADDR		(DT_REG_ADDR(DT_NODELABEL(cpuapp_cpurad_ipc_shm)))
+volatile static uint32_t *shared_var = (volatile uint32_t *) SHM_START_ADDR;
+
+static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(DT_ALIAS(led), gpios);
+
+const uint32_t freq[] = {320, 256, 128, 64};
+
+/*
+ * Set Global Domain frequency (HSFLL120)
+ */
+void set_global_domain_frequency(uint32_t freq)
+{
+	int err;
+	int res;
+	struct onoff_client cli;
+	const struct device *hsfll_dev = DEVICE_DT_GET(DT_NODELABEL(hsfll120));
+	const struct nrf_clock_spec clk_spec_global_hsfll = {.frequency = MHZ(freq)};
+
+	printk("Requested frequency [Hz]: %d\n", clk_spec_global_hsfll.frequency);
+	sys_notify_init_spinwait(&cli.notify);
+	err = nrf_clock_control_request(hsfll_dev, &clk_spec_global_hsfll, &cli);
+	__ASSERT((err >= 0 && err < 3), "Wrong nrf_clock_control_request return code");
+	do {
+		err = sys_notify_fetch_result(&cli.notify, &res);
+		k_yield();
+	} while (err == -EAGAIN);
+	__ASSERT(err == 0, "Wrong clock control request return code");
+	__ASSERT(res == 0, "Wrong clock control request response");
+}
+
+int main(void)
+{
+	uint32_t counter = 0;
+
+	gpio_pin_configure_dt(&led, GPIO_OUTPUT_INACTIVE);
+
+	*shared_var = REMOTE_IS_READY;
+	sys_cache_data_flush_range((void *) shared_var, sizeof(*shared_var));
+	k_msleep(300);
+
+	while (1) {
+		gpio_pin_set_dt(&led, 1);
+		set_global_domain_frequency(freq[counter++ % ARRAY_SIZE(freq)]);
+		k_busy_wait(1000);
+		gpio_pin_set_dt(&led, 0);
+		k_msleep(2000);
+	}
+
+	return 0;
+}

tests/benchmarks/multicore/idle_counter/Kconfig

@@ -12,4 +12,8 @@ config TEST_SLEEP_DURATION_MS
 	  Based on the value of 'min-residency-us' specified for each power state defined in the DTS,
 	  core enters the lowest possible power state.
 
+config GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING
+	bool "Enable global domain frequency changing"
+	select CLOCK_CONTROL
+
 source "Kconfig.zephyr"

tests/benchmarks/multicore/idle_counter/prj.conf

@@ -9,6 +9,8 @@ CONFIG_PM=y
 CONFIG_PM_S2RAM=y
 CONFIG_PM_S2RAM_CUSTOM_MARKING=y
 CONFIG_POWEROFF=y
+CONFIG_CONSOLE=n
+CONFIG_UART_CONSOLE=n
 CONFIG_SERIAL=n
 CONFIG_BOOT_BANNER=n
 CONFIG_LOG=n

tests/benchmarks/multicore/idle_counter/remote/Kconfig

@@ -12,4 +12,15 @@ config TEST_SLEEP_DURATION_MS
 	  Based on the value of 'min-residency-us' specified for each power state defined in the DTS,
 	  core enters the lowest possible power state.
 
+config TEST_ROLE_REMOTE
+	bool "Execute test variant for Remote core"
+	default y
+	help
+	  KConfig used in synchronization phase.
+	  Set TEST_ROLE_REMOTE=y on core that shall synchronize with the Host core.
+
+config GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING
+	bool "Enable global domain frequency changing from remote"
+	select CLOCK_CONTROL
+
 source "Kconfig.zephyr"

tests/benchmarks/multicore/idle_counter/remote/prj.conf

@@ -14,5 +14,6 @@ CONFIG_CONSOLE=n
 CONFIG_UART_CONSOLE=n
 CONFIG_SERIAL=n
 CONFIG_BOOT_BANNER=n
+CONFIG_LOG=n
 
 CONFIG_ASSERT=y

tests/benchmarks/multicore/idle_counter/src/main.c

@@ -5,6 +5,7 @@
  */
 
 #include <zephyr/kernel.h>
+#include <zephyr/cache.h>
 #include <zephyr/drivers/gpio.h>
 #include <zephyr/drivers/counter.h>
 #include <zephyr/logging/log.h>
@@ -13,16 +14,21 @@
 
 LOG_MODULE_REGISTER(idle_counter);
 
+#define SHM_START_ADDR (DT_REG_ADDR(DT_NODELABEL(cpuapp_cpurad_ipc_shm)))
+volatile static uint32_t *shared_var = (volatile uint32_t *)SHM_START_ADDR;
+#define HOST_IS_READY	(1)
+#define REMOTE_IS_READY (2)
+
 static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(DT_ALIAS(led), gpios);
 
 #define ALARM_CHANNEL_ID (0)
 const struct device *const counter_dev = DEVICE_DT_GET(DT_ALIAS(counter));
 
 static K_SEM_DEFINE(my_sem, 0, 1);
 
-#if defined(CONFIG_CLOCK_CONTROL) && defined(CONFIG_SOC_NRF54H20_CPUAPP)
 const uint32_t freq[] = {320, 256, 128, 64};
 
+#if defined(CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING)
 /*
  * Set Global Domain frequency (HSFLL120)
  */
@@ -45,12 +51,11 @@ void set_global_domain_frequency(uint32_t freq)
 	__ASSERT(err == 0, "Wrong clock control request return code");
 	__ASSERT(res == 0, "Wrong clock control request response");
 }
-#endif /* CONFIG_CLOCK_CONTROL && CONFIG_SOC_NRF54H20_CPUAPP */
+#endif /* CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING */
 
 void counter_handler(const struct device *counter_dev, uint8_t chan_id, uint32_t ticks,
 		     void *user_data)
 {
-	gpio_pin_set_dt(&led, 1);
 	k_sem_give(&my_sem);
 	counter_stop(counter_dev);
 }
@@ -92,6 +97,17 @@ void verify_timer(uint32_t start_time)
 		 "expected time to elapse is 1s");
 }
 
+void sleep_with_state_indication(uint32_t sleep_duration_ms)
+{
+	int ret;
+
+	ret = gpio_pin_set_dt(&led, 0);
+	__ASSERT(ret == 0, "Unable to turn off LED");
+	k_msleep(sleep_duration_ms);
+	ret = gpio_pin_set_dt(&led, 1);
+	__ASSERT(ret == 0, "Unable to turn on LED");
+}
+
 int main(void)
 {
 	uint32_t start_time;
@@ -106,28 +122,45 @@ int main(void)
 	/* Wait a bit to solve NRFS request timeout issue. */
 	k_msleep(500);
 
-	while (1) {
-		ret = gpio_pin_set_dt(&led, 0);
-		__ASSERT(ret == 0, "Unable to turn off LED");
-		k_msleep(CONFIG_TEST_SLEEP_DURATION_MS);
-		ret = gpio_pin_set_dt(&led, 1);
-		__ASSERT(ret == 0, "Unable to turn on LED");
-		k_busy_wait(100000);
+	/* Synchronize Remote core with Host core */
+#if !defined(CONFIG_TEST_ROLE_REMOTE)
+	LOG_DBG("HOST starts");
+	*shared_var = HOST_IS_READY;
+	sys_cache_data_flush_range((void *)shared_var, sizeof(*shared_var));
+	LOG_DBG("HOST wrote HOST_IS_READY: %u", *shared_var);
+	while (*shared_var != REMOTE_IS_READY) {
+		sys_cache_data_invd_range((void *)shared_var, sizeof(*shared_var));
+		LOG_DBG("shared_var is: %u", *shared_var);
+	}
+	LOG_DBG("HOST continues");
+#else
+	LOG_DBG("REMOTE starts");
+	while (*shared_var != HOST_IS_READY) {
+		sys_cache_data_invd_range((void *)shared_var, sizeof(*shared_var));
+		LOG_DBG("shared_var is: %u", *shared_var);
+	}
+	LOG_DBG("REMOTE found that HOST_IS_READY");
+	*shared_var = REMOTE_IS_READY;
+	sys_cache_data_flush_range((void *)shared_var, sizeof(*shared_var));
+	LOG_DBG("REMOTE wrote REMOTE_IS_READY: %u", *shared_var);
+	LOG_DBG("REMOTE continues");
+#endif
 
-#if defined(CONFIG_CLOCK_CONTROL) && defined(CONFIG_SOC_NRF54H20_CPUAPP)
-		for (int i = 0; i <= ARRAY_SIZE(freq); i++) {
+	while (1) {
+		sleep_with_state_indication(CONFIG_TEST_SLEEP_DURATION_MS);
+		for (int i = 0; i < ARRAY_SIZE(freq); i++) {
 			start_time = start_timer(counter_dev);
-			if (i) {
-				set_global_domain_frequency(freq[i - 1]);
-			}
+			k_msleep(100);
+#if defined(CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING)
+			sleep_with_state_indication(CONFIG_TEST_SLEEP_DURATION_MS / 2 - 100);
+			set_global_domain_frequency(freq[(i + 1) % ARRAY_SIZE(freq)]);
+			k_msleep(10);
+#endif /* CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING */
 			verify_timer(start_time);
-			k_busy_wait(100000);
 		}
-#else
-		start_time = start_timer(counter_dev);
-		verify_timer(start_time);
-		k_busy_wait(100000);
-#endif /* CONFIG_CLOCK_CONTROL && CONFIG_SOC_NRF54H20_CPUAPP */
+		ret = gpio_pin_set_dt(&led, 1);
+		__ASSERT(ret == 0, "Unable to turn on LED");
+		k_msleep(100);
 	}
 
 	return 0;

tests/benchmarks/multicore/idle_counter/sysbuild.cmake

@@ -4,10 +4,12 @@
 # SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 #
 
-# Add remote project
-ExternalZephyrProject_Add(
+if(SB_CONFIG_SOC_NRF54H20)
+  # Add remote project
+  ExternalZephyrProject_Add(
     APPLICATION remote
-    SOURCE_DIR ${ZEPHYR_NRF_MODULE_DIR}/tests/benchmarks/power_consumption/common/remote_sleep_forever
+    SOURCE_DIR ${APP_DIR}/remote
     BOARD ${SB_CONFIG_BOARD}/${SB_CONFIG_SOC}/cpurad
     BOARD_REVISION ${BOARD_REVISION}
-)
+  )
+endif()

tests/benchmarks/multicore/idle_counter/testcase.yaml

@@ -1,18 +1,27 @@
 common:
+  sysbuild: true
+  integration_platforms:
+    - nrf54h20dk/nrf54h20/cpuapp
+  platform_allow:
+    - nrf54h20dk/nrf54h20/cpuapp
   tags:
     - ppk_power_measure
     - ci_tests_benchmarks_current_consumption
 tests:
   benchmarks.power_consumption.counter:
-    sysbuild: true
-    integration_platforms:
-      - nrf54h20dk/nrf54h20/cpuapp
-    platform_allow:
-      - nrf54h20dk/nrf54h20/cpuapp
     extra_args:
-      - CONFIG_CLOCK_CONTROL=y
+      - idle_counter_CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING=y
     harness: pytest
     harness_config:
       fixture: ppk_power_measure
       pytest_root:
-        - "${CUSTOM_ROOT_TEST_DIR}/test_measure_power_consumption.py::test_measure_and_data_dump_fast_timer_and_s2ram_with_clock_control"
+        - "${CUSTOM_ROOT_TEST_DIR}/test_measure_power_consumption.py::test_measure_and_data_dump_fast_counter_and_s2ram_with_clock_control"
+
+  benchmarks.power_consumption.counter.remote_gd_freq_switching:
+    extra_args:
+      - remote_CONFIG_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING=y
+    harness: pytest
+    harness_config:
+      fixture: ppk_power_measure
+      pytest_root:
+        - "${CUSTOM_ROOT_TEST_DIR}/test_measure_power_consumption.py::test_measure_and_data_dump_fast_counter_and_s2ram_with_clock_control"

tests/benchmarks/multicore/idle_pwm_loopback/Kconfig.sysbuild

@@ -6,6 +6,5 @@
 
 source "${ZEPHYR_BASE}/share/sysbuild/Kconfig"
 
-config REMOTE_BOARD
-	string
-	default "$(BOARD)/nrf54h20/cpurad" if SOC_NRF54H20_CPUAPP
+config REMOTE_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING
+	bool "Enable global domain frequency changing from remote"

tests/benchmarks/multicore/idle_pwm_loopback/sysbuild.cmake

@@ -4,14 +4,18 @@
 # SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 #
 
-if("${SB_CONFIG_REMOTE_BOARD}" STREQUAL "")
-  message(FATAL_ERROR "REMOTE_BOARD must be set to a valid board name")
-endif()
+if(SB_CONFIG_SOC_NRF54H20)
+  if(SB_CONFIG_REMOTE_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING)
+    set(REMOTE_SOURCE_DIR ${ZEPHYR_NRF_MODULE_DIR}/tests/benchmarks/multicore/common/remote_gdf_switching)
+  else()
+    set(REMOTE_SOURCE_DIR ${APP_DIR}/remote)
+  endif()
 
-# Add remote project
-ExternalZephyrProject_Add(
+  # Add remote project
+  ExternalZephyrProject_Add(
     APPLICATION remote
-    SOURCE_DIR ${APP_DIR}/remote
-    BOARD ${SB_CONFIG_REMOTE_BOARD}
+    SOURCE_DIR ${REMOTE_SOURCE_DIR}
+    BOARD ${SB_CONFIG_BOARD}/${SB_CONFIG_SOC}/cpurad
     BOARD_REVISION ${BOARD_REVISION}
-)
+  )
+endif()

tests/benchmarks/multicore/idle_pwm_loopback/testcase.yaml

@@ -90,6 +90,19 @@ tests:
       pytest_root:
         - "${CUSTOM_ROOT_TEST_DIR}/test_measure_power_consumption.py::test_measure_and_data_dump_pwm_and_s2ram"
 
+  benchmarks.multicore.idle_pwm_loopback.nrf54h20dk_cpuapp_cpurad.s2ram_fast.remote_gd_freq_switching:
+    filter: not CONFIG_COVERAGE
+    tags: ppk_power_measure
+    extra_args:
+      - idle_pwm_loopback_CONF_FILE=prj_s2ram.conf
+      - idle_pwm_loopback_DTC_OVERLAY_FILE="boards/nrf54h20dk_nrf54h20_cpuapp_fast_p7_1.overlay"
+      - SB_CONFIG_REMOTE_GLOBAL_DOMAIN_CLOCK_FREQUENCY_SWITCHING=y
+    harness: pytest
+    harness_config:
+      fixture: spi_loopback
+      pytest_root:
+        - "${CUSTOM_ROOT_TEST_DIR}/test_measure_power_consumption.py::test_measure_and_data_dump_pwm_and_s2ram"
+
   benchmarks.multicore.idle_pwm_loopback.nrf54h20dk_cpuapp_cpurad.s2ram_fast.gd_freq_320MHz:
     filter: not CONFIG_COVERAGE
     tags: ppk_power_measure