Line 1... |
Line 1... |
# $Id: INSTALL.txt 576 2014-08-02 12:24:28Z mueller $
|
# $Id: INSTALL.txt 604 2014-11-16 22:33:09Z mueller $
|
|
|
Guide to install and build w11a systems, test benches and support software
|
Guide to install and build w11a systems, test benches and support software
|
|
|
Table of content:
|
Table of content:
|
|
|
Line 110... |
Line 110... |
server) requires
|
server) requires
|
|
|
- the definition of the environment variables:
|
- the definition of the environment variables:
|
- RETROBASE: must refer to the installation root directory
|
- RETROBASE: must refer to the installation root directory
|
- TCLINC: pathname for includes of Tcl runtime library
|
- TCLINC: pathname for includes of Tcl runtime library
|
|
- TCLLIBNAME: name of Tcl runtime library
|
- RETRO_FX2_VID and RETRO_FX2_PID: default USB VID/PID, see below
|
- RETRO_FX2_VID and RETRO_FX2_PID: default USB VID/PID, see below
|
- that the tools binary directory is in the path
|
- that the tools binary directory is in the path
|
- that the tools library directory is in the library path
|
- that the tools library directory is in the library path
|
- optional environment variables:
|
- optional environment variables:
|
|
- TCLLIB: pathname for libraries of Tcl
|
- BOOSTINC: pathname for includes of boost library
|
- BOOSTINC: pathname for includes of boost library
|
- BOOSTLIB: pathname for libraries of boost library
|
- BOOSTLIB: pathname for libraries of boost library
|
{Note: Either both must be undefined, or both must be defined}
|
{Note: Either both must be undefined, or both must be defined}
|
|
|
For bash and alike use
|
For bash and alike use
|
Line 132... |
Line 134... |
|
|
In most cases the boost library version coming with the distribution will
|
In most cases the boost library version coming with the distribution will
|
work, similar for Tcl, in those cases simply use
|
work, similar for Tcl, in those cases simply use
|
|
|
export TCLINC=/usr/include/tcl8.5
|
export TCLINC=/usr/include/tcl8.5
|
|
export TCLLIBNAME=tcl8.5
|
|
|
and don't setup BOOSTINC and BOOSTLIB.
|
and don't setup BOOSTINC and BOOSTLIB.
|
|
|
After that building functional model based test benches will work. If you
|
After that building functional model based test benches will work. If you
|
want to also build post-xst or post-par test benches read next section.
|
want to also build post-xst or post-par test benches read next section.
|
Line 258... |
Line 261... |
cd $RETROBASE/tools/fx2/src
|
cd $RETROBASE/tools/fx2/src
|
make clean
|
make clean
|
make
|
make
|
make install
|
make install
|
|
|
|
Note: The default build assumes that sdcc with a version 3.x is installed.
|
|
In case sdcc 2.x is installed use
|
|
make SDCC29=1
|
|
instead. See also tools/fx2/src/README.txt in the
|
|
|
Please read README_USB_VID-PID.txt carefully to understand the usage
|
Please read README_USB_VID-PID.txt carefully to understand the usage
|
of USB VID and PID.
|
of USB VID and PID.
|
|
|
6. The build system -------------------------------------------------------
|
6. The build system -------------------------------------------------------
|
|
|
Line 485... |
Line 493... |
xtwi config_wrapper --board=s3board iconfig .bit
|
xtwi config_wrapper --board=s3board iconfig .bit
|
|
|
b. for Digilent Nexys2 board (using Cypress FX2 USB controller)
|
b. for Digilent Nexys2 board (using Cypress FX2 USB controller)
|
|
|
xtwi config_wrapper --board=nexys2 bit2svf .bit
|
xtwi config_wrapper --board=nexys2 bit2svf .bit
|
fx2load_wrapper --board=nexys2 --file=nexys2_jtag_2fifo_ic.ihx
|
fx2load_wrapper --board=nexys2
|
xtwi config_wrapper --board=nexys2 jconfig .svf
|
xtwi config_wrapper --board=nexys2 jconfig .svf
|
|
|
c. for Digilent Nexys3 board (using Cypress FX2 USB controller)
|
c. for Digilent Nexys3 board (using Cypress FX2 USB controller)
|
|
|
xtwi config_wrapper --board=nexys3 bit2svf .bit
|
xtwi config_wrapper --board=nexys3 bit2svf .bit
|
fx2load_wrapper --board=nexys3 --file=nexys3_jtag_2fifo_ic.ihx
|
fx2load_wrapper --board=nexys3
|
xtwi config_wrapper --board=nexys3 jconfig .svf
|
xtwi config_wrapper --board=nexys3 jconfig .svf
|
|
|
9. Generate Doxygen based source code view --------------------------------
|
9. Generate Doxygen based source code view --------------------------------
|
|
|
Currently there is not much real documentation included in the source
|
Currently there is not much real documentation included in the source
|