|
 |
|
PICjoy Operations
(v 0.92)
(Windows XP only at this time)
|
Downloads:
Copyright
notice:
-
PPjoy is
copyrighted by Deon van der Westhuysen. Free for personal use.
-
PICjoy is
copyrighted by TTi, Inc. Free for personal use. May not be distributed
without permission.
Please do not
hot link to download files, linking to this page is encouraged since
instructions will be updated often. |
|

|
Introduction: At least a few
times a week, I would get the question: "would this cable works with G2?". I
can finally answer YES (at least for the non-interlink version).
PICjoy is a
joystick emulator software that processes the Serial-PIC protocol and sends
the decoded PPM signals (stick positions) to a HID (human interface device)
compliant virtual joystick under the Windows environment. PICjoy uses the
PPjoy Device Driver (parallel port joystick driver) created by
Deon van der Westhuysen (and is free for
personal use). You can download both PPJoy and PICjoy using the links above.
From most Windows applications that use the joystick as
input, PICjoy will allow using the transmitter and a Serial-PIC protocol
interface cable as the controller (such as our popular PIC-Serial and USB
cables). Yes it will work with Realflight G2 (non-interlink version) and
others. With PICjoy, you can now use the PIC-Serial and USB
interfaces with other popular simulators.
Summary of Setting up PICjoy:
- Install PPJoy Drivers
- Create a Virtual Joystick using PPJoy
- Install PICjoy (automatic if you install FMS
Additional Scenes)
- Change PICjoy mapping Parameters to match stick
motion with joystick axis or buttons
- Calibrate your "joystick" under the Windows Control
Panel - Game Controller applet.
Summary of Using PICjoy:
- Run PICjoy [GO]
- Run your Windows application that uses joystick as
input, the input from your transmitter will be translated and mapped to
axis and buttons on a joystick.
Also important is the PPM channel assignment from your
transmitter. Depending on your transmitter type:
|
Mode 2 Channel Assignment |
PPM
Chan |
Futaba
AM |
Futaba
FM |
Airtronics |
JR |
Joystick
Axis |
| 1 |
Ail |
Ail |
Elev |
Thro |
1->X |
| 2 |
Thro |
Elev |
Ail |
Ail |
2->Y |
| 3 |
Elev |
Thro |
Thro |
Elev |
5->Slider2 |
| 4 |
Rud |
Rud |
Rud |
Rud |
4->Z-rotation |
|
| |
Installation:
PPJoy Drivers
You will need to download and install the PPJoy driver
first. The downloaded file for PPJoy is a zipped file: PPJoySetup.zip.
Extract this file to a temporary location and run the Setup.exe installer
from that location. Please check the above download location (and alternate
location) for installation instructions for PPJoy. For most systems, the
installation will be straight forward (just click OK, then Next, Next,....)
PICjoy
If you
received our latest CD, then PICjoy is automatically installed with the additional
Scenes and Models installation. For users who downloaded the program from our web-site,
just unzip and copy the PICjoy.exe file to any folder, such as the default installation folder of
FMS or BackYard EditionXL.
|
| |
Using PICjoy
Creating Virtual Joystick with PPjoy
Before starting PICjoy, a virtual joystick must
be created using PPJoy. If you've installed PPJoy, you can access the
[Parallel Port Joysticks] applet in the Control Panel. |
| |
Parallel Port Joysticks applet in Control Panel |
| |
 |
At first start, the Configured joysticks box is
empty, click [Add] |
|
| |
 |
For the Parallel port section, select [Virtual
port]; and for the Controller number, select [Controller 1]. Then click
[Add] |
|
| |
 |
The installation wizard for [Parallel Port
Joystick 1] will start. Click [Next >] |
|
| |
|
| |
 |
At the Windows Logo compatibility warning, click
[Continue Anyway] |
|
| |
 |
Copying files |
|
| |
 |
At the completion of installing [Parallel Port
Joystick 1], click [Finish] |
|
| |
 |
