osdp 0.2.1

Pure-Rust, no_std-friendly implementation of the SIA Open Supervised Device Protocol (OSDP) v2.2
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

//! Manufacturer-specific replies.
//!
//! # Spec: §7.23–§7.25
//!
//! - `osdp_MFGSTATR` (`0x83`) — vendor status (OUI + payload).
//! - `osdp_MFGERRR` (`0x84`) — vendor error (OUI + error code + payload).
//! - `osdp_MFGREP` (`0x90`) — vendor reply (OUI + payload).

use crate::error::Error;
use alloc::vec::Vec;

macro_rules! oui_plus_payload {
    ($Ty:ident, $code:expr, $doc:literal) => {
        #[doc = $doc]
        #[derive(Debug, Clone, PartialEq, Eq)]
        pub struct $Ty {
            /// IEEE-assigned OUI.
            pub oui: [u8; 3],
            /// Vendor payload.
            pub payload: Vec<u8>,
        }

        impl $Ty {
            /// Encode.
            pub fn encode(&self) -> Result<Vec<u8>, Error> {
                let mut out = Vec::with_capacity(3 + self.payload.len());
                out.extend_from_slice(&self.oui);
                out.extend_from_slice(&self.payload);
                Ok(out)
            }

            /// Decode.
            pub fn decode(data: &[u8]) -> Result<Self, Error> {
                if data.len() < 3 {
                    return Err(Error::MalformedPayload {
                        code: $code,
                        reason: "manufacturer reply requires 3-byte OUI",
                    });
                }
                let mut oui = [0u8; 3];
                oui.copy_from_slice(&data[..3]);
                Ok(Self {
                    oui,
                    payload: data[3..].to_vec(),
                })
            }
        }
    };
}

oui_plus_payload!(
    MfgStatR,
    0x83,
    "`osdp_MFGSTATR` body — manufacturer status reply."
);
oui_plus_payload!(
    MfgErrR,
    0x84,
    "`osdp_MFGERRR` body — manufacturer error reply."
);
oui_plus_payload!(MfgRep, 0x90, "`osdp_MFGREP` body — manufacturer reply.");