Struct probe_rs::architecture::arm::ArmCommunicationInterface

source · [−]

pub struct ArmCommunicationInterface<S: ArmDebugState> { /* private fields */ }

Expand description

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

source

impl<'interface> ArmCommunicationInterface<Initialized>

source

pub fn memory_interface(
&'interface mut self,
access_port: MemoryAp
) -> Result<Memory<'interface>, ProbeRsError>

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

source

impl ArmCommunicationInterface<Initialized>

source

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

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

Trait Implementations

source

impl ArmProbeInterface for ArmCommunicationInterface<Initialized>

source

fn memory_interface(
&mut self,
access_port: MemoryAp
) -> Result<Memory<'_>, ProbeRsError>

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

source

fn ap_information(
&mut self,
access_port: GenericAp
) -> Result<&ApInformation, ProbeRsError>

Returns information about a specific access port.

source

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

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

source

fn num_access_ports(&mut self, dp: DpAddress) -> Result<usize, ProbeRsError>

Returns the number of access ports the debug port has.

source

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

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

source

impl CommunicationInterface for ArmCommunicationInterface<Initialized>

source

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

Flush all remaining commands if the target driver implements batching.

source

fn get_arm_communication_interface(
&mut self
) -> Result<&mut ArmCommunicationInterface<Initialized>, ProbeRsError>

Tries to get the underlying ArmCommunicationInterface.

source

impl DapAccess for ArmCommunicationInterface<Initialized>

source

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

Read a Debug Port register. Read more

source

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

Write a Debug Port register. Read more

source

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

Read an Access Port register. Read more

source

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

Read multiple values from the same Access Port register. Read more

source

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

Write an AP register. Read more

source

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

Write multiple values to the same Access Port register. Read more

source

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

source

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

Formats the value using the given formatter. Read more

source

impl SwoAccess for ArmCommunicationInterface<Initialized>

source

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

Configure a SwoAccess interface for reading SWO data.

source

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

Disable SWO reading on this SwoAccess interface.

source

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

Read SWO data for up to timeout duration. Read more

source

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

Read any available SWO data without waiting. Read more

source

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

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

source

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

Request the probe SWO buffer size, if known.

Auto Trait Implementations

impl<S> !RefUnwindSafe for ArmCommunicationInterface<S>

impl<S> Send for ArmCommunicationInterface<S> where
S: Send,

impl<S> !Sync for ArmCommunicationInterface<S>

impl<S> Unpin for ArmCommunicationInterface<S> where
S: Unpin,

impl<S> !UnwindSafe for ArmCommunicationInterface<S>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> ApAccess for T where
T: DapAccess,

source

fn read_ap_register<PORT, R>(
 &mut self,
 port: impl Into<PORT>
) -> Result<R, DebugProbeError> where
 PORT: AccessPort,
 R: ApRegister<PORT>,

Read a register of the access port.

source

fn write_ap_register<PORT, R>(
 &mut self,
 port: impl Into<PORT>,
 register: R
) -> Result<(), DebugProbeError> where
 PORT: AccessPort,
 R: ApRegister<PORT>,

Write a register of the access port.

source

fn write_ap_register_repeated<PORT, R>(
 &mut self,
 port: impl Into<PORT>,
 _register: R,
 values: &[u32]
) -> Result<(), DebugProbeError> where
 PORT: AccessPort,
 R: ApRegister<PORT>,

Write a register of the access port using a block transfer. This can be used to write multiple values to the same register. Read more

source

fn read_ap_register_repeated<PORT, R>(
 &mut self,
 port: impl Into<PORT>,
 _register: R,
 values: &mut [u32]
) -> Result<(), DebugProbeError> where
 PORT: AccessPort,
 R: ApRegister<PORT>,

Read a register of the access port using a block transfer. This can be used to read multiple values from the same register. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> DpAccess for T where
T: DapAccess,

source

fn read_dp_register<R>(&mut self, dp: DpAddress) -> Result<R, DebugPortError> where
R: DpRegister,

Reads a debug port register.

source

fn write_dp_register<R>(
 &mut self,
 dp: DpAddress,
 register: R
) -> Result<(), DebugPortError> where
 R: DpRegister,

Write a debug port register.

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct probe_rs::architecture::arm::ArmCommunicationInterface

Implementations

impl<'interface> ArmCommunicationInterface<Initialized>

