probe_control
Manage SHM waveform recording to control dump file size. Pause recording during uninteresting simulation periods to save disk space, then re-enable before regions of interest.
Instructions
Control SHM waveform recording to manage dump file size.
Disable probes during uninteresting simulation periods to save disk space. Re-enable before the region of interest. Optionally target a specific scope.
Args: mode: "enable" to start recording, "disable" to pause, "status" to check. scope: Hierarchical scope to target (e.g. "top.hw.u_ext"). Empty = all probes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| scope | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/xcelium_mcp/server.py:437-452 (handler)The probe_control tool handler which communicates with the Xcelium simulator via a TclBridge instance to manage SHM waveform recording.
@mcp.tool() async def probe_control(mode: str, scope: str = "") -> str: """Control SHM waveform recording to manage dump file size. Disable probes during uninteresting simulation periods to save disk space. Re-enable before the region of interest. Optionally target a specific scope. Args: mode: "enable" to start recording, "disable" to pause, "status" to check. scope: Hierarchical scope to target (e.g. "top.hw.u_ext"). Empty = all probes. """ bridge = _get_bridge() cmd = f"__PROBE_CONTROL__ {mode} {scope}" if scope else f"__PROBE_CONTROL__ {mode}" result = await bridge.execute(cmd) return result