1 |
22 |
wfjm |
.\" -*- nroff -*-
|
2 |
|
|
.\" $Id: xilinx_ghdl_unisim.1 522 2013-05-24 17:50:29Z mueller $
|
3 |
|
|
.\"
|
4 |
|
|
.\" Copyright 2010- by Walter F.J. Mueller
|
5 |
|
|
.\"
|
6 |
|
|
.\" ------------------------------------------------------------------
|
7 |
|
|
.
|
8 |
|
|
.TH XILINX_GHDL_UNISIM 1 2010-07-25 "Retro Project" "Retro Project Manual"
|
9 |
|
|
.\" ------------------------------------------------------------------
|
10 |
|
|
.SH NAME
|
11 |
|
|
xilinx_ghdl_unisim \- compile Xilinx ISE UNISIM libraries for ghdl
|
12 |
|
|
.\" ------------------------------------------------------------------
|
13 |
|
|
.SH SYNOPSIS
|
14 |
|
|
.
|
15 |
|
|
.B xilinx_ghdl_unisim
|
16 |
|
|
.
|
17 |
|
|
.\" ------------------------------------------------------------------
|
18 |
|
|
.SH DESCRIPTION
|
19 |
|
|
\fBxilinx_ghdl_unisim\fP compiles the Xilinx ISE/WebPack UNISIM libraries for
|
20 |
|
|
\fBghdl\fP. The object files generated by \fBghdl\fP
|
21 |
|
|
are stored in the directory tree of the currently active version of
|
22 |
|
|
ISE/WebPack under \fI$XILINX/ghdl/unisim\fP.
|
23 |
|
|
This is convenient when several ISE/WebPack versions are installed in
|
24 |
|
|
parallel, the \fB$XILINX\fP
|
25 |
|
|
environment variable is enough to setup the context for the synthesis
|
26 |
|
|
flows as well as for build of \fBghdl\fP models. Just use the
|
27 |
|
|
\fBghdl\fP option
|
28 |
|
|
|
29 |
|
|
.EX
|
30 |
|
|
-P${XILINX}/ghdl/unisim
|
31 |
|
|
.EE
|
32 |
|
|
|
33 |
|
|
to link to the UNISIM library.
|
34 |
|
|
|
35 |
|
|
Up to ISE 10 the VITAL models were all concatinated in one large file
|
36 |
|
|
\fIunisim_VITAL.vhd\fP. In this case the \fBxilinx_vhdl_chop\fP
|
37 |
|
|
helper script will create individual source files for each model.
|
38 |
|
|
For ISE 11 and later the modules are shipped as separate files.
|
39 |
|
|
|
40 |
|
|
The XILINX source code has since many releases some buggy statements with
|
41 |
|
|
self-referencial initializations. They seem to be tolerated by the commercial
|
42 |
|
|
tools but not by \fBghdl\fP.
|
43 |
|
|
The \fBxilinx_vhdl_memcolltype_fix\fP
|
44 |
|
|
helper script simply removes them, no further problems seen so far.
|
45 |
|
|
|
46 |
|
|
.\" ------------------------------------------------------------------
|
47 |
|
|
.SH ENVIRONMENT VARIABLES
|
48 |
|
|
.IP \fBXILINX\fP
|
49 |
|
|
points to the root of the currently active ISE/WebPack installation.
|
50 |
|
|
.
|
51 |
|
|
.\" ------------------------------------------------------------------
|
52 |
|
|
.SH FILES
|
53 |
|
|
.IP \fI$XILINX/vhdl/src/unisims\fP
|
54 |
|
|
The vhdl sources for the UNISIM library are looked for in this directory tree.
|
55 |
|
|
.IP \fI$XILINX/ghdl/unisim\fP
|
56 |
|
|
The created object files will be written into this directory. The directory
|
57 |
|
|
is created if not yet existing. Note that the \fI$XILINX\fP
|
58 |
|
|
directory must be writable for the script.
|
59 |
|
|
.
|
60 |
|
|
.\" ------------------------------------------------------------------
|
61 |
|
|
.SH "SEE ALSO"
|
62 |
|
|
.BR ghdl (1),
|
63 |
|
|
.BR xilinx_ghdl_simprim (1)
|
64 |
|
|
.
|
65 |
|
|
.\" ------------------------------------------------------------------
|
66 |
|
|
.SH AUTHOR
|
67 |
|
|
Walter F.J. Mueller
|