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
92
93
94
95
96
97

// SPDX-License-Identifier: AGPL-3.0-or-later
// Copyright 2020 Branan Riley <me@branan.info>

//! A library for simple asynchronous embedded programming
//!
//! ```
//! use cntrlr::prelude::*;
//! use core::futures::pending;
//!
//! #[entry]
//! async fn main() -> ! {
//!    serial_1().enable(9600);
//!    writeln!(serial_1(), "Hello, World").await.expect("Failed to message");
//!    pending().await
//! }
//! ```
//!
//! For an API overview, check the [`prelude`] module. This is the
//! core set of functionality provided by Cntrlr, and provides
//! functionality for most applications.
//!
//! For hardware-specific functionality, each supported board and
//! microcontroller has its own module under [`hw`]. Note that there
//! are currently both safety and ergonomics issues with these
//! lower-level APIs, and they don't provide much more functionality
//! than what is needed to implement the main Cntrlr API. They will be
//! expanded as time goes on, and will be improved for correcntess and
//! usability.

#![no_std]
#![allow(incomplete_features)]
#![deny(missing_docs)]
#![feature(
    alloc_error_handler,
    asm,
    cfg_target_has_atomic,
    future_poll_fn,
    generic_associated_types,
    naked_functions,
    never_type,
    type_alias_impl_trait
)]
#![cfg_attr(feature = "doc-cfg", feature(doc_cfg))]

extern crate alloc;

pub mod digital;
pub mod hw;
pub mod io;
pub mod sync;
pub mod task;
pub mod time;

/// Support Macros
pub mod macros {
    pub use cntrlr_macros::{entry, raw_entry, reset};
}

/// Common functions and traits for using Cntrlr
pub mod prelude {
    pub use crate::digital::{PinMode, Pull};
    pub use crate::io::{Read, ReadExt, Serial, Write, WriteExt};
    use cntrlr_macros::prelude_fn;

    #[prelude_fn(red_v, teensy_30, teensy_32, teensy_35, teensy_36, teensy_lc)]
    pub use crate::digital::{digital_read, digital_write, pin_mode};

    #[prelude_fn(red_v)]
    pub use crate::io::pc_serial;

    #[prelude_fn(red_v, teensy_30, teensy_32, teensy_35, teensy_36, teensy_lc)]
    pub use crate::io::serial_1;

    #[prelude_fn(red_v, teensy_30, teensy_32, teensy_35, teensy_36, teensy_lc)]
    pub use crate::io::serial_2;

    #[prelude_fn(teensy_30, teensy_32, teensy_35, teensy_36, teensy_lc)]
    pub use crate::io::serial_3;

    #[prelude_fn(teensy_35, teensy_36)]
    pub use crate::io::serial_4;

    #[prelude_fn(teensy_35, teensy_36)]
    pub use crate::io::serial_5;

    #[prelude_fn(teensy_35)]
    pub use crate::io::serial_6;

    #[prelude_fn(red_v, teensy_30, teensy_32, teensy_35, teensy_36, teensy_lc)]
    pub use crate::time::{millis, sleep_millis};

    pub use crate::macros::entry;
}

mod allocator;
mod register;
mod runtime;