|
|
@@ -2,20 +2,33 @@
|
|
2
|
2
|
|
|
3
|
3
|
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.
|
|
4
|
4
|
|
|
5
|
|
-Depending on the USB-Serial converter stick included with your Transmitter, you may need to install the [SiLabs CP210x driver](https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx).
|
|
|
5
|
+####This software has been tested on the following versions of OS X:
|
|
|
6
|
+ * 10.10.x (Yosemite)
|
|
|
7
|
+ * 10.11.x (El Capitan)
|
|
6
|
8
|
|
|
7
|
|
-You also need to install the virtual userspace IOKit HID driver [foohid](https://github.com/unbit/foohid).
|
|
|
9
|
+## Installation
|
|
|
10
|
+### USB to Serial Driver
|
|
|
11
|
+Depending on the USB-Serial cable included with your Transmitter, you may need to install the [SiLabs CP210x driver](https://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx).
|
|
8
|
12
|
|
|
9
|
|
-Download the latest release (**already including foohid**) [here on GitHub](https://github.com/xythobuz/SerialGamepad/releases).
|
|
|
13
|
+You can verify that this is working by running the following command in a terminal:
|
|
10
|
14
|
|
|
11
|
|
-This software has been tested on OS 10.10 (Yosemite) and 10.11 (El Capitan).
|
|
|
15
|
+`ls /dev/ | grep 'tty\.'`
|
|
|
16
|
+
|
|
|
17
|
+You should see something that looks like `tty.USBtoUARTBridge`. If you don't see something like that displayed, you either have an issue with the driver for your serial adapter (try reinstalling it) or you have a different serial adapter and you'll need to find the drivers for that. To see what adapter is registring with OS X, Apple => About This Mac => System Report => USB.
|
|
|
18
|
+
|
|
|
19
|
+### Package File
|
|
|
20
|
+Next you'll need to download and install the latest release of the Gamepad Driver (**includes foohid**) [here on GitHub](https://github.com/xythobuz/SerialGamepad/releases).
|
|
|
21
|
+
|
|
|
22
|
+_Note: You need to make sure to install the virtual userspace IOKit HID driver [foohid](https://github.com/unbit/foohid). This should be already be done if you install the .pkg_
|
|
12
|
23
|
|
|
13
|
24
|
## SerialGamepad GUI App
|
|
14
|
25
|
|
|
15
|
|
-This app can connect to a compatible transmitter over a serial port and then provide a virtual gamepad using fooHID.
|
|
|
26
|
+This app allows a compatible transmitter to connect over a serial port and then provide a virtual gamepad using fooHID. In the app, select your serial port from the dropdown list. (It should be the same one from the section above.) Next, click connect. If everything is working you should see the signals coming from the transmitter via the green bars. (See below) If it doesn't connect, make sure that you have your reciever turned on.
|
|
16
|
27
|
|
|
17
|
28
|
|
|
18
|
29
|
|
|
|
30
|
+_NOTE: Make sure to keep the SerialGamepad app running and connected when you start your simulator._
|
|
|
31
|
+
|
|
19
|
32
|
## foohid command-line app
|
|
20
|
33
|
|
|
21
|
34
|
This small utility does the same thing as the SerialGamepad.app without a graphical user interface.
|
|
|
@@ -26,7 +39,7 @@ This small utility only reads the channel values from a serial port and pretty-p
|
|
26
|
39
|
|
|
27
|
40
|
# For Developers
|
|
28
|
41
|
|
|
29
|
|
-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.
|
|
|
42
|
+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.
|
|
30
|
43
|
|
|
31
|
44
|
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`.
|
|
32
|
45
|
|
Carl Krauss
8 years ago