patch-2.4.0-test2 linux/Documentation/joystick-parport.txt

Next file: linux/Documentation/joystick.txt
Previous file: linux/Documentation/ioctl-number.txt
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.0-test1/linux/Documentation/joystick-parport.txt linux/Documentation/joystick-parport.txt
@@ -1,5 +1,5 @@
-		  Linux Joystick parport drivers v1.2 BETA
-	       (c) 1998-1999 Vojtech Pavlik <vojtech@suse.cz>
+		    Linux Joystick parport drivers v2.0
+	       (c) 1998-2000 Vojtech Pavlik <vojtech@suse.cz>
 	       (c) 1998 Andree Borrmann <a.borrmann@tu-bs.de>
 			     Sponsored by SuSE
 ----------------------------------------------------------------------------
@@ -39,7 +39,7 @@
 lines of the parallel port are shared, while one of 5 available input lines
 is assigned to each gamepad.
 
-  This protocol is handled by the joy-console.c driver, so that's the one
+  This protocol is handled by the gamecon.c driver, so that's the one
 you'll use for NES and SNES gamepads.
 
   The main problem with PC parallel ports is that they don't have +5V power
@@ -199,9 +199,9 @@
 
   And there were many others.
 
-2.2.1 Multisystem joysticks using joy-db9.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-  For the Multisystem joysticks, and their derivatives, the joy-db9.c driver
+2.2.1 Multisystem joysticks using db9.c
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+  For the Multisystem joysticks, and their derivatives, the db9.c driver
 was written. It allows only one joystick / gamepad per parallel port, but
 the interface is easy to build and works with almost anything.
 
@@ -236,25 +236,25 @@
   And that's it.
 
   On a side note, if you have already built a different adapter for use with
-the digital joystick driver 0.8.0.2, this is also supported by the joy-db9.c
+the digital joystick driver 0.8.0.2, this is also supported by the db9.c
 driver, as device type 8. (See section 3.2)
 
-2.2.2 Multisystem joysticks using joy-console.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+2.2.2 Multisystem joysticks using gamecon.c
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   For some people just one joystick per parallel port is not enough, and/or
-want to use them on one parallel port together with NES/SNES/PSX pads. This
-is possible using the joy-console.c. It supports up to 5 devices of the
-above types, including 1 and 2 buttons Multisystem joysticks.
+want to use them on one parallel port together with NES/SNES/PSX pads. This is
+possible using the gamecon.c. It supports up to 5 devices of the above types,
+including 1 and 2 buttons Multisystem joysticks.
 
   However, there is nothing for free. To allow more sticks to be used at
 once, you need the sticks to be purely switch based (that is non-TTL), and
 not to need power. Just a plain simple six switches inside. If your
 joystick can do more (eg. turbofire) you'll need to disable it totally first
-if you want to use joy-console.c.
+if you want to use gamecon.c.
 
   Also, the connection is a bit more complex. You'll need a bunch of diodes,
 and one pullup resistor. First, you connect the Directions and the button
-the same as for joy-db9, however with the diodes inbetween.
+the same as for db9, however with the diodes inbetween.
 
 	    Diodes
 (pin 2) -----|<|----> Up
@@ -278,17 +278,17 @@
 
   And that's all, here we go!
 
-2.2.3 Multisystem joysticks using joy-turbografx.c
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+2.2.3 Multisystem joysticks using turbografx.c
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   The TurboGraFX interface, designed by
 
 	Steffen Schwenke <schwenke@burg-halle.de>
 
   allows up to 7 Multisystem joysticks connected to the parallel port. In
-Steffen's version, there is support for up to 5 buttons per joystick.
-However, since this doesn't work reliably on all parallel ports, the
-joy-turbografx.c driver supports only one button per joystick. For more
-information on how to build the interface, see
+Steffen's version, there is support for up to 5 buttons per joystick.  However,
+since this doesn't work reliably on all parallel ports, the turbografx.c driver
+supports only one button per joystick. For more information on how to build the
+interface, see
 
 	http://www2.burg-halle.de/~schwenke/parport.html
 
@@ -298,7 +298,7 @@
   WARNING: PSX support is experimental, and at the moment doesn't seem to
 work for most people. If you like adventure, you can try yourself.
 
-  The PSX controller is supported by the joy-console.c.
+  The PSX controller is supported by the gamecon.c.
 
 Pinout of the PSX controller (compatible with DirectPadPro):
 
@@ -328,7 +328,7 @@
 ~~~~~~~~
   All the Sega controllers are more or less based on the standard 2-button
 Multisystem joystick. However, since they don't use switches and use TTL
-logic, the only driver useable with them is the joy-db9.c driver.
+logic, the only driver useable with them is the db9.c driver.
 
 2.4.1 Sega Master System
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -377,13 +377,13 @@
 
 (pin 14) -----> Select
 
-  The rest is the same as for Multi2 joysticks using joy-db9.c
+  The rest is the same as for Multi2 joysticks using db9.c
 
 2.4.3 Sega Saturn
 ~~~~~~~~~~~~~~~~~
   Sega Saturn has eight buttons, and to transfer that, without hacks like
 Genesis 6 pads use, it needs one more select pin. Anyway, it is still
-handled by the joy-db9.c driver. Its pinout is very different from anything
+handled by the db9.c driver. Its pinout is very different from anything
 else.  Use this schematic:
 
     +-----------> Select 1
@@ -409,7 +409,7 @@
 (pin 16) -----> Select 2
 
   The other pins (Up, Down, Right, Left, Power, Ground) are the same as for
-Multi joysticks using joy-db9.c
+Multi joysticks using db9.c
 
 3. The drivers
 ~~~~~~~~~~~~~~
