mirror of
https://github.com/embassy-rs/embassy.git
synced 2025-09-27 04:10:25 +00:00
a52ca758ac
this requires you to install [`cargo-release`]. note that this does not include a URL pointing to the diff on GitHub as is usually done in changelogs since `embassy` is a mono-repo and the GH UI doesn't offer a commit view per folder (see the [GH feature request] for this). [`cargo-release`]: https://crates.io/crates/cargo-release [GH feature request]: https://github.com/orgs/community/discussions/162131
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 usingpool_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.