Struct ArmCommunicationInterface

pub struct ArmCommunicationInterface<S: ArmDebugState> { /* 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<'interface> ArmCommunicationInterface<Initialized>

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

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

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

Tries to obtain a memory interface which can be used to read memory from ARM targets.

impl ArmCommunicationInterface<Initialized>

pub fn read_chip_info_from_rom_table( &mut self, dp: DpAddress, ) -> Result<Option<ArmChipInfo>, ArmError>

Reads the chip info from the romtable of given debug port.

Trait Implementations

impl ArmProbeInterface for ArmCommunicationInterface<Initialized>

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 read_chip_info_from_rom_table( &mut self, dp: DpAddress, ) -> Result<Option<ArmChipInfo>, ArmError>

Reads the chip info from the romtable of given debug port.

fn current_debug_port(&self) -> 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.

impl DapAccess for ArmCommunicationInterface<Initialized>

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

Read a Debug Port register.

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

Write a Debug Port register.

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

Read an Access Port register.

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

Read multiple values from the same Access Port register.

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

Write an AP register.

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

Write multiple values to the same Access Port register.

impl<S: Debug + ArmDebugState> Debug for ArmCommunicationInterface<S>

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

Formats the value using the given formatter.

impl<S: ArmDebugState> Drop for ArmCommunicationInterface<S>

fn drop(&mut self)

Executes the destructor for this type.

impl SwoAccess for ArmCommunicationInterface<Initialized>

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.