Enum FirmwareEntity 

pub enum FirmwareEntity {
    Readable {
        index: u8,
        info: FirmwareEntityInfo,
    },
    Unreadable {
        index: u8,
        error: WriteError,
    },
}

One firmware entity a device reports through HID++ 0x0003 function 1. Returned by dump_firmware_entities so a device report can name the exact firmware it is running.

There are two states and only two: the device answered with a record that decoded, or it did not. An enum makes “a version with no kind” and “an error alongside a version” unrepresentable rather than merely unreachable.

Variants

Readable

The entity’s record was read and decoded.

Fields

index: u8

Index of the entity in the device’s own table.

info: FirmwareEntityInfo

The decoded firmware record.

Unreadable

The device declared the entity, but its record could not be read.

Reported rather than dropped: omitting the row would claim the device has fewer firmware images than it says it has, and a device that cannot describe one of its own images is what a bug report needs to say.

Fields

index: u8

Index of the entity in the device’s own table.

error: WriteError

Why the record could not be read.

Trait Implementations

impl Clone for FirmwareEntity

fn clone(&self) -> FirmwareEntity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FirmwareEntity

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

Formats the value using the given formatter.