Product Documentation
Command-Line IP Selector (CLIPS) User Guide
Product Version IC23.1, June 2023

CLIPS Command-line Arguments

Depending on your requirements, you can use one or more of the following optional command-line arguments:

Argument Description

-batch

Runs (netlists) a loaded CLIPS file and exits with status (0==pass, 1==fail).

cdsPre value

Sets the full path to a UNIX script file to set up Virtuoso-specific environment variables. This C Shell script is sourced before Virtuoso sessions are started. Enter setenv CLIPS_VIRTUOSO_BOURNE_SHELL to use the Bourne shell format.

This is the command-line equivalent of the field Virtuoso Setup Script.

checkbind value

Automatically runs elaboration/binding check after netlisting, when CLIPS is run in batch mode. Default values are yes or no.

clips -help

Displays the help information for CLIPS.

continue

Continues after load/setup error, if not in batch. Default behavior is to exit, which does not allow any changes.

depth depth

Sets the depth of hierarchy to show. 0 means all levels.

details value

Shows parsing and hierarchy processing in the log area / file. Default values are yes or no.

dirs dirs

Loads Virtuoso directories: <dir>[:<nickname>][,<dir>[:<nickname>]]...

-export

Exports an IP block from a remote Virtuoso config or schematic view, without top-level SoC design access to a package directory. To use this argument for batch mode, specify the following commands (for IP providers).

clips -batch
-export "config=<lib/cell/view>
ade=<stateLib/stateCell/stateView[/testName]>
outdir=<ip_export_dir>
[cdsdir=<dir where cds.lib exists>]"

export value

Exports an IP remotely to assemble with a test bench in AMS UNL. It supports both, ADE and Maestro states. For multiple instances, add an option and value for each instance.

hideCell value

Shows the list of cell names for which instances will be hidden in the hierarchy. Its default value is the value of the environment variable $CLIPS_HIDE_CELLS.

load file

Loads the setup from previously saved CLIPS file.

–local

Automatically connects to Virtuoso using a local cds.lib when started without loading.

log file

Sets the status log file. The default value is CLIPS.log. Set as no to disable log write.

modelfile value

Used for netlisting configs. Its syntax: <model1[:model2(sectionName)]>. Its default value is the value in the environment variable $CLIPS_MODELFILE.

-netlist

Runs (netlists) a loaded CLIPS file on startup before interactive use.

output value

Netlists and exports the hierarchy to a new CLIPSOUTPUT (or -subDir <name>) under this directory (this directory must exist). It defaults to './'

postrun

Enables running of any batch, post netlisting run commands.

postRunFail value

Specifies a UNIX command to run after running netlisting, when in batch mode. It is used if netlisting has failed. Example: sendFailMail projectLeaders <logfile>

postRunPass value

Specifies a UNIX command to run after running netlisting when in batch mode, if -postrun is set. It is used only if netlisting has passed. Example: xrun -f xrunArgs -f ./CLIPS_OUTPUT/clips.f

postRun value

Specifies a UNIX command to always run (pass or fail) after running netlisting, when in batch mode, if -postrun is set. Example: mv ./CLIPS_OUTPUT ~/simFiles

preRun value

Specifies a UNIX command to run before running netlisting, when in batch mode, if -postrun is set. If it returns a non-zero value, then netlisting does not run.

savebatch file

When in batch mode, saves the setup to <file> before running netlisting. It includes all command-line changes.

subDir value

Creates subdirectory under -output <directory> during netlisting. We can include <date> or $envvarnam, which will be processed when the directory is created.

-switch

Imports multiple packages into an SoC top-level design to assemble them together.To use this argument for batch mode, specify the following commands (for IP users).

clips -batch
-xrun <top soc xrunArgs file>\
-output <output directory after import>\
-switch "inst=<inst hierarchy in top design> import=<ip1_export_dir>"\
-switch "inst=<inst hierarchy in top design> import=<ip2_export_dir>"

switch value

Switches the settings of specified instances to an HED configuration. For multiple instances, add an option and value for each instance.

xrun file,...

Populates the hierarchy from one or more existing xrun -f files. Runs and analyzes the created .pak file.


Return to top
 ⠀
X