2 releases
0.1.1 | Sep 21, 2020 |
---|---|
0.1.0 | Sep 13, 2020 |
#513 in Embedded development
120KB
2K
SLoC
juggle
Async task switching for
cooperative multitasking
in single thread environments with no_std
support.
This library provides tools to dynamically manage group of tasks in single threaded or embedded
environments. Note than this is not an operating system but can serve as a simple replacement
where you don't need context switches, for example on embedded applications.
Tasks use async/await mechanisms of Rust and it's programmer job to insert switching
points into them. Luckily this crate provides Yield
utility for this as well as
handling busy waits. Primary scheduler (Wheel
) can dynamically spawn, suspend, resume
or cancel tasks managed by round robin algorithm.
Crate by default uses std library (feature std
) but also can be configured
as #![no_std]
with alloc
crate, this disables some features in utils
module.
Examples
Simple program that reads data from sensor and processes it.
use juggle::*;
use alloc::collections::VecDeque;
use core::cell::RefCell;
async fn collect_temperature(queue: &RefCell<VecDeque<i32>>,handle: WheelHandle<'_>){
loop{ // loop forever or until cancelled
let temperature: i32 = read_temperature_sensor().await;
queue.borrow_mut().push_back(temperature);
yield_once!(); // give scheduler opportunity to execute other tasks
}
}
async fn wait_for_timer(id: IdNum,queue: &RefCell<VecDeque<i32>>,handle: WheelHandle<'_>){
init_timer();
for _ in 0..5 {
yield_while!(get_timer_value() < 200); // busy wait but also executes other tasks.
process_data(&mut queue.borrow_mut());
reset_timer();
}
handle.cancel(id); // cancel 'collect_temperature' task.
shutdown_timer();
}
fn main(){
let queue = &RefCell::new(VecDeque::new());
let wheel = Wheel::new();
let handle = wheel.handle(); // handle to manage tasks, can be cloned inside this thread
let temp_id = handle.spawn(SpawnParams::default(),
collect_temperature(queue,handle.clone()));
handle.spawn(SpawnParams::default(),
wait_for_timer(temp_id.unwrap(),queue,handle.clone()));
// execute tasks
smol::block_on(wheel).unwrap(); // or any other utility to block on future.
}
Dependencies
~73KB