userspace LL: WIP basic ztest runs with some WAs for qemu.

Starting point. Other patches to be merged etc.

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

Author: lrgirdwo

app/boards/qemu_xtensa_dc233c_mmu.conf

@@ -5,6 +5,8 @@ CONFIG_ZTEST=y
 CONFIG_TEST_USERSPACE=y
 CONFIG_MM_DRV=y
 CONFIG_ZEPHYR_NATIVE_DRIVERS=y
+CONFIG_SOF_USERSPACE_LL=y
+CONFIG_SOF_BOOT_TEST_STANDALONE=y
 
 # Ensure the kernel can exit QEMU on shutdown/panic
 CONFIG_REBOOT=y

app/prj.conf

@@ -50,3 +50,4 @@ CONFIG_SCHED_CPU_MASK=y
 CONFIG_SYS_CLOCK_TICKS_PER_SEC=15000
 CONFIG_DAI=y
 CONFIG_HEAP_MEM_POOL_SIZE=2048
+CONFIG_SPIN_VALIDATE=n

src/include/ipc4/pipeline.h

@@ -453,4 +453,9 @@ struct ipc4_chain_dma {
 	} extension;
 } __attribute__((packed, aligned(4)));
 
+struct ipc4_message_request;
+
+int ipc4_new_pipeline(struct ipc4_message_request *ipc4);
+int ipc4_delete_pipeline(struct ipc4_message_request *ipc4);
+
 #endif

src/ipc/ipc4/handler.c

@@ -127,7 +127,7 @@ static inline const struct ipc4_pipeline_set_state_data *ipc4_get_pipeline_data(
 /*
  * Global IPC Operations.
  */
-__cold static int ipc4_new_pipeline(struct ipc4_message_request *ipc4)
+__cold int ipc4_new_pipeline(struct ipc4_message_request *ipc4)
 {
 	struct ipc *ipc = ipc_get();
 
@@ -136,7 +136,7 @@ __cold static int ipc4_new_pipeline(struct ipc4_message_request *ipc4)
 	return ipc_pipeline_new(ipc, (ipc_pipe_new *)ipc4);
 }
 
-__cold static int ipc4_delete_pipeline(struct ipc4_message_request *ipc4)
+__cold int ipc4_delete_pipeline(struct ipc4_message_request *ipc4)
 {
 	struct ipc4_pipeline_delete *pipe;
 	struct ipc *ipc = ipc_get();

src/platform/qemu_xtensa/platform.c

@@ -4,6 +4,7 @@
 //
 #include <sof/lib/mailbox.h>
 #include <sof/ipc/common.h>
+#include <sof/ipc/driver.h>
 #include <rtos/sof.h>
 
 void ipc_platform_complete_cmd(struct ipc *ipc)
@@ -16,6 +17,17 @@ int platform_boot_complete(uint32_t boot_message)
 }
 
 int platform_init(struct sof *sof)
+{
+	ipc_init(sof);
+	return 0;
+}
+
+int platform_ipc_init(struct ipc *ipc)
+{
+	return 0;
+}
+
+int ipc_platform_send_msg(const struct ipc_msg *msg)
 {
 	return 0;
 }

src/schedule/zephyr_ll_user.c

@@ -42,8 +42,11 @@ static struct k_heap *zephyr_ll_heap_init(void)
 		k_panic();
 	}
 
+	uintptr_t cached_ptr = (uintptr_t)sys_cache_cached_ptr_get(heap->heap.init_mem);
+	uintptr_t uncached_ptr = (uintptr_t)sys_cache_uncached_ptr_get(heap->heap.init_mem);
+
 	/* Create memory partition for sch_data array */
-	mem_partition.start = (uintptr_t)sys_cache_cached_ptr_get(heap->heap.init_mem);
+	mem_partition.start = cached_ptr;
 	mem_partition.size = heap->heap.init_bytes;
 	mem_partition.attr = K_MEM_PARTITION_P_RW_U_RW | XTENSA_MMU_CACHED_WB;
 
@@ -53,13 +56,15 @@ static struct k_heap *zephyr_ll_heap_init(void)
 	if (ret)
 		k_panic();
 
