cdsTextTo5x Arguments

The following table describes the arguments that you can specify when using the cdsTextTo5x command:

Argument	Description
`-LIB <library_name>`
	Name of the library where the cellview is generated. This is a mandatory argument. You must also specify the name of the file you want to import after the library name.
`-CELL <cell_name>`
	Name of the cell for which the 5x structure is to be generated. This is an optional argument. The command uses the default name if the cell name is not specified.
`-VIEW <view_name>`
	Name of the view. This is an optional argument. The command uses the default names if the cell and view names are not specified.
`-SYMBOL` `symbol_view_name`
	Name of the symbol view to be generated. This is an optional argument. The command does not create a symbol view if the symbol name is not specified.
`-CDSLIB` `cds.lib_to_use`
	Name of the `cds.lib` file with the path to the specified library. This is an optional argument. If you do not specify this value, the default `cds.lib` file is used. If the file does not exist, it is created.
`-LANG` `language_name`
	Language of the text file being imported. The valid values are `spice`, `pspice`, `dspf`, `spectre`, `verilog`, `verilogams`, `systemverilog`, `vhdl`, and `vhdlams`. This is an optional argument. If you do not specify the language, the command determines the language from the filename extension of the file being imported. If the language is specified, the command honors the language irrespective of the specified file extension. If the FILE_TO_IMPORT in the `cdsTextTo5x` command does not contain a file extension, specifying the `-LANG` argument becomes mandatory.
`-LOG` `log_file_name`
	Name of the log file. The file also contains the instance binding report. This is an optional argument.
`-COMPILEROPTIONS` `compiler_options_file_name`
	File containing option settings to be passed directly to the compiler (`irun` or `xrun`) when cdsTextTo5x is executed. This is an optional argument.
`-SHADOW`	Generates the shadows for Verilog or SystemVerilog views. This argument does not require any parameters. If shadow generation fails when using cdsTextTo5x, you can view the errors and warning messages in the `cdsTextTo5x.log` file. This is an optional argument. For analog languages, such as `spice`, `pspice`, `dspf`, and `spectre`, the OA database is generated by default. You do not need to specify the `-SHADOW` argument explicitly.
`-BLACKBOX`	Imports only the interface information for a cell and does not include the instance information. This argument can be used only when `-CELL` is specified. Example: `cdsTextTo5x -LIB` work `-CELL` bot `-BLACKBOX` verilog.v This is an optional argument. This functionality is supported for Verilog only.
-HDLPKGMODE	Enables the HDL Package mode. This argument can be used only when `-COMPILEROPTIONS` <compiler_options_file_name> is specified. Here, <compiler_options_file_name> contains the compiler (XRUN) arguments that have been exported from the HDL Package Setup form. Example: `cdsTextTo5x -LIB` testlib `-HDLPKGMODE -COMPILEROPTIONS` options.f test.sv This is an optional argument.
`-SPECIFICUNIT`	Imports only the specified cell if multiple module definitions exist in the same text file. All other cells are ignored. The performance is improved when multiple cells exist in a file. In such cases, parsing saves a lot of time. This is an optional argument. This argument can be used only when `-CELL` is specified.
`-PARAM /[-P]` `param_file_name`
	Specifies the name of the parameter file. This is an optional argument.
`-TEMPLATEPARAMFILE` `template_param_file_name`
	Creates a template parameter file with the specified name. This is an optional argument.
`-HELP`	Displays the help for the command. This is an optional argument.

Examples

Example 1

cdsTextTo5x -LIB myLib test.v

Imports the test.v file into the Virtuoso Studio Design Environment and generates its library, cell, and view structure.

Example 2

cdsTextTo5x -LIB myLib -SYMBOL symbol test.v

Imports the test.v file into the Virtuoso Studio Design Environment and generates the symbol corresponding to the cell defined in the file.

Example 3

cdsTextTo5x -LIB myLib -SHADOW test.v

Imports the test.v file into the Virtuoso Studio Design Environment and generates the OpenAccess database (netlist.oa) corresponding to the cell defined in the file.

Example 4

cdsTextTo5x -LIB myLib -SHADOW -CELL top -BLACKBOX test.v

Imports only the top cell and ignores the instance information. It fetches the interface information in the OpenAccess database only.

Example 5

cdsTextTo5x -LIB myLib -CELL top -SPECIFICUNIT test.v

Imports only the top cell if multiple cells are defined in test.v.

Example 6

cdsTextTo5x -lib myLib file1.sv file2.sv

Imports the 5x structure with default cell names for multiple SystemVerilog files.

Example 7

cdsTextTo5x -lib myLib file1.sv file2.v

Imports the files created in different languages based on the file extension.

Example 8

cdsTextTo5x -lib myLib -LANG verilog file1.sv file2.v

Imports the files in Verilog format irrespective of file extension.

Virtuoso Import Tools User Guide
Product Version IC23.1, September 2023