5f87a34b6a
- Adds a executor for the Xtensa arch - Light sleep implemented with assembly, so we don't pull in the xtensa_lx crates (yet) - lock behind a nightly feature due to Xtensa asm support not upstream
47 lines
1.6 KiB
Rust
47 lines
1.6 KiB
Rust
//! 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.
|
|
|
|
#![deny(missing_docs)]
|
|
|
|
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::*;
|