Enum Error 

#[non_exhaustive]
pub enum Error {
    AppPartitionNotFound,
    Cancelled,
    ChipDetectError(String),
    ChipMismatch(String, String),
    ChipNotProvided,
    CorruptData(usize, usize),
    DigestMismatch(Vec<u8>, Vec<u8>),
    ElfNotRamLoadable,
    ElfTooBig(u32, u32),
    FlashConnect,
    IncorrectDigestLength(usize),
    IncorrectResponse,
    InvalidBootloader,
    InvalidBootloaderPath,
    InvalidFlashSize(String),
    InvalidPartitionTablePath,
    NoSerial,
    ReadMoreThanExpected,
    StubRequired,
    SerialNotFound(String),
    SerialNotSelected,
    UnsupportedFeature {
        chip: Chip,
        feature: String,
    },
    UnsupportedFlash(u8),
    UnsupportedFlashFrequency {
        chip: Chip,
        frequency: FlashFrequency,
    },
    UnsupportedChipRevision {
        major: u16,
        minor: u16,
        found_major: u16,
        found_minor: u16,
    },
    ParseChipRevError {
        chip_rev: String,
    },
    Connection(Box<dyn Error + Send + Sync>),
    Flashing(Box<dyn Error + Send + Sync>),
    InvalidElf(Box<dyn Error + Send + Sync>),
    InvalidAppDescriptor(Box<dyn Error + Send + Sync>),
    RomError(Box<dyn Error + Send + Sync>),
    MissingPartition(Box<dyn Error + Send + Sync>),
    MissingPartitionTable(Box<dyn Error + Send + Sync>),
    VerifyFailed,
    TryFromSlice(Box<dyn Error + Send + Sync>),
    ParseIntError(Box<dyn Error + Send + Sync>),
    Utf8Error(Box<dyn Error + Send + Sync>),
    FileOpenError(String, Error),
    Partition(Box<dyn Error + Send + Sync>),
    InvalidResponse(String),
    InvalidEraseRegionArgument {
        address: u32,
        size: u32,
    },
    FirmwareChipMismatch {
        elf: String,
        detected: Chip,
    },
    PartitionTableDoesNotFit(FlashSize),
    AppDescriptorNotPresent(String),
    MisplacedKey(String),
}

All possible errors returned by espflash

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.

AppPartitionNotFound

App partition not found

Cancelled

Operation was cancelled by the user

ChipDetectError(String)

Unable to detect chip type

ChipMismatch(String, String)

The specified chip does not match the detected chip

ChipNotProvided

Chip argument not provided, this is required when using the --before no-reset-no-sync option

CorruptData(usize, usize)

Corrupted data received

DigestMismatch(Vec<u8>, Vec<u8>)

The calculated and received MD5 digests do not match

ElfNotRamLoadable

Supplied ELF image can not be run from RAM, as it includes segments mapped to ROM addresses

ElfTooBig(u32, u32)

The supplied ELF image is too large for the configured app partition

FlashConnect

Failed to connect to on-device flash

IncorrectDigestLength(usize)

Received MD5 digest has the incorrect length

IncorrectResponse

Incorrect response from the stub/ROM loader

InvalidBootloader

The provided bootloader binary is invalid

InvalidBootloaderPath

Specified bootloader path is not a .bin file

InvalidFlashSize(String)

Invalid flash size provided

InvalidPartitionTablePath

Specified partition table path is not a .bin or .csv file

NoSerial

No serial ports could be detected

ReadMoreThanExpected

Read more bytes than expected

StubRequired

Command requires using the RAM stub

SerialNotFound(String)

Serial port could not be found

SerialNotSelected

No serial port argument was provided

UnsupportedFeature

Chip does not support a specific feature

Fields

chip: Chip

Chip

feature: String

Unsupported feature

UnsupportedFlash(u8)

Unsupported flash chip

UnsupportedFlashFrequency

Flash frequency not supported by chip

Fields

chip: Chip

Chip

frequency: FlashFrequency

Flash frequency

UnsupportedChipRevision

Unsupported chip revision for connected chip

Fields

major: u16

Minimum supported major version

minor: u16

Minimum supported minor version

found_major: u16

Detected major version

found_minor: u16

Detected minor version

ParseChipRevError

Failed to parse chip revision due to invalid format

Fields

chip_rev: String

Chip revision

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

Error while connecting to device

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

Communication error while flashing device

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

Supplied ELF image is not valid

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

Supplied ELF image contains an invalid application descriptor

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

Available on crate feature serialport only.

The bootloader returned an error

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

The selected partition does not exist in the partition table

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

The partition table is missing or invalid

VerifyFailed

Verification of flash content failed

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

Error while trying to convert from slice

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

Error while trying to parse int from text

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

Error while trying to parse UTF-8 from bytes

FileOpenError(String, Error)

Failed to open file

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

Failed to parse partition table

InvalidResponse(String)

Invalid response from target device

InvalidEraseRegionArgument

An invalid address and/or size argument was provided

Fields

address: u32

Address argument

size: u32

Size argument

FirmwareChipMismatch

Firmware was built for a chip other than what was detected

Fields

elf: String

Chip which the ELF file was built for

detected: Chip

Chip which was detected

PartitionTableDoesNotFit(FlashSize)

The partition table does not fit into the flash

AppDescriptorNotPresent(String)

App descriptor not present in the binary

MisplacedKey(String)

Key is not in the expected section

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Diagnostic for Error

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn url(&self) -> Option<Box<dyn Display + '_>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

Available on crate feature serialport only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature serialport only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for Error

fn from(err: ParseIntError) -> Self

Converts to this type from the input type.

impl From<SlipError> for Error

Available on crate feature serialport only.

fn from(err: SlipError) -> Self

Converts to this type from the input type.

impl From<TryFromSliceError> for Error

fn from(err: TryFromSliceError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Self

Converts to this type from the input type.