User Manual Omega.x

user%20manual%20-%20omega.x

User Manual:

Open the PDF directly: View PDF .
Page Count: 24

Download
Open PDF In Browser	View PDF

USER MANUAL

omega.x haptic device
version 1.7
06.2013

Force Dimension
Route de Saint-Cergue 295
CH – 1260 Nyon
Switzerland
www.forcedimension.com

summary
The purpose of this document is
> to describe the setup of the omega.x haptic device
> to describe the installation of the drivers and haptic software SDK
> to describe the operation of the omega.x haptic device

glossary
FD-SDK
omega.x

refers to the Software Development Kit (SDK) for all Force Dimension products.
refers to the base haptic device shared by the omega.3, omega.6 and omega.7
haptic devices. Unless specified, all instructions in this manual apply to all three
device types.
3

table of contents

device description

important safety instructions

setting up the omega.x

3.1
3.2
4.

configuring the omega.x under Windows
4.1
4.2
4.3

installing the software
installation description
installing the drivers

using the omega.x
7.1
7.2
7.3
7.4

installing the software
installation description
installing the drivers

configuring the omega.x under Mac OS X
6.1
6.2
6.3

installing the software
installation description
installing the drivers

configuring the omega.x under Linux
5.1
5.2
5.3

unpacking the device
installing the power supply

device geometry
operating the omega.x
running the HapticDesk program
running the demonstrations programs

technical information

9
10
11
11
11
11
12
12
12
12
13
13
13
13
14
14
16
19
20
23

1. device description

1
1

base plate

status LED

control unit

force LED

arms

10. programmable button

end-effector

11. power switch

force button

12. power connector

calibration pole

13. USB connector

calibration pit

14. tightening knob

2. important safety instructions

IMPORTANT
WHEN USING THIS UNIT, BASIC SAFETY PRECAUTIONS
SHOULD ALWAYS BE FOLLOWED TO REDUCE THE RISK
OF FIRE, ELECTRICAL SHOCK, OR PERSONAL INJURY.

read and understand all instructions

follow all warnings and instructions marked on this unit

do not use or place this system near water

place the unit securely on a stable surface

make sure that the workspace of the omega.x is free of objects

do not overload wall outlets and extension cords
this can result in a risk of fire or electrical shock

switch off the omega.x when it is not in use

to reduce the risk of electrical shock, do not disassemble the omega.x

3. setting up the omega.x

IMPORTANT
PLEASE KEEP THE ORIGINAL PACKAGING
ONLY USE THE ORIGINAL PACKAGING FOR STORING OR SHIPPING

3.1

unpacking the device

Before unpacking the device, remove the device stabilizer and the accessories box from within
the box. Carefully remove the device and the end-effector stabilizer from the box, then remove
the end-effector stabilizer.
device stabilizer

end-effector stabilizer

figure 1 – omega.x shipping box and accessories box

The accessories box contains the power and data cables, as well as the driver and SDK installation media.

3.2

installing the power supply

Plug the power supply into the power connector. The system supports either 110/120 Volts or
220/230 Volts. Only use the Force Dimension power supply that came with your device. Replacement power supplies can be ordered from Force Dimension.

4. configuring the omega.x under Windows
4.1

installing the software

The installation USB drive must be installed onto your system before connecting the omega.x to
the system. To do this, perform the following steps.
1.

plug the Force Dimension USB drive into your system

open the \Windows subfolder on the USB drive

run setup.exe icon to launch the installation program

follow the instructions given by the installation program

4.2

installation description

The installation program creates the following subfolders in :
C:\Program Files\Force Dimension\sdk-

\bin subfolder
This directory contains the demonstration executables and the DLL files required to run the
omega.x software. The required DLL files are also copied to the Windows system folder during
the installation.
\drivers subfolder
This directory contains the USB and PCI drivers required to operate your device.
\examples subfolder
This directory contains the demonstration programs. Example applications described in section
7.4 and come with their full source code.
\doc subfolder
All documentation files and notices are located in that directory.
\manuals subfolder
All hardware user manuals are located in that directory.
\lib,\include subfolders
These directories contain the files required to compile you application with the Force Dimension
SDK. Please refer to the on-line programming manual for more information.

4.3

installing the drivers
USB drivers

The omega.x requires the Force Dimension USB driver. These drivers are installed automatically
and no additional step is required.

5. configuring the omega.x under Linux
5.1

installing the software

The Force Dimension development folder must be installed onto your system before the omega.x
can be used. To do this, perform the following steps:
1.

plug the Force Dimension USB drive into your system

decompress the sdk-.tar.gz file from the drive \Linux subfolder to the desired location (typically your home folder) by running the following command within the target folder:
tar –zxvf sdk-.tar.gz

