patch-2.1.126 linux/Documentation/joystick.txt
Next file: linux/Documentation/mca.txt
Previous file: linux/Documentation/joystick-parport.txt
Back to the patch index
Back to the overall index
- Lines: 131
- Date:
Wed Oct 21 08:43:33 1998
- Orig file:
v2.1.125/linux/Documentation/joystick.txt
- Orig date:
Fri Oct 9 13:27:04 1998
diff -u --recursive --new-file v2.1.125/linux/Documentation/joystick.txt linux/Documentation/joystick.txt
@@ -1,12 +1,9 @@
- Linux Joystick driver v1.2.11 BETA
+ Linux Joystick driver v1.2.12
(c) 1996-1998 Vojtech Pavlik <vojtech@ucw.cz>
----------------------------------------------------------------------------
0. Disclaimer
~~~~~~~~~~~~~
- This is a BETA release. It probably will work well for you, but it doesn't
-have to.
-
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
@@ -25,7 +22,7 @@
- mail your message to <vojtech@ucw.cz>, or by paper mail: Vojtech Pavlik,
Ucitelska 1576, Prague 8, 182 00 Czech Republic
- For your convenience, the GNU General Public Licens version 2 is included
+ For your convenience, the GNU General Public License version 2 is included
in the package: See the file COPYING.
1. Intro
@@ -36,19 +33,19 @@
These currently include various analog joysticks (both variable resistor
based and microswitch+resistor based), following IBM PC joystick standard,
with extensions like additional hats and buttons compatible with CH
-Flightstick Pro, ThrustMaster FCS or PC 6 or 8 button gamepads.
+Flightstick Pro, ThrustMaster FCS or 6 and 8 button gamepads.
In addition to these it also supports some of the new PC joysticks that
-use porprietary digital protocols to communicate over the gameport,
-currently by FPGaming, Genius, Gravis, Logitech, MadCatz and Microsoft.
-ThrustMaster and Creative Labs protocols are in the works.
+use proprietary digital protocols to communicate over the gameport,
+currently by FPGaming, Genius, Gravis, Logitech, MadCatz, Microsoft and
+ThrustMaster. Creative Labs protocol support is still to be done.
The driver also includes support for many gamepads and joysticks that were
used by various non-PC computers and game consoles. These include Multi
system joysticks (Atari, Amiga, Commodore, Amstrad), Sega gamepads (Master
System, Genesis, Saturn), Nintendo gamepads (NES, SNES), Sony gamepads (PSX).
Support for N64, Atari Jaguar, Atari 2600, NES FourScore, SNES MultiTap,
-Pegasus, PSX NegCon and others might be added later.
+PSX NegCon and others might be added later.
Last, but not least there is also native Amiga joystick support for the
Amiga linux port.
@@ -92,24 +89,23 @@
module at once, if you have more than one joystick installed.
If you want to have the driver compiled into your kernel, you first need
-to patch the kernel. For that, use either kernel-2.0.35.patch, or
-kernel-2.1.115.patch files, that are included in the joystick package, and
-using the command
+to patch the kernel, so that it contains the current driver version. You do
+that with a command:
- patch -Esp1 < /usr/src/joystick-1.2.x/kernel-2.x.y.patch
+ patch -Esp1 < /usr/src/joystick-1.2.x/kernel-2.x.y.diff
in
/usr/src/linux
-apply the patch to your kernel. To compile joystick support into the kernel,
-use the kernel configuration scripts, and answer 'Y' to Joystick support and
-also to at least one of the hardware specific options.
-
- After patching the kernel you can also compile it as a module, answering
-'M' to all joystick support you want to have modules for. It is possible to
-have the main joystick driver compiled into the kernel and the hardware
-dependent drivers as modules.
+ To compile joystick support into the kernel, use the kernel configuration
+scripts, and answer 'Y' to Joystick support and also to at least one of the
+hardware specific options.
+
+ You can also compile the driver as modules, answering 'M' to all joystick
+support you want to have modules for. It is possible to have the main
+joystick driver compiled into the kernel and the hardware dependent drivers
+as modules.
After you're done with installation of the driver itself, you'll need to
create the joystick device files in /dev so that applications can use them.
@@ -128,7 +124,7 @@
* 2-axis, 4-button joystick
* 3-axis, 4-button joystick
-* Two 2-axis, 2-buttons joysticks on an Y-cable
+* Two 2-axis, 2-button joysticks on an Y-cable
For other joystick types (more/less axes, hats, and buttons) support
you'll need to specify the types either on the kernel command line or on the
@@ -155,12 +151,12 @@
9 | 512 | CHF Hat 1
10 | 1024 | CHF Hat 2
11 | 2048 | FCS Hat
- 12 | 4096 | PXY Button X
- 13 | 8192 | PXY Button Y
- 14 | 16384 | PXY Button U
- 15 | 32768 | PXY Button V
+ 12 | 4096 | Pad Button X
+ 13 | 8192 | Pad Button Y
+ 14 | 16384 | Pad Button U
+ 15 | 32768 | Pad Button V
-(CHF = CH Flightstick Pro, FCS = ThrustMaster FCS, PXY - Pad with 6 or 8 buttons)
+(CHF = CH Flightstick Pro, FCS = ThrustMaster FCS)
Following is a table of joysticks for which the 'm' values are known. If
you have any additions/corrections to it, e-mail me.
@@ -176,6 +172,7 @@
Laing #1 PC SuperPad | 0xf0f3
Microsoft SideWinder Standard | 0x003b
QuickShot QS-201 SuperWarrior | 0x00fb
+ Saitek Megapad XII | 0x30f3
In case you have one of the joystick in the table below, and it doesn't
work with a specific driver in digital mode for some reason, you can use
@@ -470,9 +467,9 @@
1.1.3 Leslie F. Donaldson <donaldlf@cs.rose-hulman.edu>
1.2.0 Eng-Jon Ong <ongej@dcs.qmw.ac.uk>
1.2.8 Ragnar Hojland Espinosa <ragnar@lightside.ddns.org>
- 1.2.3-1.2.9 Andree Borrmann <a.borrmann@tu-bs.de>
1.1.0-1.2.9 Brian Gerst <bgerst@quark.vpplus.com>
- 0.9.0-1.2.11 Vojtech Pavlik <vojtech@ucw.cz>
+ 1.2.3-1.2.12 Andree Borrmann <a.borrmann@tu-bs.de>
+ 0.9.0-1.2.12 Vojtech Pavlik <vojtech@ucw.cz>
If you think you should be in this list and are not, it's possible that
I forgot to include you - contact me and I'll correct the error. :)
FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen, slshen@lbl.gov