Struct ConnectOptions 

pub struct ConnectOptions {
    pub speed: Option<String>,
    pub force: bool,
    pub halt: bool,
    pub gdb: bool,
    pub jlink_script: Option<Vec<u8>>,
    pub openocd_config: Option<Vec<u8>>,
}

Options for DebugNet::connect_with.

Fields

speed: Option<String>

SWD/JTAG speed (e.g. "4000" kHz or "adaptive"). None uses the service default (adaptive).

force: bool

Force a fresh backend start even if one is already running.

halt: bool

Halt the target on connect. This is reset-then-halt (the box runs OpenOCD’s reset halt / J-Link’s halting connect), which pulses nRESET and re-enters through the reset vector — on a part executing in place out of QSPI that re-runs the bootloader. There is no halt-in-place over the debug service’s HTTP API today; on J-Link a halt-first script via ConnectOptions::jlink_script is the supported route. Honored on the OpenOCD backend by box >= 0.43.0 (older boxes pinned it to false on that backend; J-Link always honored it).

gdb: bool

Start a GDB server (needed for reset/read_memory on some backends).

jlink_script: Option<Vec<u8>>

Contents of a .JLinkScript to run for this connection (J-Link backend only; ignored by OpenOCD). Rides base64-encoded in the request and takes precedence over a script saved on the net.

openocd_config: Option<Vec<u8>>

Contents of an OpenOCD .cfg for this connection (OpenOCD backend only; ignored by J-Link). Must be a complete cfg that selects the adapter driver — lager still appends its own ftdi channel <N> for a net with a probe channel, and that command dies at startup unless a cfg has selected the ftdi adapter first. Takes precedence over a config saved on the net.

Trait Implementations

impl Clone for ConnectOptions

fn clone(&self) -> ConnectOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConnectOptions

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

Formats the value using the given formatter.

impl Default for ConnectOptions

fn default() -> Self

Returns the “default value” for a type.