compile-xilinx-vivado.sh
------------------------

.. program:: compile-xilinx-vivado.sh

This script pre-compiles the Xilinx primitives. Because Xilinx offers two tool
chains (ISE, Vivado), this script will generate all outputs into a
:file:`xilinx-vivado` directory and a symlink to :file:`xilinx` will be created.
This eases the coexistence of pre-compiled primitives from ISE and Vivado.

.. The symlink can be changed by the user or via :option:`--relink`.


.. rubric:: Supported Simulators

+----------+--------------------------------------------+
| Target   | Description                                |
+==========+============================================+
| All      | pre-compile for all simulators             |
+----------+--------------------------------------------+
| GHDL     | pre-compile for the GHDL simulator         |
+----------+--------------------------------------------+
| Questa   | pre-compile for Metor Graphics QuestaSim   |
+----------+--------------------------------------------+


.. rubric:: Command Line Options

.. option:: --help

   Show the embedded help page(s).

.. option:: --clean

   Clean up directory before analyzing.

.. option:: --all

   Pre-compile all libraries and packages for all simulators.

.. option:: --ghdl

   Pre-compile the Altera Quartus libraries for GHDL.

.. option:: --questa

   Pre-compile the Altera Quartus libraries for QuestaSim.


.. rubric:: Additional Options for GHDL

.. option:: --vhdl93

   For GHDL only: Set VHDL Standard to '93.

.. option:: --vhdl2008

   For GHDL only: Set VHDL Standard to '08.


.. rubric:: GHDL Notes

Not all primitives and macros are available as plain VHDL source code. Encrypted
SecureIP primitives and netlists cannot be pre-compiled by GHDL.


.. rubric:: QuestaSim Notes

The pre-compilation for QuestaSim uses a build in program from Xilinx.