debug_session_start
Start a persistent OpenOCD debug session to control CPU execution, set hardware breakpoints/watchpoints, inspect registers/stack, and return a session ID for subsequent debug operations.
Instructions
Start a real-time debug session via a persistent OpenOCD connection.
Enables CPU control (halt/resume/step/reset), hardware breakpoints, watchpoints, register access, and stack inspection through the debug_* tools. One session per probe.
Args: probe: Board nickname, probe nickname, or ST-Link SN. elf_path: Path to the firmware .elf — enables symbol names for breakpoints and source locations in halt reports. Recommended.
Returns: Session ID (pass to all other debug_* tools) and core state.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "debug_session_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| probe | No | ||
| elf_path | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |