Enum DecodeError 

pub enum DecodeError {
    Truncated {
        expected: usize,
        actual: usize,
    },
    LengthMismatch {
        expected: usize,
        actual: usize,
    },
    PduTooLarge {
        length: usize,
        maximum: usize,
    },
    UnknownFunctionCode(u8),
    ByteCountMismatch {
        declared: usize,
        actual: usize,
    },
    ByteCountOutOfRange {
        count: usize,
        minimum: usize,
        maximum: usize,
    },
    QuantityOutOfRange {
        quantity: u16,
    },
    InvalidCoilValue(u16),
    InvalidReferenceType(u8),
    InvalidFileRecordLength {
        length: usize,
    },
    FileRecordOutOfRange {
        file_number: u16,
        record_number: u16,
        record_length: u16,
    },
    UnknownMeiType(u8),
    UnknownExceptionCode(u8),
    UnknownDiagnosticSubFunction(u16),
    InvalidDiagnosticDataLength {
        length: usize,
    },
    InvalidDeviceIdCode(u8),
    InvalidDeviceIdConformityLevel(u8),
    InvalidDeviceIdMoreFollows(u8),
    InvalidDeviceIdNextObjectId(u8),
    InvalidDeviceIdObjectCount(u8),
}

Errors that can occur when decoding a Modbus PDU.

Variants

Truncated

PDU is shorter than the minimum for the function code.

Fields

expected: usize

Minimum expected length.

actual: usize

Actual length received.

LengthMismatch

PDU has extra bytes for a fixed-length function code.

Fields

expected: usize

Exact expected length.

actual: usize

Actual length received.

PduTooLarge

PDU exceeds the Modbus maximum of 253 bytes.

Fields

length: usize

Actual PDU length.

maximum: usize

Maximum allowed PDU length.

UnknownFunctionCode(u8)

Function code byte is not recognized.

ByteCountMismatch

Byte count field does not match actual remaining data length.

Fields

declared: usize

Byte count declared in the PDU.

actual: usize

Actual remaining data length.

ByteCountOutOfRange

Byte count field is outside the allowed range for this function code.

Fields

count: usize

The invalid byte count.

minimum: usize

The minimum allowed byte count.

maximum: usize

The maximum allowed byte count.

QuantityOutOfRange

Quantity value is outside the allowed range for this function code.

Fields

quantity: u16

The invalid quantity value.

InvalidCoilValue(u16)

Coil value is neither 0xFF00 nor 0x0000.

InvalidReferenceType(u8)

File sub-request reference type is not 6.

InvalidFileRecordLength

Packed file-record data cannot be split into valid sub-record groups.

Fields

length: usize

Invalid packed file-record byte length.

FileRecordOutOfRange

File-record address fields are outside the Modbus file-record model.

Fields

file_number: u16

File number.

record_number: u16

Starting record number.

record_length: u16

Number of records.

UnknownMeiType(u8)

MEI type byte is not recognized.

UnknownExceptionCode(u8)

Exception code byte is not recognized.

UnknownDiagnosticSubFunction(u16)

Diagnostic sub-function code is not recognized.

InvalidDiagnosticDataLength

Diagnostics data is not an even number of bytes.

Fields

length: usize

Invalid diagnostics data length.

InvalidDeviceIdCode(u8)

Device ID code byte is not recognized (FC 0x2B / MEI 0x0E).

InvalidDeviceIdConformityLevel(u8)

Device ID conformity level byte is not recognized (FC 0x2B / MEI 0x0E).

InvalidDeviceIdMoreFollows(u8)

Device ID More Follows byte is neither 0x00 nor 0xFF.

InvalidDeviceIdNextObjectId(u8)

Device ID Next Object ID must be zero when More Follows is 0x00.

InvalidDeviceIdObjectCount(u8)

Individual Device ID access must return exactly one object.

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> DecodeError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for DecodeError

impl Debug for DecodeError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for DecodeError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for DecodeError

impl Error for DecodeError

Available on crate feature std only.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for DecodeError

fn eq(&self, other: &DecodeError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DecodeError