Enum Error

pub enum Error {
    Probe(DebugProbeError),
    Arm(ArmError),
    Riscv(RiscvError),
    Xtensa(XtensaError),
    CoreDisabled(usize),
    CoreNotFound(usize),
    ChipNotFound(RegistryError),
    MissingPermissions(String),
    GenericCoreError(String),
    Register(String),
    RegisterAddressOutOfBounds(RegisterAddressOutOfBounds),
    NotImplemented(&'static str),
    Other(String),
    Timeout,
    MemoryNotAligned(MemoryNotAlignedError),
    InvalidDataLength(InvalidDataLengthError),
    WriteRegister {
        register: String,
        source: Box<dyn Error + Send + Sync + 'static>,
    },
    ReadRegister {
        register: String,
        source: Box<dyn Error + Send + Sync + 'static>,
    },
}

The overarching error type which contains all possible errors as variants.

Variants

Probe(DebugProbeError)

An error with the usage of the probe occurred

Arm(ArmError)

An ARM specific error occurred.

Riscv(RiscvError)

A RISC-V specific error occurred.

Xtensa(XtensaError)

An Xtensa specific error occurred.

CoreDisabled(usize)

Core {0} is not enabled.

CoreNotFound(usize)

Core {0} does not exist.

ChipNotFound(RegistryError)

Unable to load specification for chip

MissingPermissions(String)

An operation was not performed because the required permissions were not given: {0}.

This can for example happen when the core is locked and needs to be erased to be unlocked. Then the correct permission needs to be given to automatically unlock the core to prevent accidental erases.

GenericCoreError(String)

An error that is not architecture specific occurred: {0}

Register(String)

Errors accessing core register: {0}

RegisterAddressOutOfBounds(RegisterAddressOutOfBounds)

Error calculating the address of a register

NotImplemented(&'static str)

The {0} capability has not yet been implemented for this architecture.

Because of the large varieties of supported architectures, it is not always possible for a contributor to implement functionality for all of them. This allows us to implement new functionality on selected architectures first, and then add support for the other architectures later.

Other(String)

Some uncategorized error occurred.

Timeout

A timeout occurred.

MemoryNotAligned(MemoryNotAlignedError)

Memory access to address {0.address:#X?} was not aligned to {0.alignment} bytes.

InvalidDataLength(InvalidDataLengthError)

The data buffer had an invalid length.

WriteRegister

Failed to write CPU register {register}.

Fields

register: String

The name of the register that was tried to be written.

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

The source error of this error.

ReadRegister

Failed to read CPU register {register}.

Fields

register: String

The name of the register that was tried to be read.

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

The source error of this error.

Trait Implementations

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, 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<ArmError> for Error

fn from(value: ArmError) -> Self

Converts to this type from the input type.

impl From<DebugProbeError> for Error

fn from(source: DebugProbeError) -> Self

Converts to this type from the input type.

impl From<Error> for DebugError

Available on crate feature debug only.

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FileDownloadError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RegistryError> for Error

fn from(source: RegistryError) -> Self

Converts to this type from the input type.

impl From<RiscvError> for Error

fn from(err: RiscvError) -> Self

Converts to this type from the input type.

impl From<XtensaError> for Error

fn from(err: XtensaError) -> Self

Converts to this type from the input type.