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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! The kernel interface.
//!
//! Not to be confused with [`r3_kernel`][], a kernel implementation.
//!
//! [`r3_kernel`]: https://crates.io/crates/r3_kernel

#[macro_use]
mod macros;

pub mod cfg;
mod error;
pub mod event_group;
mod global;
pub mod hook;
pub mod hunk;
pub mod interrupt;
pub mod mutex;
pub mod raw;
pub mod raw_cfg;
pub mod semaphore;
pub mod task;
pub mod timer;
pub use {
    cfg::Cfg,
    error::*,
    event_group::{
        EventGroup, EventGroupBits, EventGroupRef, EventGroupWaitFlags, StaticEventGroup,
    },
    global::*,
    hook::StartupHook,
    hunk::Hunk,
    interrupt::{InterruptLine, InterruptNum, InterruptPriority, StaticInterruptHandler},
    mutex::{Mutex, MutexProtocol, MutexRef, StaticMutex},
    raw::{Id, QueueOrder},
    semaphore::{Semaphore, SemaphoreRef, SemaphoreValue, StaticSemaphore},
    task::{LocalTask, StaticTask, Task, TaskRef},
    timer::{StaticTimer, Timer, TimerRef},
};

/// The prelude module. This module re-exports [`Kernel`][2] and other extension
/// traits with impl-only-use (`use ... as _`, [RFC2166][1]).
///
/// <div class="admonition-follows"></div>
///
/// > **Rationale:** A prelude module is usually imported with a wildcard
/// > import (`use ...::prelude::*`). Name collisions caused by a wildcard
/// > import are difficult to notice (but cause a very confusing error) and
/// > fragile against otherwise-harmless upstream changes because imported
/// > names are not explicitly spelled in the source code.
/// >
/// > `Kernel` is not designed to be used in trait bounds, and system types are
/// > not supposed to have an associated function conflicting with those from
/// > `Kernel`. For these reasons, it's mostly useless to import the name
/// > `Kernel`.
///
/// [1]: https://rust-lang.github.io/rfcs/2166-impl-only-use.html
/// [2]: crate::kernel::Kernel
#[doc = include_str!("../common.md")]
pub mod prelude {
    #[doc(no_inline)]
    pub use super::{
        event_group::{EventGroupHandle as _, EventGroupMethods as _},
        mutex::{MutexHandle as _, MutexMethods as _},
        semaphore::{SemaphoreHandle as _, SemaphoreMethods as _},
        task::{TaskHandle as _, TaskMethods as _},
        timer::{TimerHandle as _, TimerMethods as _},
        Kernel as _,
    };
}

/// Re-exports all traits defined under this module for convenience.
pub mod traits {
    #[doc(no_inline)]
    pub use super::{
        cfg::{CfgStatic, KernelStatic},
        event_group::{EventGroupHandle, EventGroupMethods},
        mutex::{MutexHandle, MutexMethods},
        raw::{
            KernelAdjustTime, KernelBase, KernelBoostPriority, KernelEventGroup,
            KernelInterruptLine, KernelMutex, KernelSemaphore, KernelTaskSetPriority, KernelTime,
            KernelTimer,
        },
        raw_cfg::{
            CfgBase, CfgEventGroup, CfgInterruptLine, CfgMutex, CfgSemaphore, CfgTask, CfgTimer,
        },
        semaphore::{SemaphoreHandle, SemaphoreMethods},
        task::{TaskHandle, TaskMethods},
        timer::{TimerHandle, TimerMethods},
        Kernel,
    };
}