xpad.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433
  1. /*
  2. * X-Box gamepad - v0.0.6
  3. *
  4. * Copyright (c) 2002 Marko Friedemann <mfr@bmx-chemnitz.de>
  5. * 2004 Oliver Schwartz <Oliver.Schwartz@gmx.de>,
  6. * Steven Toth <steve@toth.demon.co.uk>,
  7. * Franz Lehner <franz@caos.at>,
  8. * Ivan Hawkes <blackhawk@ivanhawkes.com>
  9. * 2005 Dominic Cerquetti <binary1230@yahoo.com>
  10. * 2006 Adam Buchbinder <adam.buchbinder@gmail.com>
  11. *
  12. * This program is free software; you can redistribute it and/or
  13. * modify it under the terms of the GNU General Public License as
  14. * published by the Free Software Foundation; either version 2 of
  15. * the License, or (at your option) any later version.
  16. *
  17. * This program is distributed in the hope that it will be useful,
  18. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  20. * GNU General Public License for more details.
  21. *
  22. * You should have received a copy of the GNU General Public License
  23. * along with this program; if not, write to the Free Software
  24. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  25. *
  26. *
  27. * This driver is based on:
  28. * - information from http://euc.jp/periphs/xbox-controller.ja.html
  29. * - the iForce driver drivers/char/joystick/iforce.c
  30. * - the skeleton-driver drivers/usb/usb-skeleton.c
  31. *
  32. * Thanks to:
  33. * - ITO Takayuki for providing essential xpad information on his website
  34. * - Vojtech Pavlik - iforce driver / input subsystem
  35. * - Greg Kroah-Hartman - usb-skeleton driver
  36. * - XBOX Linux project - extra USB id's
  37. *
  38. * TODO:
  39. * - fine tune axes (especially trigger axes)
  40. * - fix "analog" buttons (reported as digital now)
  41. * - get rumble working
  42. * - need USB IDs for other dance pads
  43. *
  44. * History:
  45. *
  46. * 2002-06-27 - 0.0.1 : first version, just said "XBOX HID controller"
  47. *
  48. * 2002-07-02 - 0.0.2 : basic working version
  49. * - all axes and 9 of the 10 buttons work (german InterAct device)
  50. * - the black button does not work
  51. *
  52. * 2002-07-14 - 0.0.3 : rework by Vojtech Pavlik
  53. * - indentation fixes
  54. * - usb + input init sequence fixes
  55. *
  56. * 2002-07-16 - 0.0.4 : minor changes, merge with Vojtech's v0.0.3
  57. * - verified the lack of HID and report descriptors
  58. * - verified that ALL buttons WORK
  59. * - fixed d-pad to axes mapping
  60. *
  61. * 2002-07-17 - 0.0.5 : simplified d-pad handling
  62. *
  63. * 2004-10-02 - 0.0.6 : DDR pad support
  64. * - borrowed from the XBOX linux kernel
  65. * - USB id's for commonly used dance pads are present
  66. * - dance pads will map D-PAD to buttons, not axes
  67. * - pass the module paramater 'dpad_to_buttons' to force
  68. * the D-PAD to map to buttons if your pad is not detected
  69. */
  70. #include <linux/kernel.h>
  71. #include <linux/init.h>
  72. #include <linux/slab.h>
  73. #include <linux/stat.h>
  74. #include <linux/module.h>
  75. #include <linux/moduleparam.h>
  76. #include <linux/usb/input.h>
  77. #define DRIVER_VERSION "v0.0.6"
  78. #define DRIVER_AUTHOR "Marko Friedemann <mfr@bmx-chemnitz.de>"
  79. #define DRIVER_DESC "X-Box pad driver"
  80. #define XPAD_PKT_LEN 32
  81. /* xbox d-pads should map to buttons, as is required for DDR pads
  82. but we map them to axes when possible to simplify things */
  83. #define MAP_DPAD_TO_BUTTONS 0
  84. #define MAP_DPAD_TO_AXES 1
  85. #define MAP_DPAD_UNKNOWN -1
  86. static int dpad_to_buttons;
  87. module_param(dpad_to_buttons, bool, S_IRUGO);
  88. MODULE_PARM_DESC(dpad_to_buttons, "Map D-PAD to buttons rather than axes for unknown pads");
  89. static const struct xpad_device {
  90. u16 idVendor;
  91. u16 idProduct;
  92. char *name;
  93. u8 dpad_mapping;
  94. } xpad_device[] = {
  95. { 0x045e, 0x0202, "Microsoft X-Box pad v1 (US)", MAP_DPAD_TO_AXES },
  96. { 0x045e, 0x0289, "Microsoft X-Box pad v2 (US)", MAP_DPAD_TO_AXES },
  97. { 0x045e, 0x0285, "Microsoft X-Box pad (Japan)", MAP_DPAD_TO_AXES },
  98. { 0x045e, 0x0287, "Microsoft Xbox Controller S", MAP_DPAD_TO_AXES },
  99. { 0x0c12, 0x8809, "RedOctane Xbox Dance Pad", MAP_DPAD_TO_BUTTONS },
  100. { 0x044f, 0x0f07, "Thrustmaster, Inc. Controller", MAP_DPAD_TO_AXES },
  101. { 0x046d, 0xca84, "Logitech Xbox Cordless Controller", MAP_DPAD_TO_AXES },
  102. { 0x046d, 0xca88, "Logitech Compact Controller for Xbox", MAP_DPAD_TO_AXES },
  103. { 0x05fd, 0x1007, "Mad Catz Controller (unverified)", MAP_DPAD_TO_AXES },
  104. { 0x05fd, 0x107a, "InterAct 'PowerPad Pro' X-Box pad (Germany)", MAP_DPAD_TO_AXES },
  105. { 0x0738, 0x4516, "Mad Catz Control Pad", MAP_DPAD_TO_AXES },
  106. { 0x0738, 0x4522, "Mad Catz LumiCON", MAP_DPAD_TO_AXES },
  107. { 0x0738, 0x4526, "Mad Catz Control Pad Pro", MAP_DPAD_TO_AXES },
  108. { 0x0738, 0x4536, "Mad Catz MicroCON", MAP_DPAD_TO_AXES },
  109. { 0x0738, 0x4540, "Mad Catz Beat Pad", MAP_DPAD_TO_BUTTONS },
  110. { 0x0738, 0x4556, "Mad Catz Lynx Wireless Controller", MAP_DPAD_TO_AXES },
  111. { 0x0738, 0x6040, "Mad Catz Beat Pad Pro", MAP_DPAD_TO_BUTTONS },
  112. { 0x0c12, 0x8802, "Zeroplus Xbox Controller", MAP_DPAD_TO_AXES },
  113. { 0x0c12, 0x8810, "Zeroplus Xbox Controller", MAP_DPAD_TO_AXES },
  114. { 0x0c12, 0x9902, "HAMA VibraX - *FAULTY HARDWARE*", MAP_DPAD_TO_AXES },
  115. { 0x0e4c, 0x1097, "Radica Gamester Controller", MAP_DPAD_TO_AXES },
  116. { 0x0e4c, 0x2390, "Radica Games Jtech Controller", MAP_DPAD_TO_AXES},
  117. { 0x0e6f, 0x0003, "Logic3 Freebird wireless Controller", MAP_DPAD_TO_AXES },
  118. { 0x0e6f, 0x0005, "Eclipse wireless Controller", MAP_DPAD_TO_AXES },
  119. { 0x0e6f, 0x0006, "Edge wireless Controller", MAP_DPAD_TO_AXES },
  120. { 0x0e8f, 0x0201, "SmartJoy Frag Xpad/PS2 adaptor", MAP_DPAD_TO_AXES },
  121. { 0x0f30, 0x0202, "Joytech Advanced Controller", MAP_DPAD_TO_AXES },
  122. { 0x0f30, 0x8888, "BigBen XBMiniPad Controller", MAP_DPAD_TO_AXES },
  123. { 0x102c, 0xff0c, "Joytech Wireless Advanced Controller", MAP_DPAD_TO_AXES },
  124. { 0x12ab, 0x8809, "Xbox DDR dancepad", MAP_DPAD_TO_BUTTONS },
  125. { 0x1430, 0x8888, "TX6500+ Dance Pad (first generation)", MAP_DPAD_TO_BUTTONS },
  126. { 0xffff, 0xffff, "Chinese-made Xbox Controller", MAP_DPAD_TO_AXES },
  127. { 0x0000, 0x0000, "Generic X-Box pad", MAP_DPAD_UNKNOWN }
  128. };
  129. static const signed short xpad_btn[] = {
  130. BTN_A, BTN_B, BTN_C, BTN_X, BTN_Y, BTN_Z, /* "analog" buttons */
  131. BTN_START, BTN_BACK, BTN_THUMBL, BTN_THUMBR, /* start/back/sticks */
  132. -1 /* terminating entry */
  133. };
  134. /* only used if MAP_DPAD_TO_BUTTONS */
  135. static const signed short xpad_btn_pad[] = {
  136. BTN_LEFT, BTN_RIGHT, /* d-pad left, right */
  137. BTN_0, BTN_1, /* d-pad up, down (XXX names??) */
  138. -1 /* terminating entry */
  139. };
  140. static const signed short xpad_abs[] = {
  141. ABS_X, ABS_Y, /* left stick */
  142. ABS_RX, ABS_RY, /* right stick */
  143. ABS_Z, ABS_RZ, /* triggers left/right */
  144. -1 /* terminating entry */
  145. };
  146. /* only used if MAP_DPAD_TO_AXES */
  147. static const signed short xpad_abs_pad[] = {
  148. ABS_HAT0X, ABS_HAT0Y, /* d-pad axes */
  149. -1 /* terminating entry */
  150. };
  151. static struct usb_device_id xpad_table [] = {
  152. { USB_INTERFACE_INFO('X', 'B', 0) }, /* X-Box USB-IF not approved class */
  153. { }
  154. };
  155. MODULE_DEVICE_TABLE (usb, xpad_table);
  156. struct usb_xpad {
  157. struct input_dev *dev; /* input device interface */
  158. struct usb_device *udev; /* usb device */
  159. struct urb *irq_in; /* urb for interrupt in report */
  160. unsigned char *idata; /* input data */
  161. dma_addr_t idata_dma;
  162. char phys[65]; /* physical device path */
  163. int dpad_mapping; /* map d-pad to buttons or to axes */
  164. };
  165. /*
  166. * xpad_process_packet
  167. *
  168. * Completes a request by converting the data into events for the
  169. * input subsystem.
  170. *
  171. * The used report descriptor was taken from ITO Takayukis website:
  172. * http://euc.jp/periphs/xbox-controller.ja.html
  173. */
  174. static void xpad_process_packet(struct usb_xpad *xpad, u16 cmd, unsigned char *data)
  175. {
  176. struct input_dev *dev = xpad->dev;
  177. /* left stick */
  178. input_report_abs(dev, ABS_X, (__s16) (((__s16)data[13] << 8) | data[12]));
  179. input_report_abs(dev, ABS_Y, (__s16) (((__s16)data[15] << 8) | data[14]));
  180. /* right stick */
  181. input_report_abs(dev, ABS_RX, (__s16) (((__s16)data[17] << 8) | data[16]));
  182. input_report_abs(dev, ABS_RY, (__s16) (((__s16)data[19] << 8) | data[18]));
  183. /* triggers left/right */
  184. input_report_abs(dev, ABS_Z, data[10]);
  185. input_report_abs(dev, ABS_RZ, data[11]);
  186. /* digital pad */
  187. if (xpad->dpad_mapping == MAP_DPAD_TO_AXES) {
  188. input_report_abs(dev, ABS_HAT0X, !!(data[2] & 0x08) - !!(data[2] & 0x04));
  189. input_report_abs(dev, ABS_HAT0Y, !!(data[2] & 0x02) - !!(data[2] & 0x01));
  190. } else /* xpad->dpad_mapping == MAP_DPAD_TO_BUTTONS */ {
  191. input_report_key(dev, BTN_LEFT, data[2] & 0x04);
  192. input_report_key(dev, BTN_RIGHT, data[2] & 0x08);
  193. input_report_key(dev, BTN_0, data[2] & 0x01); // up
  194. input_report_key(dev, BTN_1, data[2] & 0x02); // down
  195. }
  196. /* start/back buttons and stick press left/right */
  197. input_report_key(dev, BTN_START, data[2] & 0x10);
  198. input_report_key(dev, BTN_BACK, data[2] & 0x20);
  199. input_report_key(dev, BTN_THUMBL, data[2] & 0x40);
  200. input_report_key(dev, BTN_THUMBR, data[2] & 0x80);
  201. /* "analog" buttons A, B, X, Y */
  202. input_report_key(dev, BTN_A, data[4]);
  203. input_report_key(dev, BTN_B, data[5]);
  204. input_report_key(dev, BTN_X, data[6]);
  205. input_report_key(dev, BTN_Y, data[7]);
  206. /* "analog" buttons black, white */
  207. input_report_key(dev, BTN_C, data[8]);
  208. input_report_key(dev, BTN_Z, data[9]);
  209. input_sync(dev);
  210. }
  211. static void xpad_irq_in(struct urb *urb)
  212. {
  213. struct usb_xpad *xpad = urb->context;
  214. int retval;
  215. switch (urb->status) {
  216. case 0:
  217. /* success */
  218. break;
  219. case -ECONNRESET:
  220. case -ENOENT:
  221. case -ESHUTDOWN:
  222. /* this urb is terminated, clean up */
  223. dbg("%s - urb shutting down with status: %d", __FUNCTION__, urb->status);
  224. return;
  225. default:
  226. dbg("%s - nonzero urb status received: %d", __FUNCTION__, urb->status);
  227. goto exit;
  228. }
  229. xpad_process_packet(xpad, 0, xpad->idata);
  230. exit:
  231. retval = usb_submit_urb (urb, GFP_ATOMIC);
  232. if (retval)
  233. err ("%s - usb_submit_urb failed with result %d",
  234. __FUNCTION__, retval);
  235. }
  236. static int xpad_open (struct input_dev *dev)
  237. {
  238. struct usb_xpad *xpad = input_get_drvdata(dev);
  239. xpad->irq_in->dev = xpad->udev;
  240. if (usb_submit_urb(xpad->irq_in, GFP_KERNEL))
  241. return -EIO;
  242. return 0;
  243. }
  244. static void xpad_close (struct input_dev *dev)
  245. {
  246. struct usb_xpad *xpad = input_get_drvdata(dev);
  247. usb_kill_urb(xpad->irq_in);
  248. }
  249. static void xpad_set_up_abs(struct input_dev *input_dev, signed short abs)
  250. {
  251. set_bit(abs, input_dev->absbit);
  252. switch (abs) {
  253. case ABS_X:
  254. case ABS_Y:
  255. case ABS_RX:
  256. case ABS_RY: /* the two sticks */
  257. input_set_abs_params(input_dev, abs, -32768, 32767, 16, 128);
  258. break;
  259. case ABS_Z:
  260. case ABS_RZ: /* the triggers */
  261. input_set_abs_params(input_dev, abs, 0, 255, 0, 0);
  262. break;
  263. case ABS_HAT0X:
  264. case ABS_HAT0Y: /* the d-pad (only if MAP_DPAD_TO_AXES) */
  265. input_set_abs_params(input_dev, abs, -1, 1, 0, 0);
  266. break;
  267. }
  268. }
  269. static int xpad_probe(struct usb_interface *intf, const struct usb_device_id *id)
  270. {
  271. struct usb_device *udev = interface_to_usbdev (intf);
  272. struct usb_xpad *xpad;
  273. struct input_dev *input_dev;
  274. struct usb_endpoint_descriptor *ep_irq_in;
  275. int i;
  276. int error = -ENOMEM;
  277. for (i = 0; xpad_device[i].idVendor; i++) {
  278. if ((le16_to_cpu(udev->descriptor.idVendor) == xpad_device[i].idVendor) &&
  279. (le16_to_cpu(udev->descriptor.idProduct) == xpad_device[i].idProduct))
  280. break;
  281. }
  282. xpad = kzalloc(sizeof(struct usb_xpad), GFP_KERNEL);
  283. input_dev = input_allocate_device();
  284. if (!xpad || !input_dev)
  285. goto fail1;
  286. xpad->idata = usb_buffer_alloc(udev, XPAD_PKT_LEN,
  287. GFP_ATOMIC, &xpad->idata_dma);
  288. if (!xpad->idata)
  289. goto fail1;
  290. xpad->irq_in = usb_alloc_urb(0, GFP_KERNEL);
  291. if (!xpad->irq_in)
  292. goto fail2;
  293. xpad->udev = udev;
  294. xpad->dpad_mapping = xpad_device[i].dpad_mapping;
  295. if (xpad->dpad_mapping == MAP_DPAD_UNKNOWN)
  296. xpad->dpad_mapping = dpad_to_buttons;
  297. xpad->dev = input_dev;
  298. usb_make_path(udev, xpad->phys, sizeof(xpad->phys));
  299. strlcat(xpad->phys, "/input0", sizeof(xpad->phys));
  300. input_dev->name = xpad_device[i].name;
  301. input_dev->phys = xpad->phys;
  302. usb_to_input_id(udev, &input_dev->id);
  303. input_dev->dev.parent = &intf->dev;
  304. input_set_drvdata(input_dev, xpad);
  305. input_dev->open = xpad_open;
  306. input_dev->close = xpad_close;
  307. input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_ABS);
  308. /* set up buttons */
  309. for (i = 0; xpad_btn[i] >= 0; i++)
  310. set_bit(xpad_btn[i], input_dev->keybit);
  311. if (xpad->dpad_mapping == MAP_DPAD_TO_BUTTONS)
  312. for (i = 0; xpad_btn_pad[i] >= 0; i++)
  313. set_bit(xpad_btn_pad[i], input_dev->keybit);
  314. /* set up axes */
  315. for (i = 0; xpad_abs[i] >= 0; i++)
  316. xpad_set_up_abs(input_dev, xpad_abs[i]);
  317. if (xpad->dpad_mapping == MAP_DPAD_TO_AXES)
  318. for (i = 0; xpad_abs_pad[i] >= 0; i++)
  319. xpad_set_up_abs(input_dev, xpad_abs_pad[i]);
  320. ep_irq_in = &intf->cur_altsetting->endpoint[0].desc;
  321. usb_fill_int_urb(xpad->irq_in, udev,
  322. usb_rcvintpipe(udev, ep_irq_in->bEndpointAddress),
  323. xpad->idata, XPAD_PKT_LEN, xpad_irq_in,
  324. xpad, ep_irq_in->bInterval);
  325. xpad->irq_in->transfer_dma = xpad->idata_dma;
  326. xpad->irq_in->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  327. error = input_register_device(xpad->dev);
  328. if (error)
  329. goto fail3;
  330. usb_set_intfdata(intf, xpad);
  331. return 0;
  332. fail3: usb_free_urb(xpad->irq_in);
  333. fail2: usb_buffer_free(udev, XPAD_PKT_LEN, xpad->idata, xpad->idata_dma);
  334. fail1: input_free_device(input_dev);
  335. kfree(xpad);
  336. return error;
  337. }
  338. static void xpad_disconnect(struct usb_interface *intf)
  339. {
  340. struct usb_xpad *xpad = usb_get_intfdata (intf);
  341. usb_set_intfdata(intf, NULL);
  342. if (xpad) {
  343. usb_kill_urb(xpad->irq_in);
  344. input_unregister_device(xpad->dev);
  345. usb_free_urb(xpad->irq_in);
  346. usb_buffer_free(interface_to_usbdev(intf), XPAD_PKT_LEN,
  347. xpad->idata, xpad->idata_dma);
  348. kfree(xpad);
  349. }
  350. }
  351. static struct usb_driver xpad_driver = {
  352. .name = "xpad",
  353. .probe = xpad_probe,
  354. .disconnect = xpad_disconnect,
  355. .id_table = xpad_table,
  356. };
  357. static int __init usb_xpad_init(void)
  358. {
  359. int result = usb_register(&xpad_driver);
  360. if (result == 0)
  361. info(DRIVER_DESC ":" DRIVER_VERSION);
  362. return result;
  363. }
  364. static void __exit usb_xpad_exit(void)
  365. {
  366. usb_deregister(&xpad_driver);
  367. }
  368. module_init(usb_xpad_init);
  369. module_exit(usb_xpad_exit);
  370. MODULE_AUTHOR(DRIVER_AUTHOR);
  371. MODULE_DESCRIPTION(DRIVER_DESC);
  372. MODULE_LICENSE("GPL");