Compiling Xilinx Vivado Simulation Libraries for Riviera-PRO

Introduction

This document describes how you can compile simulation libraries in Xilinx™ Vivado Design Suite to be used in Riviera-PRO.

When you instantiate a component in your design, the simulator must reference a library that describes the functionality of the component to ensure proper simulation. Thus, before performing simulation of the design that contains Xilinx components in Riviera-PRO, you should attach the proper simulation libraries.

You can either use pre-compiled simulation libraries provided by Aldec (libraries can be downloaded from Aldec's website) or you can compile them yourself in the Xilinx Vivado Design Suite then attach the compiled libraries into Riviera-PRO.

Requirements and Limitations

This application note assumes that you have Xilinx Vivado Design Suite 2014.04 or later and Riviera-PRO 2015.02 or later properly installed and licensed.

Compiling simulation libraries

You can either use the compile_simlib command or the Compile Simulation Library wizard that simplifies compiling simulation libraries. The following libraries can be compiled:

  • UNISIM

  • UNIMACRO

  • UNIFAST

  • SIMPRIMS (Verilog Only)

  • SECUREIP (Verilog Only)

You can find detailed description of these libraries in the following document: http://www.xilinx.com/support/documentation/sw_manuals/xilinx2013_2/ug900-vivado-logic-simulation.pdf

Using the Compile Simulation Libraries Wizard

  1. Open Vivado 2014.4

  2. Go to Tools | Compile Simulation Libraries.

    Figure 1: Accessing the Compile Simulation Libraries

  3. The Compile Simulation Libraries will open.

  4. Select Riviera-PRO under Simulator. Select the desired language and libraries.

    Figure 2: Compile Simulation Libraries: Simulator, Language and Library selection

  5. Under the Compiled Library Location, select the directory where you want the compiled libraries to be saved. Under the Simulator Executable Path, provide the path to the directory containing the Riviera.exe file in the Riviera-PRO installation directory.

    Figure 3: Compile Simulation Libraries: Compiled Library Location and Tool Executable Path

  6. When you have specified all of your settings, select Compile.

    Figure 4: Compile Simulation Libraries: Compile

  7. Once the compilation is completed, you should see the compilation summary in the Tcl Console similar to the one in the picture below:

    Figure 5: TCL Console: Compilation Summary

Using the compile_simlib command

  1. In Vivado Design Suite, execute the following command from the Tcl Console:

    compile_simlib -dir <output_folder> -simulator riviera -simulator_exec_path <Riviera-PRO installation folder>
    

    where:

    <output_folder> is a path to the directory where you want compiled libraries to be saved;

    <Riviera-PRO installation folder> is a path to the bin folder inside the Riviera-PRO installation folder.

    NOTE: The path to the Riviera-PRO executable is contained within quotes because the compile_simlib command does not accept spaces within a path.

    For example, the command may look as follows:

    compile_simlib -dir C:/Aldec/Xilinx_Lib_RPRO -simulator riviera -simulator_exec_path "C:/Aldec/Riviera-PRO-2015.02-x64/bin"
    

    Figure 6: Executing compile_simlib command from the Vivado Tcl Console.

    The above command will compile all VHDL and Verilog libraries for all devices available in Vivado. You can find detailed information about the compile_simlib command by typing compile_simlib -help in the Vivado TCL Console.

  2. Once the compilation is completed, you should see the compilation summary in the Tcl Console similar to the one in the picture below:

    Figure 7: Library Compilation Summary.

    The output directory (specified with the -directory switch) will contain the folders with pre-compiled libraries.

Attaching Compiled Xilinx Libraries Into Riviera-PRO

After generating the compiled Xilinx libraries, they have to be attached as global libraries into Riviera-PRO. You can either use the amap command or the Attach Library wizard that simplifies attaching simulation libraries.

Using the Attach Library Wizard

  1. Open Riviera-PRO.

  2. Click the Attach Library icon in the Library Manager.

    Figure 8: Opening the Attach Library

  3. Under Library Name, enter the logical name of the library. Click Browse and select the location of the compiled Xilinx libraries, then select the *.lib file of the selected library. Click Ok.

    Figure 9: Attach Library: Library selection

  4. The library will then show up as a local library. In order to add a local library to the global library, right click the library then select Make Library Global. Verify that it is added to the global library by expanding the library.cfg.

    Figure 10: Library Manager: Adding a local library to the global library

    Figure 11: Library Manager: Verifying the global library under library.cfg.

  5. Repeat the steps 2-5 for every library that needs to be attached.

Using the AMAP Command

  1. In Riviera-PRO, execute the following command from the Tcl Console:

    amap –global <Logical Name> “<Lib File Path>“
    

    where:

    <Logical Name> specifies the logical name of the library.

    <Lib File Path> is the name of the library index file with the full path and the *.lib extension.

    NOTE: The path to the *.lib file is contained within quotes because the amap command does not accept spaces within a path.

    For example, the command may look as follows:

    amap -global unisim "C:\Aldec\Xilinx_Lib\unisim\unisim.lib"
    

    Figure 12: Executing amap command from the Riviera-PRO Console

    You can find information about the amap command by typing amap -help in the Console.

  2. Repeat the step 2 for every library that needs to be attached. Verify that the libraries are attached correctly under Library Manager.

Conclusion

In order to simulate Xilinx Vivado designs in Riviera-PRO, Xilinx simulation libraries are required. You can either use pre-compiled libraries provided by Aldec or you can compile the libraries yourself in Vivado Design Suite. After compiling the libraries in Vivado, they have to be attached as global libraries into Active-HDL in order to run the simulation.

If you have difficulty compiling or using the libraries, please contact Aldec Support through the customer portal.

Ask Us a Question
x

Ask Us a Question

x
Captcha ImageReload Captcha
Incorrect data entered.
Thank you! Your question has been submitted. Please allow 1-3 business days for someone to respond to your question.
Internal error occurred. Your question was not submitted. Please contact us using Feedback form.