Subversion Repositories w11

.\"  -*- nroff -*-

.\"  $Id: xilinx_ghdl_simprim.1 522 2013-05-24 17:50:29Z mueller $

.\"

.\" Copyright 2010- by Walter F.J. Mueller 

.\"

.\" ------------------------------------------------------------------

.

.TH XILINX_GHDL_SIMPRIM 1 2010-07-25 "Retro Project" "Retro Project Manual"

.\" ------------------------------------------------------------------

.SH NAME

xilinx_ghdl_simprim \- compile Xilinx ISE SIMPRIM libraries for ghdl

.\" ------------------------------------------------------------------

.SH SYNOPSIS

.

.B xilinx_ghdl_simprim

.

.\" ------------------------------------------------------------------

.SH DESCRIPTION

\fBxilinx_ghdl_simprim\fP compiles the Xilinx ISE/WebPack SIMPRIM libraries

for \fBghdl\fP.

The object files generated by \fBghdl\fP are stored in the directory

tree of the currently active version of ISE/WebPack under

\fI$XILINX/ghdl/simprim\fP.

This is convenient when several ISE/WebPack versions are installed in

parallel, the \fB$XILINX\fP

environment variable is enough to setup the context for the synthesis

flows as well as for build of \fBghdl\fP models. Just use the \fBghdl\fP

option

.EX

    -P${XILINX}/ghdl/simprim

.EE

to link to the SIMPRIM library.

Up to ISE 10 the VITAL models were all concatinated in one large file

\fIsimprim_VITAL.vhd\fP.

In this case the \fBxilinx_vhdl_chop\fP

helper script will create individual source files for each model.

For ISE 11 and later the modules are shipped as separate files.

The XILINX source code has since many releases some buggy statements with

self-referencial initializations. They seem to be tolerated by the commercial

tools but not by \fBghdl\fP.

The \fBxilinx_vhdl_memcolltype_fix\fP

helper script simply removes them, no further problems seen so far.

.\" ------------------------------------------------------------------

.SH ENVIRONMENT VARIABLES

.TP

.B XILINX

points to the root of the currently active ISE/WebPack installation.

.

.\" ------------------------------------------------------------------

.SH FILES

.IP \fI$XILINX/vhdl/src/simprims\fP

The vhdl sources for the SIMPRIM library are looked for in this directory tree.

.IP \fI$XILINX/ghdl/simprim\fP

The created object files will be written into this directory. The directory

is created if not yet existing. Note that the \fI$XILINX\fP

directory must be writable for the script.

.

.\" ------------------------------------------------------------------

.SH "SEE ALSO"

.BR ghdl (1),

.BR xilinx_ghdl_unisim (1)

.

.\" ------------------------------------------------------------------

.SH AUTHOR

Walter F.J. Mueller