Skip to content

raleighlittles/Tourbox_Neo_Linux_Driver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CI build badge

Tourbox Stock image

About

This is a simple Linux driver (written in C++) for the Tourbox Neo. (The manufacturer frustratingly refused to provide a Linux driver, so I decided to write one)

This driver lets you use the device as a rudimentary keyboard and mouse combo -- the D-pad controls a virtual mouse, and the various keys perform different functions (see docs folder for full list).

Usage

Compile the driver via C-Make.

$ cmake CMakeLists.txt
$ make

In a separate window, open dmesg.

Since the device will be writing to /dev/uinput, you need to either:

(a) Run the executable (Tourbox_Linux_Driver) as root, passing in the path to the serial port for your device. This is either /dev/ttyACM0 or /dev/ttyUSB0 on most distributions, check your dmesg output when you connect your device to be sure.

(b) Change the permissions on /dev/uinput

Whatever you decide to do, after running the executable you should see an entry in the dmesg window with the device:

input: Custom Tourbox TBG_H Driver (Keyboard/Mouse) as /devices/virtual/input/input48

This tells you it's ready for use. When you're ready to stop using the driver, simply Ctrl + C (SIGINT) the program

If you'd like to change the functionality provided by the driver, you can use Xmodmap to create your own keymap.