GVHDL(1) | User Commands | GVHDL(1) |
NAME¶
gvhdl - Frontend to the VHDL compiler/simulator FreeHDL.SYNOPSIS¶
gvhdl [ OPTION] ... [VHDL_FILES] ... [OBJECT_FILES] ...DESCRIPTION¶
FreeHDL is a compiler/simulator suite for the hardware description language VHDL. VHDL'93 as well as VHDL'87 standards are supported.OPTIONS¶
- -L VHDLLIB
- Path to VHDL library root directory. Within this directory the compiler search for a file named v2cc.libs. The mapping file v2cc.libs translates library unit names to directories. Note that more than one VHDLLIB may be provided.
- -g
- Adds debug information to the executable. In detail, this options associates the generated machine code to the corresponding lines in the VHDL source files.
- -G
- Adds debug information to the executable but does not associate machine code to VHDL source lines. This option is actually used to debug the generated C++ code.
- -c
- Do not generate simulator executable. Using this option, the compiler translated VHDL source into executables and compiles them into object code but does not generate a final simulator executable. This option is especially useful to compile VHDL packages.
- -l LIBNAME
- Associate the VHDL source code to VHDL library LIBNAME. As default the library name WORK is used. This option is especially important if VHDL components from several VHDL libraries shall be build into the simulator. Note that in order to successfully use a VHDL component from another than the current working library, the corresponding VHDL files must be found by the compiler using the mechanisms described in v2cc.libs. Further, components must be compiled with the appropriate -l LIBNAME option.
- --relaxed-component-visibility
- Allows invisible default bindings from WORK.
- --libieee
- Add the IEEE standard library files to the simulation executable.
ENVIRONMENT VARIABLES¶
- V2CC_LIBRARY_PATH
- The variable V2CC_LIBRARY_PATH consists of ":" separated filenames. In addition to the environment variable, you can use the "-L libdir" command line option with v2cc. The directories specified with "-L" are added in front of the ones specified by V2CC_LIBRARY_PATH. In the final library path, they appear in the same order as on the command line.
SUPPORTED VHDL SUBSET¶
Currently, FreeHDL does not support the entire VHDL'93 standard. The following incomplete list gives an overview on what is currently not supported:EXAMPLES¶
Usegvhdl -c adder.vhdl
gvhdl adder.vhdl
gvhdl top.vhdl adder.o --libieee
gvhdl -c -l mylib adder.vhdl
SIMULATION COMMANDS¶
After the simulator has been started a short summary of the available commands is printed to the screen:c <number> : execute cycles = execute <number> simulation cycles
n : next = execute next simulation cycle
q : quit = quit simulation
r <time> : run = execute simulation for <time>
d : dump = dump signals
doff : dump off = stop dumping signals
don : dump on = continue dumping signals
s : show = show signal values
dv : dump var = dump a signal from the signal lists
ds : dump show = shows the list of dumped signals
nds : number show = shows the number of dumped signals
dc [-f <filename>] [-t <timescale> <time unit>] [-cfg <translation file>] [-q]
: configures dump process
SIMULATOR COMMAND LINE OPTIONS¶
Simulation can be controlled via the command line parameter '-cmd "cmd1; cmd2; ..."' where 'cmd1', 'cmd2', ... are simulation commands as described in the previous section. Note that each command must be separated by ';'. E.g., executing./top -cmd "d;run 1000 ns;q;"
SEE ALSO¶
freehdl-v2cc(1), freehdl-config(1), v2cc.libs(5)AVAILABILITY¶
The latest version of FreeHDL can always be obtained from www.freehdl.seul.orgREPORTING BUGS¶
Known bugs are documented within the BUGS file. If your report addresses a parser related topic then contact Marius Vollmer <mvo@zagadka.ping.de>. If it is related to the code generator or compiler then send an email to Edwin Naroska <edwin@ds.e-technik.uni-dortmund.de>. If your are not sure send it to Edwin. He will take care of forwarding your report to the appropriate recipient.COPYRIGHT¶
Edwin Naroska © 1999, 2000, 2001, 2002, 2003, 2004, 2005 <edwin@ds.e-technik.uni-dortmund.de> This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.AUTHORS¶
Written by Marius Vollmer <mvo@zagadka.ping.de> and Edwin Naroska <edwin@ds.e-technik.uni-dortmund.de>.December 2005 | Debian/GNU Linux |