From a0f1b0ee01d461607660d2d56b5b1bdc57e0d3fb Mon Sep 17 00:00:00 2001 From: Dario Nieuwenhuis Date: Fri, 29 Jul 2022 21:58:35 +0200 Subject: Split embassy crate into embassy-executor, embassy-util. --- embassy-executor/src/executor/mod.rs | 44 ++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 embassy-executor/src/executor/mod.rs (limited to 'embassy-executor/src/executor/mod.rs') diff --git a/embassy-executor/src/executor/mod.rs b/embassy-executor/src/executor/mod.rs new file mode 100644 index 000000000..45d00c568 --- /dev/null +++ b/embassy-executor/src/executor/mod.rs @@ -0,0 +1,44 @@ +//! Async task executor. +//! +//! This module provides an async/await executor designed for embedded usage. +//! +//! - No `alloc`, no heap needed. Task futures are statically allocated. +//! - 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(Duration::from_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. + +cfg_if::cfg_if! { + if #[cfg(cortex_m)] { + #[path="arch/cortex_m.rs"] + mod arch; + pub use arch::*; + } + else if #[cfg(target_arch="riscv32")] { + #[path="arch/riscv32.rs"] + mod arch; + pub use arch::*; + } + else if #[cfg(all(target_arch="xtensa", feature = "nightly"))] { + #[path="arch/xtensa.rs"] + mod arch; + pub use arch::*; + } + else if #[cfg(feature="wasm")] { + #[path="arch/wasm.rs"] + mod arch; + pub use arch::*; + } + else if #[cfg(feature="std")] { + #[path="arch/std.rs"] + mod arch; + pub use arch::*; + } +} + +pub mod raw; + +mod spawner; +pub use spawner::*; -- cgit