Building VLSI Project

Pascal Francq

April 2, 2013 (March 28, 2013)

Abstract

This document describes how the download, compile and install the VLSI project.
Several steps must be follow to download, compile and use the VLSI project (library and application). All the source code is available through our subversion server svn.otlet-institute.org.

1 The VLSI project

The [VLSI Project] consists in two parts:
  1. The RVLSI library (section 2↓) that provides the classes that solve a (very simple) VLSI problem.
  2. The application KDevVLSI (section 3↓) that offers a graphical user interface.
All official libraries and applications related to the VLSI project are managed through cmake. The RVLSI library classes are defined in the RVLSI namespace.

2 The RVLSI Library

The RVLSI library depends only from the libraries of the R Project. So the first step is to compile these libraries. Next, you must build the RVLSI library. The Qt library with development is necessary if you want to compile graphical widgets. You can download the source code from our subversion server:
svn co svn://svn.otlet-institute.org/home/subversion/rvlsi/trunk rvlsi
To build the rvlsi library, you must go to the directory, create a sub-directory (for example ’build’) and go into it. In this latest directory, you must type:
cmake .. [OPTIONS] 
make or make VERBOSE=1
Two interesting options are:
-DCMAKE_BUILD_TYPE=Debugfull This option generates all the necessary debugging symbols.
-Ddisable-kde=true This option disables the support for Qt/KDE libraries.
As for the R libraries, you can use the RVLSI library in two different ways:
  1. The library and the include files are installed (for example in /usr/include/r and /usr/lib). This can be done after the compilation with the command:
    sudo make install
    
  2. The library can be used without to be installed. You may create an environment variable RVLSI_LIB pointing to the root directory containing the RVLSI library.
The simplest method to include the RVLSI library in your application is to follow the steps described for using the R libraries. In practice, you have to add a line in the “prj.cmake” file:
R_LOAD_DEPENDENCY("RVLSI" "RVLSI_LIB" "rvlsi")
In the code sub-directory of your application, you must specify in the “CMakeLists.txt” file that it must be linked with the RVLSI library:
TARGET_LINK_LIBRARIES(testgalilei rcore rmath roptimization rvlsi)

3 The KDevVLSI Application

KDevVLSI is a KDE-based application that provides a graphical user interface to manage a (very simple) VLSI problem. You can get the source code from our subversion server:
svn co svn://svn.otlet-institute.org/home/subversion/kdevvlsi/trunk kdevvlsi
To build an application, you must go to the directory, create a sub-directory (for example ’build’) and go into it. In this latest directory, you must type:
cmake .. [OPTIONS] 
make or make VERBOSE=1
You can add the option -DCMAKE_BUILD_TYPE=Debug to add the debugging symbols to your application. To install the application, you must add the additional command:
sudo make install