# relabsd
Duplicates an input device to convert its relative axes into absolute ones.
## Why would you do that?
The main purpose of this program is to bypass an issue of 3DConnexion's SpaceNavigator (but other devices might also suffer from this issue).
Indeed, this device reports having relatives axes despite sending absolute values.
Here are some people having issues because of this:
* http://www.3dconnexion.com/forum/viewtopic.php?t=2688
* http://www.osculator.net/forum/archive/index.php/t-708.html
* http://www.gimpusers.com/forums/gimp-developer/6231-adding-spacenavigator-support#message29509

Relative axes make Simple DirectMedia Layer (SDL) consider the device as 2 dimentional track ball, whereas absolute ones are understood to be a 6 axis joystick (which, at least to me, seems about right).


## How?
### Dependencies
* CMake
* libevdev

### Compiling
```
$ mkdir build
$ cd build
$ cmake ..
```
### Running
```
# ./relabsd /dev/input/spacenavigator ../conf/space_navigator.conf
```
### Results
(Using [Grumpel's sdl-jstest](https://github.com/Grumbel/sdl-jstest))

**SDL 1:**
```
$ ./sdl-jstest --list
Found 1 joystick(s)

Joystick Name:     'relabsd device'
Joystick Number:    0
Number of Axes:     6
Number of Buttons:  2
Number of Hats:     0
Number of Balls:    0
```
**SDL 2:**
```
$ ./sdl2-jstest --list
Found 2 joystick(s)

Joystick Name:     '3Dconnexion SpaceNavigator'
Joystick GUID:     030000006d04000026c6000011010000
Joystick Number:    0
Number of Axes:     0
Number of Buttons:  2
Number of Hats:     0
Number of Balls:    1
GameController:
  not a gamepad

Joystick Name:     'relabsd device'
Joystick GUID:     030000006d04000026c6000011010000
Joystick Number:    1
Number of Axes:     6
Number of Buttons:  2
Number of Hats:     0
Number of Balls:    0
GameController:
  not a gamepad
```
# Troubleshooting
## I can't find my (real) input device.
Your input device should be listed in /dev/input.

If you are using a 3DConnexion device and not finding it in /dev/input, read [this wiki page](https://github.com/nsensfel/relabsd/wiki/Note-on-3DConnexion-devices).