Struct FieldSafeProbe 

pub struct FieldSafeProbe {
    link: LinkAdapt,
    attached: bool,
}

The probe: a tagcore LinkAdapt opened on one base.

Created by FieldSafeProbe::open. probe-rs then calls [DebugProbe::attach] to enter SWD, after asserting reset for an attach under reset. Dropping it (or [DebugProbe::detach]) leaves SWD mode and closes the USB device.

Fields

link: LinkAdapt

The open base; every USB exchange goes through it.

attached: bool

Whether SWD has been entered since the last detach (for Debug only).

Implementations

impl FieldSafeProbe

pub fn open(usbdev: &UsbDev) -> Result<Probe, DebugProbeError>

Opens the base usbdev selects, without touching nRST or SWD, and wraps it as a probe-rs [Probe].

The tag is not reset until probe-rs attaches. Leaves DFU mode if the base is in it.

Errors

A LinkError for “open” if no base matches usbdev or it cannot be claimed (for example because another process holds it).

Trait Implementations

impl Debug for FieldSafeProbe

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

Shows only attached; LinkAdapt has no Debug form.

impl DebugProbe for FieldSafeProbe

fn get_name(&self) -> &str

Returns the name probe-rs prints for this probe.

fn speed_khz(&self) -> u32

Reports a nominal 1000 kHz; the base sets its own SWD clock.

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

Accepts any speed and reports it back; nothing is sent to the base.

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

Enters SWD mode. Does not touch nRST: for an attach under reset, probe-rs has already asserted it through target_reset_assert.

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

Leaves SWD mode and closes the base; always succeeds.

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

Pulses nRST: asserts it, waits 10 ms and releases it. The tag reboots.

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

Drives nRST low, holding the tag in reset and ending whatever it was doing.

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

Releases nRST, letting the tag boot (or stop at the reset vector if vector catch is armed).

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

Accepts SWD only; the bases have no JTAG.

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

Always SWD.

fn has_arm_interface(&self) -> bool

Always true: the tags are Arm Cortex-M parts.

fn try_get_arm_debug_interface<'probe>( self: Box<Self>, _sequence: Arc<dyn ArmDebugSequence>, ) -> Result<Box<dyn ArmDebugInterface + 'probe>, (Box<dyn DebugProbe>, ArmError)>

Wraps the probe in a FieldSafeArm; never fails.

The debug sequence is ignored here: the sequence’s own steps run through the returned interface, and the DAP power-up handshake it performs is answered from the DapTable.

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

Returns the probe itself as a boxed [DebugProbe].

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

Returns the target supply voltage the base measures, in volts; None if the voltage command fails.

fn try_as_jtag_probe(&mut self) -> Option<&mut (dyn JtagAccess + 'static)>

Returns a [JtagAccess] from the debug probe, if implemented.

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

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>, XtensaError>

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_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_as_dap_probe(&mut self) -> Option<&mut (dyn DapProbe + 'static)>

Try creating a DAP interface for the given probe.