Skip to content

schedule: add support for user-space LL scheduler #10508

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kv2019i wants to merge 6 commits into
base: main
Choose a base branch
from
+585 −43
Open

schedule: add support for user-space LL scheduler #10508

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ea745aa
zephyr: userspace_helper: add function to add common partition to domain
kv2019i Feb 4, 2026
e16e507
schedule: add support for user-space LL scheduler
kv2019i Jan 29, 2026
39a4d06
debug: telemetry: add a dependency to kernel mode LL thread
kv2019i Jan 15, 2026
1cc9722
schedule: add a dependency for LL stats on kernel mode LL thread
kv2019i Jan 15, 2026
d9149c0
zephyr: test: add test case for user-space ll scheduling
kv2019i Jan 29, 2026
6531ead
zephyr: test: align Cmake style
kv2019i Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/debug/telemetry/Kconfig
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
config SOF_TELEMETRY
bool "enable telemetry"
default n
depends on !SOF_USERSPACE_LL
Copy link
Member

@lgirdwood lgirdwood Feb 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume here we still need to map this page with timer IO for user as RO ?

Copy link
Collaborator Author

@kv2019i kv2019i Feb 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lgirdwood Not sure I understand connection with timer IO. Telemetry does direct writes to the debug window in shared memory and these are writes are down from various call sites in SOF codebase. Mapping the debug window to ll thread is one option, but given this is optional (and not really used in Linux), this is something we can easily tackle later if needed.

Copy link
Collaborator

@lyakh lyakh Feb 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we need the addition of the Kconfig entry at least together with this patch, not after it. Even if kconfig doesn't complain and just takes a non-existing option as false, I'd still not do that

Copy link
Collaborator Author

@kv2019i kv2019i Feb 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ack, I'll moved it later in the series. Will be in V3. Doesn't have to be in same commit as SOF_USERSPACE_LL is not yet used and is disabled by default.

help
Enables telemetry. Enables performance measurements and debug utilities
that use memory window 2 (debug window) as interface. Measurements include
Expand Down
35 changes: 33 additions & 2 deletions src/include/sof/schedule/ll_schedule_domain.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,11 @@ struct ll_schedule_domain_ops {
struct ll_schedule_domain {
uint64_t next_tick; /**< ticks just set for next run */
uint64_t new_target_tick; /**< for the next set, used during the reschedule stage */
struct k_spinlock lock; /**< standard lock */
#ifdef CONFIG_SOF_USERSPACE_LL
struct k_mutex *lock; /**< standard lock */
#else
struct k_spinlock lock; /**< standard lock */
#endif
atomic_t total_num_tasks; /**< total number of registered tasks */
atomic_t enabled_cores; /**< number of enabled cores */
uint32_t ticks_per_ms; /**< number of clock ticks per ms */
Expand All @@ -93,13 +97,26 @@ static inline struct ll_schedule_domain *dma_domain_get(void)
return sof_get()->platform_dma_domain;
}

#ifdef CONFIG_SOF_USERSPACE_LL
struct task *zephyr_ll_task_alloc(void);
struct k_heap *zephyr_ll_user_heap(void);
void zephyr_ll_user_resources_init(void);
#endif /* CONFIG_SOF_USERSPACE_LL */

static inline struct ll_schedule_domain *domain_init
(int type, int clk, bool synchronous,
const struct ll_schedule_domain_ops *ops)
{
struct ll_schedule_domain *domain;

#ifdef CONFIG_SOF_USERSPACE_LL
domain = sof_heap_alloc(zephyr_ll_user_heap(), SOF_MEM_FLAG_USER | SOF_MEM_FLAG_COHERENT,
sizeof(*domain), sizeof(void *));
if (domain)
memset(domain, 0, sizeof(*domain));
#else
domain = rzalloc(SOF_MEM_FLAG_KERNEL | SOF_MEM_FLAG_COHERENT, sizeof(*domain));
#endif
if (!domain)
return NULL;
domain->type = type;
Expand All @@ -116,7 +133,17 @@ static inline struct ll_schedule_domain *domain_init
domain->next_tick = UINT64_MAX;
domain->new_target_tick = UINT64_MAX;

#ifdef CONFIG_SOF_USERSPACE_LL
/* Allocate mutex dynamically for userspace access */
domain->lock = k_object_alloc(K_OBJ_MUTEX);
if (!domain->lock) {
sof_heap_free(zephyr_ll_user_heap(), domain);
return NULL;
}
k_mutex_init(domain->lock);
#else
k_spinlock_init(&domain->lock);
#endif
atomic_init(&domain->total_num_tasks, 0);
atomic_init(&domain->enabled_cores, 0);

Expand Down Expand Up @@ -246,7 +273,11 @@ struct ll_schedule_domain *zephyr_dma_domain_init(struct dma *dma_array,
struct ll_schedule_domain *zephyr_ll_domain(void);
struct ll_schedule_domain *zephyr_domain_init(int clk);
#define timer_domain_init(timer, clk) zephyr_domain_init(clk)
#endif
#ifdef CONFIG_SOF_USERSPACE_LL
struct k_thread *zephyr_domain_thread_tid(struct ll_schedule_domain *domain);
struct k_mem_domain *zephyr_ll_mem_domain(void);
#endif /* CONFIG_SOF_USERSPACE_LL */
#endif /* __ZEPHYR__ */

struct ll_schedule_domain *dma_multi_chan_domain_init(struct dma *dma_array,
uint32_t num_dma, int clk,
Expand Down
4 changes: 4 additions & 0 deletions src/init/init.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -218,6 +218,10 @@ __cold static int primary_core_init(int argc, char *argv[], struct sof *sof)
io_perf_monitor_init();
#endif

#if CONFIG_SOF_USERSPACE_LL
zephyr_ll_user_resources_init();
#endif

/* init the platform */
if (platform_init(sof) < 0)
sof_panic(SOF_IPC_PANIC_PLATFORM);
Expand Down
4 changes: 4 additions & 0 deletions src/schedule/CMakeLists.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,4 +54,8 @@ zephyr_library_sources_ifdef(CONFIG_ZEPHYR_TWB_SCHEDULER
zephyr_twb_schedule.c
)

zephyr_library_sources_ifdef(CONFIG_SOF_USERSPACE_LL
zephyr_ll_user.c
)

endif()
1 change: 1 addition & 0 deletions src/schedule/Kconfig
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ config SCHEDULE_DMA_MULTI_CHANNEL
config SCHEDULE_LL_STATS_LOG
bool "Log low-latency scheduler statistics"
default y
depends on !SOF_USERSPACE_LL
help
Log statistics from low-latency scheduler. This is a low overhead
mechanism to gather average and worst-case execution times of
Expand Down
Loading
Loading