config_compile_simlib - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2024-05-30
Version
2024.1 English

Configure settings for compile_simlib

Syntax

config_compile_simlib [‑cfgopt <arg>] [‑cfgval <arg>] [‑simulator <arg>]
    [‑reset] [‑quiet] [‑verbose]

Usage

Name Description
[-cfgopt] Name of the configuration to set
[-cfgval] Get the value of specified configuration
[-simulator] Print the list of configurations for the specified simulator
[-reset] Initialize configurations to default value
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution

Categories

Description

Configure third-party simulator options for use by the compile_simlib command.

The AMD Vivado™ Design Suite has a pre-defined configuration file for the compile_simlib command, with compilation options defined for supported third-party simulators, languages, and libraries. The config_compile_simlib command is provided to let you change the configuration options for specific combinations of simulator, language, and library.

Use the config_compile_simlib command without any arguments to return all current configuration options.

Arguments

-cfgopt <arg> - (Optional) Specify the configuration options for a specific third party simulator, language, and library combination. The -cfgopt argument is specified as a string made up of four parts in the following form.

{<simulator>.<language>.<library>.<options> }

where,

  • <simulator> - Specify the third-party simulator to configure options for. Refer to the compile_simlib command for currently supported versions of third-party simulators. Valid values are modelsim, questa, xcelium, vcs, riviera, activehdl
  • <language> - Specify the language to set the simulation options for. Valid values are verilog, vhdl, g++, gcc, <compiler>
  • <library> - Specify the library to compile. Valid values are axi_bfm, ieee, simprim, xpm, xilinx_vip, std, synopsys, unisim, secureip, vl, global, <ip>
  • <options> - Configuration options specific to the simulator, language, and library specified. The following are the default compilation options available for different <simulator>.<language>.<library> combinations.
    • modelsim: -quiet, +define+XIL_TIMING, -93 (vhdl), -source (simprim, unisim)
    • questa: -quiet, +define+XIL_TIMING, -93 (vhdl), -source (simprim, unisim)
    • - xcelium: -MESSAGES, -NOLOG, -DEFINE XIL_TIMING, -v93 (vhdl), -RELAX (vhdl)
    • - vcs: -sverilog (verilog), -nc, +v2k (simprim, unisim), +define+XIL_TIMING
    • - riviera: -v2k5 (verilog), +define+XIL_TIMING, -93 (vhdl), -nowarn ELAB1_0026 (vhdl)
    • - activehdl: -v2k5 (verilog), +define+XIL_TIMING, -93 (vhdl), -nowarn ELAB1_0026 (vhdl)
    Note: Refer to the third-party simulator documentation for other compilation options that may be supported.
-cfgval <arg> - (Optional) Get the configuration value of the specified option. The -cfgval argument is specified as a string made up of three parts in the following form.
{<simulator>.<language>.<library>}
Note: Refer -cfgopt switch for the argument values.

-simulator <arg> - (Optional) This option acts as a filter to return only the configuration options associated with the specified simulator. Refer to the -cfgopt option for a list of valid simulator values.

-reset - (Optional) Restore all configuration settings to the factory default value.

-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

Examples

The following example prints the available configurations for the Questa simulator:

config_compile_simlib -simulator questa

The following example configures the compilation options for the verilog unisim library when compiling for ModelSim simulator:

config_compile_simlib -cfgopt {modelsim.verilog.unisim: -O4}

The following example configures the compilation options for the verilog synopsys and verilog simprim library when compiling for Questa simulator:

config_compile_simlib -cfgopt {questa.verilog.synopsys: -quiet} \
-cfgopt {questa.verilog.simprim:-source +define+XIL_TIMING}

The following example configures the compilation options for all vhdl based libraries when compiling for Xcelium simulator:

config_compile_simlib -cfgopt {xcelium.vhdl.global: -MESSAGES}

The following example configures the compilation options for the hdcp_v1_0_3 IP library when compiling for VCS simulator:

config_compile_simlib -cfgopt {vcs.vhdl.hdcp_v1_0_3: -MESSAGES}

The following example returns the current value of the configured option for the Riviera verilog xpm library:

config_compile_simlib -cfgval {riviera.verilog.xpm}

See Also