medius 1.5.0

Host control library for the medius transparent mouse passthrough box
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! Decoded `RESP(STATS)` — delivery and telemetry counters (§4.6).

/// Delivery/telemetry counters the firmware maintains. Under the fire-and-forget model (§2.1) these
/// are the host's only window into whether commands were actually delivered: a nonzero
/// [`Stats::tx_drops`] or [`Stats::tx_wedges`] is the actionable signal that delivery degraded under
/// load. Narrowed fields are saturated by the box (a maxed counter reads as max, never wrapped).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct Stats {
    /// Pure-injection reports emitted (the no-halving / 1 kHz path).
    pub inject_emits: u32,
    /// Reports dropped on TX-queue overflow (should stay 0).
    pub tx_drops: u16,
    /// Backed-up reports merged instead of queued.
    pub tx_merges: u16,
    /// Deepest the TX queue has reached.
    pub tx_maxdepth: u8,
    /// Wedged-endpoint recoveries by the watchdog.
    pub tx_wedges: u8,
    /// Remote-wakeups issued.
    pub wakeups: u16,
    /// USB bus resets seen.
    pub reset_count: u16,
    /// `SET_CONFIGURATION` events (re-enumerations).
    pub config_count: u16,
}

impl Stats {
    /// Decode a `RESP(STATS)` payload (§4.6): `[what][inject_emits u32][tx_drops u16][tx_merges u16]
    /// [tx_maxdepth u8][tx_wedges u8][wakeups u16][reset_count u16][config_count u16]`.
    pub(crate) fn from_payload(p: &[u8]) -> Option<Self> {
        if p.len() < 17 {
            return None;
        }
        Some(Stats {
            inject_emits: u32::from_le_bytes([p[1], p[2], p[3], p[4]]),
            tx_drops: u16::from_le_bytes([p[5], p[6]]),
            tx_merges: u16::from_le_bytes([p[7], p[8]]),
            tx_maxdepth: p[9],
            tx_wedges: p[10],
            wakeups: u16::from_le_bytes([p[11], p[12]]),
            reset_count: u16::from_le_bytes([p[13], p[14]]),
            config_count: u16::from_le_bytes([p[15], p[16]]),
        })
    }
}