@@ -417,16 +417,14 @@
 described above, allows to connect a different group of joysticks and pads.
 Here are described their command lines:
 
-3.1 joy-console.c
-~~~~~~~~~~~~~~~~~
-  Using joy-console.c you can connect up to five devices to one parallel
-port. It uses the following kernel/module command line:
+3.1 gamecon.c
+~~~~~~~~~~~~~
+  Using gamecon.c you can connect up to five devices to one parallel port. It
+uses the following kernel/module command line:
 
-	js_console=port,pad1,pad2,pad3,pad4,pad5
+	gc=port,pad1,pad2,pad3,pad4,pad5
 
-  Where 'port' is either the address of the parallel port the joystick/pad
-is connected to (eg. 0x378), or, if you are using the parport driver of 2.1+
-Linux kernels, the number of the parport interface (eg. 0 for parport0).
+  Where 'port' the number of the parport interface (eg. 0 for parport0).
 
   And 'pad1' to 'pad5' are pad types connected to different data input pins
 (10,11,12,13,15), as described in section 2.1 of this file.
@@ -442,47 +440,22 @@
 	  5  | Multisystem 2-button joystick
 	  6  | Sony PSX controller
 	  7  | N64 pad
-	  8  | N64 pad with direction pad as buttons (DirectPadPro style)
 
   The exact type of the PSX controller type is autoprobed, so you must have
 your controller plugged in before initializing.
 
-  Should you want to use more than one of parallel ports at once, you can
-use js_console_2 and js_console_3 as additional command line parameters for
-two more parallel ports.
-
-  Changes:
-    v0.1  : First version (SNES only)
-    v0.2  : X/Y directions were exchanged...
-    v0.3  : Adaptation for kernel 2.1
-    v0.4  : Adaptation for joystick-1.2.6
-	    - added open/close callbacks
-    v0.5  : Renamed to "joy-console" because I have added
-	    PSX controller support.
-    v0.6  : NES support
-    v0.7V : Added "multi system" support
-    v0.8  : Bugfixed PSX driver...
-    v0.9V : Changed multi system support
-	    Added Multi2 support
-	    Fixed parport handling
-	    Cleaned up
-    v0.10 : Fixed PSX buttons 8 and 9
-    v0.11V: Switched to EXCL mode
-	    Removed wakeup
-    v0.12V: Added N64 support
-    v0.13V: Updated N64 support
-    v0.14V: Fixed N64 axis/button counts
+  Should you want to use more than one of parallel ports at once, you can use
+gc_2 and gc_3 as additional command line parameters for two more parallel
+ports.
 
-3.2 joy-db9.c
-~~~~~~~~~~~~~
+3.2 db9.c
+~~~~~~~~~
   Apart from making an interface, there is nothing difficult on using the
-joy-db9.c driver. It uses the following kernel/module command line:
+db9.c driver. It uses the following kernel/module command line:
 
-	js_db9=port,type
+	db9=port,type
 
-  Where 'port' is either the address of the parallel port the joystick/pad
-is connected to (eg. 0x378), or, if you are using the parport driver of 2.1+
-Linux kernels, the number of the parport interface (eg. 0 for parport0).
+  Where 'port' is the number of the parport interface (eg. 0 for parport0).
 
   Caveat here: This driver only works on bidirectional parallel ports. If
 your parallel port is recent enough, you should have no trouble with this.
@@ -500,39 +473,26 @@
 	  6  | Genesis pad (6+2 buttons)
 	  7  | Saturn pad (8 buttons)
 	  8  | Multisystem 1-button joystick (v0.8.0.2 pin-out)
-	  9  | Two Multiststem 1-button joysticks (v0.8.0.2 pin-out) 
+	  9  | Two Multisystem 1-button joysticks (v0.8.0.2 pin-out) 
+	 10  | Amiga CD32 pad
 
   Should you want to use more than one of these joysticks/pads at once, you
-can use js_db9_2 and js_db9_3 as additional command line parameters for two
+can use db9_2 and db9_3 as additional command line parameters for two
 more joysticks/pads.
 
-  Changes:
-    v0.1 : First version
-    v0.2 : Changed kernel parameter format
-    v0.3V: Added Sega Saturn support
-	   Fixed parport and PS/2 mode handling
-	   Cleaned up
-    v0.4V: Switched to EXCL mode
-           Removed wakeup
-    v0.5V: Added 0.8.0.2 HW compatibility for Multi sticks
-    v0.6V: Better timing for Genesis 6
-    v0.7V: Added 0.8.0.2 second joystick support
-
-3.3 joy-turbografx.c
-~~~~~~~~~~~~~~~~~~~~
-  The joy-turbografx.c driver uses a very simple kernel/module command line:
+3.3 turbografx.c
+~~~~~~~~~~~~~~~~
+  The turbografx.c driver uses a very simple kernel/module command line:
 
-	js_tg=port,js1,js2,js3,js4,js5,js6,js7
+	tgfx=port,js1,js2,js3,js4,js5,js6,js7
 
-  Where 'port' is either the address of the parallel port the interface is
-connected to (eg. 0x378), or, if you are using the parport driver of 2.1+
-Linux kernels, the number of the parport interface (eg. 0 for parport0).
+  Where 'port' is the number of the parport interface (eg. 0 for parport0).
 
   'jsX' is the number of buttons the Multisystem joysticks connected to the
 interface ports 1-7 have. For a standard multisystem joystick, this is 1.
 
   Should you want to use more than one of these interfaces at once, you can
-use js_tg_2 and js_tg_3 as additional command line parameters for two more
+use tgfx_2 and tgfx_3 as additional command line parameters for two more
 interfaces.
 
 3.4 PC parallel port pinout
FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)