[−][src]Module drone_cortex_m::thr
The Threads module.
NOTE A Drone platform crate may re-export this module with its own additions under the same name, in which case it should be used instead.
Drone is a hard real-time operating system. It uses interrupt-based preemptive priority scheduling, where tasks with same priorities are executed cooperatively. A task unit, called Fiber in Drone, is a stack-less co-routine programmed with Rust async/await and/or generator syntax.
A Drone application maps available prioritized interrupts to Drone threads.
The number of threads is always static but configurable. Any number of
fibers can be attached to particular threads, see [fib
] for details. The
Drone application configures its own thread type, which implements
Thread
, and creates a continuous array of this type.
use drone_core::thr; thr! { // Path to the array of threads. use THREADS; /// The thread object. pub struct Thr { // You can add your own fields to the thread object. These fields will be // accessible through `to_thr` method of thread tokens. The types of // these fields should be `Sync`. pub foo: bool = false; } // This is a part of `Thr` that can be accessed with `thr::local` function. /// The thread-local storage. pub struct ThrLocal { // You can add your own fields here with the same syntax as above. // Note that the initializer uses the special `index` variable, that // has the value of the position of the thread within the threads array. // The types of these fields shouldn't necessarily be `Sync`. pub bar: usize = index; } } // This is for example only. Platform crates should provide macros to // automatically generate this. static mut THREADS: [Thr; 2] = [Thr::new(0), Thr::new(1)];
Modules
prelude | The Threads prelude. |
Structs
PreemptedCell | Thread-local previous thread index cell. |
TaskCell | Thread-local task context cell. |
Traits
Thread | Generic thread. |
ThreadLocal | Generic thread-local storage. |
Functions
local | Returns a reference to the thread-local storage of the current thread. |
thread_resume⚠ | The thread handler function. |