https://github.com/raleighlittles/tourbox_neo_linux_driver
A Linux keyboard driver for the Tourbox Neo (TBG_H)
https://github.com/raleighlittles/tourbox_neo_linux_driver
keyboard-driver mouse-driver tourbox tourbox-neo uinput
Last synced: about 1 year ago
JSON representation
A Linux keyboard driver for the Tourbox Neo (TBG_H)
- Host: GitHub
- URL: https://github.com/raleighlittles/tourbox_neo_linux_driver
- Owner: raleighlittles
- Created: 2022-07-16T05:03:55.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-08T03:51:36.000Z (about 2 years ago)
- Last Synced: 2025-03-28T08:01:58.529Z (about 1 year ago)
- Topics: keyboard-driver, mouse-driver, tourbox, tourbox-neo, uinput
- Language: C++
- Homepage: https://www.tourboxtech.com/en/product.html
- Size: 698 KB
- Stars: 27
- Watchers: 3
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# About
This is a simple Linux driver (written in C++) for the [Tourbox Neo](https://www.tourboxtech.com/en/product.html). (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.
```bash
$ 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.