Enum probe_rs::flashing::FlashError

source ·

pub enum FlashError {
Show 24 variants    NoSuitableNvm {
        start: u64,
        end: u64,
        description_source: TargetDescriptionSource,
    },
    ChipEraseFailed {
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    EraseFailed {
        sector_address: u64,
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    PageWrite {
        page_address: u64,
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    Init(Box<dyn Error + Send + Sync + 'static>),
    Uninit(Box<dyn Error + Send + Sync + 'static>),
    ChipEraseNotSupported,
    RoutineCallFailed {
        name: &'static str,
        error_code: u32,
    },
    UnexpectedCoreStatus {
        status: CoreStatus,
    },
    AddressNotInRegion {
        address: u32,
        region: NvmRegion,
    },
    Core(Error),
    FlashAlgorithmNotLoaded,
    InvalidFlashAlgorithmLoadAddress {
        address: u64,
    },
    InvalidPageSize {
        size: u32,
    },
    NoFlashLoaderAlgorithmAttached {
        name: String,
    },
    MultipleDefaultFlashLoaderAlgorithms {
        region: NvmRegion,
    },
    MultipleFlashLoaderAlgorithmsNoDefault {
        region: NvmRegion,
    },
    Verify,
    NoRamDefined {
        name: String,
    },
    InvalidFlashAlgorithmLength {
        name: String,
        algorithm_source: Option<TargetDescriptionSource>,
    },
    DataOverlaps {
        added_addresses: Range<u64>,
        existing_addresses: Range<u64>,
    },
    NoNvmCoreAccess(NvmRegion),
    NoRamCoreAccess(RamRegion),
    RegisterValueNotSupported(u64),
}

Expand description

Describes any error that happened during the or in preparation for the flashing procedure.

Variants§

§

NoSuitableNvm

Fields

§start: u64

The start of the requested memory range.

§end: u64

The end of the requested memory range.

§description_source: TargetDescriptionSource

The source of this target description (was it a built in target or one loaded externally and from what file path?).

No flash memory contains the entire requested memory range.

§

ChipEraseFailed

Fields

§source: Box<dyn Error + Send + Sync + 'static>

The source error of this error.

Erasing the full chip flash failed.

§

EraseFailed

Fields

§sector_address: u64

The address of the sector that should have been erased.

§source: Box<dyn Error + Send + Sync + 'static>

The source error of this error.

Erasing the given flash sector failed.

§

PageWrite

Fields

§page_address: u64

The address of the page that should have been written.

§source: Box<dyn Error + Send + Sync + 'static>

The source error of this error.

Writing the given page failed.

§

Init(Box<dyn Error + Send + Sync + 'static>)

Initializing the flash algorithm failed.

§

Uninit(Box<dyn Error + Send + Sync + 'static>)

Uninizializing the flash algorithm failed.

§

ChipEraseNotSupported

This target does not support full chip flash erases.

§

RoutineCallFailed

Fields

§name: &'static str

The name of the routine that was called.

§error_code: u32

The error code the called routine returned.

Calling the given routine returned the given error code.

§

UnexpectedCoreStatus

Fields

§status: CoreStatus

The status that the core entered.

The core entered an unexpected status while executing a flashing operation.

§

AddressNotInRegion

Fields

§address: u32

The address which was not contained in region.

§region: NvmRegion

The region which did not contain address.

The given address was not contained in the given NVM region.

§

Core(Error)

An error occurred during the interaction with the core.

§

FlashAlgorithmNotLoaded

The RAM contents did not match the flash algorithm.

§

InvalidFlashAlgorithmLoadAddress

Fields

§address: u64

The address where the algorithm was supposed to be loaded to.

Failed to load the flash algorithm into RAM at given address. This can happen if there is not enough space.

Check the algorithm code and settings before you try again.

§

InvalidPageSize

Fields

§size: u32

The size of the page in bytes.

The given page size is not valid. Only page sizes multiples of 4 bytes are allowed.

§

NoFlashLoaderAlgorithmAttached

Fields

§name: String

The name of the chip.

No flash algorithm was linked to this target.

§

MultipleDefaultFlashLoaderAlgorithms

Fields

§region: NvmRegion

The region which matched more than one flash algorithm.

More than one matching flash algorithm was found for the given memory range and all of them is marked as default.

§

MultipleFlashLoaderAlgorithmsNoDefault

Fields

§region: NvmRegion

The region which matched more than one flash algorithm.

More than one matching flash algorithm was found for the given memory range and none of them is marked as default.

§

Verify

Flash content verification failed.

§

NoRamDefined

Fields

§name: String

The name of the chip.

The given chip has no RAM defined.

§

InvalidFlashAlgorithmLength

Fields

§name: String

The name of the flash algorithm.

§algorithm_source: Option<TargetDescriptionSource>

The source of the flash algorithm (was it a built in target or one loaded externally and from what file path?).

The given flash algorithm did not have a leng multiple of 4 bytes.

This means that the flash algorithm that was loaded is broken.

§

DataOverlaps

Fields

§added_addresses: Range<u64>

The address range that was tried to be added.

§existing_addresses: Range<u64>

The address range that was already present.

Two blocks of data overlap each other which means the loaded binary is broken.

Please check your data and try again.

§

NoNvmCoreAccess(NvmRegion)

No core can access this NVM region.

§

NoRamCoreAccess(RamRegion)

No core can access this RAM region.

§

RegisterValueNotSupported(u64)

The register value supplied for this flash algorithm is out of the supported range.

Trait Implementations§

source §

impl Debug for FlashError

source §

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

Formats the value using the given formatter. Read more

source §

impl Display for FlashError

source §

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

Formats the value using the given formatter. Read more

source §

impl Error for FlashError

source §

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more

1.0.0 · source§

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

source §

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports. Read more

source §

impl From<Error> for FlashError

source §

fn from(source: Error) -> Self

Converts to this type from the input type.

source §

impl From<FlashError> for FileDownloadError

source §

fn from(source: FlashError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for FlashError

§

impl !UnwindSafe for FlashError

Blanket Implementations§

source §

impl<T> Any for Twhere T: 'static + ?Sized,

source §

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source §

impl<T> Borrow<T> for Twhere T: ?Sized,

source §

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source §

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source §

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

§

impl<T> Conv for T

§

fn conv<T>(self) -> Twhere Self: Into<T>,

Converts self into T using Into<T>. Read more

§

impl<T> FmtForward for T

§

fn fmt_binary(self) -> FmtBinary<Self>where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.

§

fn fmt_display(self) -> FmtDisplay<Self>where Self: Display,

Causes self to use its Display implementation when Debug-formatted.

§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.

§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.

§

fn fmt_octal(self) -> FmtOctal<Self>where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.

§

fn fmt_pointer(self) -> FmtPointer<Self>where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.

§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.

§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.

§

fn fmt_list(self) -> FmtList<Self>where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more

source §

impl<T> From<T> for T

source §

fn from(t: T) -> T

Returns the argument unchanged.

source §

impl<T> Instrument for T

source §

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source §

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source §

impl<T, U> Into for Twhere U: From<T>,

source §

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<D> OwoColorize for D

§

fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>where C: Color,

Set the foreground color generically Read more

§

fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>where C: Color,

Set the background color generically. Read more

§

fn black<'a>(&'a self) -> FgColorDisplay<'a, Black, Self>

Change the foreground color to black

§

fn on_black<'a>(&'a self) -> BgColorDisplay<'a, Black, Self>

Change the background color to black

§

fn red<'a>(&'a self) -> FgColorDisplay<'a, Red, Self>

Change the foreground color to red

§

fn on_red<'a>(&'a self) -> BgColorDisplay<'a, Red, Self>

Change the background color to red

§

fn green<'a>(&'a self) -> FgColorDisplay<'a, Green, Self>

Change the foreground color to green

§

fn on_green<'a>(&'a self) -> BgColorDisplay<'a, Green, Self>

Change the background color to green

§

fn yellow<'a>(&'a self) -> FgColorDisplay<'a, Yellow, Self>

Change the foreground color to yellow

§

fn on_yellow<'a>(&'a self) -> BgColorDisplay<'a, Yellow, Self>

