run

The Tcl run command starts simulation or resumes a previously halted simulation.

run Command Syntax

run -analogsolver -clean -delta [cycle_spec] -next -phase -process -return -step -sync [-timepoint] [time_spec] [-absolute | -relative]

run Command Options

This section describes the options that you can use with the Tcl run command.

`-analogsolver`	Reboots the analog solver to the exact setup you left at during the last run.
`-clean`	Runs the simulation to the next point at which it is possible to create a checkpoint snapshot with the `save -simulation` command. See `save`.
`-delta [cycle_spec]`	Runs the simulation for the specified number of delta cycles. If no `cycle_spec` argument is specified, run the simulation to the beginning of the next delta cycle. A `run -delta` command is the same as `run -delta 1`.
`-next`	Runs one line of source code, stepping over any subprogram calls. If the current execution point is a VHDL non-zero `wait` statement, `run -next` might behave the same as `run -step`. For example, if the current execution point is a `wait` statement, which suspends the current process, another process might be scheduled to run at the current simulation time. In this situation, `run -next` runs the next behavioral statement, and the simulation stops in the scheduled process. If you want to run to the next executable line in the source code after the `wait`, set a line breakpoint on the line and enter a `run` command.
`-phase`	Runs to the beginning of the next phase of the simulation cycle. A simulation cycle consists of two phases: signal evaluation and process execution.
`-process`	Runs until the beginning of the next scheduled process or to the beginning of the next delta cycle, whichever comes first. In VHDL, a process is a process statement. In Verilog it is an always block, an initial block, or some other behavior that can be scheduled to run. For the purposes of `run -process`, the `analog` block is not considered a process.
`-return`	Runs until the current subprogram (task, function, procedure) returns.
`-step`	Runs one behavioral statement, stepping into subprogram calls. The `-step` option does not step into function calls made by an `analog` statement. In this situation, the behavior of the `-step` option is identical to the behavior of the `-next` option.
`-sync`	Runs until the analog solver next hands control to the digital solver.
`[-timepoint] [time_spec] [-absolute \| -relative]`	Runs until the specified time is reached. The time specification can be absolute or relative. Relative is the default. In addition to time units such as fs, ps, ns, us, and so on, you can use `deltas` as the unit. For example: `xcelium> run 10 deltas` This is the same as `run -delta 10`. If you include a time specification and a breakpoint or interrupt stops simulation before the specified time is reached, the time specification is thrown away. For example, in the following sequence of commands, the last `run` command does not stop the simulation at 500 ns. `xcelium> stop -object x Created stop 1 xcelium> run 500 ns Stop 1 {x = 0} at 10 ns xcelium> run` Using `run -timepoint` without a `time_spec` argument runs the simulation until the next scheduled event.

run Command Examples

The following command runs the simulation until an interrupt occurs or until simulation completes.

xcelium> run

The following command advances the simulation to 500 ns absolute time. The -timepoint option is not required.

xcelium> run -timepoint 500 ns -absolute

The following command advances the simulation 500 ns relative time. With a time specification, -relative is the default.

xcelium> run 500 ns

The following command runs one behavioral statement, stepping into any subprogram calls.

xcelium> run -step

The following command runs one behavioral statement, stepping over any subprogram calls.

xcelium> run -next

The following command runs until the current subprogram returns. The subprogram can be a task, function, or procedure.

xcelium> run -return

The following two commands are equivalent. They both run the simulation for 5 delta cycles.

xcelium> run -delta 5
xcelium> run 5 deltas

The following command runs the simulation until the digital solver next becomes active.

xcelium> run -sync
Ran until 2 NS + 0

The following command reboots the analog solver to the exact setup you left at during the last run.

xcelium> run -analogsolver

run

run Command Syntax

run Command Options

run Command Examples

Related Topic