atsam4-hal 0.1.12

HAL for the ATSAM4 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
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
98
99
100
101
102
103
104
105
106
107
108
109

//! HAL for the ATSAM4 series of microcontrollers
//!
//! This is an implementation of the [`embedded-hal`] traits for the ATSAM4 microcontrollers
//!
//! [`embedded-hal`]: https://github.com/japaric/embedded-hal
//!
//! # Requirements
//!
//! This crate requires `arm-none-eabi-gcc` to be installed and available in `$PATH` to build.
//!
//! # Usage
//!
//! To build applications (binary crates) using this crate follow the [cortex-m-quickstart]
//! instructions and add this crate as a dependency in step number 5 and make sure you enable the
//! "rt" Cargo feature of this crate.
//!
//! [cortex-m-quickstart]: https://docs.rs/cortex-m-quickstart/~0.3
//!

//#![deny(missing_docs)]
//#![deny(warnings)]
#![no_std]
// Needed to quiet names such as NCS1 and UART0Clock (which now throw linting errors)
// These errors seem to have been removed in nightly, so I suspect they may not stay.
#![allow(clippy::upper_case_acronyms)]

pub extern crate embedded_hal as hal;
pub use hal::digital::v2::*;

#[cfg(feature = "atsam4e16c")]
pub use atsam4e16c_pac as pac;
#[cfg(feature = "atsam4e16e")]
pub use atsam4e16e_pac as pac;
#[cfg(feature = "atsam4e8c")]
pub use atsam4e8c_pac as pac;
#[cfg(feature = "atsam4e8e")]
pub use atsam4e8e_pac as pac;

#[cfg(feature = "atsam4n16b")]
pub use atsam4n16b_pac as pac;
#[cfg(feature = "atsam4n16c")]
pub use atsam4n16c_pac as pac;
#[cfg(feature = "atsam4n8a")]
pub use atsam4n8a_pac as pac;
#[cfg(feature = "atsam4n8b")]
pub use atsam4n8b_pac as pac;
#[cfg(feature = "atsam4n8c")]
pub use atsam4n8c_pac as pac;

#[cfg(feature = "atsam4s2a")]
pub use atsam4s2a_pac as pac;
#[cfg(feature = "atsam4s2b")]
pub use atsam4s2b_pac as pac;
#[cfg(feature = "atsam4s2c")]
pub use atsam4s2c_pac as pac;
#[cfg(feature = "atsam4s4a")]
pub use atsam4s4a_pac as pac;
#[cfg(feature = "atsam4s4b")]
pub use atsam4s4b_pac as pac;
#[cfg(feature = "atsam4s4c")]
pub use atsam4s4c_pac as pac;
#[cfg(feature = "atsam4s8b")]
pub use atsam4s8b_pac as pac;
#[cfg(feature = "atsam4s8c")]
pub use atsam4s8c_pac as pac;
#[cfg(feature = "atsam4sa16b")]
pub use atsam4sa16b_pac as pac;
#[cfg(feature = "atsam4sa16c")]
pub use atsam4sa16c_pac as pac;
#[cfg(feature = "atsam4sd16b")]
pub use atsam4sd16b_pac as pac;
#[cfg(feature = "atsam4sd16c")]
pub use atsam4sd16c_pac as pac;
#[cfg(feature = "atsam4sd32b")]
pub use atsam4sd32b_pac as pac;
#[cfg(feature = "atsam4sd32c")]
pub use atsam4sd32c_pac as pac;

use core::mem;

pub mod chipid;
pub mod clock;
pub mod delay;
pub mod gpio;
pub mod prelude;
pub mod rtt;
pub mod serial;
pub mod static_memory_controller;
pub mod watchdog;

/// Borrows a peripheral without checking if it has already been taken
unsafe trait BorrowUnchecked {
    fn borrow_unchecked<T>(f: impl FnOnce(&mut Self) -> T) -> T;
}

macro_rules! borrow_unchecked {
    ($($peripheral:ident),*) => {
        $(
            unsafe impl BorrowUnchecked for pac::$peripheral {
                fn borrow_unchecked<T>(f: impl FnOnce(&mut Self) -> T) -> T {
                    let mut p = unsafe { mem::transmute(()) };
                    f(&mut p)
                }
            }
        )*
    }
}

borrow_unchecked!(PMC);