statime-wire 0.1.1

Full-featured implementation of NTP with NTS support
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use crate::{
    Error,
    common::{PortIdentity, Timestamp},
};

/// Delay response message body
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct DelayRespMessage {
    /// Time the delay request was received by the remote.
    pub receive_timestamp: Timestamp,
    /// Port identity of the PTP port that sent the request.
    pub requesting_port_identity: PortIdentity,
}

impl DelayRespMessage {
    pub(crate) fn content_size(&self) -> usize {
        20
    }

    pub(crate) fn serialize_content(&self, buffer: &mut [u8]) -> Result<(), Error> {
        self.receive_timestamp
            .serialize(buffer.get_mut(0..10).ok_or(Error::BufferTooShort)?)?;
        self.requesting_port_identity
            .serialize(buffer.get_mut(10..20).ok_or(Error::BufferTooShort)?)?;

        Ok(())
    }

    pub(crate) fn deserialize_content(buffer: &[u8]) -> Result<Self, Error> {
        let slice = buffer.get(0..20).ok_or(Error::BufferTooShort)?;
        let receive_timestamp = Timestamp::deserialize(&slice[0..10])?;
        let requesting_port_identity = PortIdentity::deserialize(&slice[10..20])?;

        Ok(Self {
            receive_timestamp,
            requesting_port_identity,
        })
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::common::{ClockIdentity, PortIdentity};

    #[test]
    fn timestamp_wireformat() {
        let representations = [(
            [
                0x00, 0x00, 0x45, 0xb1, 0x11, 0x5a, 0x0a, 0x64, 0xfa, 0xb0, 0x01, 0x02, 0x03, 0x04,
                0x05, 0x06, 0x07, 0x08, 0x09, 0x0a,
            ],
            DelayRespMessage {
                receive_timestamp: Timestamp::new(1_169_232_218, 174_389_936).unwrap(),
                requesting_port_identity: PortIdentity {
                    clock_identity: ClockIdentity([0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08]),
                    port_number: 0x090a,
                },
            },
        )];

        for (byte_representation, object_representation) in representations {
            // Test the serialization output
            let mut serialization_buffer = [0; 20];
            object_representation
                .serialize_content(&mut serialization_buffer)
                .unwrap();
            assert_eq!(serialization_buffer, byte_representation);

            // Test the deserialization output
            let deserialized_data =
                DelayRespMessage::deserialize_content(&byte_representation).unwrap();
            assert_eq!(deserialized_data, object_representation);
        }
    }
}