tests: add sdh_evt_dispatch helper file

Add a small helper file to dispatch SoftDevice events to registered
observers. This avoids boilerplate in tests, and clutter in the
implementations under test to keep the observer's handlers global
when compiling unit test.

Signed-off-by: Emanuele Di Santo <emdi@nordicsemi.no>

Author: lemrey

CODEOWNERS

@@ -105,6 +105,7 @@
 # Tests
 /tests/subsys/fs/bm_zms/                    @nrfconnect/ncs-bm @rghaddab
 /tests/subsys/kmu/                          @nrfconnect/ncs-eris @nrfconnect/ncs-eris-test
+/tests/unit/common/                         @nrfconnect/ncs-bm
 /tests/unit/lib/                            @nrfconnect/ncs-bm
 /tests/unit/lib/bluetooth/ble_adv/          @nrfconnect/ncs-bm-test
 /tests/unit/lib/bluetooth/ble_conn_params/  @nrfconnect/ncs-bm

Kconfig.nrf_bm

@@ -16,6 +16,7 @@ rsource "lib/Kconfig"
 rsource "modules/Kconfig"
 rsource "samples/Kconfig"
 rsource "subsys/Kconfig"
+rsource "tests/Kconfig"
 # zephyr-keep-sorted-stop
 
 endif # NCS_BM

lib/bluetooth/ble_conn_state/ble_conn_state.c

@@ -372,11 +372,7 @@ uint32_t ble_conn_state_for_each_set_user_flag(uint16_t flag_index,
 	return for_each_set_flag(bcs.flags.user_flags[flag_index], user_function, ctx);
 }
 
-#ifdef CONFIG_UNITY
-void ble_evt_handler(const ble_evt_t *ble_evt, void *ctx)
-#else
 static void ble_evt_handler(const ble_evt_t *ble_evt, void *ctx)
-#endif
 {
 	int idx = nrf_sdh_ble_idx_get(ble_evt->evt.gap_evt.conn_handle);
 

subsys/storage/bm_storage/sd/bm_storage_sd.c

@@ -97,10 +97,7 @@ static const struct bm_storage_info bm_storage_info = {
 	.is_erase_before_write = false,
 };
 
-#ifndef CONFIG_UNITY
-static
-#endif
-void bm_storage_sd_on_soc_evt(uint32_t evt, void *ctx);
+static void bm_storage_sd_on_soc_evt(uint32_t evt, void *ctx);
 
 static bool on_operation_success(struct bm_storage_sd_op *op);
 
@@ -498,10 +495,7 @@ int bm_storage_sd_on_state_evt(enum nrf_sdh_state_evt evt, void *ctx)
 }
 NRF_SDH_STATE_EVT_OBSERVER(sdh_state_evt, bm_storage_sd_on_state_evt, NULL, HIGH);
 
-#ifndef CONFIG_UNITY
-static
-#endif
-void bm_storage_sd_on_soc_evt(uint32_t evt, void *ctx)
+static void bm_storage_sd_on_soc_evt(uint32_t evt, void *ctx)
 {
 	bool operation_finished;
 

tests/Kconfig

@@ -0,0 +1,9 @@
+#
+# Copyright (c) 2026 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+config TEST_SDH_EVT_DISPATCH
+	bool "SoftDevice event dispatch test utility"
+	depends on UNITY

tests/unit/CMakeLists.txt

@@ -5,3 +5,5 @@
 #
 
 include(${CMAKE_CURRENT_LIST_DIR}/cmake/softdevice_unity_setup.cmake)
+
+add_subdirectory(common)

tests/unit/common/CMakeLists.txt

@@ -0,0 +1,7 @@
+#
+# Copyright (c) 2026 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+add_subdirectory_ifdef(CONFIG_TEST_SDH_EVT_DISPATCH sdh_evt_dispatch)

tests/unit/common/sdh_evt_dispatch/CMakeLists.txt

@@ -0,0 +1,12 @@
+#
+# Copyright (c) 2026 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+zephyr_library_named(sdh_evt_dispatch)
+
+zephyr_include_directories(include)
+zephyr_library_sources(sdh_evt_dispatch.c)
+
+zephyr_linker_sources(SECTIONS sdh_evt_dispatch.ld)

tests/unit/common/sdh_evt_dispatch/include/sdh_evt_dispatch.h

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+/**
+ * @file
+ * @brief Test utility for dispatching SoftDevice events to registered observers.
+ *
+ * Allows unit tests to send BLE, SoC, and state events to all observers
+ * registered via NRF_SDH_BLE_OBSERVER, NRF_SDH_SOC_OBSERVER, and
+ * NRF_SDH_STATE_EVT_OBSERVER without needing to make handler functions
+ * non-static or extern.
+ */
+
+#ifndef SDH_EVT_DISPATCH_H__
+#define SDH_EVT_DISPATCH_H__
+
+#include <ble.h>
+#include <bm/softdevice_handler/nrf_sdh.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Dispatch a BLE event to all registered BLE observers.
+ *
+ * Iterates the nrf_sdh_ble_evt_observers iterable section and invokes
+ * each observer's handler in priority order.
+ *
+ * @param evt BLE event to dispatch.
+ */
+void sdh_evt_dispatch_ble(const ble_evt_t *evt);
+
+/**
+ * @brief Dispatch a SoC event to all registered SoC observers.
+ *
+ * Iterates the nrf_sdh_soc_evt_observers iterable section and invokes
+ * each observer's handler in priority order.
+ *
+ * @param evt_id SoC event ID to dispatch.
+ */
+void sdh_evt_dispatch_soc(uint32_t evt_id);
+
+/**
+ * @brief Dispatch a state event to all registered state observers.
+ *
+ * Iterates the nrf_sdh_state_evt_observers iterable section and invokes
+ * each observer's handler in priority order.
+ *
+ * @param state State event to dispatch.
+ */
+void sdh_evt_dispatch_state(enum nrf_sdh_state_evt state);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* SDH_EVT_DISPATCH_H__ */

tests/unit/common/sdh_evt_dispatch/sdh_evt_dispatch.c

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+ */
+
+#include <sdh_evt_dispatch.h>
+#include <bm/softdevice_handler/nrf_sdh_ble.h>
+#include <bm/softdevice_handler/nrf_sdh_soc.h>
+#include <zephyr/sys/iterable_sections.h>
+
+void sdh_evt_dispatch_ble(const ble_evt_t *evt)
+{
+	TYPE_SECTION_FOREACH(struct nrf_sdh_ble_evt_observer,
+			     nrf_sdh_ble_evt_observers, obs) {
+		obs->handler(evt, obs->context);
+	}
+}
+
+void sdh_evt_dispatch_soc(uint32_t evt_id)
+{
+	TYPE_SECTION_FOREACH(struct nrf_sdh_soc_evt_observer,
+			     nrf_sdh_soc_evt_observers, obs) {
+		obs->handler(evt_id, obs->context);
+	}
+}
+
+void sdh_evt_dispatch_state(enum nrf_sdh_state_evt state)
+{
+	TYPE_SECTION_FOREACH(struct nrf_sdh_state_evt_observer,
+			     nrf_sdh_state_evt_observers, obs) {
+		obs->handler(state, obs->context);
+	}
+}