Struct Armv8m

pub struct Armv8m<'probe> { /* private fields */ }

The state of a core that can be used to persist core state across calls to multiple different cores.

Trait Implementations

impl CoreInterface for Armv8m<'_>

fn hw_breakpoints(&mut self) -> Result<Vec<Option<u64>>, Error>

See docs on the CoreInterface::hw_breakpoints trait

fn wait_for_core_halted(&mut self, timeout: Duration) -> Result<(), Error>

Wait until the core is halted. If the core does not halt on its own, a DebugProbeError::Timeout error will be returned.

fn core_halted(&mut self) -> Result<bool, Error>

Check if the core is halted. If the core does not halt on its own, a DebugProbeError::Timeout error will be returned.

fn status(&mut self) -> Result<CoreStatus, Error>

Returns the current status of the core.

fn halt(&mut self, timeout: Duration) -> Result<CoreInformation, Error>

Try to halt the core. This function ensures the core is actually halted, and returns a DebugProbeError::Timeout otherwise.

fn run(&mut self) -> Result<(), Error>

Continue to execute instructions.

fn reset(&mut self) -> Result<(), Error>

Reset the core, and then continue to execute instructions. If the core should be halted after reset, use the reset_and_halt function.

fn reset_and_halt( &mut self, _timeout: Duration, ) -> Result<CoreInformation, Error>

Reset the core, and then immediately halt. To continue execution after reset, use the reset function.

fn step(&mut self) -> Result<CoreInformation, Error>

Steps one instruction and then enters halted state again.

fn read_core_reg(&mut self, address: RegisterId) -> Result<RegisterValue, Error>

Read the value of a core register.

fn write_core_reg( &mut self, address: RegisterId, value: RegisterValue, ) -> Result<(), Error>

Write the value of a core register.

fn available_breakpoint_units(&mut self) -> Result<u32, Error>

Returns all the available breakpoint units of the core.

fn enable_breakpoints(&mut self, state: bool) -> Result<(), Error>

Enables breakpoints on this core. If a breakpoint is set, it will halt as soon as it is hit.

fn set_hw_breakpoint( &mut self, bp_unit_index: usize, addr: u64, ) -> Result<(), Error>

Sets a breakpoint at addr. It does so by using unit bp_unit_index.

fn clear_hw_breakpoint(&mut self, bp_unit_index: usize) -> Result<(), Error>

Clears the breakpoint configured in unit unit_index.

fn registers(&self) -> &'static CoreRegisters

Returns a list of all the registers of this core.

fn program_counter(&self) -> &'static CoreRegister

Returns the program counter register.

fn frame_pointer(&self) -> &'static CoreRegister

Returns the stack pointer register.

fn stack_pointer(&self) -> &'static CoreRegister

Returns the frame pointer register.

fn return_address(&self) -> &'static CoreRegister

Returns the return address register, a.k.a. link register.

fn hw_breakpoints_enabled(&self) -> bool

Returns true if hardware breakpoints are enabled, false otherwise.

fn architecture(&self) -> Architecture

Get the Architecture of the Core.

fn core_type(&self) -> CoreType

Get the CoreType of the Core

fn instruction_set(&mut self) -> Result<InstructionSet, Error>

Determine the instruction set the core is operating in This must be queried while halted as this is a runtime decision for some core types

fn fpu_support(&mut self) -> Result<bool, Error>

Determine if an FPU is present. This must be queried while halted as this is a runtime decision for some core types.

fn floating_point_register_count(&mut self) -> Result<usize, Error>

Determine the number of floating point registers. This must be queried while halted as this is a runtime decision for some core types.

fn reset_catch_set(&mut self) -> Result<(), Error>

Set the reset catch setting.

fn reset_catch_clear(&mut self) -> Result<(), Error>

Clear the reset catch setting.

fn debug_core_stop(&mut self) -> Result<(), Error>

Called when we stop debugging a core.

fn enable_vector_catch( &mut self, condition: VectorCatchCondition, ) -> Result<(), Error>

Enables vector catching for the given condition

fn disable_vector_catch( &mut self, condition: VectorCatchCondition, ) -> Result<(), Error>

Disables vector catching for the given condition

fn debug_on_sw_breakpoint(&mut self, _enabled: bool) -> Result<(), Error>

Configure the target to ensure software breakpoints will enter Debug Mode.

fn on_session_stop(&mut self) -> Result<(), Error>

Called during session stop to do any pending cleanup

fn is_64_bit(&self) -> bool

Check if the integer size is 64-bit