Struct Duration 

#[repr(C)]
pub struct Duration(/* private fields */);

A duration between two instants in DW3000 system time

Internally uses the same 40-bit timestamps that the DW3000 uses.

Implementations

impl Duration

pub fn new(value: u64) -> Option<Self>

Creates a new instance of Duration

The given value must fit in a 40-bit timestamp, so: 0 <= value <= 2^40 - 1

Returns Some(...), if value is within the valid range, None if it isn’t.

Example

use dw3000_ng::time::{
    TIME_MAX,
    Duration,
};

let valid_duration   = Duration::new(TIME_MAX);
let invalid_duration = Duration::new(TIME_MAX + 1);

assert!(valid_duration.is_some());
assert!(invalid_duration.is_none());

pub fn from_nanos(nanos: u32) -> Self

Creates an instance of Duration from a number of nanoseconds, rounding to the nearest

On the DW3000, the TX_TIME/RX_TIME registers have a resolution of 40-bits and a unit of 1/(128499.210^6) seconds. This means that 1 nanosecond is 63.8976 DW3000 time units.

We do this with fixed point arithmetic, where (dividend + (divisor / 2)) / divisor

pub fn value(&self) -> u64

Returns the raw 40-bit timestamp

The returned value is guaranteed to be in the following range: 0 <= value <= 2^40 - 1

Trait Implementations

impl Add<Duration> for Instant

type Output = Instant

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

impl Clone for Duration

fn clone(&self) -> Duration

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Duration

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Duration

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Duration

fn eq(&self, other: &Duration) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Duration

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<Duration> for Instant

type Output = Instant

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Copy for Duration

impl Eq for Duration

impl StructuralPartialEq for Duration