mirror of
https://github.com/rtic-rs/rtic.git
synced 2024-12-01 16:04:33 +01:00
book: resources shared with init must also be Send
This commit is contained in:
parent
c4bad51deb
commit
e865cbb2e5
3 changed files with 47 additions and 0 deletions
|
@ -44,6 +44,14 @@ send operation where the initial value is sent from `idle`, which has the lowest
|
||||||
priority of `0`, to a task with will run with a priority greater than or equal
|
priority of `0`, to a task with will run with a priority greater than or equal
|
||||||
to `1`. Thus all late resources need to implement the `Send` trait.
|
to `1`. Thus all late resources need to implement the `Send` trait.
|
||||||
|
|
||||||
|
Sharing a resource with `init` can be used to implement late initialization, see
|
||||||
|
example below. For that reason, resources shared with `init` must also implement
|
||||||
|
the `Send` trait.
|
||||||
|
|
||||||
|
``` rust
|
||||||
|
{{#include ../../../../examples/shared-with-init.rs}}
|
||||||
|
```
|
||||||
|
|
||||||
## `Sync`
|
## `Sync`
|
||||||
|
|
||||||
Similarly, [`Sync`] is a marker trait for "types for which it is safe to share
|
Similarly, [`Sync`] is a marker trait for "types for which it is safe to share
|
||||||
|
|
|
@ -109,6 +109,7 @@ main() {
|
||||||
types
|
types
|
||||||
not-send
|
not-send
|
||||||
not-sync
|
not-sync
|
||||||
|
shared-with-init
|
||||||
|
|
||||||
generics
|
generics
|
||||||
ramfunc
|
ramfunc
|
||||||
|
|
38
examples/shared-with-init.rs
Normal file
38
examples/shared-with-init.rs
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
//! `examples/shared-with-init.rs`
|
||||||
|
|
||||||
|
#![deny(unsafe_code)]
|
||||||
|
#![deny(warnings)]
|
||||||
|
#![no_main]
|
||||||
|
#![no_std]
|
||||||
|
|
||||||
|
extern crate panic_halt;
|
||||||
|
|
||||||
|
use cortex_m_semihosting::debug;
|
||||||
|
use lm3s6965::Interrupt;
|
||||||
|
use rtfm::app;
|
||||||
|
|
||||||
|
pub struct MustBeSend;
|
||||||
|
|
||||||
|
#[app(device = lm3s6965)]
|
||||||
|
const APP: () = {
|
||||||
|
static mut SHARED: Option<MustBeSend> = None;
|
||||||
|
|
||||||
|
#[init(resources = [SHARED])]
|
||||||
|
fn init() {
|
||||||
|
// this `message` will be sent to task `UART0`
|
||||||
|
let message = MustBeSend;
|
||||||
|
*resources.SHARED = Some(message);
|
||||||
|
|
||||||
|
rtfm::pend(Interrupt::UART0);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[interrupt(resources = [SHARED])]
|
||||||
|
fn UART0() {
|
||||||
|
if let Some(message) = resources.SHARED.take() {
|
||||||
|
// `message` has been received
|
||||||
|
drop(message);
|
||||||
|
|
||||||
|
debug::exit(debug::EXIT_SUCCESS);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
Loading…
Reference in a new issue