Struct Stamp 

#[non_exhaustive]
pub struct Stamp {
    pub arrived: Instant,
    pub since_open: Duration,
    pub box_time: Option<BoxTime>,
    pub received: Instant,
    pub received_since_open: Duration,
    pub received_qpc: Option<i64>,
}

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

arrived: Instant

the best guess at when the event happened, on the PC’s clock. on Medius it’s the box clock mapped onto the PC’s through the medius crate, which keeps it from ever going backwards and smooths it after bursts, so it’s an estimate there and NOT when the PC got the event, use received for that

since_open: Duration

the same moment as the time since the device was opened, for code that can’t use Instant

box_time: Option<BoxTime>

received: Instant

when anybox got the event. on MAKCU that’s right after the port read returned with the report’s last byte, on Medius it’s when anybox took it from the medius crate, which reads the port on its own thread, so it’s a bit after the read there. either way it’s the read and not the USB arrival, driver buffering and a backlog make it late, and reports that came in one read share it

received_since_open: Duration

the same moment as received, as the time since the device was opened

received_qpc: Option<i64>

the raw QueryPerformanceCounter value at received, on Windows only, since an Instant can’t be turned back into one and a USB capture stamps its packets in QPC

Implementations

impl Stamp

pub fn new(arrived: Instant, since_open: Duration) -> Self

for tests and for code that builds events itself. received starts out as arrived, and since_open isn’t checked against arrived

pub fn with_box_time(self, box_time: BoxTime) -> Self

pub fn arrived_ns(&self) -> u64

arrived in nanoseconds on the clock monotonic_ns reads, so it lines up with stamps from other devices and other programs on this machine

pub fn received_ns(&self) -> u64

received in nanoseconds on the clock monotonic_ns reads

pub fn with_received(self, received: Instant, qpc: Option<i64>) -> Self

received_since_open comes out of received and since_open, so set those right first

Trait Implementations

impl Clone for Stamp

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Stamp

impl Debug for Stamp

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

Formats the value using the given formatter.

impl Eq for Stamp

impl PartialEq for Stamp

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Stamp