Enum EtherNetIpError 

#[non_exhaustive]
pub enum EtherNetIpError {
    Io(Error),
    Protocol(String),
    TagNotFound(String),
    DataTypeMismatch {
        expected: String,
        actual: String,
    },
    WriteError {
        status: u8,
        message: String,
    },
    ReadError {
        status: u8,
        message: String,
    },
    InvalidResponse {
        reason: String,
    },
    Timeout(Duration),
    Udt(String),
    Connection(String),
    ConnectionLost(String),
    CipError {
        code: u8,
        message: String,
    },
    StringTooLong {
        max_length: usize,
        actual_length: usize,
    },
    InvalidString {
        reason: String,
    },
    Tag(String),
    Permission(String),
    Utf8(FromUtf8Error),
    Other(String),
    Subscription(String),
    Unsupported {
        api: &'static str,
        reason: &'static str,
    },
}

Error types that can occur during EtherNet/IP communication

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

IO error (network issues, connection problems)

Protocol(String)

Protocol error (invalid packet format, unsupported features)

TagNotFound(String)

Tag not found in PLC

DataTypeMismatch

Data type mismatch

Fields

expected: String

Data type required by the target.

actual: String

Data type supplied by the caller or response.

WriteError

Write error with status code

Fields

status: u8

CIP general status code.

message: String

Human-readable write failure detail.

ReadError

Read error with status code

Fields

status: u8

CIP general status code.

message: String

Human-readable read failure detail.

InvalidResponse

Invalid response from PLC

Fields

reason: String

Explanation of the malformed or inconsistent response.

Timeout(Duration)

Timeout error

Udt(String)

UDT error

Connection(String)

Connection error (PLC not responding, session issues)

ConnectionLost(String)

Connection lost (network closed, PLC unreachable)

CipError

CIP protocol error with status code (from PLC)

Fields

code: u8

CIP general status code.

message: String

Human-readable controller response.

StringTooLong

String is too long for the PLC’s string type

Fields

max_length: usize

Maximum encoded string byte length for the target type/path.

actual_length: usize

Supplied UTF-8 byte length.

InvalidString

String contains invalid characters

Fields

reason: String

Explanation of the invalid length, encoding, or payload.

Tag(String)

Tag error

Permission(String)

Permission denied

Utf8(FromUtf8Error)

UTF-8 error

Other(String)

Other error

Subscription(String)

Subscription error

Unsupported

Unsupported API surface retained only for 1.x compatibility.

Fields

api: &'static str

API name that is no longer supported.

reason: &'static str

Reason the API is unsupported and the replacement to use.

Implementations

impl EtherNetIpError

pub fn is_retriable(&self) -> bool

Returns true if the error is likely retriable (e.g. timeout, connection lost). Use this to decide whether to retry an operation or reconnect.

Trait Implementations

impl Debug for EtherNetIpError

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

Formats the value using the given formatter.

impl Display for EtherNetIpError

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

Formats the value using the given formatter.

impl Error for EtherNetIpError

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 From<Error> for EtherNetIpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for EtherNetIpError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<T>> for EtherNetIpError

fn from(_: PoisonError<T>) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for EtherNetIpError

fn from(error: ProtocolError) -> Self

Converts to this type from the input type.

impl From<TagPathError> for EtherNetIpError

fn from(error: TagPathError) -> Self

Converts to this type from the input type.

impl From<TypeError> for EtherNetIpError

fn from(error: TypeError) -> Self

Converts to this type from the input type.

impl From<UdtError> for EtherNetIpError

fn from(error: UdtError) -> Self

Converts to this type from the input type.