Struct microbit::hal::Timer

pub struct Timer<T, U = OneShot>(_, _);

Interface to a TIMER instance.

Right now, this is a very basic interface. The timer will always be hardcoded to a frequency of 1 MHz and 32 bits accuracy.

CC[0] is used for the current/most-recent delay period and CC[1] is used to grab the current value of the counter at a given instant.

Implementations

impl<T> Timer<T, OneShot> where
    T: Instance, 

pub fn one_shot(timer: T) -> Timer<T, OneShot>

pub fn new(timer: T) -> Timer<T, OneShot>

impl<T> Timer<T, Periodic> where
    T: Instance, 

pub fn periodic(timer: T) -> Timer<T, Periodic>

impl<T, U> Timer<T, U> where
    T: Instance, 

pub const TICKS_PER_SECOND: u32 = 1_000_000u32

pub fn into_periodic(self) -> Timer<T, Periodic>

pub fn into_oneshot(self) -> Timer<T, OneShot>

pub fn free(self) -> T

Return the raw interface to the underlying timer peripheral.

pub fn read(&self) -> u32

Return the current value of the counter, by capturing to CC[1].

pub fn enable_interrupt(&mut self)

Enables the interrupt for this timer.

Enables an interrupt that is fired when the timer reaches the value that is given as an argument to start.

Note that the interrupt also has to be unmasked in the NVIC, or the handler won’t get called.

pub fn disable_interrupt(&mut self)

Disables the interrupt for this timer.

Disables an interrupt that is fired when the timer reaches the value that is given as an argument to start.

Note that the interrupt also has to be unmasked in the NVIC, or the handler won’t get called.

pub fn delay(&mut self, cycles: u32)

pub fn task_start(&self) -> &Reg<TASKS_START_SPEC>

Returns reference to the START task endpoint for PPI. Starts timer.

pub fn task_stop(&self) -> &Reg<TASKS_STOP_SPEC>

Returns reference to the STOP task endpoint for PPI. Stops timer.

pub fn task_count(&self) -> &Reg<TASKS_COUNT_SPEC>

Returns reference to the COUNT task endpoint for PPI. Increments timer (counter mode only).

pub fn task_clear(&self) -> &Reg<TASKS_CLEAR_SPEC>

Returns reference to the CLEAR task endpoint for PPI. Clears timer.

pub fn task_capture_cc0(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[0] CAPTURE task endpoint for PPI. Captures timer value to the CC[0] register.

pub fn task_capture_cc1(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[1] CAPTURE task endpoint for PPI. Captures timer value to the CC[1] register.

pub fn task_capture_cc2(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[2] CAPTURE task endpoint for PPI. Captures timer value to the CC[2] register.

pub fn task_capture_cc3(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[3] CAPTURE task endpoint for PPI. Captures timer value to the CC[3] register.

pub fn event_compare_cc0(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[0] COMPARE event endpoint for PPI. Generated when the counter is incremented and then matches the value specified in the CC[0] register.

pub fn event_compare_cc1(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[1] COMPARE event endpoint for PPI. Generated when the counter is incremented and then matches the value specified in the CC[1] register.

pub fn event_compare_cc2(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[2] COMPARE event endpoint for PPI. Generated when the counter is incremented and then matches the value specified in the CC[2] register.

pub fn event_compare_cc3(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[3] COMPARE event endpoint for PPI. Generated when the counter is incremented and then matches the value specified in the CC[3] register.

Trait Implementations

impl<T, U> Cancel for Timer<T, U> where
    T: Instance, 

type Error = ()

Error returned when a countdown can’t be canceled.

fn cancel(&mut self) -> Result<(), <Timer<T, U> as Cancel>::Error>

Tries to cancel this countdown.

impl<T, U> CountDown for Timer<T, U> where
    T: Instance, 

fn start<Time>(&mut self, cycles: Time) where
    Time: Into<<Timer<T, U> as CountDown>::Time>, 

Start the timer.

The timer will run for the given number of cycles, then it will stop and reset.

fn wait(&mut self) -> Result<(), Error<Void>>

Wait for the timer to stop.

Will return Err(nb::Error::WouldBlock) while the timer is still running. Once the timer reached the number of cycles given in the start method, it will return Ok(()).

To block until the timer has stopped, use the block! macro from the nb crate. Please refer to the documentation of nb for other options.

type Time = u32

The unit of time used by this timer

impl<T, U> DelayMs<u16> for Timer<T, U> where
    T: Instance, 

fn delay_ms(&mut self, ms: u16)

Pauses execution for ms milliseconds

impl<T, U> DelayMs<u32> for Timer<T, U> where
    T: Instance, 

fn delay_ms(&mut self, ms: u32)

Pauses execution for ms milliseconds

impl<T, U> DelayMs<u8> for Timer<T, U> where
    T: Instance, 

fn delay_ms(&mut self, ms: u8)

Pauses execution for ms milliseconds

impl<T, U> DelayUs<u16> for Timer<T, U> where
    T: Instance, 

fn delay_us(&mut self, us: u16)

Pauses execution for us microseconds

impl<T, U> DelayUs<u32> for Timer<T, U> where
    T: Instance, 

fn delay_us(&mut self, us: u32)

Pauses execution for us microseconds

impl<T, U> DelayUs<u8> for Timer<T, U> where
    T: Instance, 

fn delay_us(&mut self, us: u8)

Pauses execution for us microseconds

impl ExtendedCCTimer for Timer<TIMER3, OneShot>

fn task_capture_cc4(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[4] CAPTURE task endpoint for PPI.

fn task_capture_cc5(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[5] CAPTURE task endpoint for PPI.

fn event_compare_cc4(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[4] COMPARE event endpoint for PPI.

fn event_compare_cc5(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[5] COMPARE event endpoint for PPI.

impl ExtendedCCTimer for Timer<TIMER4, OneShot>

fn task_capture_cc4(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[4] CAPTURE task endpoint for PPI.

fn task_capture_cc5(&self) -> &Reg<TASKS_CAPTURE_SPEC>

Returns reference to the CC[5] CAPTURE task endpoint for PPI.

fn event_compare_cc4(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[4] COMPARE event endpoint for PPI.

fn event_compare_cc5(&self) -> &Reg<EVENTS_COMPARE_SPEC>

Returns reference to the CC[5] COMPARE event endpoint for PPI.

impl<T> Periodic for Timer<T, Periodic> where
    T: Instance,