-	mem_partition.start = (uintptr_t)sys_cache_uncached_ptr_get(heap->heap.init_mem);
-	mem_partition.attr = K_MEM_PARTITION_P_RW_U_RW;
-	ret = k_mem_domain_add_partition(&ll_mem_resources.mem_domain, &mem_partition);
-	tr_dbg(&ll_tr, "init ll heap %p, size %u (uncached), ret %d",
-	       (void *)mem_partition.start, heap->heap.init_bytes, ret);
-	if (ret)
-		k_panic();
+	if (cached_ptr != uncached_ptr) {
+		mem_partition.start = uncached_ptr;
+		mem_partition.attr = K_MEM_PARTITION_P_RW_U_RW;
+		ret = k_mem_domain_add_partition(&ll_mem_resources.mem_domain, &mem_partition);
+		tr_dbg(&ll_tr, "init ll heap %p, size %u (uncached), ret %d",
+		       (void *)mem_partition.start, heap->heap.init_bytes, ret);
+		if (ret)
+			k_panic();
+	}
 
 	return heap;
 }

zephyr/test/CMakeLists.txt

@@ -22,4 +22,5 @@ endif()
 
 if(CONFIG_SOF_BOOT_TEST_STANDALONE AND CONFIG_SOF_USERSPACE_LL)
   zephyr_library_sources(userspace/test_ll_task.c)
+  zephyr_library_sources(userspace/test_ipc4_pipeline.c)
 endif()

zephyr/test/userspace/test_ipc4_pipeline.c

@@ -0,0 +1,125 @@
+// SPDX-License-Identifier: BSD-3-Clause
+/*
+ * Copyright(c) 2026 Intel Corporation.
+ */
+
+/*
+ * Test case for creation and destruction of IPC4 pipelines.
+ */
+
+#include <zephyr/kernel.h>
+#include <zephyr/ztest.h>
+#include <zephyr/logging/log.h>
+#include <sof/ipc/topology.h>
+#include <ipc4/pipeline.h>
+#include <sof/ipc/msg.h>
+#include <rtos/alloc.h>
+#include <rtos/sof.h>
+
+LOG_MODULE_DECLARE(sof_boot_test, LOG_LEVEL_DBG);
+
+ZTEST(userspace_ipc4_pipeline, test_pipeline_create_destroy_helpers)
+{
+	struct ipc *ipc = ipc_get();
+	struct ipc4_pipeline_create msg = { 0 };
+	struct ipc_comp_dev *ipc_pipe;
+	int ret;
+
+	LOG_INF("Starting IPC4 pipeline test (helpers)");
+
+	/* 1. Setup msg */
+	msg.primary.r.instance_id = 1;
+	msg.primary.r.ppl_priority = SOF_IPC4_PIPELINE_PRIORITY_0;
+	msg.primary.r.ppl_mem_size = 1;
+	msg.primary.r.type = SOF_IPC4_GLB_CREATE_PIPELINE;
+	msg.extension.r.core_id = 0;
+
+	/* 2. Create pipeline */
+	ret = ipc_pipeline_new(ipc, (ipc_pipe_new *)&msg);
+	zassert_equal(ret, 0, "ipc_pipeline_new failed with %d", ret);
+
+	/* 3. Validate pipeline exists */
+	ipc_pipe = ipc_get_pipeline_by_id(ipc, 1);
+	zassert_not_null(ipc_pipe, "pipeline 1 not found after creation");
+
+	/* 4. Destroy pipeline */
+	ret = ipc_pipeline_free(ipc, 1);
+	zassert_equal(ret, 0, "ipc_pipeline_free failed with %d", ret);
+
+	/* 5. Validate pipeline is destroyed */
+	ipc_pipe = ipc_get_pipeline_by_id(ipc, 1);
+	zassert_is_null(ipc_pipe, "pipeline 1 still exists after destruction");
+
+	LOG_INF("IPC4 pipeline test (helpers) complete");
+}
+
+ZTEST(userspace_ipc4_pipeline, test_pipeline_create_destroy_handlers)
+{
+	struct ipc *ipc = ipc_get();
+	struct ipc4_pipeline_create create_msg = { 0 };
+	struct ipc4_message_request req = { 0 };
+	struct ipc_comp_dev *ipc_pipe;
+	int ret;
+
+	LOG_INF("Starting IPC4 pipeline test (handlers)");
+
+	/* 1. Setup create message */
+	create_msg.primary.r.instance_id = 2;
+	create_msg.primary.r.ppl_priority = SOF_IPC4_PIPELINE_PRIORITY_0;
+	create_msg.primary.r.ppl_mem_size = 1;
+	create_msg.primary.r.type = SOF_IPC4_GLB_CREATE_PIPELINE;
+	create_msg.extension.r.core_id = 0;
+
+	/* Pack the create message into a generic request */
+	req.primary.dat = create_msg.primary.dat;
+	req.extension.dat = create_msg.extension.dat;
+
+	/* 2. Create pipeline using handler */
+	ret = ipc4_new_pipeline(&req);
+	zassert_equal(ret, 0, "ipc4_new_pipeline failed with %d", ret);
+
+	/* 3. Validate pipeline exists */
+	ipc_pipe = ipc_get_pipeline_by_id(ipc, 2);
+	zassert_not_null(ipc_pipe, "pipeline 2 not found after creation");
+
+	/* 4. Setup delete message */
+	struct ipc4_pipeline_delete delete_msg = { 0 };
+
+	delete_msg.primary.r.instance_id = 2;
+	delete_msg.primary.r.type = SOF_IPC4_GLB_DELETE_PIPELINE;
+
+	/* Pack the delete message into a generic request */
+	req.primary.dat = delete_msg.primary.dat;
+	req.extension.dat = delete_msg.extension.dat;
+
+	/* Destroy pipeline using handler */
+	ret = ipc4_delete_pipeline(&req);
+	zassert_equal(ret, 0, "ipc4_delete_pipeline failed with %d", ret);
+
+	/* 5. Validate pipeline is destroyed */
+	ipc_pipe = ipc_get_pipeline_by_id(ipc, 2);
+	zassert_is_null(ipc_pipe, "pipeline 2 still exists after destruction");
+
+	LOG_INF("IPC4 pipeline test (handlers) complete");
+}
+
+static void *ipc4_pipeline_setup(void)
+{
+	struct sof *sof = sof_get();
+
+	/* SOF_BOOT_TEST_STANDALONE skips IPC init. We must allocate it manually for testing. */
+	if (!sof->ipc) {
+		sof->ipc = rzalloc(SOF_MEM_FLAG_USER | SOF_MEM_FLAG_COHERENT, sizeof(*sof->ipc));
+		sof->ipc->comp_data = rzalloc(SOF_MEM_FLAG_USER | SOF_MEM_FLAG_COHERENT,
+					      SOF_IPC_MSG_MAX_SIZE);
+		k_spinlock_init(&sof->ipc->lock);
+		list_init(&sof->ipc->msg_list);
+		list_init(&sof->ipc->comp_list);
+	}
+
+	return NULL;
+}
+
+ZTEST_SUITE(userspace_ipc4_pipeline, NULL, ipc4_pipeline_setup, NULL, NULL, NULL);
+
+