pub fn memory_interface( &'interface mut self, access_port: MemoryAp) -> Result<Memory<'interface>, ProbeRsError>

impl ArmCommunicationInterface<Initialized>

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

Trait Implementations

impl ArmProbeInterface for ArmCommunicationInterface<Initialized>

fn memory_interface( &mut self, access_port: MemoryAp) -> Result<Memory<'_>, ProbeRsError>

fn ap_information( &mut self, access_port: GenericAp) -> Result<&ApInformation, ProbeRsError>

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

fn num_access_ports(&mut self, dp: DpAddress) -> Result<usize, ProbeRsError>

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

impl CommunicationInterface for ArmCommunicationInterface<Initialized>

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

fn get_arm_communication_interface( &mut self) -> Result<&mut ArmCommunicationInterface<Initialized>, ProbeRsError>

impl DapAccess for ArmCommunicationInterface<Initialized>

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

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

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

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

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

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

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

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

impl SwoAccess for ArmCommunicationInterface<Initialized>

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

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

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

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

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

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

Auto Trait Implementations

impl<S> !RefUnwindSafe for ArmCommunicationInterface<S>

impl<S> Send for ArmCommunicationInterface<S> where S: Send,

impl<S> !Sync for ArmCommunicationInterface<S>

impl<S> Unpin for ArmCommunicationInterface<S> where S: Unpin,

impl<S> !UnwindSafe for ArmCommunicationInterface<S>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> ApAccess for T where T: DapAccess,

fn read_ap_register<PORT, R>( &mut self, port: impl Into<PORT>) -> Result<R, DebugProbeError> where PORT: AccessPort, R: ApRegister<PORT>,

fn write_ap_register<PORT, R>( &mut self, port: impl Into<PORT>, register: R) -> Result<(), DebugProbeError> where PORT: AccessPort, R: ApRegister<PORT>,

fn write_ap_register_repeated<PORT, R>( &mut self, port: impl Into<PORT>, _register: R, values: &[u32]) -> Result<(), DebugProbeError> where PORT: AccessPort, R: ApRegister<PORT>,

fn read_ap_register_repeated<PORT, R>( &mut self, port: impl Into<PORT>, _register: R, values: &mut [u32]) -> Result<(), DebugProbeError> where PORT: AccessPort, R: ApRegister<PORT>,

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> DpAccess for T where T: DapAccess,

fn read_dp_register<R>(&mut self, dp: DpAddress) -> Result<R, DebugPortError> where R: DpRegister,

fn write_dp_register<R>( &mut self, dp: DpAddress, register: R) -> Result<(), DebugPortError> where R: DpRegister,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

pub fn memory_interface(
&'interface mut self,
access_port: MemoryAp
) -> Result<Memory<'interface>, ProbeRsError>

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

fn memory_interface(
&mut self,
access_port: MemoryAp
) -> Result<Memory<'_>, ProbeRsError>

fn ap_information(
&mut self,
access_port: GenericAp
) -> Result<&ApInformation, ProbeRsError>

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

fn get_arm_communication_interface(
&mut self
) -> Result<&mut ArmCommunicationInterface<Initialized>, ProbeRsError>

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

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

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

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

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

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

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

impl<S> Send for ArmCommunicationInterface<S> where
S: Send,

impl<S> Unpin for ArmCommunicationInterface<S> where
S: Unpin,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> ApAccess for T where
T: DapAccess,

fn read_ap_register<PORT, R>(
&mut self,
port: impl Into<PORT>
) -> Result<R, DebugProbeError> where
PORT: AccessPort,
R: ApRegister<PORT>,

fn write_ap_register<PORT, R>(
&mut self,
port: impl Into<PORT>,
register: R
) -> Result<(), DebugProbeError> where
PORT: AccessPort,
R: ApRegister<PORT>,

fn write_ap_register_repeated<PORT, R>(
&mut self,
port: impl Into<PORT>,
_register: R,
values: &[u32]
) -> Result<(), DebugProbeError> where
PORT: AccessPort,
R: ApRegister<PORT>,

fn read_ap_register_repeated<PORT, R>(
&mut self,
port: impl Into<PORT>,
_register: R,
values: &mut [u32]
) -> Result<(), DebugProbeError> where
PORT: AccessPort,
R: ApRegister<PORT>,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T> DpAccess for T where
T: DapAccess,

fn read_dp_register<R>(&mut self, dp: DpAddress) -> Result<R, DebugPortError> where
R: DpRegister,

fn write_dp_register<R>(
&mut self,
dp: DpAddress,
register: R
) -> Result<(), DebugPortError> where
R: DpRegister,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,