Enum probe_rs::Error

pub enum Error {
    Probe(DebugProbeError),
    Arm(ArmError),
    Riscv(RiscvError),
    Xtensa(XtensaError),
    UnableToOpenProbe(&'static str),
    CoreNotFound(usize),
    ChipNotFound(RegistryError),
    MissingPermissions(String),
    GenericCoreError(String),
    Register(String),
    NotImplemented(&'static str),
    Other(Error),
    Timeout,
    MemoryNotAligned {
        address: u64,
        alignment: usize,
    },
}

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

Variants

Probe(DebugProbeError)

An error in the probe driver occurred.

Arm(ArmError)

An ARM specific error occurred.

Riscv(RiscvError)

A RISC-V specific error occurred.

Xtensa(XtensaError)

An Xtensa specific error occurred.

UnableToOpenProbe(&'static str)

The probe could not be opened.

CoreNotFound(usize)

The core with given ID does not exist.

ChipNotFound(RegistryError)

The given chip does not exist.

MissingPermissions(String)

An operation was not performed because the required permissions were not given.

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.

Register(String)

Errors related to the handling of core registers inside probe-rs .

NotImplemented(&'static str)

The variant of the function you called is not yet implemented. 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(Error)

Any other error occurred.

Timeout

A timeout occurred during an operation

MemoryNotAligned

Fields

address: u64

The address of the register.

alignment: usize

The required alignment in bytes (address increments).

Unaligned memory access

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)>

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

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

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.