Hi!
Attached is a BK patch to add a new driver for X-Box gamepads. It's
fairly simple, and I think it can be put into the 2.5 tree.
--
Vojtech Pavlik
SuSE Labs
You can import this changeset into BK by piping this whole message to:
'| bk receive [path to repository]' or apply the patch as usual.
===================================================================
[EMAIL PROTECTED], 2002-07-12 16:28:28+02:00, [EMAIL PROTECTED]
Add a driver for X-Box gamepads. While they have quite normal
data format, they cannot be handled by HID, because they lack
the descriptors and have completely nonstandard interface class.
Documentation/input/xpad.txt | 84 ++++++++++
drivers/usb/input/Config.help | 14 +
drivers/usb/input/Config.in | 2
drivers/usb/input/Makefile | 1
drivers/usb/input/xpad.c | 330 ++++++++++++++++++++++++++++++++++++++++++
5 files changed, 430 insertions(+), 1 deletion(-)
diff -Nru a/Documentation/input/xpad.txt b/Documentation/input/xpad.txt
--- /dev/null Wed Dec 31 16:00:00 1969
+++ b/Documentation/input/xpad.txt Fri Jul 12 16:44:31 2002
@@ -0,0 +1,84 @@
+usb-xpad - Linux USB driver for XBOX HID gamecontrollers
+
+This is the very first release of a driver for XBOX gamecontrollers.
+Basically, this was hacked away in just a few hours, so don't expect
+miracles.
+
+0. Status
+---------
+
+For now, this driver has only been tested on just one Linux-Box.
+This one is running a 2.4.18 kernel with usb-uhci on an amd athlon 600.
+
+The jstest-program from joystick-1.2.15 (jstest-version 2.1.0) reports
+8 axes and 10 buttons.
+
+Alls 8 axes work, though they all have the same range (-32768..32767)
+and the zero-setting is not correct for the triggers.
+9 of the 10 buttons work (my black button does not work, though I can
+see no reason for it not to), all of them are in digital mode, though
+(the six buttons on the right side are "analog" ones).
+
+
+1. USB adapter
+--------------
+
+Before you can actually use the driver, you need to get yourself an
+adapter cable to connect the XBOX-controller to your Linux-Box.
+
+Such a cable is pretty easy to build. The Controller itself is a USB device
+(a hub with three ports; two expansion slots and the controller device)
+with the only differnce in a nonstandard connector (5 pins vs. 4 on
+standard USB connector).
+
+You just need to solder an USB connector onto the cable and keep the
+yellow wire unconnected. The other pins have the same order on both
+connectors so there no magic to it. Detailed info on these matters can be found
+on the net.
+
+Thanks to the trip splitter found on the cable you don't even need to cut the
+original cable, you can buy an extension cable and cut that instead. That way,
+you can still use the controller with your XBOX, if you have one ;)
+
+
+2. driver installation
+----------------------
+
+Once you have the adapter cable and the controller is connected, you need
+to load your USB subsystem and should cat /proc/bus/usb/devices.
+There should be an entry like the one in InterAct_german.dump.
+
+Don't worry if the vendor and/or product ID don't match, those are easy to
+add to the driver. You could do it yourself, just add the appropriate line
+into the list after the line
+ '} xpad_device[] = {'
+, but before the line that says
+ '{ 0x0000, 0x0000, "unknown...." }'.
+
+In theory, the driver should work with other controllers than mine
+(InterAct PowerPad pro, bought in Germany) just fine, but see for yourself.
+
+If you compiled and installed the driver, test the functionality:
+> modprobe usb-xpad
+> modprobe joydev
+> jstest /dev/input/js0
+
+There should be a single line showing 18 inputs (8 axes, 10 buttons), and
+it's values should change if you move the sticks and push the buttons.
+
+It works? Voila, your done ;)
+
+
+3. Thanks
+---------
+
+I have to thank ITO Takayuki for the detailed info on his site
+ http://euc.jp/periphs/xbox-controller.ja.html.
+
+His useful info and both the usb-skeleton as well as the iforce input driver
+helped a lot in rapid prototyping the basic functionality.
+
+
+--
+Marko Friedemann <[EMAIL PROTECTED]>
+2002-07-02
diff -Nru a/drivers/usb/input/Config.help b/drivers/usb/input/Config.help
--- a/drivers/usb/input/Config.help Fri Jul 12 16:44:31 2002
+++ b/drivers/usb/input/Config.help Fri Jul 12 16:44:31 2002
@@ -114,3 +114,17 @@
inserted in and removed from the running kernel whenever you want).
The module will be called powermate.o. If you want to compile it as a
module, say M here and read <file:Documentation/modules.txt>.
+
+CONFIG_USB_XPAD
+ Say Y here if you want to use the X-Box pad with your computer.
+ Make sure to say Y to "Joystick support" (CONFIG_INPUT_JOYDEV)
+ and/or "Event interface support" (CONFIG_INPUT_EVDEV) as well.
+
+ For information about how to connect the X-Box pad to USB, see
+ Documentation/input/xpad.txt.
+
+ This driver is also available as a module ( = code which can be
+ inserted in and removed from the running kernel whenever you want).
+ The module will be called wacom.o. If you want to compile it as a
+ module, say M here and read <file:Documentation/modules.txt>.
+
diff -Nru a/drivers/usb/input/Config.in b/drivers/usb/input/Config.in
--- a/drivers/usb/input/Config.in Fri Jul 12 16:44:31 2002
+++ b/drivers/usb/input/Config.in Fri Jul 12 16:44:31 2002
@@ -23,4 +23,4 @@
dep_tristate ' Aiptek 6000U/8000U tablet support' CONFIG_USB_AIPTEK $CONFIG_USB
$CONFIG_INPUT
dep_tristate ' Wacom Intuos/Graphire tablet support' CONFIG_USB_WACOM $CONFIG_USB
$CONFIG_INPUT
dep_tristate ' Griffin PowerMate and Contour Jog support' CONFIG_USB_POWERMATE
$CONFIG_USB $CONFIG_INPUT
-
+dep_tristate ' X-Box gamepad support' CONFIG_USB_XPAD $CONFIG_USB $CONFIG_INPUT
diff -Nru a/drivers/usb/input/Makefile b/drivers/usb/input/Makefile
--- a/drivers/usb/input/Makefile Fri Jul 12 16:44:31 2002
+++ b/drivers/usb/input/Makefile Fri Jul 12 16:44:31 2002
@@ -32,5 +32,6 @@
obj-$(CONFIG_USB_MOUSE) += usbmouse.o
obj-$(CONFIG_USB_WACOM) += wacom.o
obj-$(CONFIG_USB_POWERMATE) += powermate.o
+obj-$(CONFIG_USB_XPAD) += xpad.o
include $(TOPDIR)/Rules.make
diff -Nru a/drivers/usb/input/xpad.c b/drivers/usb/input/xpad.c
--- /dev/null Wed Dec 31 16:00:00 1969
+++ b/drivers/usb/input/xpad.c Fri Jul 12 16:44:31 2002
@@ -0,0 +1,330 @@
+/*
+ * USB XBOX HID Gamecontroller - v0.0.3
+ *
+ * Copyright (c) 2002 Marko Friedemann <[EMAIL PROTECTED]>
+ *
+ *
+ * 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) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ *
+ *
+ * This driver is based on:
+ * - information from http://euc.jp/periphs/xbox-controller.ja.html
+ * - the iForce driver drivers/char/joystick/iforce.c
+ * - the skeleton-driver drivers/usb/usb-skeleton.c
+ *
+ * Thanks to:
+ * - ITO Takayuki for providing xpad information on his website
+ * - Vojtech Pavlik - iforce driver / input subsystem
+ * - Greg Kroah-Hartman - usb-skeleton driver
+ *
+ * TODO:
+ * - get the black button to work
+ * - fine tune axes
+ * - fix "analog" buttons
+ * - get rumble working
+ *
+ * History:
+ *
+ * 2002-06-27 - 0.0.1 - first version, just said "XBOX HID controller"
+ *
+ * 2002-07-02 - 0.0.2 - basic working version
+ * all axes and 9 of the 10 buttons work (german InterAct device)
+ * the black button does not work
+ *
+ */
+
+#include <linux/config.h>
+#include <linux/kernel.h>
+#include <linux/input.h>
+#include <linux/sched.h>
+#include <linux/signal.h>
+#include <linux/errno.h>
+#include <linux/poll.h>
+#include <linux/init.h>
+#include <linux/slab.h>
+#include <linux/fcntl.h>
+#include <linux/module.h>
+#include <linux/spinlock.h>
+#include <linux/list.h>
+#include <linux/smp_lock.h>
+#include <linux/devfs_fs_kernel.h>
+#include <linux/usb.h>
+
+#define DRIVER_VERSION "v0.0.3"
+#define DRIVER_AUTHOR "Marko Friedemann <[EMAIL PROTECTED]>"
+#define DRIVER_DESC "X-Box pad driver"
+
+#define XPAD_PKT_LEN 32
+
+static struct xpad_device {
+ u16 idVendor;
+ u16 idProduct;
+ char *name;
+} xpad_device[] = {
+ { 0x045e, 0x0202, "Microsoft X-Box pad (US)" },
+ { 0x045e, 0x0285, "Microsoft X-Box pad (Japan)" },
+ { 0x05fd, 0x107a, "InterAct X-Box pad (Germany)" },
+ { 0x0000, 0x0000, "X-Box pad" }
+};
+
+static signed short xpad_btn[] = {
+ BTN_A, BTN_B, BTN_C, BTN_X, BTN_Y, BTN_Z, /* 6 "analog" buttons */
+ BTN_START, BTN_BACK, BTN_THUMBL, BTN_THUMBR, /* start/back + stick press */
+ -1 /* terminating entry */
+};
+
+static signed short xpad_abs[] = {
+ ABS_X, ABS_Y, /* left stick */
+ ABS_RX, ABS_RY, /* right stick */
+ ABS_Z, ABS_RZ, /* triggers left/right */
+ ABS_HAT0X, ABS_HAT0Y, /* dpad */
+ -1 /* terminating entry */
+};
+
+static struct {
+ __s32 x;
+ __s32 y;
+} xpad_hat_to_axis[] = { {0, 0}, {0, -1}, {1, -1}, {1, 0}, {1, 1}, {0, 1}, {-1, 1},
+{-1, 0}, {-1, -1} };
+
+static struct usb_device_id xpad_table [] = {
+ { USB_INTERFACE_INFO('X', 'B', 0) }, /* X-Box USB-IF not approved class */
+ { }
+};
+
+MODULE_DEVICE_TABLE (usb, xpad_table);
+
+struct usb_xpad {
+ struct input_dev dev; /* input device interface */
+ struct usb_device *udev; /* usb device */
+
+ struct urb *irq_in; /* urb for interrupt in report */
+ unsigned char idata[XPAD_PKT_LEN]; /* input data */
+
+ char phys[65]; /* physical device path */
+ int open_count; /* how many times has this been opened
+*/
+};
+
+/*
+ * xpad_process_packet
+ *
+ * Completes a request by converting the data into events for the input
+subsystem.
+ *
+ * The used report descriptor given below was taken from ITO Takayukis website:
+ * http://euc.jp/periphs/xbox-controller.ja.html
+ *
+ *
+----------------------------------------------------------------------------------------------------------------
+ * | padding | byte-cnt | dpad sb12 | reserved | bt A | bt B | bt X |
+bt Y | bt black | bt white |
+ * | 01234567 | 01234567 | 0123 4567 | 01234567 | 01234567 | 01234567 | 01234567 |
+01234567 | 01234567 | 01234567 |
+ * | 0 | 1 | 2 | 3 | 4 | 5 | 6 |
+7 | 8 | 9 |
+ *
+----------------------------------------------------------------------------------------------------------------
+ *
+ *
+---------------------------------------------------------------------------------------------------------------
+ * | trig L | trig R | left stick X | left stick Y | right
+stick X | right stick Y |
+ * | 01234567 | 01234567 | 01234567 | 01234567 | 01234567 | 01234567 | 01234567 |
+01234567 | 01234567 | 01234567 |
+ * | 10 | 11 | 12 | 13 | 14 | 15 | 16 |
+17 | 18 | 19 |
+ *
+---------------------------------------------------------------------------------------------------------------
+ */
+
+static void xpad_process_packet(struct usb_xpad *xpad, u16 cmd, unsigned char *data)
+{
+ struct input_dev *dev = &xpad->dev;
+
+ /* left stick */
+ input_report_abs(dev, ABS_X, (__s16) (((__s16)data[13] << 8) | data[12]));
+ input_report_abs(dev, ABS_Y, (__s16) (((__s16)data[15] << 8) | data[14]));
+
+ /* right stick */
+ input_report_abs(dev, ABS_RX, (__s16) (((__s16)data[17] << 8) | data[16]));
+ input_report_abs(dev, ABS_RY, (__s16) (((__s16)data[19] << 8) | data[18]));
+
+ /* triggers left/right */
+ input_report_abs(dev, ABS_Z, data[10]);
+ input_report_abs(dev, ABS_RZ, data[11]);
+
+ /* digital pad */
+ input_report_abs(dev, ABS_HAT0X, xpad_hat_to_axis[data[2] & 0x0f].x);
+ input_report_abs(dev, ABS_HAT0Y, xpad_hat_to_axis[data[2] & 0x0f].y);
+
+ /* start/back buttons and stick press left/right */
+ input_report_key(dev, BTN_START, (data[2] & 0x10) >> 4);
+ input_report_key(dev, BTN_BACK, (data[2] & 0x20) >> 5);
+ input_report_key(dev, BTN_THUMBL, (data[2] & 0x40) >> 6);
+ input_report_key(dev, BTN_THUMBR, data[2] >> 7);
+
+ /* "analog" buttons A, B, X, Y */
+ input_report_key(dev, BTN_A, data[4]);
+ input_report_key(dev, BTN_B, data[5]);
+ input_report_key(dev, BTN_X, data[6]);
+ input_report_key(dev, BTN_Y, data[7]);
+
+ /* "analog" buttons black, white */
+ input_report_key(dev, BTN_C, data[8]);
+ input_report_key(dev, BTN_Z, data[9]);
+}
+
+static void xpad_irq_in(struct urb *urb)
+{
+ struct usb_xpad *xpad = urb->context;
+
+ if (urb->status)
+ return;
+
+ xpad_process_packet(xpad, 0, xpad->idata);
+}
+
+static int xpad_open (struct input_dev *dev)
+{
+ struct usb_xpad *xpad = dev->private;
+
+ if (xpad->open_count++)
+ return 0;
+
+ xpad->irq_in->dev = xpad->udev;
+ if (usb_submit_urb(xpad->irq_in, GFP_KERNEL))
+ return -EIO;
+
+ return 0;
+}
+
+static void xpad_close (struct input_dev *dev)
+{
+ struct usb_xpad *xpad = dev->private;
+
+ if (!--xpad->open_count)
+ usb_unlink_urb(xpad->irq_in);
+}
+
+static void * xpad_probe(struct usb_device *udev, unsigned int ifnum, const struct
+usb_device_id *id)
+{
+ struct usb_xpad *xpad = NULL;
+ struct usb_endpoint_descriptor *ep_irq_in;
+ char path[64];
+ int i;
+
+ for (i = 0; xpad_device[i].idVendor; i++) {
+ if ((udev->descriptor.idVendor == xpad_device[i].idVendor) &&
+ (udev->descriptor.idProduct == xpad_device[i].idProduct))
+ break;
+ }
+
+ if ((xpad = kmalloc (sizeof(struct usb_xpad), GFP_KERNEL)) == NULL) {
+ err("cannot allocate memory for new pad");
+ return NULL;
+ }
+ memset(xpad, 0, sizeof(struct usb_xpad));
+
+ xpad->irq_in = usb_alloc_urb(0, GFP_KERNEL);
+ if (!xpad->irq_in) {
+ err("cannot allocate memory for new pad irq urb");
+ kfree(xpad);
+ return NULL;
+ }
+
+ ep_irq_in = udev->actconfig->interface[ifnum].altsetting[0].endpoint + 0;
+
+ FILL_INT_URB(xpad->irq_in, udev, usb_rcvintpipe(udev,
+ep_irq_in->bEndpointAddress),
+ xpad->idata, XPAD_PKT_LEN, xpad_irq_in, xpad, ep_irq_in->bInterval);
+
+ xpad->udev = udev;
+
+ xpad->dev.idbus = BUS_USB;
+ xpad->dev.idvendor = udev->descriptor.idVendor;
+ xpad->dev.idproduct = udev->descriptor.idProduct;
+ xpad->dev.idversion = udev->descriptor.bcdDevice;
+ xpad->dev.private = xpad;
+ xpad->dev.name = xpad_device[i].name;
+ xpad->dev.phys = xpad->phys;
+ xpad->dev.open = xpad_open;
+ xpad->dev.close = xpad_close;
+
+ usb_make_path(udev, path, 64);
+ snprintf(xpad->phys, 64, "%s/input0", path);
+
+ xpad->dev.evbit[0] = BIT(EV_KEY) | BIT(EV_ABS);
+
+ for (i = 0; xpad_btn[i] >= 0; i++)
+ set_bit(xpad_btn[i], xpad->dev.keybit);
+
+ for (i = 0; xpad_abs[i] >= 0; i++) {
+
+ signed short t = xpad_abs[i];
+
+ set_bit(t, xpad->dev.absbit);
+
+ switch (t) {
+ case ABS_X:
+ case ABS_Y:
+ case ABS_RX:
+ case ABS_RY:
+ xpad->dev.absmax[t] = 32767;
+ xpad->dev.absmin[t] = -32768;
+ xpad->dev.absflat[t] = 128;
+ xpad->dev.absfuzz[t] = 16;
+ break;
+ case ABS_Z:
+ case ABS_RZ:
+ xpad->dev.absmax[t] = 255;
+ xpad->dev.absmin[t] = 0;
+ break;
+ case ABS_HAT0X:
+ case ABS_HAT0Y:
+ xpad->dev.absmax[t] = 1;
+ xpad->dev.absmin[t] = -1;
+ break;
+ }
+ }
+
+ input_register_device(&xpad->dev);
+
+ printk(KERN_INFO "input: %s on %s", xpad->dev.name, path);
+
+ return xpad;
+}
+
+static void xpad_disconnect(struct usb_device *udev, void *ptr)
+{
+ struct usb_xpad *xpad = ptr;
+
+ usb_unlink_urb(xpad->irq_in);
+ input_unregister_device(&xpad->dev);
+ usb_free_urb(xpad->irq_in);
+ kfree(xpad);
+}
+
+static struct usb_driver xpad_driver = {
+ name: "xpad",
+ probe: xpad_probe,
+ disconnect: xpad_disconnect,
+ id_table: xpad_table,
+};
+
+static int __init usb_xpad_init(void)
+{
+ usb_register(&xpad_driver);
+ info(DRIVER_DESC ":" DRIVER_VERSION);
+ return 0;
+}
+
+static void __exit usb_xpad_exit(void)
+{
+ usb_deregister(&xpad_driver);
+}
+
+module_init(usb_xpad_init);
+module_exit(usb_xpad_exit);
+
+MODULE_AUTHOR(DRIVER_AUTHOR);
+MODULE_DESCRIPTION(DRIVER_DESC);
+MODULE_LICENSE("GPL");
===================================================================
This BitKeeper patch contains the following changesets:
1.650
## Wrapped with gzip_uu ##
begin 664 bkpatch25297
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
M)4`O[6/L0+Q,Y.O,8ZY_NT[NDP-\U4Q?;@-EL@K7!PM["_GV.0G$!>0EL
M,RN*R873"D8A*#'`XUQ@_UL>B5(FY"YN#$]3S)$!P?G%J@'W2CG;)]0MRJ"<
M0_ZN7<0(]IEB@*:9!&BF&:#69D30CQW7U@5\/\@X.9$0@`H*N=7YG6-QK<!@
M&/>E!T?#``T@O&P;HJE/NPR#&OE@Z/J1]#F2,B>@9%/4%`,N]Y7M#`:X-2QA
M)#9W\J96B[8M-&""E0K<A3K4D4Y+QY!\Z3AAFFM4J-B=B59#W[5Q>C3"W&!D
M@YU"1EDMH<0C3'ST2)MA%8>%VM1!$\:>HN%*53Z."*1`\]O$#V@BU$$?AVCI
M3"$[EMAIL PROTECTED];K6"27$^EPB%G`<47Y-?"5]Z,6(=@]5F8;N'7NVIGS3
MXY$,$<P;A:"6@-MK`N'$=8A.CD]\6:Z.W$S%0ZQH4]U8L7`FS4>/=]#)Y>A2
MZK;]>$:*X_<1E];-="5)&17'&(28T`U^PX!<TA)R#%:X$Q.7S_E"5K63&Y>2
M,E^HDR+H=E%LLJJ>5K?D%JXK\MJ*1(;CS\B/4D8TY_P66N*5Z.6I>;/=J*%N
M7!]3GI"1_":,^R$&7PHHR"3$^.&B#G#!%8S05J4?2WPKG3RD9$#V5N/Z7&A1
M%%*N,^+*_87/=^AL8<^*>A@>Q\S3[7@\(0,?"FMAZ$,:9Z`RJ&?[07(V@?/:
M,08#3+S2LF.ZE1"Q+91Q2VUSC"-VXBCJE`=HEUA"-IL\,0T[)95*;:DH-L%9
M)H%#U9;K>%QSDDWC.C1L0+J57STZ3@!X]44@\)Y4Q*<;V(&_7FDEBK"H!A$3
MD_'2?;#<#R7E7PC^#/PII9_KL3?"E.SI^+,.7UZ17CK"K?U`H(%D08FB12(1
MSB4W:0Y'T&P>C$G.0J)S./>G/#A'.^,R449*"N30\$;88E:4VA@@D5P!I1U*
M-HFZA$#2=]6!ABW\0[DKM^=B/>5J\6"`,84\F>&&G6UINY254`)TDP1KY9]A
MUD=MXA.9[8&<3&&[SZ$AX<*\KV'J\FY=I65\/J7,C"!$$(50D*F_E$O!E#0Q
MQCC1*XRRS(TQ\R8^+O!ILD/I=$@&/,(A,LY/XE`&]!S"Z,BL'?X7/OB.RTIR
M(]FYO5T3`0-CV!P(ZZBMZPMSC:!S>0:7;,1F\<A)P82])>(5.A!XXC*+)
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
ARWR&&N;V`9OD,TWVV>DPBM*G:)L,GA_^`?U/B><U1P``
`
end
