Trivisio Colibri Manuale utente
Contents
1 Introduction 3
2 Installation 4
2.1 Windows ..................................... 4
2.2 Linux ...................................... 6
3 GUI 7
3.1 Starting the application ............................ 7
3.2 The GUI ..................................... 8
3.3 Calibration parameters ............................. 11
3.4 Boresighting ................................... 12
3.5 Jitter Reduction ................................. 13
3.6 Additional functionality ............................ 13
3.6.1 Disable drawing of textures ...................... 13
3.6.2 Additional COM ports to scan ..................... 14
3.6.3 Sensor Diagnosis ............................ 15
3.6.4 Firmware Upgrade ........................... 16
4 SDK 18
4.1 The test.c example .............................. 18
4.2 The orientation.cpp example ........................ 21
4.3 Simple Import mechanism for data profiling ................. 21
Colibri User Manualsdf df 1
Chapter 1
Introduction
Thank you for purchasing the Trivisio Colibri and using its software development kit
(SDK).
This user’s manual covers the software available for the Colibri Tracker. Chapter 2is
an installation guide for the software. The graphical user interface (GUI) provided with
the sensor is described in Chapter 3. It covers the functionality of the GUI and does also
gives some hint on how to get the most out of the Colibri Tracker. Chapter 4describes
two examples of using the SDK’s API. The code of one of the examples is studied in
detail.
Colibri User Manualsdf df 3
Chapter 2
Installation
This chapter provides the installation guides for Microsoft Windows and Linux.
If you do not have an installer yet, please download the installation file from the
Trivisio GmbH website: http://www.trivisio.com. Installers for Window and Linux
(32 and 64 bit) can be freely downloaded from the Support — Software section (http:
//www.trivisio.com/index.php/support/software).
Download the installer for your system, and continue to the section covering the in-
stallation guidelines for your operating system.
2.1 Windows
Run the installer, the following images will then guide you through the installation pro-
cedure.
Step 1: Welcome Screen
This is the welcome screen of the installer. Press next to start the installation or cancel
to abort.
4 Colibri User Manualsdf df
Step 2: EULA
The next dialog is the End User License Agreement. Please read it carefully.
If you agree to the terms and conditions, please press the “I Agree” button to continue
the installation procedure.
Step 3: Installation path
In this dialog the user is able to choose or select the desired installation path.
Colibri User Manualsdf df 5
Step 4: Start menu folder
If you want to have a different name for your start menu folder, please modify the path
to your personal need.
Step 5: Component installation
The next dialog can be used to select different installation types. The default installation
type is FULL.
The different options are: Full, Developer, GUI, and Custom. The Full installation
comprise the Developer and GUI installations.
After this dialog the installation is executed and you are able to use the applications
and develop your own software based on the SDK.
2.2 Linux
Simply run the installer, accept the EULA, and follow the instruction presented.
6 Colibri User Manualsdf df
Chapter 3
GUI
This section provides an overview about the graphical user interface, which can be used
to view the connected sensors and their values.
3.1 Starting the application
Using Microsoft Windows
You can start the application either by clicking the Trivisio – Colibri icon on your
desktop or by selecting it from the start menu. The default location is: Trivisio –
Colibri X.X.X (see below) and execute the Trivisio – Colibri.
Using Linux
Execute the TrivisioGUI executable, available in the bin directory of the installation.
Colibri User Manualsdf df 7
3.2 The GUI
This is a snapshot of the GUI application.
Based on this image, the functionality will be described briefly below:
1. The list of Colibri sensors found connected to the system.
Detailed information about each sensor can be viewed and changed by expanding the
tree view by pressing the “plus” symbol. There might be sensors marked with red.
These are equipped with an outdated firmware version, which must be updated
before the sensor can be accessed or used. See Section 3.6.4. The sensors are
identified by their serial number and firmware version.
When a sensor is not running, it is possible to change its settings. The boresighting
setting, further described in Section 3.4, is an exception to this rule as it can also
be changed when the sensor is running.
By expanding the Sensor Config (see figure below), it is possible to see what indi-
vidual sensor elements are enabled in the Colibri. The user can enable the individual
magnetometers,accelerometers, and gyroscopes, and also the built in temperature
sensor. The Orientation sensor turns on the Colibri’s virtual orientation sensor.
When using the orientation sensor, all accelerometers, gyroscopes and magnetome-
ters will automatically be turned on and cannot be deactivated before the orientation
is deactivated.
The Magnetic div determines the sensitivity of the magnetometers. A higher value
improves the magnetic measurements, but does also take more time to measure.
8 Colibri User Manualsdf df
Indice
Altri manuali Trivisio GPS