Change the background color to yellow

§

fn blue<'a>(&'a self) -> FgColorDisplay<'a, Blue, Self>

Change the foreground color to blue

§

fn on_blue<'a>(&'a self) -> BgColorDisplay<'a, Blue, Self>

Change the background color to blue

§

fn magenta<'a>(&'a self) -> FgColorDisplay<'a, Magenta, Self>

Change the foreground color to magenta

§

fn on_magenta<'a>(&'a self) -> BgColorDisplay<'a, Magenta, Self>

Change the background color to magenta

§

fn purple<'a>(&'a self) -> FgColorDisplay<'a, Magenta, Self>

Change the foreground color to purple

§

fn on_purple<'a>(&'a self) -> BgColorDisplay<'a, Magenta, Self>

Change the background color to purple

§

fn cyan<'a>(&'a self) -> FgColorDisplay<'a, Cyan, Self>

Change the foreground color to cyan

§

fn on_cyan<'a>(&'a self) -> BgColorDisplay<'a, Cyan, Self>

Change the background color to cyan

§

fn white<'a>(&'a self) -> FgColorDisplay<'a, White, Self>

Change the foreground color to white

§

fn on_white<'a>(&'a self) -> BgColorDisplay<'a, White, Self>

Change the background color to white

§

fn default_color<'a>(&'a self) -> FgColorDisplay<'a, Default, Self>

