Trait trinket_m0::prelude::_embedded_hal_timer_CountDown

pub trait _embedded_hal_timer_CountDown {
    type Time;
    pub fn start<T>(&mut self, count: T)
    where
        T: Into<Self::Time>;
    pub fn wait(&mut self) -> Result<(), Error<Void>>;
}

A count down timer

Contract

• self.start(count); block!(self.wait()); MUST block for AT LEAST the time specified by count.

Note that the implementer doesn't necessarily have to be a downcounting timer; it could also be an upcounting timer as long as the above contract is upheld.

Examples

You can use this timer to create delays

extern crate embedded_hal as hal;
#[macro_use(block)]
extern crate nb;

use hal::prelude::*;

fn main() {
    let mut led: Led = {
        // ..
    };
    let mut timer: Timer6 = {
        // ..
    };

    Led.on();
    timer.start(1.s());
    block!(timer.wait()); // blocks for 1 second
    Led.off();
}

Associated Types

type Time

The unit of time used by this timer

Loading content...

Required methods

pub fn start<T>(&mut self, count: T) where
    T: Into<Self::Time>, 

Starts a new count down

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

Non-blockingly "waits" until the count down finishes

Contract

• If Self: Periodic, the timer will start a new count down right after the last one finishes.
• Otherwise the behavior of calling wait after the last call returned Ok is UNSPECIFIED. Implementers are suggested to panic on this scenario to signal a programmer error.

Loading content...

Implementors

impl CountDown for Rtc

type Time = Nanoseconds

pub fn start<T>(&mut self, timeout: T) where
    T: Into<<Rtc as CountDown>::Time>, 

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

impl CountDown for SpinTimer

type Time = u32

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

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

impl<TC> CountDown for TimerCounter<TC> where
    TC: Count16, 

type Time = Nanoseconds

pub fn start<T>(&mut self, timeout: T) where
    T: Into<<TimerCounter<TC> as CountDown>::Time>, 

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

Loading content...