| Line 1... |
Line 1... |
# $Id: INSTALL.txt 512 2013-04-28 07:44:02Z mueller $
|
# $Id: INSTALL.txt 559 2014-06-06 21:26:47Z 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 27... |
Line 27... |
1. Download ---------------------------------------------------------------
|
1. Download ---------------------------------------------------------------
|
|
|
All instructions below assume that the project files reside in a
|
All instructions below assume that the project files reside in a
|
working directory with the name represented as
|
working directory with the name represented as
|
|
|
To download latest tagged version (V0.5) of w11a
|
- to download latest snapshot of trunk
|
|
|
cd
|
cd
|
svn co http://opencores.org/ocsvn/w11/w11/tags/w11a_V0.5
|
svn co http://opencores.org/ocsvn/w11/w11/trunk
|
|
|
|
- to download tagged verions (from major releases)
|
|
list available svn tags
|
|
|
To download latest snapshot of trunk
|
svn ls http://opencores.org/ocsvn/w11/w11/tags
|
|
|
|
and download one of them
|
|
|
cd
|
cd
|
svn co http://opencores.org/ocsvn/w11/w11/trunk
|
svn co http://opencores.org/ocsvn/w11/w11/tags/
|
|
|
|
- to download specific svn revision (from minor releases)
|
|
determine desired svn revsion from list given on
|
|
http://opencores.org/project,w11,overview
|
|
|
|
and download
|
|
|
|
cd
|
|
svn co -r http://opencores.org/ocsvn/w11/w11/trunk
|
|
|
|
|
2. System requirements ----------------------------------------------------
|
2. System requirements ----------------------------------------------------
|
|
|
This project contains not only VHDL code but also support software. Therefore
|
This project contains not only VHDL code but also support software. Therefore
|
quite a few software packages are expected to be installed. The following
|
quite a few software packages are expected to be installed. The following
|
| Line 106... |
Line 121... |
|
|
export RETROBASE=
|
export RETROBASE=
|
export PATH=$PATH:$RETROBASE/tools/bin
|
export PATH=$PATH:$RETROBASE/tools/bin
|
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$RETROBASE/tools/lib
|
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$RETROBASE/tools/lib
|
|
|
|
To access the man pages update also the MANPATH
|
|
|
|
export MANPATH=$MANPATH:$RETROBASE/doc/man
|
|
|
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
|
|
|
| Line 350... |
Line 369... |
.bit file, and configure the FPGA. In case the bit file is out-of-date
|
.bit file, and configure the FPGA. In case the bit file is out-of-date
|
the whole design will be re-implemented before.
|
the whole design will be re-implemented before.
|
|
|
8c. Available systems ------------------------------------------------
|
8c. Available systems ------------------------------------------------
|
|
|
Note: Currently ready to build versions exist for
|
Currently ready to build versions exist for
|
Digilent S3BOARD (-1000 FPGA version)
|
- Digilent S3BOARD (-1000 FPGA version)
|
Digilent Nexys2 board (-1200 FPGA version)
|
- Digilent Nexys2 board (-1200 FPGA version)
|
Digilent Nexys3 board
|
- Digilent Nexys3 board
|
|
|
|
Tarballs with ready to use bit file and and all logfiles from the tool
|
|
chain can be downloaded from
|
|
http://www.retro11.de/data/oc_w11/bitkits/
|
|
This area is organized in folders for different releases. The tarball
|
|
file names contain information about release, Xlinix tool, and design:
|
|
__.tgz
|
|
|
|
To build the designs locally use
|
|
|
1. rlink tester
|
1. rlink tester
|
a. for Digilent Nexys2 board
|
a. for Digilent S3BOARD
|
|
|
|
cd $RETROBASE/rtl/sys_gen/tst_rlink/s3board
|
|
make sys_tst_rlink_s3.bit
|
|
|
|
b. for Digilent Nexys2 board
|
|
|
cd $RETROBASE/rtl/sys_gen/tst_rlink/nexys2
|
cd $RETROBASE/rtl/sys_gen/tst_rlink/nexys2
|
make sys_tst_rlink_n2.bit
|
make sys_tst_rlink_n2.bit
|
|
|
b. for Digilent Nexys3 board
|
c. for Digilent Nexys3 board
|
|
|
cd $RETROBASE/rtl/sys_gen/tst_rlink/nexys3
|
cd $RETROBASE/rtl/sys_gen/tst_rlink/nexys3
|
make sys_tst_rlink_n3.bit
|
make sys_tst_rlink_n3.bit
|
|
|
2. rlink over USB tester
|
2. rlink over USB tester
|