Change the foreground color to the terminal default

§

fn on_default_color<'a>(&'a self) -> BgColorDisplay<'a, Default, Self>

Change the background color to the terminal default

§

fn bright_black<'a>(&'a self) -> FgColorDisplay<'a, BrightBlack, Self>

Change the foreground color to bright black

§

fn on_bright_black<'a>(&'a self) -> BgColorDisplay<'a, BrightBlack, Self>

Change the background color to bright black

§

fn bright_red<'a>(&'a self) -> FgColorDisplay<'a, BrightRed, Self>

Change the foreground color to bright red

§

fn on_bright_red<'a>(&'a self) -> BgColorDisplay<'a, BrightRed, Self>

Change the background color to bright red

§

fn bright_green<'a>(&'a self) -> FgColorDisplay<'a, BrightGreen, Self>

Change the foreground color to bright green

§

fn on_bright_green<'a>(&'a self) -> BgColorDisplay<'a, BrightGreen, Self>

Change the background color to bright green

§

fn bright_yellow<'a>(&'a self) -> FgColorDisplay<'a, BrightYellow, Self>

Change the foreground color to bright yellow

§

fn on_bright_yellow<'a>(&'a self) -> BgColorDisplay<'a, BrightYellow, Self>

Change the background color to bright yellow

§

fn bright_blue<'a>(&'a self) -> FgColorDisplay<'a, BrightBlue, Self>

Change the foreground color to bright blue

§

fn on_bright_blue<'a>(&'a self) -> BgColorDisplay<'a, BrightBlue, Self>

Change the background color to bright blue

§

fn bright_magenta<'a>(&'a self) -> FgColorDisplay<'a, BrightMagenta, Self>

Change the foreground color to bright magenta

§

fn on_bright_magenta<'a>(&'a self) -> BgColorDisplay<'a, BrightMagenta, Self>

Change the background color to bright magenta

§

fn bright_purple<'a>(&'a self) -> FgColorDisplay<'a, BrightMagenta, Self>

Change the foreground color to bright purple

§

fn on_bright_purple<'a>(&'a self) -> BgColorDisplay<'a, BrightMagenta, Self>

Change the background color to bright purple

§

fn bright_cyan<'a>(&'a self) -> FgColorDisplay<'a, BrightCyan, Self>

Change the foreground color to bright cyan

§

fn on_bright_cyan<'a>(&'a self) -> BgColorDisplay<'a, BrightCyan, Self>

Change the background color to bright cyan

§

fn bright_white<'a>(&'a self) -> FgColorDisplay<'a, BrightWhite, Self>

Change the foreground color to bright white

§

fn on_bright_white<'a>(&'a self) -> BgColorDisplay<'a, BrightWhite, Self>

Change the background color to bright white

§

fn bold<'a>(&'a self) -> BoldDisplay<'a, Self>

Make the text bold

§

fn dimmed<'a>(&'a self) -> DimDisplay<'a, Self>

Make the text dim

§

fn italic<'a>(&'a self) -> ItalicDisplay<'a, Self>

Make the text italicized

§

fn underline<'a>(&'a self) -> UnderlineDisplay<'a, Self>

Make the text italicized

§

fn blink<'a>(&'a self) -> BlinkDisplay<'a, Self>

Make the text blink

§

fn blink_fast<'a>(&'a self) -> BlinkFastDisplay<'a, Self>

Make the text blink (but fast!)

§

fn reversed<'a>(&'a self) -> ReversedDisplay<'a, Self>

Swap the foreground and background colors

§

fn hidden<'a>(&'a self) -> HiddenDisplay<'a, Self>

Hide the text

§

fn strikethrough<'a>(&'a self) -> StrikeThroughDisplay<'a, Self>

Cross out the text

§

fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>where Color: DynColor,

Set the foreground color at runtime. Only use if you do not know which color will be used at compile-time. If the color is constant, use either OwoColorize::fg or a color-specific method, such as OwoColorize::green, Read more

§

fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>where Color: DynColor,

Set the background color at runtime. Only use if you do not know what color to use at compile-time. If the color is constant, use either OwoColorize::bg or a color-specific method, such as OwoColorize::on_yellow, Read more

§