Struct CmsisDap

pub struct CmsisDap { /* private fields */ }

A CMSIS-DAP probe.

Trait Implementations

impl Debug for CmsisDap

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

Formats the value using the given formatter.

impl DebugProbe for CmsisDap

fn speed_khz(&self) -> u32

Get the currently set maximum speed.

CMSIS-DAP offers no possibility to get the actual speed used.

fn set_speed(&mut self, speed_khz: u32) -> Result<u32, DebugProbeError>

For CMSIS-DAP, we can set the maximum speed. The actual speed used by the probe cannot be determined, but it will not be higher than this value.

fn scan_chain(&self) -> Result<&[ScanChainElement], DebugProbeError>

Returns the JTAG scan chain

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

Enters debug mode.

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

Leave debug mode.

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

Asserts the nRESET pin.

fn get_name(&self) -> &str

Get human readable name for the probe.

fn set_scan_chain( &mut self, scan_chain: Vec<ScanChainElement>, ) -> Result<(), DebugProbeError>

Set the JTAG scan chain information for the target under debug.

fn select_protocol( &mut self, protocol: WireProtocol, ) -> Result<(), DebugProbeError>

Selects the transport protocol to be used by the debug probe.

fn active_protocol(&self) -> Option<WireProtocol>

Get the transport protocol currently in active use by the debug probe.

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

This should assert the reset pin of the target via debug probe.

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

This should deassert the reset pin of the target via debug probe.

fn get_swo_interface(&self) -> Option<&dyn SwoAccess>

Get a SWO interface from the debug probe.

fn get_swo_interface_mut(&mut self) -> Option<&mut dyn SwoAccess>

Get a mutable SWO interface from the debug probe.

fn try_get_arm_interface<'probe>( self: Box<Self>, ) -> Result<Box<dyn UninitializedArmProbe + 'probe>, (Box<dyn DebugProbe>, DebugProbeError)>

Get the dedicated interface to debug ARM chips. To check that the probe actually supports this, call DebugProbe::has_arm_interface first.

fn has_arm_interface(&self) -> bool

Check if the probe offers an interface to debug ARM chips.

fn into_probe(self: Box<Self>) -> Box<dyn DebugProbe>

Boxes itself.

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

Try creating a DAP interface for the given probe.

fn select_jtag_tap(&mut self, index: usize) -> Result<(), DebugProbeError>

Selects the JTAG TAP to be used for communication.

fn try_get_riscv_interface_builder<'probe>( &'probe mut self, ) -> Result<Box<dyn RiscvInterfaceBuilder<'probe> + 'probe>, DebugProbeError>

Try to get a RiscvInterfaceBuilder object, which can be used to set up a communication interface with chips using the RISC-V architecture.

fn has_riscv_interface(&self) -> bool

Check if the probe offers an interface to debug RISC-V chips.

fn try_get_xtensa_interface<'probe>( &'probe mut self, _state: &'probe mut XtensaDebugInterfaceState, ) -> Result<XtensaCommunicationInterface<'probe>, DebugProbeError>

Get the dedicated interface to debug Xtensa chips. Ensure that the probe actually supports this by calling DebugProbe::has_xtensa_interface first.

fn has_xtensa_interface(&self) -> bool

Check if the probe offers an interface to debug Xtensa chips.

fn get_target_voltage(&mut self) -> Result<Option<f32>, DebugProbeError>

Reads the target voltage in Volts, if possible. Returns Ok(None) if the probe doesn’t support reading the target voltage.

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

Try to get a J-Link interface from the debug probe.

impl Drop for CmsisDap

fn drop(&mut self)

Executes the destructor for this type.

impl RawDapAccess for CmsisDap

fn raw_read_register( &mut self, port: PortType, addr: u8, ) -> Result<u32, ArmError>

Reads the DAP register on the specified port and address.

fn raw_write_register( &mut self, port: PortType, addr: u8, value: u32, ) -> Result<(), ArmError>

Writes a value to the DAP register on the specified port and address.

fn core_status_notification( &mut self, status: CoreStatus, ) -> Result<(), DebugProbeError>

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

fn raw_write_block( &mut self, port: PortType, register_address: u8, values: &[u32], ) -> Result<(), ArmError>

Write multiple values to the same DAP register.

fn raw_read_block( &mut self, port: PortType, register_address: u8, values: &mut [u32], ) -> Result<(), ArmError>

Read multiple values from the same DAP register.

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

Flush any outstanding writes.

fn into_probe(self: Box<Self>) -> Box<dyn DebugProbe>

Cast this interface into a generic DebugProbe.

fn configure_jtag(&mut self, skip_scan: bool) -> Result<(), DebugProbeError>

Configures the probe for JTAG use (specifying IR lengths of each DAP).

fn jtag_sequence( &mut self, cycles: u8, tms: bool, tdi: u64, ) -> Result<(), DebugProbeError>

Send a specific output sequence over JTAG.

fn swj_sequence( &mut self, bit_len: u8, bits: u64, ) -> Result<(), DebugProbeError>

Send a specific output sequence over JTAG or SWD.

fn swj_pins( &mut self, pin_out: u32, pin_select: u32, pin_wait: u32, ) -> Result<u32, DebugProbeError>

Set the state of debugger output pins directly.

impl SwoAccess for CmsisDap

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 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.

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

Read any available SWO data without waiting.