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>
impl<'interface> ArmCommunicationInterface<Initialized>
source§impl ArmCommunicationInterface<Initialized>
impl ArmCommunicationInterface<Initialized>
sourcepub fn read_chip_info_from_rom_table(
&mut self,
dp: DpAddress
) -> Result<Option<ArmChipInfo>, ArmError>
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§
source§impl ArmProbeInterface for ArmCommunicationInterface<Initialized>
impl ArmProbeInterface for ArmCommunicationInterface<Initialized>
source§fn memory_interface(
&mut self,
access_port: MemoryAp
) -> Result<Box<dyn ArmProbe + '_>, ArmError>
fn memory_interface(
&mut self,
access_port: MemoryAp
) -> Result<Box<dyn ArmProbe + '_>, ArmError>
Returns a memory interface to access the target’s memory.
source§fn ap_information(
&mut self,
access_port: GenericAp
) -> Result<&ApInformation, ArmError>
fn ap_information(
&mut self,
access_port: GenericAp
) -> Result<&ApInformation, ArmError>
Returns information about a specific access port.
source§fn read_chip_info_from_rom_table(
&mut self,
dp: DpAddress
) -> Result<Option<ArmChipInfo>, ArmError>
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.
source§impl DapAccess for ArmCommunicationInterface<Initialized>
impl DapAccess for ArmCommunicationInterface<Initialized>
source§fn read_raw_dp_register(
&mut self,
dp: DpAddress,
address: u8
) -> Result<u32, ArmError>
fn read_raw_dp_register(
&mut self,
dp: DpAddress,
address: u8
) -> Result<u32, ArmError>
Read a Debug Port register. Read more
source§fn write_raw_dp_register(
&mut self,
dp: DpAddress,
address: u8,
value: u32
) -> Result<(), ArmError>
fn write_raw_dp_register(
&mut self,
dp: DpAddress,
address: u8,
value: u32
) -> Result<(), ArmError>
Write a Debug Port register. Read more
source§fn read_raw_ap_register(
&mut self,
ap: ApAddress,
address: u8
) -> Result<u32, ArmError>
fn read_raw_ap_register(
&mut self,
ap: ApAddress,
address: u8
) -> Result<u32, ArmError>
Read an Access Port register. Read more
source§fn read_raw_ap_register_repeated(
&mut self,
ap: ApAddress,
address: u8,
values: &mut [u32]
) -> Result<(), ArmError>
fn read_raw_ap_register_repeated(
&mut self,
ap: ApAddress,
address: u8,
values: &mut [u32]
) -> Result<(), ArmError>
Read multiple values from the same Access Port register. Read more
source§impl<S: Debug + ArmDebugState> Debug for ArmCommunicationInterface<S>
impl<S: Debug + ArmDebugState> Debug for ArmCommunicationInterface<S>
source§impl SwoAccess for ArmCommunicationInterface<Initialized>
impl SwoAccess for ArmCommunicationInterface<Initialized>
source§fn enable_swo(&mut self, config: &SwoConfig) -> Result<(), ArmError>
fn enable_swo(&mut self, config: &SwoConfig) -> Result<(), ArmError>
Configure a SwoAccess interface for reading SWO data.
source§fn disable_swo(&mut self) -> Result<(), ArmError>
fn disable_swo(&mut self) -> Result<(), ArmError>
Disable SWO reading on this SwoAccess interface.
source§fn read_swo_timeout(&mut self, timeout: Duration) -> Result<Vec<u8>, ArmError>
fn read_swo_timeout(&mut self, timeout: Duration) -> Result<Vec<u8>, ArmError>
Read SWO data for up to
timeout
duration. Read moresource§fn read_swo(&mut self) -> Result<Vec<u8>, ArmError>
fn read_swo(&mut self) -> Result<Vec<u8>, ArmError>
Read any available SWO data without waiting. Read more
source§fn swo_poll_interval_hint(&mut self, config: &SwoConfig) -> Option<Duration>
fn swo_poll_interval_hint(&mut self, config: &SwoConfig) -> Option<Duration>
Request an estimated best time to wait between polls of
read_swo
. Read moresource§fn swo_buffer_size(&mut self) -> Option<usize>
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> ApAccess for Twhere
T: DapAccess,
impl<T> ApAccess for Twhere
T: DapAccess,
source§fn read_ap_register<PORT, R>(
&mut self,
port: impl Into<PORT>
) -> Result<R, ArmError>where
PORT: AccessPort,
R: ApRegister<PORT>,
fn read_ap_register<PORT, R>(
&mut self,
port: impl Into<PORT>
) -> Result<R, ArmError>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<(), ArmError>where
PORT: AccessPort,
R: ApRegister<PORT>,
fn write_ap_register<PORT, R>(
&mut self,
port: impl Into<PORT>,
register: R
) -> Result<(), ArmError>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<(), ArmError>where
PORT: AccessPort,
R: ApRegister<PORT>,
fn write_ap_register_repeated<PORT, R>(
&mut self,
port: impl Into<PORT>,
_register: R,
values: &[u32]
) -> Result<(), ArmError>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.
source§fn read_ap_register_repeated<PORT, R>(
&mut self,
port: impl Into<PORT>,
_register: R,
values: &mut [u32]
) -> Result<(), ArmError>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<(), ArmError>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.
§impl<T> Conv for T
impl<T> Conv for T
source§impl<T> DpAccess for Twhere
T: DapAccess,
impl<T> DpAccess for Twhere
T: DapAccess,
source§fn read_dp_register<R>(&mut self, dp: DpAddress) -> Result<R, ArmError>where
R: DpRegister,
fn read_dp_register<R>(&mut self, dp: DpAddress) -> Result<R, ArmError>where
R: DpRegister,
Reads a debug port register. Read more
source§fn write_dp_register<R>(
&mut self,
dp: DpAddress,
register: R
) -> Result<(), ArmError>where
R: DpRegister,
fn write_dp_register<R>(
&mut self,
dp: DpAddress,
register: R
) -> Result<(), ArmError>where
R: DpRegister,
Write a debug port register. Read more
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
Causes
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
Causes
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
Causes
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
Causes
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
Causes
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
Causes
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
Causes
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
Causes
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
Formats each item in a sequence. Read more
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Pipes by value. This is generally the method you want to use. Read more
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
Borrows
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
Mutably borrows
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> Rwhere
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> Rwhere
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> Rwhere
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> Rwhere
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,
Borrows
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> Rwhere
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,
Mutably borrows
self
, then passes self.as_mut()
into the pipe
function.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
Immutable access to the
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
Mutable access to the
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
Immutable access to the
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
Mutable access to the
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere
Self: Deref<Target = T>,
T: ?Sized,
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Selfwhere
Self: Deref<Target = T>,
T: ?Sized,
Immutable access to the
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere
Self: DerefMut<Target = T> + Deref,
T: ?Sized,
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Selfwhere
Self: DerefMut<Target = T> + Deref,
T: ?Sized,
Mutable access to the
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Selfwhere
Self: Borrow<B>,
B: ?Sized,
Calls
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Selfwhere
Self: BorrowMut<B>,
B: ?Sized,
Calls
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Selfwhere
Self: AsRef<R>,
R: ?Sized,
Calls
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Selfwhere
Self: AsMut<R>,
R: ?Sized,
Calls
.tap_ref_mut()
only in debug builds, and is erased in release
builds.