ezsp 5.0.0

Ember ZNet Serial Protocol
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

use core::fmt::Display;

/// An error that occurs when decoding a frame.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub enum Decode {
    /// Too few bytes to decode.
    TooFewBytes,

    /// Too many bytes to decode.
    TooManyBytes {
        /// The next byte in the stream.
        next: u8,
    },

    /// Frame ID mismatch.
    FrameIdMismatch {
        /// The expected frame ID.
        expected: u16,
        /// The found frame ID.
        found: u16,
    },

    /// Invalid frame ID.
    InvalidFrameId(u16),
}

impl Display for Decode {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::TooFewBytes => write!(f, "Too few bytes to decode."),
            Self::TooManyBytes { next } => write!(f, "Too many bytes to decode. Next: {next:#04X}"),
            Self::FrameIdMismatch { expected, found } => {
                write!(
                    f,
                    "Frame ID mismatch: Expected {expected:#06X}, found {found:#06X}."
                )
            }
            Self::InvalidFrameId(id) => write!(f, "Invalid frame ID: {id:#06X}."),
        }
    }
}

impl std::error::Error for Decode {}

impl<T> From<le_stream::Error<T>> for Decode {
    fn from(error: le_stream::Error<T>) -> Self {
        match error {
            le_stream::Error::StreamNotExhausted { next_byte, .. } => {
                Self::TooManyBytes { next: next_byte }
            }
            le_stream::Error::UnexpectedEndOfStream => Self::TooFewBytes,
        }
    }
}