3. this will create a sdk- development folder in the target location

5.2

installation description

The development folder contains the following directories:
\bin subfolder
This directory contains the demonstration executables and the binary files required to run the
omega.x software.
\examples subfolder
This directory contains the demonstration programs. Example applications described in section
7.4 and come with their full source code.
\doc subfolder
All documentation files and notices are located in this subfolder.
\manuals subfolder
All hardware user manuals are located in that directory.
\lib,\include subfolders
These directories contain the files required to compile you application with the Force Dimension
SDK. Please refer to the on-line programming manual for more information.

5.3

installing the drivers

The Linux version of the Force Dimension SDK requires the development packages for the libusb-1.0 and freeglut to be installed on your Linux distribution.

6. configuring the omega.x under Mac OS X
6.1

installing the software

The Force Dimension development folder must be installed onto your system before the omega.x
can be used. To do this, perform the following steps:
1.

plug the Force Dimension USB drive into your system

2. open the sdk-.dmg file from the drive \Mac OS subfolder and extract the sdk-

folder to the desired location (typically your home folder)
3. this will create a sdk- development folder in the target location

6.2

installation description

6.3

installing the drivers

The Apple version of the Force Dimension SDK uses Apple’s native USB drivers, which are included in Mac OS X 10.4 and higher. No further installation is required.

7. using the omega.x
7.1

device geometry
omega.x translation axis

The position of the end-effector can be read from the controller. The system converts the encoder values into (X, Y, Z) coordinate, expressed in IUS (metric) unit. Figure 2 shows the coordinate system. The actual origin of the coordinates system (0,0,0) is located on a virtual point at
the center of the workspace. The calibration pit places the device at the (0.019, 0.0, - 0.074) location.

Z
Y
X

calibration coordinates
(0.019, 0.000, - 0.074)

figure 2 – coordinate system

omega.6 and omega.7 extensions (optional)
The omega.6 and omega.7 provide a rotational structure. Rotation information can be retrieved
as a reference frame expressed by a 3x3 rotation matrix:

x
y

z
y

figure 3 – reference frame of the omega.6 and omega.7:

7.2

operating the omega.x
status indicators

The status LED displays the status of the system.
>
>
>
>

LED OFF
LED ON
LED BLINKING (fast)
LED BLINKING (slow)

the system is off
the system is ready
the system requires calibration
the omega.6 extension requires calibration

While the status LED is ON, it is possible to read the position of the end-effector, but no forces
can be applied. Forces must be enabled by pressing the force button. When the forces are enabled, the force LED is turned ON. Forces can be disabled by pressing the force button again.
features
calibration – calibration is necessary to obtain accurate, reproducible localization of the endeffector within the workspace of the device. The omega.x is designed in such a way that there
can be no drift of the calibration over time, so the procedure only needs to be performed once
when the device is powered on.
The calibration procedure consists in placing the calibration pole in the dedicated calibration
pit. The device detects when the calibration position is reached and the status LED stops blinking. Figure 4 illustrates the calibration procedure. After the initial calibration described above,
the LED will stop blinking (omega.3).

figure 4 – calibration procedure

On the omega.6 and omega.7 (optional), the LED will blink at a slower frequency, indicating that
the rotational structure is usable but not fully calibrated. To fully calibrate the omega.6 and
omega.7 extensions, each of the three rotation axis and the grasping axis of the omega.7 must
be moved by hand to their respective end-stops once. When the device has reached all end
stops, the LED stops blinking and the device is fully calibrated.

gravity compensation – to prevent user fatigue and to increase accuracy during manipulation,
the omega.x features gravity compensation. When gravity compensation is enabled, the weights
of the arms and of the end-effector are taken into account and a vertical force is dynamically applied to the end-effector on top of the user command. Please note that gravity compensation is
computed on the host computer, and therefore it only gets updated whenever a force command
is sent to the device by the application. Gravity compensation is enabled by default and can be
disabled via the Force Dimension SDK.
forces - by default, when an application opens a connection to the device, the forces are disabled. Forces can be enabled or disabled at any time by pressing the force button.
brakes – the device feature electromagnetic brakes that can be enabled via software. The brakes
are on by default when the forces are disabled, and can be enabled automatically by the control
unit in some cases. When the brakes are on, a viscous force is created that prevents rapid
movement of the end-effector. Also, enabling the brakes via the Force Dimension SDK simultaneously disables the forces.
end-effector tightening knob (omega.3) – the orientation of the end-effector can be adjusted by
means of the tightening knob.

safety features
The omega.x features several safety features designed to prevent uncontrolled application of
forces and possible damage to the device. These safety features can be adjusted or disabled via
a protected command in the Force Dimension SDK.

