input/devices/xpad.rst

2 xpad - Linux USB driver for Xbox compatible controllers
5 This driver exposes all first-party and third-party Xbox compatible
6 controllers. It has a long history and has enjoyed considerable usage
11 This only affects Original Xbox controllers. All later controller models
14 Rumble is supported on some models of Xbox 360 controllers but not of
15 Original Xbox controllers nor on Xbox One controllers. As of writing
16 the Xbox One's rumble protocol has not been reverse-engineered but in
25 - if you are using a known controller
26 - if you are using a known dance pad
27 - if using an unknown device (one not listed below), what you set in the
28   module configuration for "Map D-PAD to buttons rather than axes for unknown
33 If you said Y it will map the d-pad to buttons, which is needed for dance
39 unknown controllers.
42 Normal Controllers
43 ------------------
46 The jstest-program from joystick-1.2.15 (jstest-version 2.1.0) will report 8
49 All 8 axes work, though they all have the same range (-32768..32767)
50 and the zero-setting is not correct for the triggers (I don't know if that
64 ---------------
69 have been made.  The old driver would map the d-pad to axes, resulting
73 Known dance pads automatically map the d-pad to buttons and will work
77 of buttons, see section 0.3 - Unknown Controllers
82 Unknown Controllers
83 -------------------
95 All generations of Xbox controllers speak USB over the wire.
97 - Original Xbox controllers use a proprietary connector and require adapters.
98 - Wireless Xbox 360 controllers require a 'Xbox 360 Wireless Gaming Receiver
100 - Wired Xbox 360 controllers use standard USB connectors.
101 - Xbox One controllers can be wireless but speak Wi-Fi Direct and are not
103 - Xbox One controllers can be wired and use standard Micro-USB connectors.
108 --------------------------
137 .. code-block:: none
141     D:  Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS=32 #Cfgs=  1
144     I:  If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=(none)
148 .. code-block:: none
152     D:  Ver= 1.10 Cls=00(>ifc ) Sub=00 Prot=00 MxPS= 8 #Cfgs=  1
156     I:  If#= 0 Alt= 0 #EPs= 2 Cls=58(unk. ) Sub=42 Prot=00 Driver=xpad
161 Supported Controllers
164 For a full list of supported controllers and associated vendor and product
167 As of the historic version 0.0.6 (2006-10-10) the following devices
176 Unrecognized models of Xbox controllers should function as Generic
177 Xbox controllers. Unrecognized Dance Pad controllers require setting
180 If you have an unrecognized controller please see 0.3 - Unknown Controllers
207     http://euc.jp/periphs/xbox-controller.ja.html.
209 His useful info and both the usb-skeleton as well as the iforce input driver
210 (Greg Kroah-Hartmann; Vojtech Pavlik) helped a lot in rapid prototyping
218 .. [1] http://euc.jp/periphs/xbox-controller.ja.html (ITO Takayuki)
219 .. [2] http://xpad.xbox-scene.com/
227 2002-07-16 - Marko Friedemann <mfr@bmx-chemnitz.de>
228  - original doc
230 2005-03-19 - Dominic Cerquetti <binary1230@yahoo.com>
231  - added stuff for dance pads, new d-pad->axes mappings
234 'git log --follow Documentation/input/devices/xpad.rst'