qemu: add qemu target with and without MMU for CI and developer usage.

Add a qemu target for SOF that will build with native zephyr support
for drivers including xtensa MMU. This will be used for GH worklow
ztest validation and as a SDV for userspace work.

Signed-off-by: Liam Girdwood <liam.r.girdwood@linux.intel.com>

Author: lrgirdwo

app/boards/qemu_xtensa_dc233c.conf

@@ -0,0 +1,5 @@
+# SPDX-License-Identifier: BSD-3-Clause
+CONFIG_IPC_MAJOR_4=y
+CONFIG_ZTEST=y
+CONFIG_MM_DRV=y
+CONFIG_ZEPHYR_NATIVE_DRIVERS=y

app/boards/qemu_xtensa_dc233c_mmu.conf

@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: BSD-3-Clause
+CONFIG_IPC_MAJOR_4=y
+CONFIG_USERSPACE=y
+CONFIG_ZTEST=y
+CONFIG_TEST_USERSPACE=y
+CONFIG_MM_DRV=y
+CONFIG_ZEPHYR_NATIVE_DRIVERS=y

scripts/set_xtensa_params.sh

@@ -150,6 +150,12 @@ case "$platform" in
 	HOST="xtensa-mt8365-elf"
 	TOOLCHAIN_VER="RG-2018.9-linux"
 	;;
+    qemu_xtensa | qemu_xtensa_mmu)
+	PLATFORM="$1"
+	XTENSA_CORE=""
+	HOST="xtensa-zephyr-elf"
+	TOOLCHAIN_VER=""
+	;;
     *)
 	>&2 printf 'Unknown xtensa platform=%s\n' "$platform"
 	return 1
@@ -166,6 +172,8 @@ esac
 
 # For Zephyr unit tests
 case "$platform" in
+    qemu_xtensa | qemu_xtensa_mmu)
+        ZEPHYR_TOOLCHAIN_VARIANT='zephyr';;
     imx8*|mtl|lnl)
         ZEPHYR_TOOLCHAIN_VARIANT='xt-clang';;
     *) # The previous, main case/esac already caught invalid input.

scripts/xtensa-build-zephyr.py

@@ -227,6 +227,14 @@ class PlatformConfig:
 		"imx", "imx95_evk/mimx9596/m7/ddr",
 		"", "", "", ""
 	),
+	"qemu_xtensa" : PlatformConfig(
+		"zephyr", "qemu_xtensa/dc233c",
+		"", "", "zephyr"
+	),
+	"qemu_xtensa_mmu" : PlatformConfig(
+		"zephyr", "qemu_xtensa/dc233c/mmu",
+		"", "", "zephyr"
+	),
 }
 
 platform_configs = platform_configs_all.copy()
@@ -894,6 +902,7 @@ def build_platforms():
 		platform_build_dir_name = f"build-{platform}"
 
 		PLAT_CONFIG = platform_dict["PLAT_CONFIG"]
+
 		build_cmd = ["west"]
 		build_cmd += ["-v"] * args.verbose
 		if args.menuconfig:
