Send any Tcl command to Visualizer's command interpreter.

This is the escape hatch — every Visualizer Tcl command (run, step, wave add, force, examine, env, ...) can be sent through this tool.

Report VCC server reachability, host/port, and registration status.

Does NOT auto-launch. Use vcc_connect (or any other tool) to trigger an auto-launch if Visualizer is not running.

Ensure Visualizer is running and the VCC socket is open. Idempotent.

Returns an error with instructions if Visualizer is not running.

Advance simulation. time may be "100ns", "-all", or None for default.

Single-step the simulation count times.

Report runStatus (current simulator state).

Return the current simulation time.

Add one or more signals to the wave window. Use dot-separated paths with "sim." prefix, e.g. ["sim.top.clk", "sim.top.dut.state", "sim.div_tb.*"]

Force signal to value (e.g. force sim.top.rst 1 0; force sim.top.clk 0 50ns).

Examine the value of a signal, optionally at a specific simulation time.

signal: dot-separated hierarchical path with "sim." prefix e.g. sim.testbench.u1.my_signal time: simulation time e.g. "400 ns" (omit for current time) radix: decimal (default), binary, hexadecimal, unsigned, octal

The returned value may include a size/radix annotation e.g. "4'd3" (4-bit vector, decimal value 3). If Visualizer is not configured to annotate, the plain value is returned e.g. "3". Signal must be last in the examine command; this tool enforces that.

Scan a signal across a time range; optionally search for a specific value.

Returns all sampled values across the range as a Tcl list. If find_value is given, also reports whether the signal ever held that value (handles both plain "3" and annotated forms like "4'd3"). When find_value is given and no time range is specified, the scan starts from time 0 to cover the full simulation.

signal: dot-separated hierarchical path with "sim." prefix e.g. sim.testbench.u1.my_signal find_value: value to search for e.g. "6" (optional) from_time: range start e.g. "0 ns" (defaults to "0" when find_value given) to_time: range end e.g. "1 us" (omit to scan to simulation end) radix: decimal (default), binary, hexadecimal, unsigned, octal

Return recent async signal notifications received from Visualizer (e.g. vTimeChange, vDesignStateChange). Newest last.