Enum ArmError

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

ARM-specific errors

Variants

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

The operation requires one of the following architectures: {0:?}

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

Error using access port {address:?}.

Fields

address: FullyQualifiedApAddress

Address of the access port

source: AccessPortError

Source of the error.

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 could not be performed because it lacked the permission to do so: {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.

Dap(DapError)

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

Probe(DebugProbeError)

The debug probe encountered an error.

MemoryNotAligned(MemoryNotAlignedError)

Failed to access address 0x{0.address:08x} as it is not aligned to the requirement of {0.alignment} bytes for this platform and API call.

OutOfBounds

A region outside of the AP address space was accessed.

UnsupportedTransferWidth(usize)

{0} bit is not a supported memory transfer width on the current core.

ApDoesNotExist(FullyQualifiedApAddress)

The AP with address {0:?} does not exist.

WrongApVersion

The AP has the wrong version for the operation.

WrongApType

The AP has the wrong type for the operation.

UnsupportedBreakpointAddress(u32)

Unable to create a breakpoint at address {0:#010X}. Hardware breakpoints are only supported at addresses < 0x2000_0000.

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 the following extension(s): {0:?}.

RegisterAddressOutOfBounds(RegisterAddressOutOfBounds)

An error occurred while calculating the address of a register.

NotImplemented(&'static str)

Some required functionality is not implemented: {0}

InvalidDataLength(InvalidDataLengthError)

Invalid data length error: {0}

Other(String)

Another ARM error occurred: {0}

Implementations

impl ArmError

pub fn from_access_port( err: AccessPortError, ap_address: &FullyQualifiedApAddress, ) -> 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)>

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

fn from(source: RegisterParseError) -> Self

Converts to this type from the input type.

impl From<RomTableError> for ArmError

fn from(value: RomTableError) -> Self

Converts to this type from the input type.