Enum Error 

#[non_exhaustive]
pub enum Error {
    IoError,
    IoTimeout,
    NotAligned,
    OutOfBounds,
    NotSupported,
    Unknown,
}

Available on crate feature unstable only.

Flash operation error.

Stability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

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.

IoError

I/O error reported by the ROM.

Includes a ROM-side size check against its cached chip size when that is smaller than Flash::capacity.

IoTimeout

Operation timed out.

NotAligned

Address or length is not aligned for this operation.

Flash::read, Flash::read_encrypted, and Flash::write require a 4-byte-aligned flash offset. Flash::write_encrypted requires a 16-byte address and a word count that is a multiple of 4 (16 bytes). Flash::erase requires a 4096-byte range.

OutOfBounds

Address range exceeds Flash::capacity, or from > to.

Capacity is the JEDEC density, not the ROM cached chip size. An address range within this limit can still fail in the ROM if the cached size is smaller (often the image-header size on ESP32).

NotSupported

Not supported in the current environment.

Returned when the buffer is not in DRAM, when Flash::write_encrypted is called while flash encryption is disabled, or when Flash::read_encrypted cannot allocate an MMU entry.

Unknown

Unexpected ROM status code (logged).

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Error

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

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 Hash for Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given [Hasher].

impl PartialEq for Error

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Error