Project

General

Profile

Installation Guide » History » Version 70

Alexander Kamkin, 09/27/2011 08:15 AM

1 1 Alexander Kamkin
h1. Installation Guide
2
3
h2. Introduction
4
5 26 Alexander Kamkin
This document describes the steps should be followed to install "ะก++TESK Testing ToolKit":http://forge.ispras.ru/projects/cpptesk-toolkit (hereinafter C++TESK). In addition to C++TESK, "Icarus Verilog":http://iverilog.icarus.com and "VeriTool":http://forge.ispras.ru/projects/veritool (hereinafter Verilog tools) are recommended to be installed (they are used for generating C/C++ API for Verilog modules).
6 11 Alexander Kamkin
7
Before installing the toolkit make sure that [[System Requirements]] are met.
8 1 Alexander Kamkin
9
h2. Installation
10
11 41 Alexander Kamkin
h3. Basic Installation (Recommended)
12 40 Alexander Kamkin
13 12 Alexander Kamkin
To install C++TESK, pass the following steps:
14 1 Alexander Kamkin
15 49 Alexander Kamkin
# Download the latest version of the C++TESK package (@cpptesk-toolkit-src-<version-number>.tar.gz@) from the "Files":http://forge.ispras.ru/projects/cpptesk-toolkit/files page.
16 54 Alexander Kamkin
# Unzip the downloaded package:
17 18 Alexander Kamkin
<pre>
18 50 Alexander Kamkin
% tar xf cpptesk-toolkit-src-<version-number>.tar.gz
19 18 Alexander Kamkin
</pre>
20 28 Alexander Kamkin
# Run the @install.sh@ script as follows.
21 29 Alexander Kamkin
22 27 Alexander Kamkin
* To install C++TESK without installing the Verilog tools, run:
23 22 Alexander Kamkin
<pre>
24 68 Alexander Kamkin
% ./install.sh
25 1 Alexander Kamkin
</pre>
26 62 Alexander Kamkin
* To install C++TESK together with the Verilog tools (โˆ™) not reinstalling the Verilog tools if they have been already installed, run:
27 23 Alexander Kamkin
<pre>
28 68 Alexander Kamkin
% ./install.sh --install-veritool
29 31 Alexander Kamkin
</pre>
30 62 Alexander Kamkin
* To install C++TESK and (re)install the Verilog tools (โˆ™), run:
31 25 Alexander Kamkin
<pre>
32 68 Alexander Kamkin
% ./install.sh --force-install-veritool
33 66 Alexander Kamkin
</pre> (โˆ™) It should be emphasized that when installing the Verilog tools they are downloaded from the Internet. If direct connection is not available, try to install the Verilog tools manually as it is described in the next section.
34 1 Alexander Kamkin
35 34 Alexander Kamkin
Home directories for the tools are chosen according to the following rules:
36 1 Alexander Kamkin
37 69 Alexander Kamkin
# If the environment variable @ISPRAS_HOME@ is not set,
38 70 Alexander Kamkin
 @ISPRAS_HOME=<user-home-directory>@.
39 51 Alexander Kamkin
# If the environment variable @CPPTESK_HOME@ is not set, @CPPTESK_HOME=$ISPRAS_HOME/tools/cpptesk-toolkit@.
40
# If the environment variable @ICARUS_HOME@ is not set, @ICARUS_HOME=$ISPRAS_HOME/tools/verilog@.
41
# It the environment variable @VERITOOL_HOME@ is not set, @VERITOOL_HOME=$ISPRAS_HOME/tools/veritool@.
42 35 Alexander Kamkin
43 39 Alexander Kamkin
C++TESK is installed into the directory @$CPPTESK_HOME@.
44 36 Alexander Kamkin
45 55 Alexander Kamkin
"Icarus Verilog":http://iverilog.icarus.com and "VeriTool":http://forge.ispras.ru/projects/veritool (if they are required) are installed into @$ICARUS_HOME@ and @$VERITOOL_HOME@, respectively.
46 1 Alexander Kamkin
47 40 Alexander Kamkin
h3. Manual Installation of the Verilog Tools
48 1 Alexander Kamkin
49 67 Alexander Kamkin
The Verilog tools can be installed manually (it might be useful if the target computer is not connected to the Internet, while there is another computer that can be used for downloading the packages).
50 2 Alexander Kamkin
51 55 Alexander Kamkin
To install "Icarus Verilog":http://iverilog.icarus.com, pass the following steps:
52 1 Alexander Kamkin
53 55 Alexander Kamkin
# Download the package from "here":http://sourceforge.net/projects/iverilog/files/iverilog.
54 53 Alexander Kamkin
# If the environment variable @ICARUS_HOME@ is not set, assign an appropriate value:
55 7 Alexander Kamkin
<pre>
56 47 Alexander Kamkin
% export ICARUS_HOME=<path-to-icarus-verilog-installation-directory>
57 42 Alexander Kamkin
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.profile"
58
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.bashrc"
59 7 Alexander Kamkin
</pre>
60 42 Alexander Kamkin
# Create the @$ICARUS_HOME@ directory if it does not exist:
61 7 Alexander Kamkin
<pre>
62 46 Alexander Kamkin
% mkdir -p "$ICARUS_HOME"
63 1 Alexander Kamkin
</pre>
64 54 Alexander Kamkin
# Unzip the downloaded package and compile the sources:
65 1 Alexander Kamkin
<pre>
66 48 Alexander Kamkin
% tar xf verilog-<version-number>.tar.gz
67
% cd verilog-<version-number>
68 46 Alexander Kamkin
% ./configure --prefix="$ICARUS_HOME"
69
% make && make install
70 1 Alexander Kamkin
</pre>
71 7 Alexander Kamkin
72 55 Alexander Kamkin
To install "VeriTool":http://forge.ispras.ru/projects/veritool, pass the following steps:
73 7 Alexander Kamkin
74 55 Alexander Kamkin
# Download the package from "here":http://forge.ispras.ru/projects/veritool/files.
75 53 Alexander Kamkin
# If the environment variable @VERITOOL_HOME@ is not set, assign an appropriate value:
76 9 Alexander Kamkin
<pre>
77 47 Alexander Kamkin
% export VERITOOL_HOME=<path-to-veritool-installation-directory>
78 46 Alexander Kamkin
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.profile"
79
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.bashrc"
80 9 Alexander Kamkin
</pre>
81 46 Alexander Kamkin
# Create the @$VERITOOL_HOME@ directory if it does not exist:
82 9 Alexander Kamkin
<pre>
83 46 Alexander Kamkin
% mkdir -p "$VERITOOL_HOME"
84 9 Alexander Kamkin
</pre>
85 54 Alexander Kamkin
# Unzip the downloaded package and compile the sources:
86 9 Alexander Kamkin
<pre>
87 48 Alexander Kamkin
% tar xf veritool-<version-number>.tar.gz
88
% cd veritool-<version-number>
89 46 Alexander Kamkin
% ./configure --prefix="$VERITOOL_HOME"
90
% make all && make install
91 9 Alexander Kamkin
</pre>