mirror of
https://github.com/wfjm/w11.git
synced 2026-02-15 12:36:34 +00:00
86 lines
2.8 KiB
Groff
86 lines
2.8 KiB
Groff
.\" -*- nroff -*-
|
|
.\" $Id: xtwi.1 1235 2022-05-07 12:47:28Z mueller $
|
|
.\" SPDX-License-Identifier: GPL-3.0-or-later
|
|
.\" Copyright 2014-2022 by Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
|
|
.\"
|
|
.\" ------------------------------------------------------------------
|
|
.
|
|
.TH XTWI 1 2016-03-19 "Retro Project" "Retro Project Manual"
|
|
.\" ------------------------------------------------------------------
|
|
.SH NAME
|
|
xtwi \- Xilinx Tool Wrapper script for ISE
|
|
.\" ------------------------------------------------------------------
|
|
.SH SYNOPSIS
|
|
.
|
|
.SY xtwi
|
|
.RI [ COMMAND ]
|
|
.YS
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH DESCRIPTION
|
|
The Xilinx ISE setup script redefines \fBPATH\fP and \fBLD_LIBRARY_PATH\fP.
|
|
The ISE tools run fine in this environment, but other installed programs on
|
|
the system can (and actually do) fail. \fBxtwi\fP helps to keep the ISE
|
|
environment separate from the normal working environment.
|
|
|
|
The environment variable \fBXTWI_PATH\fP must be set up to the install path
|
|
of the ISE version to be used. Without the /ISE_DS/ which is added
|
|
by the ISE installation procedure.
|
|
|
|
\fBxtwi\fP uses \fBXTWI_PATH\fP to locate the ISE setup script, sources it,
|
|
and execs the \fICOMMAND\fP. This way \fICOMMAND\fP is executed in the
|
|
ISE environment, while the login shell stays clean.
|
|
|
|
\fBxtwi\fP can also set up a clean environment when \fBBARE_PATH\fP and
|
|
\fBBARE_LD_LIBRARY_PATH\fP are defined.
|
|
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH ENVIRONMENT
|
|
.TP 4
|
|
.B XTWI_PATH
|
|
Install path of ISE, without the /ISE_DS/ appended by ISE installation
|
|
.
|
|
.TP
|
|
.B BARE_PATH
|
|
Optional. If defined \fBxtwi\fP will set
|
|
.EX
|
|
export PATH=$BARE_PATH:$RETROBASE/tools/bin
|
|
.EE
|
|
LD_LIBRARY_PATH will be unset unless BARE_LD_LIBRARY_PATH is
|
|
defined too.
|
|
.
|
|
.TP
|
|
.B BARE_LD_LIBRARY_PATH
|
|
Optional. If defined \fBxtwi\fP will set
|
|
.EX
|
|
export LD_LIBRARY_PATH=$BARE_LD_LIBRARY_PATH
|
|
.EE
|
|
Used only when BARE_PATH is defined.
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH FILES
|
|
.TP 4
|
|
$XTWI_PATH/ISE_DS/settings32.sh
|
|
.TQ
|
|
$XTWI_PATH/ISE_DS/settings64.sh
|
|
ISE setup script located and sourced on 32 or 64 bit systems
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH "NOTES"
|
|
If both ISE and Vivado are used \fBxtwi\fP and \fBxtwv\fP(1) offer a convenient
|
|
way to have both tools available in one session without interference.
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH EXAMPLES
|
|
.IP "\fBxtwi netgen -sim -intstyle xflow -ofmt vhdl -w test.ngc" 4
|
|
Starts the ISE netlister and generates a VHDL model from \fItest.ngc\fP.
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH "SEE ALSO"
|
|
.BR xtwv (1)
|
|
.
|
|
.\" ------------------------------------------------------------------
|
|
.SH AUTHOR
|
|
Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
|