Mac OS X gamepad emulator for serial RC transmitters
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 2.6KB

Mac OS X Gamepad Driver for Flysky compatible transmitters

This project emulates a virtual Gamepad using input data from a serial port. This can be used to enable Flysky CT6A / CT6B compatible transmitters (Turbobrix, Exceed, Modelcraft) in games or simulators.

Depending on the USB-Serial converter stick included with your Transmitter, you may need to install the SiLabs CP210x driver.

You also need to install the virtual userspace IOKit HID driver foohid.

Download the latest release (already including foohid) here on GitHub.

This software has been tested on OS 10.10 (Yosemite) and 10.11 (El Capitan).

SerialGamepad GUI App

This app can connect to a compatible transmitter over a serial port and then provide a virtual gamepad using fooHID.

Screenshot

foohid command-line app

This small utility does the same thing as the SerialGamepad.app without a graphical user interface.

protocol command-line app

This small utility only reads the channel values from a serial port and pretty-prints them to a POSIX compatible terminal.

For Developers

You don’t need to use the included Makefile if you want to change something in the GUI App. Just directly open the XCode project file.

However, the makefile allows you not only to build the GUI app, but also a distributable Installer including the foohid dependency. For this, just run make distribute. The finished installer will be placed in bin/SerialGamepad.pkg.

To build the command-line apps and the GUI apps, just run make all. You can also install all of them using sudo make install. The cli-binaries will go to /usr/local/bin, the App to /Applications.

Other Resources

Licensing

----------------------------------------------------------------------------
"THE BEER-WARE LICENSE" (Revision 42):
<xythobuz@xythobuz.de> wrote this file.  As long as you retain this notice
you can do whatever you want with this stuff. If we meet some day, and you
think this stuff is worth it, you can buy me a beer in return.   Thomas Buck
----------------------------------------------------------------------------