Then the installation wizard for [HID-compliant
game controller] will start. Click [Next >] |
|
| |
 |
Copying Files |
|
| |

|
At the completion of installing [HID-compliant
game controller], click [Finish]. You are
DONE with creating the Virtual Joystick |
|
| |
PICjoy Running Screens
Main PICjoy Screen


|
- COM value
This is the com port where the PIC-Serial is connected (usually COM1
or COM2) or USB cable Com port assigned by the USB driver (usually
COM3 or COM4)
- GO button
Start the joystick emulation session. While the session is active, the
caption will show [active] and the status bar at bottom will show the
number of detected PPM channels
- btn checkbox
Manually issue a button pressed (checked) or release (unchecked), as
if a button is pressed and release (fire) on the joystick, this is
handy for the traversing the Windows Game Controller calibration.
- Enable Meters checkbox
Show the PPM pulse width as it is being processed. This is usually
used for trouble shooting and to get "mid-stick" pulse value. Disable
this option once everything is running properly (to save system
resources)
- Status bar (bottom)
Running status or any error messages.
- Param button
Launch the PICjoy Parameters dialogbox (see below), where you can
change the mapping assignment of the PPM pulse-width (transmitter
motion) to Joystick motion.
To quit PICjoy, you will neet to [STOP] first |
|
| |
PICjoy Parameters
 |
PPM Mapping
- JoyStick dropdown combobox
You can assign PPM pulses 1 ~ 8 to a JoyStick
action: axis1~8 or button1~4. The JoyStick action must be unique for
PPM1 to 8. Duplication of JoyStick action will yield unpredictable
results.
- inv checkbox
Invert the direction of control.
- mid value
The mid value is the PPM number (see Enable Meters above) where
the stick motion is at mid travel.
The mid value is used in two cases:
- JoyStick action is a button. Then the mid
value is used to indicate when the button is pressed (less than mid)
or released (greater or equal to mid)
- inv is used (invert direction of control).
This is mid point of the invert. Note: you can invert a button
action.
|
|
| |
Error Messages


