Skip to content
This repository was archived by the owner on Jun 6, 2025. It is now read-only.

raleighlittles/Tourbox_Neo_Linux_Driver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 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.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages