bern-kernel 0.3.0

Preemptive real-time kernel for microcontrollers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! Generic event system.

use crate::mem::linked_list::LinkedList;
use crate::exec::runnable::Runnable;

/// Event errors.
#[allow(dead_code)]
#[repr(u8)]
pub enum Error {
    /// Time out reached while pending for an event
    TimeOut,
    /// No event matches the ID
    InvalidId,
}

/// Event wake strategy.
#[allow(dead_code)]
pub enum Wake {
    /// Wake first from pendable list
    WakeFirst,
    /// Wake all from pendable list
    WakeAll,
}

/// Generic event system.
#[allow(dead_code)]
pub struct Event {
    /// Event identifier (randomize to protect access)
    id: usize,
    /// Tasks waiting for the event
    pub pending: LinkedList<Runnable>,
    /// Wake strategy on event
    wake: Wake,
    /// Apply priority inversion
    priority_inversion: bool,
}

impl Event {
    /// Allocate a new event from a given unique ID.
    pub fn new(id: usize) -> Self {
        Event {
            id,
            pending: LinkedList::new(),
            wake: Wake::WakeFirst,
            priority_inversion: false,
        }
    }

    /// Get the ID of this event.
    pub fn id(&self) -> usize {
        self.id
    }
}