User Guide: DSim Cloud CLI simulator commands

Synopsis

mdc dcmerge | dcreport | dlib | dsim | dvhcom | dvhencrypt | dvlcom | dvlencrypt  -a '[options]' [-v]

Allows you to run DSim simulator commands through the DSim Cloud CLI (mdc).

DSim simulator commands

dcmerge: Merge coverage databases. Cannot be used in job files.

dcreport: Generate a coverage report in HTML format. Cannot be used in job files.

dlib: Manage design libraries.

dsim: Analyze/elaborate/simulate a design.

dvhcom: Analyze VHDL source code.

dvhencrypt: Encrypt VHDL source code.

dvlcom: Analyze Verilog / SystemVerilog source code.

dvlencrypt: Encrypt Verilog / SystemVerilog source code.

Options

Refer to DSim Common Options.

Usage

You run DSim simulator commands through mdc by wrapping the command options in single quotes and preceding them with the argument switch -a.

So given a DSim command of the form:

<DSim command> [options]

The equivalent mdc command is:

mdc <DSim command> -a '[options]'

Use the -v switch for verbose output.

mdc will display the status of executing DSim simulator commands, complete with Exit Codes and Operation IDs as shown in the following sample output. These can be used to troubleshoot issues when communicating with Metrics Support.

Submitting: dvlcom my_tb.v -lib my_lib  
  Executing: dvlcom my_tb.v -lib my_lib  
  ...  
  ...  
  ...  
  Execution complete.  
  Exit code: <exit code>
Operation ID: <operation>

Examples

DSim command:

dcmerge -out_db result.db dir1/metrics.db dir2/metrics.db

DSim Cloud CLI command:

mdc dcmerge -a '-out_db result.db dir1/metrics.db dir2/metrics.db'

DSim command:

dcreport -out_dir dir metrics.db

DSim Cloud CLI command:

mdc dcreport -a '-out_dir dir metrics.db'

DSim command:

dlib ls -lib my_lib

DSim Cloud CLI command:

mdc dlib -a 'ls -lib my_lib'

DSim command:

dsim -genimage image -top work.my_module -timescale 1ns/1ps +acc+b

DSim Cloud CLI command:

mdc dsim -a '-genimage image -top work.my_module -timescale 1ns/1ps +acc+b'

DSim command:

dsim -image image -run-until 10us -waves file.vcd

DSim Cloud CLI command:

mdc dsim -a '-image image -run-until 10us -waves file.vcd'

DSim command:

dvhcom -vhdl93 -lib libA ../file1.vhd ../../file2.vhd

DSim Cloud CLI command:

mdc dvhcom -a '-vhdl93 -lib libA ../file1.vhd ../../file2.vhd'

DSim command:

dvhencrypt input_plain.vhd -i default_encryption -o output_encrypted.vhd

DSim Cloud CLI command:

mdc dvhencrypt -a 'input_plain.vhd -i default_encryption -o output_encrypted.vhd'

DSim command:

dvlcom -lib libB +incdir+../../src -F filelist.txt

DSim Cloud CLI command:

mdc dvlcom -a '-lib libB +incdir+../../src -F filelist.txt'

DSim command:

dvlencrypt input_plain.sv -i default_encryption -o output_encrypted.sv

DSim Cloud CLI command:

mdc dvlencrypt -a 'input_plain.sv -i default_encryption -o output_encrypted.sv'