Enum FlashError 

#[non_exhaustive]
pub enum FlashError<E> {
    Entry(Error<E>),
    Transfer {
        offset: usize,
        length: usize,
        source: Error<E>,
    },
    Fault {
        stage: Stage,
        sense: Triplet,
    },
    ReadyTimeout(Error<E>),
    Startup(StartupError<E>),
    Mismatch {
        address: usize,
        read: u8,
        wrote: u8,
        differing: usize,
        checked: usize,
    },
    Incomplete {
        unverified: usize,
        checked: usize,
    },
}

A failed flash. Every variant after FlashError::Entry may leave the drive holding partial or unverified firmware; nothing is retried or rolled back.

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.

Entry(Error<E>)

PROBE, TEST UNIT READY or PREPARE failed; no firmware data was sent. If PREPARE was reached the drive may be in update mode.

Transfer

A STREAM write failed.

Fields

offset: usize

Offset of the failed chunk.

length: usize

Its length.

source: Error<E>

The command failure.

Fault

REQUEST SENSE reported a programming failure.

Fields

stage: Stage

When the sense was read.

sense: Triplet

The sense.

ReadyTimeout(Error<E>)

The drive did not answer TEST UNIT READY within crate::DriveClass::ready_timeout; the last poll’s error.

Startup(StartupError<E>)

Readiness/read-back completed, but the selected target was not confirmed running.

Mismatch

A protected byte read back differently.

Fields

address: usize

Offset of the first differing byte.

read: u8

The byte read back.

wrote: u8

The byte written.

differing: usize

Protected bytes that differ.

checked: usize

Protected bytes compared.

Incomplete

Chunks holding protected bytes could not be read back.

Fields

unverified: usize

Chunks not verified.

checked: usize

Protected bytes compared, all equal.

Trait Implementations

impl<E> CodedError for FlashError<E>

Available on crate features drive and image only.

fn code(&self) -> &'static str

Stable identifier, such as mediatek.receiver.changed.

impl<E: Debug> Debug for FlashError<E>

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

Formats the value using the given formatter.

impl<E: Debug> Display for FlashError<E>

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

Formats the value using the given formatter.

impl<E: Debug + 'static> Error for FlashError<E>

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.