Menu ▾ ▴

Kinova Sensor User Interface

Jean-Philippe Roberge

(AUTHOR: Jean-Philippe Roberge)

TABLE OF CONTENTS

Welcome to KinovaSensorUI's Wiki page!

This page was created to assist people with the installation of the KinovaSensorUI package on Linux operating systems.

1.0 Pre-Installation

Before starting the installation procedure, one needs to make sure libmgl.so.7.0.0 and libQtSerialPort.so.1 libraries are installed on the computer. Since these libraries are not provided as part of automatically-downloadable packages (e.g. by using sudo apt-get install or yum install), we need to rely on another way to get these essential files. There are two different ways to achieve this:

This first method copy and paste pre-compiled versions of libmgl.so.7.0.0 and libQtSerialPort.so.1 as symbolic links in /usr/lib. This is not dangerous in any way as these versions of the libraries were compiled speficially for KinovaSensorUI, they can run on either 32 and 64 bits system architecture, they are far from being system-critical and moreover they are over-writtable (in the rare case you already had a version of one of the library running on your computer). I suggest you use this method over the 2nd one, as it is more likely to make you save a significant load of work.

1) Start by downloading the Install_Libs tarball at https://sourceforge.net/projects/kinovasensorui/files/Install_Libs.tar.gz/download and untar it in a folder (for example, /home/username/Downloads/Install_Libs. In that folder, you should find a folder named "Libs" and a bash script file named "Install_Libs.sh".

2) Simply open a terminal and type:

sudo bash /home/username/Downloads/Install_Libs/Install_Libs.sh

You're done with the pre-installation!

1.2 2nd way: manual installation (hard way -- for expert users only)

Expert users who wants to manually install these two libraries can do so by compiling and installing the libraries one by one.

1) To get libmgl.so.7.0.0 (mathgl library), you need to follow all the instructions given at the mathgl website : http://mathgl.sourceforge.net/doc_en/Download.html#Download. Please note that at this moment there is no Linux pre-compiled version of the library, so you need to download the source code, and compile everything. The source files are compiled thorough the C-Make / Make build system, so the good side is that you will be able to compile a machine-specific and efficient library. The bad side is that the installation may become time-consuming if any trouble happens.

2) To get libQtSerialPort.so.1 (Qt serial-port library), you also need to build and install the library by following all the instructions given here : http://qt-project.org/wiki/QtSerialPort. The installation is pretty straight-forward, but note that you will need qmake to compile the .pro file.

Once these two libraries are installed, you are done with pre-installation!

2.0 Installation of KinovaSensorUI

2.1 Using Debian Package

Debian packages are pretty easy to work with, as they contain not only the source code allowing binary-file generation, but also the explicit list of package(s) dependency.

1)Start by installing gdebi, which is a small software that will allow the automatic resolution of all KinovaSensorUI's dependencies:

sudo apt-get install gdebi

2) Then download the KinovaSensorUI Debian package at: https://sourceforge.net/projects/kinovasensorui/files/kinovasensorui_1.0-1_i386.deb/download and save it in a folder (e.g.: /home/username/Downloads/).

3) Use gdebi to install the software:

sudo gdebi /home/username/Downloads/kinovasensorui_1.0-1_i386.deb

Installation should complete without error(s) as all the required packages will be installed together with kinovasensorui. You can then start using your software! (see next section)

libgl1-mesa-glx Package Error

Some users may have troubles completing the installation process using gdebi because of a libgl1 error such as shown below: 

[xxxx@yyyy] $ sudo gdebi kinovasensorui_1.0-1_i386.deb               [/tmp]
Reading package lists... Done
Building dependency tree        
Reading state information... Done
Building data structures... Done 
Building data structures... Done 
This package is uninstallable
Cannot install 'libgl1-mesa-glx:i386'
[xxxx@yyyy] $

If this is your case, this means you don't have the implementation of the OpenGL API installed on your machine. We will have to install that in order to use the interface, since OpenGL is required for data visualization. Thus, to fix that minor issue, just type the following in a terminal:

sudo apt-get update
sudo apt-get install libgl1-mesa-dri

Then, just re-install kinovasensorui :

sudo gdebi /home/username/Downloads/kinovasensorui_1.0-1_i386.deb

Installation should now have completed without error(s). You can then start using your software! (see next section)

3.0 Start working with the application

Once KinovaSensorUI has been installed, you can launch it simply by typing, in a terminal:

sudo kinovasensorui

Here, sudo is optional but may be required on some system to allow serial port communications.

4.0 Problems and bugs

Contact: Jean-Philippe Roberge jean-philippe.roberge@etsmtl.ca

The wiki uses Markdown syntax.

Project Members:

MongoDB Logo MongoDB