@@ -1144,8 +1153,9 @@ def install_platform(platform, sof_output_dir, platf_build_environ, platform_wco
 		install_key_dir = install_key_dir / args.key_type_subdir
 
 	os.makedirs(install_key_dir, exist_ok=True)
-	# looses file owner and group - file is commonly accessible
-	shutil.copy2(abs_build_dir / "zephyr.ri", install_key_dir / output_fwname)
+	# looses file owner and group - file is commonly accessible, dont install qemu.
+	if platform not in ("qemu_xtensa", "qemu_xtensa_mmu"):
+		shutil.copy2(abs_build_dir / "zephyr.ri", install_key_dir / output_fwname)
 
 	if args.deployable_build and platform_configs[platform].ipc4:
 		# IPC4 deployable builds are using separate directories per platforms
@@ -1298,6 +1308,8 @@ def gzip_compress(fname, gzdst=None):
 RI_INFO_UNSUPPORTED += ['imx8', 'imx8x', 'imx8m', 'imx8ulp', 'imx95']
 RI_INFO_UNSUPPORTED += ['rn', 'acp_6_0']
 RI_INFO_UNSUPPORTED += ['mt8186', 'mt8188', 'mt8195', 'mt8196', 'mt8365']
+RI_INFO_UNSUPPORTED += ['qemu_xtensa', 'qemu_xtensa_mmu']
+
 
 # For temporary workarounds. Unlike _UNSUPPORTED above, the platforms below will print a warning.
 RI_INFO_FIXME = [ ]

src/platform/CMakeLists.txt

@@ -25,4 +25,6 @@ elseif(CONFIG_MT8196)
         add_subdirectory(mt8196)
 elseif(CONFIG_MT8365)
 	add_subdirectory(mt8365)
+elseif(PLATFORM STREQUAL "qemu_xtensa")
+	add_subdirectory(qemu_xtensa)
 endif()

src/platform/qemu_xtensa/CMakeLists.txt

@@ -0,0 +1,3 @@
+# SPDX-License-Identifier: BSD-3-Clause
+
+add_local_sources(sof platform.c)

src/platform/qemu_xtensa/include/platform/lib/clk.h

@@ -0,0 +1,13 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ *
+ * Copyright(c) 2026 Intel Corporation.
+ */
+
+#ifndef __PLATFORM_LIB_CLK_H__
+#define __PLATFORM_LIB_CLK_H__
+
+/* Dummy clk header for qemu_xtensa */
+#define CLK_MAX_CPU_HZ 10000000
+#define CPU_LOWEST_FREQ_IDX 0
+
+#endif /* __PLATFORM_LIB_CLK_H__ */

src/platform/qemu_xtensa/include/platform/lib/dai.h

@@ -0,0 +1,11 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ *
+ * Copyright(c) 2026 Intel Corporation.
+ */
+
+#ifndef __PLATFORM_LIB_DAI_H__
+#define __PLATFORM_LIB_DAI_H__
+
+/* Dummy dai header for qemu_xtensa */
+
+#endif /* __PLATFORM_LIB_DAI_H__ */

src/platform/qemu_xtensa/include/platform/lib/dma.h

@@ -0,0 +1,16 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ *
+ * Copyright(c) 2026 Intel Corporation.
+ */
+
+#ifndef __PLATFORM_LIB_DMA_H__
+#define __PLATFORM_LIB_DMA_H__
+
+/* Dummy dma header for qemu_xtensa */
+struct dma;
+
+struct sof_dma {
+	const struct device *z_dev;
+};
+
+#endif /* __PLATFORM_LIB_DMA_H__ */

src/platform/qemu_xtensa/include/platform/lib/mailbox.h

@@ -0,0 +1,34 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ *
+ * Copyright(c) 2026 Intel Corporation.
+ */
+
+#ifndef __PLATFORM_LIB_MAILBOX_H__
+#define __PLATFORM_LIB_MAILBOX_H__
+
+/* Dummy mailbox header for qemu_xtensa */
+#define MAILBOX_HOSTBOX_BASE 0x10000000
+#define MAILBOX_HOSTBOX_SIZE 0x1000
+#define MAILBOX_DSPBOX_BASE  0x10005000
+#define MAILBOX_DSPBOX_SIZE  0x1000
+#define MAILBOX_STREAM_BASE  0x10001000
+#define MAILBOX_STREAM_SIZE  0x1000
+#define MAILBOX_TRACE_BASE   0x10002000
+#define MAILBOX_TRACE_SIZE   0x1000
+#define MAILBOX_EXCEPTION_BASE 0x10003000
+#define MAILBOX_EXCEPTION_SIZE 0x1000
+#define MAILBOX_DEBUG_BASE   0x10004000
+#define MAILBOX_DEBUG_SIZE   0x1000
+#define MAILBOX_SW_REG_BASE  0x10005000
+#define MAILBOX_SW_REG_SIZE  0x1000
+
+#include <stddef.h>
+#include <stdint.h>
+
+static inline void mailbox_sw_regs_write(size_t offset, const void *src, size_t bytes) {}
+static inline void mailbox_sw_reg_write(size_t offset, uint32_t val) {}
+static inline void mailbox_sw_reg_write64(size_t offset, uint64_t val) {}
+static inline uint32_t mailbox_sw_reg_read(size_t offset) { return 0; }
+static inline uint64_t mailbox_sw_reg_read64(size_t offset) { return 0; }
+
+#endif /* __PLATFORM_LIB_MAILBOX_H__ */