mirror of https://github.com/embassy-rs/embassy.git synced 2025-09-27 12:20:37 +00:00

History

James Munns 535c80e61f Add initial DRS scheduler placeholder

* Start hacking in cordyceps

This adds a third kind of runqueue, for now it should work the same as the
current "atomics" runqueue, but uses a cordyceps TransferStack instead of
the existing home-rolled linked list.

* Clean up, use new cordyceps feature

* A bit more cleanup

* Update docs to be more clear

2025-09-11 14:45:06 +02:00

src

Add initial DRS scheduler placeholder

2025-09-11 14:45:06 +02:00

tests

Fix test & rtos-trace

2025-08-29 13:30:11 +02:00

build_common.rs

Update Rust nightly, stable.

2025-07-04 00:23:22 +02:00

build.rs

Statically allocate task pools on stable Rust.

2025-03-28 19:11:53 +01:00

Cargo.toml

Add initial DRS scheduler placeholder

2025-09-11 14:45:06 +02:00

CHANGELOG.md

executor: always name main task main, not just with rtos-trace.

2025-09-05 14:57:05 +02:00

gen_config.py

[embassy-executor] improved documentation

2023-12-22 19:05:16 +01:00

README.md

Statically allocate task pools on stable Rust.

2025-03-28 19:11:53 +01:00

README.md

embassy-executor

An async/await executor designed for embedded usage.

No alloc, no heap needed.
Tasks are statically allocated. Each task gets its own static, with the exact size to hold the task (or multiple instances of it, if using pool_size) calculated automatically at compile time. If tasks don't fit in RAM, this is detected at compile time by the linker. Runtime panics due to running out of memory are not possible.
No "fixed capacity" data structures, executor works with 1 or 1000 tasks without needing config/tuning.
Integrated timer queue: sleeping is easy, just do Timer::after_secs(1).await;.
No busy-loop polling: CPU sleeps when there's no work to do, using interrupts or WFE/SEV.
Efficient polling: a wake will only poll the woken task, not all of them.
Fair: a task can't monopolize CPU time even if it's constantly being woken. All other tasks get a chance to run before a given task gets polled for the second time.
Creating multiple executor instances is supported, to run tasks with multiple priority levels. This allows higher-priority tasks to preempt lower-priority tasks.