ModelSim SE User's Manual - Electrical and Computer Engineering

UM-120 5 - Verilog simulation
Verilog-XL `uselib compiler directive
ModelSim SE User’s Manual
The `uselib compiler directive is an alternative source library management scheme to the
-v, -y, and +libext compiler arguments. It has the advantage that a design may reference
different modules having the same name. You compile designs that contain `uselib
directive statements using the -compile_uselibs argument (described below) to vlog (CR-
358).
The syntax for the `uselib directive is:
`uselib ...
where is:
dir= | file= | libext= |
lib=
The library references are equivalent to command line arguments as follows:
dir= -y
file= -v
libext= +libext+
For example, the following directive
`uselib dir=/h/vendorA libext=.v
is equivalent to the following command line arguments:
-y /h/vendorA +libext+.v
Since the `uselib directives are embedded in the Verilog source code, there is more
flexibility in defining the source libraries for the instantiations in the design. The
appearance of a `uselib directive in the source code explicitly defines how instantiations
that follow it are resolved, completely overriding any previous `uselib directives.
-compile_uselibs argument
Use the -compile_uselibs argument to vlog (CR-358) to reference `uselib directives. The
argument finds the source files referenced in the directive, compiles them into
automatically created object libraries, and updates the modelsim.ini file with the logical
mappings to the libraries.
When using -compile_uselibs, ModelSim determines into which directory to compile the
object libraries by choosing, in order, from the following three values:
The directory name specified by the -compile_uselibs argument. For example,
-compile_uselibs=./mydir
The directory specified by the MTI_USELIB_DIR environment variable (see
"Environment variables" (UM-521))
A directory named mti_uselibs that is created in the current working directory