Enum ModbusError 

pub enum ModbusError {
    Timeout,
    Protocol(Box<dyn Error + Send + Sync>),
    IO(Error),
    IllegalFunction,
    IllegalDataAddress,
    IllegalDataValue,
    ServerDeviceFailure,
    Acknowledge,
    ServerDeviceBusy,
    MemoryParityError,
    GatewayPathUnavailable,
    GatewayTargetDevice,
    Custom(u8),
}

This error is returned if a communication fails because of a timeout or underlying modbus error.

Variants

Timeout

A timeout occured

Protocol(Box<dyn Error + Send + Sync>)

The requested device does not implement modbus correctly and the underlying modbus implementation reported an error.

IO(Error)

I/O error

IllegalFunction

The function code received in the query is not an allowable action for the server (or slave). This may be because the function code is only applicable to newer devices, and was not implemented in the unit selected. It could also indicate that the server (or slave) is in the wrong state to process a request of this type, for example because it is unconfigured and is being asked to return register values.

IllegalDataAddress

The data address received in the query is not an allowable address for the server (or slave). More specifically, the combination of reference number and transfer length is invalid. For a controller with 100 registers, the PDU addresses the first register as 0, and the last one as 99. If a request is submitted with a starting register address of 96 and a quantity of registers of 4, then this request will successfully operate (address-wise at least) on registers 96, 97, 98, 99. If a request is submitted with a starting register address of 96 and a quantity of registers of 5, then this request will fail with Exception Code 0x02 “Illegal Data Address” since it attempts to operate on registers 96, 97, 98, 99 and 100, and there is no register with address 100.

IllegalDataValue

A value contained in the query data field is not an allowable value for server (or slave). This indicates a fault in the structure of the remainder of a complex request, such as that the implied length is incorrect. It specifically does NOT mean that a data item submitted for storage in a register has a value outside the expectation of the application program, since the MODBUS protocol is unaware of the significance of any particular value of any particular register.

ServerDeviceFailure

An unrecoverable error occurred while the server (or slave) was attempting to perform the requested action.

Acknowledge

Specialized use in conjunction with programming commands. The server (or slave) has accepted the request and is processing it, but a long duration of time will be required to do so. This response is returned to prevent a timeout error from occurring in the client (or master). The client (or master) can next issue a Poll Program Complete message to determine if processing is completed.

ServerDeviceBusy

Specialized use in conjunction with programming commands. The server (or slave) is engaged in processing a long–duration program command. The client (or master) should retransmit the message later when the server (or slave) is free.

MemoryParityError

Specialized use in conjunction with function codes 20 and 21 and reference type 6, to indicate that the extended file area failed to pass a consistency check. The server (or slave) attempted to read record file, but detected a parity error in the memory. The client (or master) can retry the request, but service may be required on the server (or slave) device.

GatewayPathUnavailable

Specialized use in conjunction with gateways, indicates that the gateway was unable to allocate an internal communication path from the input port to the output port for processing the request. Usually means that the gateway is misconfigured or overloaded.

GatewayTargetDevice

Specialized use in conjunction with gateways, indicates that no response was obtained from the target device. Usually means that the device is not present on the network.

Custom(u8)

Custom modbus error

Trait Implementations

impl Debug for ModbusError

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

Formats the value using the given formatter.

impl Display for ModbusError

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

Formats the value using the given formatter.

impl Error for ModbusError

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 ModbusError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ModbusError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<ExceptionCode> for ModbusError

fn from(value: ExceptionCode) -> Self

Converts to this type from the input type.

impl From<ModbusError> for DiscoveryError

fn from(source: ModbusError) -> Self

Converts to this type from the input type.

impl From<ModbusError> for ReadModelError

fn from(source: ModbusError) -> Self

Converts to this type from the input type.

impl From<ModbusError> for ReadPointError

fn from(source: ModbusError) -> Self

Converts to this type from the input type.

impl From<ModbusError> for WritePointError

fn from(source: ModbusError) -> Self

Converts to this type from the input type.