Struct Timer 

pub struct Timer<R: Rate>(/* private fields */);

A running timer, and the scope its timestamps belong to.

stop takes it by value, so a timestamp taken from it keeps the count running for as long as it is held.

Implementations

impl<R: Rate> Timer<R>

pub unsafe fn start(_rate: R) -> Option<Self>

Start counting at R, or None if the timer is already running.

Writing the control register can advance the timer once, so the first interrupt may come early.

Safety

Lets the timer interrupt through and turns interrupts on. That is preemption, which the surrounding code may have been written to rule out, and it happens whether or not a timer is handed back.

pub fn now(&self) -> Instant<'_, R>

The tick count now.

pub fn wait(&self, span: Duration<R>)

Sleep until span has passed.

The CPU sleeps while waiting, so this does not return if IE lacks TIMER or interrupts are off: the count only moves when the handler runs.

pub fn count(&self) -> u8

How far the timer has counted towards its next overflow.

This is the hardware register, so it moves at the input clock rather than the overflow rate and costs no interrupt at all.

pub fn stop(self)

Stop counting.

Trait Implementations

impl<R: Rate> !Send for Timer<R>

impl<R: Rate> !Sync for Timer<R>