ambiq-hal 0.3.3

HAL for the Ambiq Apollo MCU and boards
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

#![allow(incomplete_features)]
#![feature(adt_const_params)]
#![feature(never_type)]
#![cfg_attr(not(test), no_std)]

extern crate cortex_m;

pub extern crate embedded_hal as hal;
pub extern crate ambiq_apollo3_pac2 as pac;

#[cfg(feature = "rt")]
#[cortex_m_rt::pre_init]
unsafe fn pre_init() {
    // The sparkfun bootloader does not update the VTOR to point to our programs
    // interrupt vector.
    //
    // The Ambiq Secure bootloader requires magic bytes to be set before it loads the
    // Sparkfun Variable Bootloader at 0xC000, so we can't just replace it.
    //
    // The Sparkfun bootloader loads our program from 0x10000. In the arduino hal the
    // `startup_gcc.c` runtime updates the VTOR, but ideally this should have been done
    // in the bootloader to be a bit more robust.
    //
    // If someone re-defines the `pre_init` interrupts will stop working. Pretty sure
    // that wouldn't compile anyway.
    //
    //
    // https://github.com/sparkfun/Apollo3_Uploader_SVL/issues/7
    (*cortex_m::peripheral::SCB::PTR).vtor.write(0x10000);
}


#[cfg(feature = "ambiq-sdk")]
pub extern crate ambiq_hal_sys as halc;

pub mod clock;
pub mod rtc;
pub mod time;
pub mod delay;
pub mod gpio;
pub mod adc;
pub mod watchdog;

#[cfg(feature = "ambiq-sdk")]
pub mod uart;

#[cfg(feature = "ambiq-sdk")]
pub mod iom;
#[cfg(feature = "ambiq-sdk")]
pub use iom::{i2c, spi};

pub mod prelude {
    pub use hal::prelude::*;
    pub use hal::digital::v2::{InputPin, OutputPin, ToggleableOutputPin};

    #[cfg(feature = "ambiq-sdk")]
    pub use halc;

    #[cfg(feature = "ambiq-sdk")]
    pub use halc::c_types::*;
}

#[cfg(test)]
mod tests {
    #[test]
    fn it_works() {
        assert_eq!(2 + 2, 4);
    }
}