Project

General

Profile

Installation Guide » History » Version 56

Alexander Kamkin, 09/26/2011 06:04 PM

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
% install.sh
25 1 Alexander Kamkin
</pre>
26 33 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
% install.sh --install-veritool
29 31 Alexander Kamkin
</pre>
30 37 Alexander Kamkin
* To install C++TESK and (re)install the Verilog tools, run:
31 25 Alexander Kamkin
<pre>
32
% install.sh --force-install-veritool
33 34 Alexander Kamkin
</pre>
34 56 Alexander Kamkin
It should be emphasized that when installing the Verilog tools the script downloads them from the Internet.
35 1 Alexander Kamkin
36 34 Alexander Kamkin
Home directories for the tools are chosen according to the following rules:
37 1 Alexander Kamkin
38 51 Alexander Kamkin
# If the environment variable @ISPRAS_HOME@ is not set, @ISPRAS_HOME=<user-home-directory>@.
39
# 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 56 Alexander Kamkin
The Verilog tools can be installed manually (it might be useful if your computer is not connected to the Internet, but ).
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>