statime/datastructures/common/
clock_accuracy.rs

1use core::cmp::Ordering;
2
3#[derive(Default, Debug, Clone, Copy, PartialEq, Eq, Hash)]
4#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
5/// How accurate the underlying clock device is expected to be when not
6/// synchronized.
7pub enum ClockAccuracy {
8    /// Reserved
9    Reserved,
10    /// Accurate within 1 ps
11    PS1,
12    /// Accurate within 2.5 ps
13    PS2_5,
14    /// Accurate within 10 ps
15    PS10,
16    /// Accurate within 25 ps
17    PS25,
18    /// Accurate within 100 ps
19    PS100,
20    /// Accurate within 250 ps
21    PS250,
22    /// Accurate within 1 ns
23    NS1,
24    /// Accurate within 2.5 ns
25    NS2_5,
26    /// Accurate within 10 ns
27    NS10,
28    /// Accurate within 25 ns
29    NS25,
30    /// Accurate within 100 ns
31    NS100,
32    /// Accurate within 250 ns
33    NS250,
34    /// Accurate within 1 us
35    US1,
36    /// Accurate within 2.5 us
37    US2_5,
38    /// Accurate within 10 us
39    US10,
40    /// Accurate within 25 us
41    US25,
42    /// Accurate within 100 us
43    US100,
44    /// Accurate within 250 us
45    US250,
46    /// Accurate within 1 ms
47    MS1,
48    /// Accurate within 2.5 ms
49    MS2_5,
50    /// Accurate within 10 ms
51    MS10,
52    /// Accurate within 25 ms
53    MS25,
54    /// Accurate within 100 ms
55    MS100,
56    /// Accurate within 250 ms
57    MS250,
58    /// Accurate within 1 s
59    S1,
60    /// Accurate within 10 s
61    S10,
62    /// Accurate within >10 s
63    SGT10,
64    /// Specific to a profile
65    ProfileSpecific(u8),
66    /// Accuracy is unknown
67    #[default]
68    Unknown,
69}
70
71impl ClockAccuracy {
72    /// Converts enum to u8 literals
73    pub fn to_primitive(self) -> u8 {
74        match self {
75            Self::Reserved => 0x00,
76            Self::PS1 => 0x17,
77            Self::PS2_5 => 0x18,
78            Self::PS10 => 0x19,
79            Self::PS25 => 0x1a,
80            Self::PS100 => 0x1b,
81            Self::PS250 => 0x1c,
82            Self::NS1 => 0x1d,
83            Self::NS2_5 => 0x1e,
84            Self::NS10 => 0x1f,
85            Self::NS25 => 0x20,
86            Self::NS100 => 0x21,
87            Self::NS250 => 0x22,
88            Self::US1 => 0x23,
89            Self::US2_5 => 0x24,
90            Self::US10 => 0x25,
91            Self::US25 => 0x26,
92            Self::US100 => 0x27,
93            Self::US250 => 0x28,
94            Self::MS1 => 0x29,
95            Self::MS2_5 => 0x2a,
96            Self::MS10 => 0x2b,
97            Self::MS25 => 0x2c,
98            Self::MS100 => 0x2d,
99            Self::MS250 => 0x2e,
100            Self::S1 => 0x2f,
101            Self::S10 => 0x30,
102            Self::SGT10 => 0x31,
103            Self::ProfileSpecific(value) => 0x80 + value,
104            Self::Unknown => 0xfe,
105        }
106    }
107
108    pub(crate) fn from_primitive(value: u8) -> Self {
109        match value {
110            0x00..=0x16 | 0x32..=0x7f | 0xff => Self::Reserved,
111            0x17 => Self::PS1,
112            0x18 => Self::PS2_5,
113            0x19 => Self::PS10,
114            0x1a => Self::PS25,
115            0x1b => Self::PS100,
116            0x1c => Self::PS250,
117            0x1d => Self::NS1,
118            0x1e => Self::NS2_5,
119            0x1f => Self::NS10,
120            0x20 => Self::NS25,
121            0x21 => Self::NS100,
122            0x22 => Self::NS250,
123            0x23 => Self::US1,
124            0x24 => Self::US2_5,
125            0x25 => Self::US10,
126            0x26 => Self::US25,
127            0x27 => Self::US100,
128            0x28 => Self::US250,
129            0x29 => Self::MS1,
130            0x2a => Self::MS2_5,
131            0x2b => Self::MS10,
132            0x2c => Self::MS25,
133            0x2d => Self::MS100,
134            0x2e => Self::MS250,
135            0x2f => Self::S1,
136            0x30 => Self::S10,
137            0x31 => Self::SGT10,
138            0x80..=0xfd => Self::ProfileSpecific(value - 0x80),
139            0xfe => ClockAccuracy::Unknown,
140        }
141    }
142
143    /// high accuracy to low accuracy
144    pub(crate) fn cmp_numeric(&self, other: &Self) -> Ordering {
145        self.to_primitive().cmp(&other.to_primitive())
146    }
147}
148
149#[cfg(test)]
150mod tests {
151    use super::*;
152
153    #[test]
154    fn network_protocol_values() {
155        for i in 0..u8::MAX {
156            let protocol = ClockAccuracy::from_primitive(i);
157            if !matches!(protocol, ClockAccuracy::Reserved) {
158                assert_eq!(protocol.to_primitive(), i);
159            }
160        }
161
162        assert_eq!(ClockAccuracy::ProfileSpecific(5).to_primitive(), 0x85);
163    }
164
165    #[test]
166    fn ordering() {
167        // the inaccuracy of PS1 is less than of PS10
168        let a = ClockAccuracy::PS1;
169        let b = ClockAccuracy::PS10;
170
171        assert_eq!(a.cmp_numeric(&b), Ordering::Less);
172    }
173}
statime/datastructures/common/clock_accuracy.rs

statime/datastructures/common/
clock_accuracy.rs