IMPORTANT
PLEASE NOTE THAT THE WARRANTY MAY NOT APPLY
IF THE SAFETY FEATURES HAVE BEEN OVERRIDEN.

When a connection to the device is made from the computer, the forces are automatically disabled to avoid unexpected behaviors. The user must press the force button to enable the forces.
This feature cannot be disabled.
If the control unit detects that the velocity of the end-effector is higher than the programmed
security limit, the forces are automatically disabled and the device brakes are engaged to prevent a possibly dangerous acceleration from the device. This velocity threshold can be adjusted
or removed via the Force Dimension SDK. Please refer to the on-line programming manual for
more information.

7.3

running the HapticDesk program

Under Windows, the HapticDesk is available as a test and diagnostic program.
HapticDesk allows the programmer to:
>
>
>
>
>
>

list all Force Dimension haptic devices connected to the system
test each device position reading
test each device force/torque capability
test each device auto-calibration procedure
read each device status
read any device encoder individually

figure 5 – HapticDesk test and diagnostic program

7.4

running the demonstrations programs

Two demonstration programs can also be used to diagnose the device. The source code and an
executable file for each of the demonstration programs are provided in two separate directories
named \gravity and \torus.
Once the system is setup, we suggest running gravity to check that everything is working
properly and to evaluate your system's performance independently of the graphics rendering
performance. torus will allow you to test the combined performance of haptics and graphics
rendering.
gravity example
This example program runs a best effort haptic loop to compensate for gravity. The appropriate
forces are applied at any point in space to balance the device end-effector so that it is safe to let
go of it. The refresh rate of the haptic loop is displayed in the console every second.

figure 6 – gravity example

torus example
The torus example displays an OpenGL scene that can be haptically explored.

figure 7 – torus example

note – OpenGL and the OpenGL Utility Toolkit (GLUT) must be installed for your compiler and
development environment to compile this example. Please refer to your compiler documentation
for more information, or consult http://www.opengl.org/resources/libraries/glut.html

8. technical information

omega.3
workspace
forces
resolution
stiffness
dimensions

translation
continuous
linear
closed loop
height
width
depth

∅ 160 mm x L 110mm
12.0 N
< 0.01 mm
14.5 N/mm
270 mm
300 mm
350 mm

interface

standard
rate
universal

USB 2.0
up to 4 KHz
100V - 240V

power
calibration
structure
user input
safety

automatic
driftless
delta-based parallel kinematics
active gravity compensation
1 programmable button
velocity monitoring
electromagnetic damping

omega.6 extension
workspace
resolution
option
user input

rotation
240 x 140 x 320 deg
angular
0.09 deg
available for right or left hand
1 programmable button

omega.7 extension
workspace
force
resolution
option

rotation
240 x 140 x 180 deg
gripper
25 mm
continuous ± 8 N
angular
0.09 deg
linear
0.006 mm
available for right or left hand

software
OS

SDK

Microsoft
Linux
Apple
QNX
WindRiver
haptic SDK
robotic SDK

Windows XP / Vista / 7 / 8
Windows CE 7
kernel 2.6 / 3.x
OS X 10.8 / 10.9
Neutrino 6.5
VxWorks 6.3 / 6.9

notice
The information in this document is provided for reference only. Force Dimension does not assume any
liability arising out of the application or use of the information or product described herein. This document
may contain or reference information and products protected by copyrights or patents and does not convey
any license under the patent rights of Force Dimension, nor the rights of others.
All trademarks or trade names are properties of their respective owners.
© Copyright 2013 – Force Dimension
All rights reserved.

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : Yes
Tagged PDF                      : Yes
XMP Toolkit                     : Adobe XMP Core 4.0-c321 44.398116, Tue Aug 04 2009 14:24:39
Producer                        : Acrobat Distiller 8.3.1 (Windows)
Company                         : EPFL
Source Modified                 : D:20140310071635
Creator Tool                    : Acrobat PDFMaker 8.1 for Word
Modify Date                     : 2014:03:10 20:17:42+13:00
Create Date                     : 2014:03:10 20:17:01+13:00
Metadata Date                   : 2014:03:10 20:17:42+13:00
Document ID                     : uuid:0df3586b-aa72-437a-94ee-37012f16dda7
Instance ID                     : uuid:547a0583-119f-4a93-af00-57a1bd488b78
Subject                         : 49
Format                          : application/pdf
Creator                         : Sebastien Grange
Title                           : 
Page Count                      : 24
Page Layout                     : OneColumn
Author                          : Sebastien Grange

EXIF Metadata provided by EXIF.tools

User Manual Omega.x

user%20manual%20-%20omega.x

Navigation menu

Versions of this User Manual:

Views

Navigation