Struct ArmCommunicationInterface 

pub struct ArmCommunicationInterface { /* private fields */ }

An implementation of the communication protocol between probe and target. Can be used to perform all sorts of generic debug access on ARM targets with probes that support low level access. (E.g. CMSIS-DAP and J-Link support this, ST-Link does not)

Implementations

impl ArmCommunicationInterface

pub fn create( probe: Box<dyn DapProbe>, sequence: Arc<dyn ArmDebugSequence>, use_overrun_detect: bool, ) -> Box<dyn ArmDebugInterface>

Create a new instance of the communication interface, which is not yet connected to a debug port.

pub fn core_status_notification(&mut self, state: CoreStatus)

Inform the probe of the CoreStatus of the chip attached to the probe.

Trait Implementations

impl ArmDebugInterface for ArmCommunicationInterface

fn reinitialize(&mut self) -> Result<(), ArmError>

Reinitialize the communication interface (in place).

fn memory_interface( &mut self, access_port_address: &FullyQualifiedApAddress, ) -> Result<Box<dyn ArmMemoryInterface + '_>, ArmError>

Returns a memory interface to access the target’s memory.

fn current_debug_port(&self) -> Option<DpAddress>

Return the currently connected debug port.

fn close(self: Box<Self>) -> Probe

Closes the interface and returns back the generic probe it consumed.

fn access_ports( &mut self, dp: DpAddress, ) -> Result<BTreeSet<FullyQualifiedApAddress>, ArmError>

Returns a vector of all the access ports the current debug port has.

fn select_debug_port(&mut self, dp: DpAddress) -> Result<(), ArmError>

Explicitly select a debug port.

impl DapAccess for ArmCommunicationInterface

fn read_raw_dp_register( &mut self, dp: DpAddress, address: DpRegisterAddress, ) -> Result<u32, ArmError>

Read a Debug Port register.

fn write_raw_dp_register( &mut self, dp: DpAddress, address: DpRegisterAddress, value: u32, ) -> Result<(), ArmError>

Write a Debug Port register.

fn read_raw_ap_register( &mut self, ap: &FullyQualifiedApAddress, address: u64, ) -> Result<u32, ArmError>

Read an Access Port register.

fn read_raw_ap_register_repeated( &mut self, ap: &FullyQualifiedApAddress, address: u64, values: &mut [u32], ) -> Result<(), ArmError>

Read multiple values from the same Access Port register.

fn write_raw_ap_register( &mut self, ap: &FullyQualifiedApAddress, address: u64, value: u32, ) -> Result<(), ArmError>

Write an AP register.

fn write_raw_ap_register_repeated( &mut self, ap: &FullyQualifiedApAddress, address: u64, values: &[u32], ) -> Result<(), ArmError>

Write multiple values to the same Access Port register.

fn flush(&mut self) -> Result<(), ArmError>

Flush any outstanding operations.

fn try_dap_probe(&self) -> Option<&dyn DapProbe>

Gain access to the Probe that implements this trait

fn try_dap_probe_mut(&mut self) -> Option<&mut dyn DapProbe>

Gain mutable access to the Probe that implements this trait

impl Debug for ArmCommunicationInterface

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

Formats the value using the given formatter.

impl Drop for ArmCommunicationInterface

fn drop(&mut self)

Executes the destructor for this type.

impl SwoAccess for ArmCommunicationInterface

fn enable_swo(&mut self, config: &SwoConfig) -> Result<(), ArmError>

Configure a SwoAccess interface for reading SWO data.

fn disable_swo(&mut self) -> Result<(), ArmError>

Disable SWO reading on this SwoAccess interface.

fn read_swo_timeout(&mut self, timeout: Duration) -> Result<Vec<u8>, ArmError>

Read SWO data for up to timeout duration.

fn read_swo(&mut self) -> Result<Vec<u8>, ArmError>

Read any available SWO data without waiting.

fn swo_poll_interval_hint(&mut self, config: &SwoConfig) -> Option<Duration>

Request an estimated best time to wait between polls of read_swo.

fn swo_buffer_size(&mut self) -> Option<usize>

Request the probe SWO buffer size, if known.