Enum probe_rs::architecture::arm::ArmError

pub enum ArmError {
    ArchitectureRequired(&'static [&'static str]),
    Timeout,
    AddressOutOf32BitAddressSpace,
    NoArmTarget,
    AccessPort {
        address: ApAddress,
        source: AccessPortError,
    },
    DebugPort(DebugPortError),
    CoreNotHalted,
    ReAttachRequired,
    MissingPermissions(String),
    Dap(DapError),
    Probe(DebugProbeError),
    MemoryNotAligned {
        address: u64,
        alignment: usize,
    },
    OutOfBounds,
    UnsupportedTransferWidth(usize),
    ApDoesNotExist(ApAddress),
    WrongApType,
    UnsupportedBreakpointAddress(u32),
    Armv8a(Armv8aError),
    Armv7a(Armv7aError),
    DebugSequence(ArmDebugSequenceError),
    TracingUnconfigured,
    RegisterParse(RegisterParseError),
    RomTable(RomTableError),
    ChipEraseFailed,
    ExtensionRequired(&'static [&'static str]),
    Other(Error),
}

ARM-specific errors

Variants

ArchitectureRequired(&'static [&'static str])

The operation requires a specific architecture.

Timeout

A timeout occurred during an operation

AddressOutOf32BitAddressSpace

The address is too large for the 32 bit address space.

NoArmTarget

The current target device is not an ARM device.

AccessPort

Fields

address: ApAddress

Address of the access port

source: AccessPortError

Source of the error.

Error using a specific AP.

DebugPort(DebugPortError)

An error occurred while using a debug port.

CoreNotHalted

The core has to be halted for the operation, but was not.

ReAttachRequired

Performing certain operations (e.g device unlock or Chip-Erase) can leave the device in a state that requires a probe re-attach to resolve.

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.

Dap(DapError)

An error occurred in the communication with an access port or debug port.

Probe(DebugProbeError)

The debug probe encountered an error.

MemoryNotAligned

Fields

address: u64

The address of the register.

alignment: usize

The required alignment in bytes (address increments).

The given register address to perform an access on was not memory aligned. Make sure it is aligned to the size of the access (address & access_size == 0).

OutOfBounds

A region outside of the AP address space was accessed.

UnsupportedTransferWidth(usize)

The requested memory transfer width is not supported on the current core.

ApDoesNotExist(ApAddress)

The AP with the specified address does not exist.

WrongApType

The AP has the wrong type for the operation.

UnsupportedBreakpointAddress(u32)

It is not possible to create a breakpoint a the given address.

Armv8a(Armv8aError)

ARMv8a specific error occurred.

Armv7a(Armv7aError)

ARMv7a specific error occurred.

DebugSequence(ArmDebugSequenceError)

Error occurred in a debug sequence.

TracingUnconfigured

Tracing has not been configured.

RegisterParse(RegisterParseError)

Error parsing a register.

RomTable(RomTableError)

Error reading ROM table.

ChipEraseFailed

Failed to erase chip

ExtensionRequired(&'static [&'static str])

The operation requires a specific extension.

Other(Error)

Any other error occurred.

Implementations

impl ArmError

pub fn from_access_port(err: AccessPortError, ap: impl AccessPort) -> Self

Constructs ArmError::MemoryNotAligned from the address and the required alignment.

pub fn alignment_error(address: u64, alignment: usize) -> Self

Constructs a ArmError::MemoryNotAligned from the address and the required alignment.

Trait Implementations

impl Debug for ArmError

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

Formats the value using the given formatter.

impl Display for ArmError

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

Formats the value using the given formatter.

impl Error for ArmError

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<ArmDebugSequenceError> for ArmError

fn from(source: ArmDebugSequenceError) -> Self

Converts to this type from the input type.

impl From<ArmError> for Error

fn from(value: ArmError) -> Self

Converts to this type from the input type.

impl From<Armv7aError> for ArmError

fn from(source: Armv7aError) -> Self

Converts to this type from the input type.

impl From<Armv8aError> for ArmError

fn from(source: Armv8aError) -> Self

Converts to this type from the input type.

impl From<ComponentError> for ArmError

fn from(value: ComponentError) -> ArmError

Converts to this type from the input type.

impl From<DapError> for ArmError

fn from(source: DapError) -> Self

Converts to this type from the input type.

impl From<DebugPortError> for ArmError

fn from(source: DebugPortError) -> Self

Converts to this type from the input type.

impl From<DebugProbeError> for ArmError

fn from(source: DebugProbeError) -> Self

Converts to this type from the input type.

impl From<Error> for ArmError

fn from(source: Error) -> Self

Converts to this type from the input type.