Lists connected ST-LINK probes via STM32_Programmer_CLI. Returns an empty list (not an error) if none are attached.

Starts a debug session: spawns ST-LINK_gdbserver and arm-none-eabi-gdb (MI2), loads ELF symbols, and connects via target extended-remote.

Cleanly tears down a debug session's gdb and ST-LINK_gdbserver child processes.

Reports the status of one debug session (by id), or lists all active sessions if id is omitted.

One-shot flash via STM32_Programmer_CLI — no debug session required. Fails with DEVICE_BUSY if a debug session is already open on the same probe (it holds exclusive USB access); disconnect first, or use flash_load_in_session instead.

Reflashes the currently loaded ELF via gdb's load (MI: -target-download) inside an already-open debug session. No USB conflict — ST-LINK_gdbserver retains ownership of the probe throughout.

Resumes (continues) the target and waits for it to stop again (e.g. a breakpoint), up to a timeout.

Interrupts the running target.

Resets the target via ST-LINK_gdbserver's monitor reset command, optionally resuming afterward.

Steps the target: 'over' (next line, step over calls), 'into' (step into calls), or 'out' (finish the current function).

Sets a breakpoint by file:line (e.g. main.c:42), symbol name (e.g. main), or address (e.g. *0x08000200).

Deletes a previously set breakpoint by its number.

Lists breakpoints currently tracked on a session (those set via breakpoint_set).

Reads raw bytes from target memory at an address or symbol-address expression (e.g. '&my_global').

Writes raw bytes to target RAM/registers at an address. Blocked for addresses inside the flash window (use flash_standalone / flash_load_in_session for flash) unless STMCP_ALLOW_FLASH_ADDRESS_WRITE is set.

Reads named core registers (default: all general-purpose + sp/lr/pc/xpsr) via gdb MI.

Writes a value to a named core register via gdb's -gdb-set $<register>=<value>.

One-call dump of Cortex-M SCB fault registers (CFSR/HFSR/MMFAR/BFAR/SHCSR/CPUID/ICSR) plus PC/SP/LR, with CFSR/HFSR bits decoded to flag names. Raw evidence only — no root-cause interpretation.

Symbol-aware expression evaluation in the current frame via gdb's -data-evaluate-expression — reads globals/locals by name, struct/array member access, pointer dereference, arithmetic, etc.