Project

General

Profile

Installation Guide » History » Version 74

Alexander Kamkin, 03/15/2013 11:51 AM

1 1 Alexander Kamkin
h1. Installation Guide
2
3 72 Alexander Kamkin
{{toc}}
4
5 1 Alexander Kamkin
h2. Introduction
6
7 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).
8 11 Alexander Kamkin
9
Before installing the toolkit make sure that [[System Requirements]] are met.
10 1 Alexander Kamkin
11
h2. Installation
12
13 41 Alexander Kamkin
h3. Basic Installation (Recommended)
14 40 Alexander Kamkin
15 12 Alexander Kamkin
To install C++TESK, pass the following steps:
16 1 Alexander Kamkin
17 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.
18 54 Alexander Kamkin
# Unzip the downloaded package:
19 18 Alexander Kamkin
<pre>
20 50 Alexander Kamkin
% tar xf cpptesk-toolkit-src-<version-number>.tar.gz
21 18 Alexander Kamkin
</pre>
22 28 Alexander Kamkin
# Run the @install.sh@ script as follows.
23 29 Alexander Kamkin
24 27 Alexander Kamkin
* To install C++TESK without installing the Verilog tools, run:
25 22 Alexander Kamkin
<pre>
26 68 Alexander Kamkin
% ./install.sh
27 1 Alexander Kamkin
</pre>
28 62 Alexander Kamkin
* To install C++TESK together with the Verilog tools (โˆ™) not reinstalling the Verilog tools if they have been already installed, run:
29 23 Alexander Kamkin
<pre>
30 68 Alexander Kamkin
% ./install.sh --install-veritool
31 31 Alexander Kamkin
</pre>
32 62 Alexander Kamkin
* To install C++TESK and (re)install the Verilog tools (โˆ™), run:
33 25 Alexander Kamkin
<pre>
34 68 Alexander Kamkin
% ./install.sh --force-install-veritool
35 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.
36 1 Alexander Kamkin
37 34 Alexander Kamkin
Home directories for the tools are chosen according to the following rules:
38 1 Alexander Kamkin
39 71 Alexander Kamkin
# If the environment variable @ISPRAS_HOME@ is not set, @ISPRAS_HOME=<user-home-directory>@.
40 51 Alexander Kamkin
# If the environment variable @CPPTESK_HOME@ is not set, @CPPTESK_HOME=$ISPRAS_HOME/tools/cpptesk-toolkit@.
41
# If the environment variable @ICARUS_HOME@ is not set, @ICARUS_HOME=$ISPRAS_HOME/tools/verilog@.
42
# It the environment variable @VERITOOL_HOME@ is not set, @VERITOOL_HOME=$ISPRAS_HOME/tools/veritool@.
43 35 Alexander Kamkin
44 39 Alexander Kamkin
C++TESK is installed into the directory @$CPPTESK_HOME@.
45 36 Alexander Kamkin
46 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.
47 1 Alexander Kamkin
48 40 Alexander Kamkin
h3. Manual Installation of the Verilog Tools
49 1 Alexander Kamkin
50 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).
51 2 Alexander Kamkin
52 55 Alexander Kamkin
To install "Icarus Verilog":http://iverilog.icarus.com, pass the following steps:
53 1 Alexander Kamkin
54 55 Alexander Kamkin
# Download the package from "here":http://sourceforge.net/projects/iverilog/files/iverilog.
55 53 Alexander Kamkin
# If the environment variable @ICARUS_HOME@ is not set, assign an appropriate value:
56 7 Alexander Kamkin
<pre>
57 47 Alexander Kamkin
% export ICARUS_HOME=<path-to-icarus-verilog-installation-directory>
58 42 Alexander Kamkin
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.profile"
59
% echo "export ICARUS_HOME=$ICARUS_HOME" >> "$HOME/.bashrc"
60 7 Alexander Kamkin
</pre>
61 42 Alexander Kamkin
# Create the @$ICARUS_HOME@ directory if it does not exist:
62 7 Alexander Kamkin
<pre>
63 46 Alexander Kamkin
% mkdir -p "$ICARUS_HOME"
64 1 Alexander Kamkin
</pre>
65 54 Alexander Kamkin
# Unzip the downloaded package and compile the sources:
66 1 Alexander Kamkin
<pre>
67 48 Alexander Kamkin
% tar xf verilog-<version-number>.tar.gz
68
% cd verilog-<version-number>
69 46 Alexander Kamkin
% ./configure --prefix="$ICARUS_HOME"
70
% make && make install
71 1 Alexander Kamkin
</pre>
72 7 Alexander Kamkin
73 55 Alexander Kamkin
To install "VeriTool":http://forge.ispras.ru/projects/veritool, pass the following steps:
74 7 Alexander Kamkin
75 55 Alexander Kamkin
# Download the package from "here":http://forge.ispras.ru/projects/veritool/files.
76 53 Alexander Kamkin
# If the environment variable @VERITOOL_HOME@ is not set, assign an appropriate value:
77 9 Alexander Kamkin
<pre>
78 47 Alexander Kamkin
% export VERITOOL_HOME=<path-to-veritool-installation-directory>
79 46 Alexander Kamkin
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.profile"
80
% echo "export VERITOOL_HOME=$VERITOOL_HOME" >> "$HOME/.bashrc"
81 9 Alexander Kamkin
</pre>
82 46 Alexander Kamkin
# Create the @$VERITOOL_HOME@ directory if it does not exist:
83 9 Alexander Kamkin
<pre>
84 46 Alexander Kamkin
% mkdir -p "$VERITOOL_HOME"
85 9 Alexander Kamkin
</pre>
86 54 Alexander Kamkin
# Unzip the downloaded package and compile the sources:
87 9 Alexander Kamkin
<pre>
88 48 Alexander Kamkin
% tar xf veritool-<version-number>.tar.gz
89
% cd veritool-<version-number>
90 46 Alexander Kamkin
% ./configure --prefix="$VERITOOL_HOME"
91
% make all && make install
92 9 Alexander Kamkin
</pre>
93 73 Sergey Smolov
94
h2. Eclipse plugin installation
95
96
To install C++TESK Eclipse plugin, do the following:
97
98
# Make sure you have Eclipse with C/C++ Development Environment and C++TESK installed.
99
# Start Eclipse.
100 74 Alexander Kamkin
# Open "Help"->"Install New Software..."
101
# Press "Add" and select "Archive" menu item and choose @CPPTESK_Eclipse_plugin.zip@ in your file system (it''s in @CPPTESK_HOME/plugins@ directory).
102 73 Sergey Smolov
# Follow installation instructions (press "Ok" on the unsigned content warning at the end of installation).
103
104
105
Also it is possible to install C++TESK Eclipse plugin by command line. If you prefer this way, do the following:
106
107
# Download and unpack C++TESK Testing Toolkit distribution archive.
108
# Run the command:
109
<pre>
110 74 Alexander Kamkin
bash ./install.sh --install-ide <path-to-Eclipse-instance-you-want-plugin-to-be-installed-in>
111 73 Sergey Smolov
</pre>
112
113 74 Alexander Kamkin
If you already have the elder version of the plugin, it will be removed, and the latest version will be installed.