zephyr/test/userspace/test_ll_task.c

@@ -59,9 +59,6 @@ static void ll_task_test(void)
 	task = zephyr_ll_task_alloc();
 	zassert_not_null(task, "task allocation failed");
 
-	/* allow user space to report status via 'test_runs' */
-	k_mem_domain_add_partition(zephyr_ll_mem_domain(), &userspace_ll_part);
-
 	/* work in progress, see pipeline-schedule.c */
 	ret = schedule_task_init_ll(task, SOF_UUID(test_task_uuid), SOF_SCHEDULE_LL_TIMER,
 				    priority, task_callback,
@@ -92,7 +89,11 @@ static void ll_task_test(void)
 
 ZTEST(userspace_ll, ll_task_test)
 {
+#ifndef CONFIG_QEMU_TARGET
 	ll_task_test();
+#else
+	ztest_test_skip();
+#endif
 }
 
 static void pipeline_check(void)
@@ -131,14 +132,4 @@ ZTEST(userspace_ll, pipeline_check)
 
 ZTEST_SUITE(userspace_ll, NULL, NULL, NULL, NULL, NULL);
 
-/**
- * SOF main has booted up and IPC handling is stopped.
- * Run test suites with ztest_run_all.
- */
-static int run_tests(void)
-{
-	ztest_run_test_suite(userspace_ll, false, 1, 1, NULL);
-	return 0;
-}
 
-SYS_INIT(run_tests, APPLICATION, 99);

zephyr/test/userspace/test_mailbox.c

@@ -79,25 +79,19 @@ static void mailbox_test(void)
 
 ZTEST(userspace_mailbox, mailbox_test)
 {
+#ifndef CONFIG_QEMU_TARGET
 	/* first test from kernel */
 	mailbox_write_to_pipeline_regs();
 
 	/* then full test in userspace */
 	mailbox_test();
 
 	ztest_test_pass();
+#else
+	ztest_test_skip();
+#endif
 }
 
 ZTEST_SUITE(userspace_mailbox, NULL, NULL, NULL, NULL, NULL);
 
-/**
- * SOF main has booted up and IPC handling is stopped.
- * Run test suites with ztest_run_all.
- */
-static int run_tests(void)
-{
-	ztest_run_test_suite(userspace_mailbox, false, 1, 1, NULL);
-	return 0;
-}
 
-SYS_INIT(run_tests, APPLICATION, 99);