Enum WriteError 

pub enum WriteError {
    Hid(String),
    DeviceNotFound,
    DeviceUnreachable {
        index: u8,
    },
    FeatureUnsupported {
        feature_hex: u16,
    },
    EmptyDpiList,
    Hidpp(String),
    HidppFeature {
        operation: HidppOperation,
        feature_hex: u16,
        kind: HidppFeatureErrorKind,
    },
    UnsupportedResponse {
        operation: HidppOperation,
        feature_hex: u16,
    },
    RequestTimedOut {
        operation: HidppOperation,
    },
    RuntimeInit {
        message: String,
    },
    AgentUnavailable,
    InvalidLightValue {
        control: String,
        value: u16,
    },
    LightUnsupported {
        control: String,
    },
    AmbiguousRawDevice,
}

Error returned by HID++ read/write operations.

Serializable + Clone so it can cross the agent↔GUI IPC unchanged: the GUI classifies a device read/write error as permanent (FeatureUnsupported / EmptyDpiList) vs transient, so the discriminating variant must survive the wire — stringifying it would collapse every case to “transient” and a device that genuinely lacks a feature would be re-probed forever. Variant order is therefore wire format: changes require a PROTOCOL_VERSION bump (guarded by openlogi-ipc/tests/wire_format.rs).

Variants

Hid(String)

HID transport error serialized as text.

async_hid::HidError isn’t Serialize, so carry its message as text; the typed error is never matched on (only constructed + displayed).

DeviceNotFound

No currently connected device matched the requested route.

DeviceUnreachable

The HID node opened, but the target HID++ device index did not answer.

Fields

index: u8

HID++ device index that failed to answer.

FeatureUnsupported

Device does not expose the requested HID++ feature.

Fields

feature_hex: u16

HID++ feature ID that was not present.

EmptyDpiList

Device reported no valid DPI values.

Hidpp(String)

Generic HID++ protocol error serialized as text.

HidppFeature

HID++ feature error response.

Fields

operation: HidppOperation

Operation being performed.

feature_hex: u16

HID++ feature ID involved in the operation.

kind: HidppFeatureErrorKind

HID++ feature error kind.

UnsupportedResponse

Device returned a structurally unsupported response.

Fields

operation: HidppOperation

Operation being performed.

feature_hex: u16

HID++ feature ID involved in the operation.

RequestTimedOut

HID++ request timed out.

Fields

operation: HidppOperation

Operation that timed out.

RuntimeInit

Tokio runtime could not be initialized for a sync caller.

Fields

message: String

Runtime initialization error message.

AgentUnavailable

Background agent write path is unavailable.

InvalidLightValue

A standalone light value is outside the driver’s supported range.

Fields

control: String

Semantic control name.

value: u16

Rejected value in the semantic/native unit supplied by the caller.

LightUnsupported

The selected light driver does not implement a requested control.

Fields

control: String

Semantic control name.

AmbiguousRawDevice

Multiple raw HID nodes matched one physical route.

Trait Implementations

impl Clone for WriteError

fn clone(&self) -> WriteError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WriteError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WriteError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for WriteError

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

Formats the value using the given formatter.

impl Error for WriteError

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 Serialize for WriteError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.