Project

General

Profile

Installation Guide » History » Version 52

Alexander Kamkin, 09/26/2011 05:34 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 20 Alexander Kamkin
# Unzip the downloaded archive:
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 1 Alexander Kamkin
35 34 Alexander Kamkin
Home directories for the tools are chosen according to the following rules:
36 1 Alexander Kamkin
37 51 Alexander Kamkin
# If the environment variable @ISPRAS_HOME@ is not set, @ISPRAS_HOME=<user-home-directory>@.
38
# If the environment variable @CPPTESK_HOME@ is not set, @CPPTESK_HOME=$ISPRAS_HOME/tools/cpptesk-toolkit@.
39
# If the environment variable @ICARUS_HOME@ is not set, @ICARUS_HOME=$ISPRAS_HOME/tools/verilog@.
40
# It the environment variable @VERITOOL_HOME@ is not set, @VERITOOL_HOME=$ISPRAS_HOME/tools/veritool@.
41 35 Alexander Kamkin
42 39 Alexander Kamkin
C++TESK is installed into the directory @$CPPTESK_HOME@.
43 36 Alexander Kamkin
44 52 Alexander Kamkin
Icarus Verilog and VeriTool (if they are required) are installed into @$ICARUS_HOME@ and @$VERITOOL_HOME@, respectively.
45 1 Alexander Kamkin
46 40 Alexander Kamkin
h3. Manual Installation of the Verilog Tools
47 6 Alexander Kamkin
48 42 Alexander Kamkin
The Verilog tools can be installed manually.
49 2 Alexander Kamkin
50 42 Alexander Kamkin
To install Icarus Verilog, pass the following steps:
51 1 Alexander Kamkin
52 44 Alexander Kamkin
# Download the Icarus Verilog package from "here":http://sourceforge.net/projects/iverilog/files/iverilog.
53 51 Alexander Kamkin
# If the environment variable @ICARUS_HOME@ is not set, it should be assigned:
54 7 Alexander Kamkin
<pre>
55 47 Alexander Kamkin
% export ICARUS_HOME=<path-to-icarus-verilog-installation-directory>
56 42 Alexander Kamkin
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.profile"
57
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.bashrc"
58 7 Alexander Kamkin
</pre>
59 42 Alexander Kamkin
# Create the @$ICARUS_HOME@ directory if it does not exist:
60 7 Alexander Kamkin
<pre>
61 46 Alexander Kamkin
% mkdir -p "$ICARUS_HOME"
62 1 Alexander Kamkin
</pre>
63 46 Alexander Kamkin
# Unzip the downloaded archive and compile the sources:
64 1 Alexander Kamkin
<pre>
65 48 Alexander Kamkin
% tar xf verilog-<version-number>.tar.gz
66
% cd verilog-<version-number>
67 46 Alexander Kamkin
% ./configure --prefix="$ICARUS_HOME"
68
% make && make install
69 1 Alexander Kamkin
</pre>
70 7 Alexander Kamkin
71 42 Alexander Kamkin
To install VeriTool, pass the following steps:
72 7 Alexander Kamkin
73 46 Alexander Kamkin
# Download the VeriTool package from "here":http://forge.ispras.ru/projects/veritool/files.
74 51 Alexander Kamkin
# If the environment variable @VERITOOL_HOME@ is not set, it should be assigned:
75 9 Alexander Kamkin
<pre>
76 47 Alexander Kamkin
% export VERITOOL_HOME=<path-to-veritool-installation-directory>
77 46 Alexander Kamkin
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.profile"
78
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.bashrc"
79 9 Alexander Kamkin
</pre>
80 46 Alexander Kamkin
# Create the @$VERITOOL_HOME@ directory if it does not exist:
81 9 Alexander Kamkin
<pre>
82 46 Alexander Kamkin
% mkdir -p "$VERITOOL_HOME"
83 9 Alexander Kamkin
</pre>
84 46 Alexander Kamkin
# Unzip the downloaded archive and compile the sources:
85 9 Alexander Kamkin
<pre>
86 48 Alexander Kamkin
% tar xf veritool-<version-number>.tar.gz
87
% cd veritool-<version-number>
88 46 Alexander Kamkin
% ./configure --prefix="$VERITOOL_HOME"
89
% make all && make install
90 9 Alexander Kamkin
</pre>