drivers: firmware: nrf_ironside: Add TDD

Added support for the IRONside TDD service which allows configuring and
powering the TraceAndDebug Domain.

Signed-off-by: Karsten Koenig <[email protected]>

Author: karstenkoenig

drivers/firmware/nrf_ironside/CMakeLists.txt

@@ -7,4 +7,5 @@ zephyr_library_sources_ifdef(CONFIG_NRF_IRONSIDE_CALL call.c)
 
 zephyr_library_sources_ifdef(CONFIG_NRF_IRONSIDE_BOOT_REPORT boot_report.c)
 zephyr_library_sources_ifdef(CONFIG_NRF_IRONSIDE_CPUCONF_SERVICE cpuconf.c)
+zephyr_library_sources_ifdef(CONFIG_NRF_IRONSIDE_TDD_SERVICE tdd.c)
 zephyr_library_sources_ifdef(CONFIG_NRF_IRONSIDE_UPDATE_SERVICE update.c)

drivers/firmware/nrf_ironside/Kconfig

@@ -37,6 +37,12 @@ config NRF_IRONSIDE_CPUCONF_SERVICE
 	help
 	  Service used to boot local domain cores.
 
+config NRF_IRONSIDE_TDD_SERVICE
+	bool "IRONside tdd service"
+	select NRF_IRONSIDE_CALL
+	help
+	  Service used to control the trace and debug domain.
+
 config NRF_IRONSIDE_UPDATE_SERVICE
 	bool "IRONside update service"
 	select NRF_IRONSIDE_CALL

drivers/firmware/nrf_ironside/tdd.c

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/drivers/firmware/nrf_ironside/tdd.h>
+#include <zephyr/drivers/firmware/nrf_ironside/call.h>
+
+int ironside_tdd(const enum ironside_tdd_config config)
+{
+	int err;
+	struct ironside_call_buf *const buf = ironside_call_alloc();
+
+	buf->id = IRONSIDE_CALL_ID_TDD_V0;
+	buf->args[IRONSIDE_TDD_SERVICE_REQ_CONFIG_IDX] = (uint32_t) config;
+
+	ironside_call_dispatch(buf);
+
+	if (buf->status == IRONSIDE_CALL_STATUS_RSP_SUCCESS) {
+		err = buf->args[IRONSIDE_TDD_SERVICE_RSP_RETCODE_IDX];
+	} else {
+		err = buf->status;
+	}
+
+	ironside_call_release(buf);
+
+	return err;
+}

include/zephyr/drivers/firmware/nrf_ironside/tdd.h

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2025 Nordic Semiconductor ASA
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef ZEPHYR_INCLUDE_ZEPHYR_DRIVERS_FIRMWARE_NRF_IRONSIDE_TDD_H_
+#define ZEPHYR_INCLUDE_ZEPHYR_DRIVERS_FIRMWARE_NRF_IRONSIDE_TDD_H_
+
+#include <zephyr/drivers/firmware/nrf_ironside/call.h>
+
+#include <nrfx.h>
+
+#define IRONSIDE_TDD_ERROR_EINVAL (22) /* Invalid argument */
+
+
+#define IRONSIDE_CALL_ID_TDD_V0 3
+
+#define IRONSIDE_TDD_SERVICE_REQ_CONFIG_IDX 0
+#define IRONSIDE_TDD_SERVICE_RSP_RETCODE_IDX 0
+
+enum ironside_tdd_config {
+	/** Don't touch the configuration */
+	IRONSIDE_TDD_CONFIG_NO_CHANGE = 0, /* This allows future extensions to the TDD service */
+	/** Turn off the TDD */
+	IRONSIDE_TDD_CONFIG_OFF = 1, 
+	/** Turn on the TDD with default configuration */
+	IRONSIDE_TDD_CONFIG_ON_DEFAULT = 2,
+	/** Turn on the TDD with default configuration, but skip TPIU pin configuration */
+	IRONSIDE_TDD_CONFIG_ON_DEFAULT_NO_PINS = 3,
+};
+
+/**
+ * @brief Control the Trace and Debug Domain (TDD).
+ *
+ * @param config The configuration to be applied.
+ *
+ * @retval 0 on success.
+ * @retval -IRONSIDE_TDD_ERROR_EINVAL on invalid argument.
+ */
+int ironside_tdd(const enum ironside_tdd_config config);
+
+#endif /* ZEPHYR_INCLUDE_ZEPHYR_DRIVERS_FIRMWARE_NRF_IRONSIDE_TDD_H_ */