|
- Error opening COM port [COM#]
Where # is the Com port number. This error
occurs when the Com port is invalid, either the port does not exist or
is being used by another application.
- Unable to connect to PPJoy
Driver
This error occurs when the PPJoy driver is not available or not
properly installed. See PPJoy installation above. The Virtual Joystick
must be created.
|
|
| |
Calibrating the "JoyStick"
 |
Before using the "JoyStick", you must
calibrate the joystick travels using the [Game Controllers] Control Panel Applet.
You must start PICjoy and click [GO] before running the calibration.
It's best if you have PICjoy and Game Controller running next to each
other on screen. |
|
| |
|
  |
Select [PPJoy Virtual joystick 1].
This is the Virtual Joystick installed earlier by PPJoy. Then click
[Properties] |
|
| |
|
 |
The Virtual Joystick is set up with 8
axis and 16 buttons. Something like the mother of all joysticks.
PICjoy will only control 8 axis and 4 buttons, and
will only use a total of 8 items (axis + buttons) so some axis and
buttons will be be used. However, we still need to go through the entire
calibration routine for this monster (virtual) joystick.
Some trial and errors may be required for assigning
the correct PPM pulse to the appropriate axis or button for proper
functions in the final Windows app.
At this point, select the [Settings] tab |
|
| |
|
 |
And click [Calibrate] |
|
| |
|
 |
To move to the next Calibration step,
you will need to "press a button" on the joystick. You can do this by:
- Moving any PPM axis that's mapped to a button
(see PICjoy Parameters above)
- Check and un-Check the btn
checkbox on the PICjoy screen. This is always mapped to the
button 4
- For Windows XP, you can move to the next screen
by clicking [Next >]
|
|
| |
|
 |
If you're flying mode 2, the
first two axis, X and Y, should be the right stick. Depending on your
Transmitter type, the correct PPM channel must be assigned to the
correct Axis. For example, Futaba FM Mode 2 radios:
PPM 1►Aileron►X
Axis
(see Mode 2 Channel Assignment above)
Follow the instructions on screen move the stick in
complete circles (actually square). |
|
| |
|
 |
The next few steps will
be for calibrating the other Axis, not all of which will be used,
including: Z, X-Rotation, Y-Rotation, Z-Rotation, Slider 1, and Slider
2. Which axis to use and which to skip is
a trial and error process, depending on the final Windows application
that will be using the "Joystick".
For the case of G2, the Throttle should be mapped
to Slider 2 (Axis 5); and Rudder should be mapped to Z-rotation (Axis 4)
|
 |
 |
|
| |
|

|
Finally, click [Finish] to complete
the Windows Game Controller Calibration. Make sure to click [OK] in the
end to apply the calibration parameters to the system.
You are now ready to use your calibrated "Joystick" in
most Windows application that accept input from a joystick. |
|
| |
Using PICjoy with other Simulators
Realflight G2
Please note the only G2 version that will work is the
standard version (that accepts input from joystick), not the interlink
version.
|
| |
|
 |
Recommended Futaba PICjoy channel
mapping for G2 (other transmitters may be slightly different). Please
note PPM channel 3 (futaba throttle) is mapped to joystick
axis 5. PPM channels 5 to
8 are mapped to buttons 1~4. This will correspond to G2 input channel
5~8 (aux), which are button controls.
Also to map your gear (usually PPM5)
to button 3 to operate the gear. |
|
| |
|
  |
Before running G2, connect your
interface cable to the transmitter, start PICjoy and activate by clicking [GO]. Once you've verified PICjoy is
properly receiving the signals, you can turn off [Enable Meters] and minimize PICjoy. |
|
| |
|
 |
Start G2, select the [Options] menu,
then [Controller Calibration] to start the Calibration dialogbox. |
|
| |
|
 |
For Controller Type, select [PPJoy
Virtual joystick 1 Joystick] For Stick
Mapping, select [Custom]
Go through the Calibration step as usual by
clicking [Calibrate] |
|
| |
|
 |
If necessary, you can access the
[Advanced Setup] for further customization, such as changing the
direction of control by checking [Reverse the direction] |
|
| |
|
| |
Pre-Flight 1.95
Please note sub-sequent releases of Pre-Flight after version
1.95 no longer support third party input devices (such as joystick) |
| |
|
 |
Recommended Futaba PICjoy channel
mapping for PF195 (other transmitters may be slightly different. Only
the first four PPM channels are used. |
|
| |
|
  |
Before running PF195, connect your
interface cable to the transmitter, start PICjoy and activate by clicking [GO]. Once you've verified PICjoy is
properly receiving the signals, you can turn off [Enable Meters] and minimize PICjoy. |
|
| |
|
 |
For the first time running PF195, select the [Options] menu,
then [Interface] to start the Select Interface Port dialogbox.
|
|
| |
|
 |
For using PF195 with PICjoy, select
[none] |
|
| |
|
 |
Then select the [Controls] menu,
then [Joystick+Keys] to start the Configure Inputs dialogbox.
|
|
| |
|
 |
Note the
channel mapping. This example is for Futaba, other transmitters may be
slightly different.
-
Throttle
→ Joy Ch 03
-
Aileron
→ Joy Ch 01
-
Elevator
→ Joy Ch 02
-
Rudder
→ Joy Ch 06 *
To change the Joystick channel assignment, click on
the corresponding [Conf] button (see below). Also note the [rev]
checkbox for reverse operation.
The [Calibrate] button has no effect here, since
PF195 will use the windows joystick calibration values.
Click on [Test] to see if meters are responding
correctly. |
|
| |
|
 |
Joystick channel configuration. |
|
| |
* Tom's note: I don't know why the Rudder is mapped to
"Joy Ch 06" for proper operation. It seems PF195 does not use the standard
Windows enumeration of joystick axis numbers. |
| |
|