hid-core.c 29 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085
  1. /*
  2. * USB HID support for Linux
  3. *
  4. * Copyright (c) 1999 Andreas Gal
  5. * Copyright (c) 2000-2005 Vojtech Pavlik <vojtech@suse.cz>
  6. * Copyright (c) 2005 Michael Haboustak <mike-@cinci.rr.com> for Concept2, Inc
  7. * Copyright (c) 2006-2007 Jiri Kosina
  8. */
  9. /*
  10. * This program is free software; you can redistribute it and/or modify it
  11. * under the terms of the GNU General Public License as published by the Free
  12. * Software Foundation; either version 2 of the License, or (at your option)
  13. * any later version.
  14. */
  15. #include <linux/module.h>
  16. #include <linux/slab.h>
  17. #include <linux/init.h>
  18. #include <linux/kernel.h>
  19. #include <linux/list.h>
  20. #include <linux/mm.h>
  21. #include <linux/smp_lock.h>
  22. #include <linux/spinlock.h>
  23. #include <asm/unaligned.h>
  24. #include <asm/byteorder.h>
  25. #include <linux/input.h>
  26. #include <linux/wait.h>
  27. #include <linux/usb.h>
  28. #include <linux/hid.h>
  29. #include <linux/hiddev.h>
  30. #include <linux/hid-debug.h>
  31. #include "usbhid.h"
  32. /*
  33. * Version Information
  34. */
  35. #define DRIVER_VERSION "v2.6"
  36. #define DRIVER_AUTHOR "Andreas Gal, Vojtech Pavlik, Jiri Kosina"
  37. #define DRIVER_DESC "USB HID core driver"
  38. #define DRIVER_LICENSE "GPL"
  39. static char *hid_types[] = {"Device", "Pointer", "Mouse", "Device", "Joystick",
  40. "Gamepad", "Keyboard", "Keypad", "Multi-Axis Controller"};
  41. /*
  42. * Module parameters.
  43. */
  44. static unsigned int hid_mousepoll_interval;
  45. module_param_named(mousepoll, hid_mousepoll_interval, uint, 0644);
  46. MODULE_PARM_DESC(mousepoll, "Polling interval of mice");
  47. /* Quirks specified at module load time */
  48. static char *quirks_param[MAX_USBHID_BOOT_QUIRKS] = { [ 0 ... (MAX_USBHID_BOOT_QUIRKS - 1) ] = NULL };
  49. module_param_array_named(quirks, quirks_param, charp, NULL, 0444);
  50. MODULE_PARM_DESC(quirks, "Add/modify USB HID quirks by specifying "
  51. " quirks=vendorID:productID:quirks"
  52. " where vendorID, productID, and quirks are all in"
  53. " 0x-prefixed hex");
  54. static char *rdesc_quirks_param[MAX_USBHID_BOOT_QUIRKS] = { [ 0 ... (MAX_USBHID_BOOT_QUIRKS - 1) ] = NULL };
  55. module_param_array_named(rdesc_quirks, rdesc_quirks_param, charp, NULL, 0444);
  56. MODULE_PARM_DESC(rdesc_quirks, "Add/modify report descriptor quirks by specifying "
  57. " rdesc_quirks=vendorID:productID:rdesc_quirks"
  58. " where vendorID, productID, and rdesc_quirks are all in"
  59. " 0x-prefixed hex");
  60. /*
  61. * Input submission and I/O error handler.
  62. */
  63. static void hid_io_error(struct hid_device *hid);
  64. /* Start up the input URB */
  65. static int hid_start_in(struct hid_device *hid)
  66. {
  67. unsigned long flags;
  68. int rc = 0;
  69. struct usbhid_device *usbhid = hid->driver_data;
  70. spin_lock_irqsave(&usbhid->inlock, flags);
  71. if (hid->open > 0 && !test_bit(HID_SUSPENDED, &usbhid->iofl) &&
  72. !test_and_set_bit(HID_IN_RUNNING, &usbhid->iofl)) {
  73. rc = usb_submit_urb(usbhid->urbin, GFP_ATOMIC);
  74. if (rc != 0)
  75. clear_bit(HID_IN_RUNNING, &usbhid->iofl);
  76. }
  77. spin_unlock_irqrestore(&usbhid->inlock, flags);
  78. return rc;
  79. }
  80. /* I/O retry timer routine */
  81. static void hid_retry_timeout(unsigned long _hid)
  82. {
  83. struct hid_device *hid = (struct hid_device *) _hid;
  84. struct usbhid_device *usbhid = hid->driver_data;
  85. dev_dbg(&usbhid->intf->dev, "retrying intr urb\n");
  86. if (hid_start_in(hid))
  87. hid_io_error(hid);
  88. }
  89. /* Workqueue routine to reset the device or clear a halt */
  90. static void hid_reset(struct work_struct *work)
  91. {
  92. struct usbhid_device *usbhid =
  93. container_of(work, struct usbhid_device, reset_work);
  94. struct hid_device *hid = usbhid->hid;
  95. int rc_lock, rc = 0;
  96. if (test_bit(HID_CLEAR_HALT, &usbhid->iofl)) {
  97. dev_dbg(&usbhid->intf->dev, "clear halt\n");
  98. rc = usb_clear_halt(hid_to_usb_dev(hid), usbhid->urbin->pipe);
  99. clear_bit(HID_CLEAR_HALT, &usbhid->iofl);
  100. hid_start_in(hid);
  101. }
  102. else if (test_bit(HID_RESET_PENDING, &usbhid->iofl)) {
  103. dev_dbg(&usbhid->intf->dev, "resetting device\n");
  104. rc = rc_lock = usb_lock_device_for_reset(hid_to_usb_dev(hid), usbhid->intf);
  105. if (rc_lock >= 0) {
  106. rc = usb_reset_composite_device(hid_to_usb_dev(hid), usbhid->intf);
  107. if (rc_lock)
  108. usb_unlock_device(hid_to_usb_dev(hid));
  109. }
  110. clear_bit(HID_RESET_PENDING, &usbhid->iofl);
  111. }
  112. switch (rc) {
  113. case 0:
  114. if (!test_bit(HID_IN_RUNNING, &usbhid->iofl))
  115. hid_io_error(hid);
  116. break;
  117. default:
  118. err_hid("can't reset device, %s-%s/input%d, status %d",
  119. hid_to_usb_dev(hid)->bus->bus_name,
  120. hid_to_usb_dev(hid)->devpath,
  121. usbhid->ifnum, rc);
  122. /* FALLTHROUGH */
  123. case -EHOSTUNREACH:
  124. case -ENODEV:
  125. case -EINTR:
  126. break;
  127. }
  128. }
  129. /* Main I/O error handler */
  130. static void hid_io_error(struct hid_device *hid)
  131. {
  132. unsigned long flags;
  133. struct usbhid_device *usbhid = hid->driver_data;
  134. spin_lock_irqsave(&usbhid->inlock, flags);
  135. /* Stop when disconnected */
  136. if (usb_get_intfdata(usbhid->intf) == NULL)
  137. goto done;
  138. /* If it has been a while since the last error, we'll assume
  139. * this a brand new error and reset the retry timeout. */
  140. if (time_after(jiffies, usbhid->stop_retry + HZ/2))
  141. usbhid->retry_delay = 0;
  142. /* When an error occurs, retry at increasing intervals */
  143. if (usbhid->retry_delay == 0) {
  144. usbhid->retry_delay = 13; /* Then 26, 52, 104, 104, ... */
  145. usbhid->stop_retry = jiffies + msecs_to_jiffies(1000);
  146. } else if (usbhid->retry_delay < 100)
  147. usbhid->retry_delay *= 2;
  148. if (time_after(jiffies, usbhid->stop_retry)) {
  149. /* Retries failed, so do a port reset */
  150. if (!test_and_set_bit(HID_RESET_PENDING, &usbhid->iofl)) {
  151. schedule_work(&usbhid->reset_work);
  152. goto done;
  153. }
  154. }
  155. mod_timer(&usbhid->io_retry,
  156. jiffies + msecs_to_jiffies(usbhid->retry_delay));
  157. done:
  158. spin_unlock_irqrestore(&usbhid->inlock, flags);
  159. }
  160. /*
  161. * Input interrupt completion handler.
  162. */
  163. static void hid_irq_in(struct urb *urb)
  164. {
  165. struct hid_device *hid = urb->context;
  166. struct usbhid_device *usbhid = hid->driver_data;
  167. int status;
  168. switch (urb->status) {
  169. case 0: /* success */
  170. usbhid->retry_delay = 0;
  171. hid_input_report(urb->context, HID_INPUT_REPORT,
  172. urb->transfer_buffer,
  173. urb->actual_length, 1);
  174. break;
  175. case -EPIPE: /* stall */
  176. clear_bit(HID_IN_RUNNING, &usbhid->iofl);
  177. set_bit(HID_CLEAR_HALT, &usbhid->iofl);
  178. schedule_work(&usbhid->reset_work);
  179. return;
  180. case -ECONNRESET: /* unlink */
  181. case -ENOENT:
  182. case -ESHUTDOWN: /* unplug */
  183. clear_bit(HID_IN_RUNNING, &usbhid->iofl);
  184. return;
  185. case -EILSEQ: /* protocol error or unplug */
  186. case -EPROTO: /* protocol error or unplug */
  187. case -ETIME: /* protocol error or unplug */
  188. case -ETIMEDOUT: /* Should never happen, but... */
  189. clear_bit(HID_IN_RUNNING, &usbhid->iofl);
  190. hid_io_error(hid);
  191. return;
  192. default: /* error */
  193. warn("input irq status %d received", urb->status);
  194. }
  195. status = usb_submit_urb(urb, GFP_ATOMIC);
  196. if (status) {
  197. clear_bit(HID_IN_RUNNING, &usbhid->iofl);
  198. if (status != -EPERM) {
  199. err_hid("can't resubmit intr, %s-%s/input%d, status %d",
  200. hid_to_usb_dev(hid)->bus->bus_name,
  201. hid_to_usb_dev(hid)->devpath,
  202. usbhid->ifnum, status);
  203. hid_io_error(hid);
  204. }
  205. }
  206. }
  207. static int hid_submit_out(struct hid_device *hid)
  208. {
  209. struct hid_report *report;
  210. struct usbhid_device *usbhid = hid->driver_data;
  211. report = usbhid->out[usbhid->outtail];
  212. hid_output_report(report, usbhid->outbuf);
  213. usbhid->urbout->transfer_buffer_length = ((report->size - 1) >> 3) + 1 + (report->id > 0);
  214. usbhid->urbout->dev = hid_to_usb_dev(hid);
  215. dbg_hid("submitting out urb\n");
  216. if (usb_submit_urb(usbhid->urbout, GFP_ATOMIC)) {
  217. err_hid("usb_submit_urb(out) failed");
  218. return -1;
  219. }
  220. return 0;
  221. }
  222. static int hid_submit_ctrl(struct hid_device *hid)
  223. {
  224. struct hid_report *report;
  225. unsigned char dir;
  226. int len;
  227. struct usbhid_device *usbhid = hid->driver_data;
  228. report = usbhid->ctrl[usbhid->ctrltail].report;
  229. dir = usbhid->ctrl[usbhid->ctrltail].dir;
  230. len = ((report->size - 1) >> 3) + 1 + (report->id > 0);
  231. if (dir == USB_DIR_OUT) {
  232. hid_output_report(report, usbhid->ctrlbuf);
  233. usbhid->urbctrl->pipe = usb_sndctrlpipe(hid_to_usb_dev(hid), 0);
  234. usbhid->urbctrl->transfer_buffer_length = len;
  235. } else {
  236. int maxpacket, padlen;
  237. usbhid->urbctrl->pipe = usb_rcvctrlpipe(hid_to_usb_dev(hid), 0);
  238. maxpacket = usb_maxpacket(hid_to_usb_dev(hid), usbhid->urbctrl->pipe, 0);
  239. if (maxpacket > 0) {
  240. padlen = (len + maxpacket - 1) / maxpacket;
  241. padlen *= maxpacket;
  242. if (padlen > usbhid->bufsize)
  243. padlen = usbhid->bufsize;
  244. } else
  245. padlen = 0;
  246. usbhid->urbctrl->transfer_buffer_length = padlen;
  247. }
  248. usbhid->urbctrl->dev = hid_to_usb_dev(hid);
  249. usbhid->cr->bRequestType = USB_TYPE_CLASS | USB_RECIP_INTERFACE | dir;
  250. usbhid->cr->bRequest = (dir == USB_DIR_OUT) ? HID_REQ_SET_REPORT : HID_REQ_GET_REPORT;
  251. usbhid->cr->wValue = cpu_to_le16(((report->type + 1) << 8) | report->id);
  252. usbhid->cr->wIndex = cpu_to_le16(usbhid->ifnum);
  253. usbhid->cr->wLength = cpu_to_le16(len);
  254. dbg_hid("submitting ctrl urb: %s wValue=0x%04x wIndex=0x%04x wLength=%u\n",
  255. usbhid->cr->bRequest == HID_REQ_SET_REPORT ? "Set_Report" : "Get_Report",
  256. usbhid->cr->wValue, usbhid->cr->wIndex, usbhid->cr->wLength);
  257. if (usb_submit_urb(usbhid->urbctrl, GFP_ATOMIC)) {
  258. err_hid("usb_submit_urb(ctrl) failed");
  259. return -1;
  260. }
  261. return 0;
  262. }
  263. /*
  264. * Output interrupt completion handler.
  265. */
  266. static void hid_irq_out(struct urb *urb)
  267. {
  268. struct hid_device *hid = urb->context;
  269. struct usbhid_device *usbhid = hid->driver_data;
  270. unsigned long flags;
  271. int unplug = 0;
  272. switch (urb->status) {
  273. case 0: /* success */
  274. break;
  275. case -ESHUTDOWN: /* unplug */
  276. unplug = 1;
  277. case -EILSEQ: /* protocol error or unplug */
  278. case -EPROTO: /* protocol error or unplug */
  279. case -ECONNRESET: /* unlink */
  280. case -ENOENT:
  281. break;
  282. default: /* error */
  283. warn("output irq status %d received", urb->status);
  284. }
  285. spin_lock_irqsave(&usbhid->outlock, flags);
  286. if (unplug)
  287. usbhid->outtail = usbhid->outhead;
  288. else
  289. usbhid->outtail = (usbhid->outtail + 1) & (HID_OUTPUT_FIFO_SIZE - 1);
  290. if (usbhid->outhead != usbhid->outtail) {
  291. if (hid_submit_out(hid)) {
  292. clear_bit(HID_OUT_RUNNING, &usbhid->iofl);
  293. wake_up(&hid->wait);
  294. }
  295. spin_unlock_irqrestore(&usbhid->outlock, flags);
  296. return;
  297. }
  298. clear_bit(HID_OUT_RUNNING, &usbhid->iofl);
  299. spin_unlock_irqrestore(&usbhid->outlock, flags);
  300. wake_up(&hid->wait);
  301. }
  302. /*
  303. * Control pipe completion handler.
  304. */
  305. static void hid_ctrl(struct urb *urb)
  306. {
  307. struct hid_device *hid = urb->context;
  308. struct usbhid_device *usbhid = hid->driver_data;
  309. unsigned long flags;
  310. int unplug = 0;
  311. spin_lock_irqsave(&usbhid->ctrllock, flags);
  312. switch (urb->status) {
  313. case 0: /* success */
  314. if (usbhid->ctrl[usbhid->ctrltail].dir == USB_DIR_IN)
  315. hid_input_report(urb->context, usbhid->ctrl[usbhid->ctrltail].report->type,
  316. urb->transfer_buffer, urb->actual_length, 0);
  317. break;
  318. case -ESHUTDOWN: /* unplug */
  319. unplug = 1;
  320. case -EILSEQ: /* protocol error or unplug */
  321. case -EPROTO: /* protocol error or unplug */
  322. case -ECONNRESET: /* unlink */
  323. case -ENOENT:
  324. case -EPIPE: /* report not available */
  325. break;
  326. default: /* error */
  327. warn("ctrl urb status %d received", urb->status);
  328. }
  329. if (unplug)
  330. usbhid->ctrltail = usbhid->ctrlhead;
  331. else
  332. usbhid->ctrltail = (usbhid->ctrltail + 1) & (HID_CONTROL_FIFO_SIZE - 1);
  333. if (usbhid->ctrlhead != usbhid->ctrltail) {
  334. if (hid_submit_ctrl(hid)) {
  335. clear_bit(HID_CTRL_RUNNING, &usbhid->iofl);
  336. wake_up(&hid->wait);
  337. }
  338. spin_unlock_irqrestore(&usbhid->ctrllock, flags);
  339. return;
  340. }
  341. clear_bit(HID_CTRL_RUNNING, &usbhid->iofl);
  342. spin_unlock_irqrestore(&usbhid->ctrllock, flags);
  343. wake_up(&hid->wait);
  344. }
  345. void usbhid_submit_report(struct hid_device *hid, struct hid_report *report, unsigned char dir)
  346. {
  347. int head;
  348. unsigned long flags;
  349. struct usbhid_device *usbhid = hid->driver_data;
  350. if ((hid->quirks & HID_QUIRK_NOGET) && dir == USB_DIR_IN)
  351. return;
  352. if (usbhid->urbout && dir == USB_DIR_OUT && report->type == HID_OUTPUT_REPORT) {
  353. spin_lock_irqsave(&usbhid->outlock, flags);
  354. if ((head = (usbhid->outhead + 1) & (HID_OUTPUT_FIFO_SIZE - 1)) == usbhid->outtail) {
  355. spin_unlock_irqrestore(&usbhid->outlock, flags);
  356. warn("output queue full");
  357. return;
  358. }
  359. usbhid->out[usbhid->outhead] = report;
  360. usbhid->outhead = head;
  361. if (!test_and_set_bit(HID_OUT_RUNNING, &usbhid->iofl))
  362. if (hid_submit_out(hid))
  363. clear_bit(HID_OUT_RUNNING, &usbhid->iofl);
  364. spin_unlock_irqrestore(&usbhid->outlock, flags);
  365. return;
  366. }
  367. spin_lock_irqsave(&usbhid->ctrllock, flags);
  368. if ((head = (usbhid->ctrlhead + 1) & (HID_CONTROL_FIFO_SIZE - 1)) == usbhid->ctrltail) {
  369. spin_unlock_irqrestore(&usbhid->ctrllock, flags);
  370. warn("control queue full");
  371. return;
  372. }
  373. usbhid->ctrl[usbhid->ctrlhead].report = report;
  374. usbhid->ctrl[usbhid->ctrlhead].dir = dir;
  375. usbhid->ctrlhead = head;
  376. if (!test_and_set_bit(HID_CTRL_RUNNING, &usbhid->iofl))
  377. if (hid_submit_ctrl(hid))
  378. clear_bit(HID_CTRL_RUNNING, &usbhid->iofl);
  379. spin_unlock_irqrestore(&usbhid->ctrllock, flags);
  380. }
  381. static int usb_hidinput_input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)
  382. {
  383. struct hid_device *hid = input_get_drvdata(dev);
  384. struct hid_field *field;
  385. int offset;
  386. if (type == EV_FF)
  387. return input_ff_event(dev, type, code, value);
  388. if (type != EV_LED)
  389. return -1;
  390. if ((offset = hidinput_find_field(hid, type, code, &field)) == -1) {
  391. warn("event field not found");
  392. return -1;
  393. }
  394. hid_set_field(field, offset, value);
  395. usbhid_submit_report(hid, field->report, USB_DIR_OUT);
  396. return 0;
  397. }
  398. int usbhid_wait_io(struct hid_device *hid)
  399. {
  400. struct usbhid_device *usbhid = hid->driver_data;
  401. if (!wait_event_timeout(hid->wait, (!test_bit(HID_CTRL_RUNNING, &usbhid->iofl) &&
  402. !test_bit(HID_OUT_RUNNING, &usbhid->iofl)),
  403. 10*HZ)) {
  404. dbg_hid("timeout waiting for ctrl or out queue to clear\n");
  405. return -1;
  406. }
  407. return 0;
  408. }
  409. static int hid_set_idle(struct usb_device *dev, int ifnum, int report, int idle)
  410. {
  411. return usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
  412. HID_REQ_SET_IDLE, USB_TYPE_CLASS | USB_RECIP_INTERFACE, (idle << 8) | report,
  413. ifnum, NULL, 0, USB_CTRL_SET_TIMEOUT);
  414. }
  415. static int hid_get_class_descriptor(struct usb_device *dev, int ifnum,
  416. unsigned char type, void *buf, int size)
  417. {
  418. int result, retries = 4;
  419. memset(buf, 0, size);
  420. do {
  421. result = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
  422. USB_REQ_GET_DESCRIPTOR, USB_RECIP_INTERFACE | USB_DIR_IN,
  423. (type << 8), ifnum, buf, size, USB_CTRL_GET_TIMEOUT);
  424. retries--;
  425. } while (result < size && retries);
  426. return result;
  427. }
  428. int usbhid_open(struct hid_device *hid)
  429. {
  430. ++hid->open;
  431. if (hid_start_in(hid))
  432. hid_io_error(hid);
  433. return 0;
  434. }
  435. void usbhid_close(struct hid_device *hid)
  436. {
  437. struct usbhid_device *usbhid = hid->driver_data;
  438. if (!--hid->open)
  439. usb_kill_urb(usbhid->urbin);
  440. }
  441. /*
  442. * Initialize all reports
  443. */
  444. void usbhid_init_reports(struct hid_device *hid)
  445. {
  446. struct hid_report *report;
  447. struct usbhid_device *usbhid = hid->driver_data;
  448. int err, ret;
  449. list_for_each_entry(report, &hid->report_enum[HID_INPUT_REPORT].report_list, list)
  450. usbhid_submit_report(hid, report, USB_DIR_IN);
  451. list_for_each_entry(report, &hid->report_enum[HID_FEATURE_REPORT].report_list, list)
  452. usbhid_submit_report(hid, report, USB_DIR_IN);
  453. err = 0;
  454. ret = usbhid_wait_io(hid);
  455. while (ret) {
  456. err |= ret;
  457. if (test_bit(HID_CTRL_RUNNING, &usbhid->iofl))
  458. usb_kill_urb(usbhid->urbctrl);
  459. if (test_bit(HID_OUT_RUNNING, &usbhid->iofl))
  460. usb_kill_urb(usbhid->urbout);
  461. ret = usbhid_wait_io(hid);
  462. }
  463. if (err)
  464. warn("timeout initializing reports");
  465. }
  466. /*
  467. * Reset LEDs which BIOS might have left on. For now, just NumLock (0x01).
  468. */
  469. static int hid_find_field_early(struct hid_device *hid, unsigned int page,
  470. unsigned int hid_code, struct hid_field **pfield)
  471. {
  472. struct hid_report *report;
  473. struct hid_field *field;
  474. struct hid_usage *usage;
  475. int i, j;
  476. list_for_each_entry(report, &hid->report_enum[HID_OUTPUT_REPORT].report_list, list) {
  477. for (i = 0; i < report->maxfield; i++) {
  478. field = report->field[i];
  479. for (j = 0; j < field->maxusage; j++) {
  480. usage = &field->usage[j];
  481. if ((usage->hid & HID_USAGE_PAGE) == page &&
  482. (usage->hid & 0xFFFF) == hid_code) {
  483. *pfield = field;
  484. return j;
  485. }
  486. }
  487. }
  488. }
  489. return -1;
  490. }
  491. static void usbhid_set_leds(struct hid_device *hid)
  492. {
  493. struct hid_field *field;
  494. int offset;
  495. if ((offset = hid_find_field_early(hid, HID_UP_LED, 0x01, &field)) != -1) {
  496. hid_set_field(field, offset, 0);
  497. usbhid_submit_report(hid, field->report, USB_DIR_OUT);
  498. }
  499. }
  500. /*
  501. * Traverse the supplied list of reports and find the longest
  502. */
  503. static void hid_find_max_report(struct hid_device *hid, unsigned int type, int *max)
  504. {
  505. struct hid_report *report;
  506. int size;
  507. list_for_each_entry(report, &hid->report_enum[type].report_list, list) {
  508. size = ((report->size - 1) >> 3) + 1;
  509. if (type == HID_INPUT_REPORT && hid->report_enum[type].numbered)
  510. size++;
  511. if (*max < size)
  512. *max = size;
  513. }
  514. }
  515. static int hid_alloc_buffers(struct usb_device *dev, struct hid_device *hid)
  516. {
  517. struct usbhid_device *usbhid = hid->driver_data;
  518. if (!(usbhid->inbuf = usb_buffer_alloc(dev, usbhid->bufsize, GFP_ATOMIC, &usbhid->inbuf_dma)))
  519. return -1;
  520. if (!(usbhid->outbuf = usb_buffer_alloc(dev, usbhid->bufsize, GFP_ATOMIC, &usbhid->outbuf_dma)))
  521. return -1;
  522. if (!(usbhid->cr = usb_buffer_alloc(dev, sizeof(*(usbhid->cr)), GFP_ATOMIC, &usbhid->cr_dma)))
  523. return -1;
  524. if (!(usbhid->ctrlbuf = usb_buffer_alloc(dev, usbhid->bufsize, GFP_ATOMIC, &usbhid->ctrlbuf_dma)))
  525. return -1;
  526. return 0;
  527. }
  528. static void hid_free_buffers(struct usb_device *dev, struct hid_device *hid)
  529. {
  530. struct usbhid_device *usbhid = hid->driver_data;
  531. usb_buffer_free(dev, usbhid->bufsize, usbhid->inbuf, usbhid->inbuf_dma);
  532. usb_buffer_free(dev, usbhid->bufsize, usbhid->outbuf, usbhid->outbuf_dma);
  533. usb_buffer_free(dev, sizeof(*(usbhid->cr)), usbhid->cr, usbhid->cr_dma);
  534. usb_buffer_free(dev, usbhid->bufsize, usbhid->ctrlbuf, usbhid->ctrlbuf_dma);
  535. }
  536. /*
  537. * Sending HID_REQ_GET_REPORT changes the operation mode of the ps3 controller
  538. * to "operational". Without this, the ps3 controller will not report any
  539. * events.
  540. */
  541. static void hid_fixup_sony_ps3_controller(struct usb_device *dev, int ifnum)
  542. {
  543. int result;
  544. char *buf = kmalloc(18, GFP_KERNEL);
  545. if (!buf)
  546. return;
  547. result = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
  548. HID_REQ_GET_REPORT,
  549. USB_DIR_IN | USB_TYPE_CLASS |
  550. USB_RECIP_INTERFACE,
  551. (3 << 8) | 0xf2, ifnum, buf, 17,
  552. USB_CTRL_GET_TIMEOUT);
  553. if (result < 0)
  554. err_hid("%s failed: %d\n", __func__, result);
  555. kfree(buf);
  556. }
  557. static struct hid_device *usb_hid_configure(struct usb_interface *intf)
  558. {
  559. struct usb_host_interface *interface = intf->cur_altsetting;
  560. struct usb_device *dev = interface_to_usbdev (intf);
  561. struct hid_descriptor *hdesc;
  562. struct hid_device *hid;
  563. u32 quirks = 0;
  564. unsigned rsize = 0;
  565. char *rdesc;
  566. int n, len, insize = 0;
  567. struct usbhid_device *usbhid;
  568. quirks = usbhid_lookup_quirk(le16_to_cpu(dev->descriptor.idVendor),
  569. le16_to_cpu(dev->descriptor.idProduct));
  570. /* Many keyboards and mice don't like to be polled for reports,
  571. * so we will always set the HID_QUIRK_NOGET flag for them. */
  572. if (interface->desc.bInterfaceSubClass == USB_INTERFACE_SUBCLASS_BOOT) {
  573. if (interface->desc.bInterfaceProtocol == USB_INTERFACE_PROTOCOL_KEYBOARD ||
  574. interface->desc.bInterfaceProtocol == USB_INTERFACE_PROTOCOL_MOUSE)
  575. quirks |= HID_QUIRK_NOGET;
  576. }
  577. if (quirks & HID_QUIRK_IGNORE)
  578. return NULL;
  579. if ((quirks & HID_QUIRK_IGNORE_MOUSE) &&
  580. (interface->desc.bInterfaceProtocol == USB_INTERFACE_PROTOCOL_MOUSE))
  581. return NULL;
  582. if (usb_get_extra_descriptor(interface, HID_DT_HID, &hdesc) &&
  583. (!interface->desc.bNumEndpoints ||
  584. usb_get_extra_descriptor(&interface->endpoint[0], HID_DT_HID, &hdesc))) {
  585. dbg_hid("class descriptor not present\n");
  586. return NULL;
  587. }
  588. for (n = 0; n < hdesc->bNumDescriptors; n++)
  589. if (hdesc->desc[n].bDescriptorType == HID_DT_REPORT)
  590. rsize = le16_to_cpu(hdesc->desc[n].wDescriptorLength);
  591. if (!rsize || rsize > HID_MAX_DESCRIPTOR_SIZE) {
  592. dbg_hid("weird size of report descriptor (%u)\n", rsize);
  593. return NULL;
  594. }
  595. if (!(rdesc = kmalloc(rsize, GFP_KERNEL))) {
  596. dbg_hid("couldn't allocate rdesc memory\n");
  597. return NULL;
  598. }
  599. hid_set_idle(dev, interface->desc.bInterfaceNumber, 0, 0);
  600. if ((n = hid_get_class_descriptor(dev, interface->desc.bInterfaceNumber, HID_DT_REPORT, rdesc, rsize)) < 0) {
  601. dbg_hid("reading report descriptor failed\n");
  602. kfree(rdesc);
  603. return NULL;
  604. }
  605. usbhid_fixup_report_descriptor(le16_to_cpu(dev->descriptor.idVendor),
  606. le16_to_cpu(dev->descriptor.idProduct), rdesc,
  607. rsize, rdesc_quirks_param);
  608. dbg_hid("report descriptor (size %u, read %d) = ", rsize, n);
  609. for (n = 0; n < rsize; n++)
  610. dbg_hid_line(" %02x", (unsigned char) rdesc[n]);
  611. dbg_hid_line("\n");
  612. if (!(hid = hid_parse_report(rdesc, n))) {
  613. dbg_hid("parsing report descriptor failed\n");
  614. kfree(rdesc);
  615. return NULL;
  616. }
  617. kfree(rdesc);
  618. hid->quirks = quirks;
  619. if (!(usbhid = kzalloc(sizeof(struct usbhid_device), GFP_KERNEL)))
  620. goto fail;
  621. hid->driver_data = usbhid;
  622. usbhid->hid = hid;
  623. usbhid->bufsize = HID_MIN_BUFFER_SIZE;
  624. hid_find_max_report(hid, HID_INPUT_REPORT, &usbhid->bufsize);
  625. hid_find_max_report(hid, HID_OUTPUT_REPORT, &usbhid->bufsize);
  626. hid_find_max_report(hid, HID_FEATURE_REPORT, &usbhid->bufsize);
  627. if (usbhid->bufsize > HID_MAX_BUFFER_SIZE)
  628. usbhid->bufsize = HID_MAX_BUFFER_SIZE;
  629. hid_find_max_report(hid, HID_INPUT_REPORT, &insize);
  630. if (insize > HID_MAX_BUFFER_SIZE)
  631. insize = HID_MAX_BUFFER_SIZE;
  632. if (hid_alloc_buffers(dev, hid)) {
  633. hid_free_buffers(dev, hid);
  634. goto fail;
  635. }
  636. for (n = 0; n < interface->desc.bNumEndpoints; n++) {
  637. struct usb_endpoint_descriptor *endpoint;
  638. int pipe;
  639. int interval;
  640. endpoint = &interface->endpoint[n].desc;
  641. if ((endpoint->bmAttributes & 3) != 3) /* Not an interrupt endpoint */
  642. continue;
  643. interval = endpoint->bInterval;
  644. /* Change the polling interval of mice. */
  645. if (hid->collection->usage == HID_GD_MOUSE && hid_mousepoll_interval > 0)
  646. interval = hid_mousepoll_interval;
  647. if (usb_endpoint_dir_in(endpoint)) {
  648. if (usbhid->urbin)
  649. continue;
  650. if (!(usbhid->urbin = usb_alloc_urb(0, GFP_KERNEL)))
  651. goto fail;
  652. pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);
  653. usb_fill_int_urb(usbhid->urbin, dev, pipe, usbhid->inbuf, insize,
  654. hid_irq_in, hid, interval);
  655. usbhid->urbin->transfer_dma = usbhid->inbuf_dma;
  656. usbhid->urbin->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  657. } else {
  658. if (usbhid->urbout)
  659. continue;
  660. if (!(usbhid->urbout = usb_alloc_urb(0, GFP_KERNEL)))
  661. goto fail;
  662. pipe = usb_sndintpipe(dev, endpoint->bEndpointAddress);
  663. usb_fill_int_urb(usbhid->urbout, dev, pipe, usbhid->outbuf, 0,
  664. hid_irq_out, hid, interval);
  665. usbhid->urbout->transfer_dma = usbhid->outbuf_dma;
  666. usbhid->urbout->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  667. }
  668. }
  669. if (!usbhid->urbin) {
  670. err_hid("couldn't find an input interrupt endpoint");
  671. goto fail;
  672. }
  673. init_waitqueue_head(&hid->wait);
  674. INIT_WORK(&usbhid->reset_work, hid_reset);
  675. setup_timer(&usbhid->io_retry, hid_retry_timeout, (unsigned long) hid);
  676. spin_lock_init(&usbhid->inlock);
  677. spin_lock_init(&usbhid->outlock);
  678. spin_lock_init(&usbhid->ctrllock);
  679. hid->version = le16_to_cpu(hdesc->bcdHID);
  680. hid->country = hdesc->bCountryCode;
  681. hid->dev = &intf->dev;
  682. usbhid->intf = intf;
  683. usbhid->ifnum = interface->desc.bInterfaceNumber;
  684. hid->name[0] = 0;
  685. if (dev->manufacturer)
  686. strlcpy(hid->name, dev->manufacturer, sizeof(hid->name));
  687. if (dev->product) {
  688. if (dev->manufacturer)
  689. strlcat(hid->name, " ", sizeof(hid->name));
  690. strlcat(hid->name, dev->product, sizeof(hid->name));
  691. }
  692. if (!strlen(hid->name))
  693. snprintf(hid->name, sizeof(hid->name), "HID %04x:%04x",
  694. le16_to_cpu(dev->descriptor.idVendor),
  695. le16_to_cpu(dev->descriptor.idProduct));
  696. hid->bus = BUS_USB;
  697. hid->vendor = le16_to_cpu(dev->descriptor.idVendor);
  698. hid->product = le16_to_cpu(dev->descriptor.idProduct);
  699. usb_make_path(dev, hid->phys, sizeof(hid->phys));
  700. strlcat(hid->phys, "/input", sizeof(hid->phys));
  701. len = strlen(hid->phys);
  702. if (len < sizeof(hid->phys) - 1)
  703. snprintf(hid->phys + len, sizeof(hid->phys) - len,
  704. "%d", intf->altsetting[0].desc.bInterfaceNumber);
  705. if (usb_string(dev, dev->descriptor.iSerialNumber, hid->uniq, 64) <= 0)
  706. hid->uniq[0] = 0;
  707. usbhid->urbctrl = usb_alloc_urb(0, GFP_KERNEL);
  708. if (!usbhid->urbctrl)
  709. goto fail;
  710. usb_fill_control_urb(usbhid->urbctrl, dev, 0, (void *) usbhid->cr,
  711. usbhid->ctrlbuf, 1, hid_ctrl, hid);
  712. usbhid->urbctrl->setup_dma = usbhid->cr_dma;
  713. usbhid->urbctrl->transfer_dma = usbhid->ctrlbuf_dma;
  714. usbhid->urbctrl->transfer_flags |= (URB_NO_TRANSFER_DMA_MAP | URB_NO_SETUP_DMA_MAP);
  715. hid->hidinput_input_event = usb_hidinput_input_event;
  716. hid->hid_open = usbhid_open;
  717. hid->hid_close = usbhid_close;
  718. #ifdef CONFIG_USB_HIDDEV
  719. hid->hiddev_hid_event = hiddev_hid_event;
  720. hid->hiddev_report_event = hiddev_report_event;
  721. #endif
  722. return hid;
  723. fail:
  724. usb_free_urb(usbhid->urbin);
  725. usb_free_urb(usbhid->urbout);
  726. usb_free_urb(usbhid->urbctrl);
  727. hid_free_buffers(dev, hid);
  728. hid_free_device(hid);
  729. return NULL;
  730. }
  731. static void hid_disconnect(struct usb_interface *intf)
  732. {
  733. struct hid_device *hid = usb_get_intfdata (intf);
  734. struct usbhid_device *usbhid;
  735. if (!hid)
  736. return;
  737. usbhid = hid->driver_data;
  738. spin_lock_irq(&usbhid->inlock); /* Sync with error handler */
  739. usb_set_intfdata(intf, NULL);
  740. spin_unlock_irq(&usbhid->inlock);
  741. usb_kill_urb(usbhid->urbin);
  742. usb_kill_urb(usbhid->urbout);
  743. usb_kill_urb(usbhid->urbctrl);
  744. del_timer_sync(&usbhid->io_retry);
  745. cancel_work_sync(&usbhid->reset_work);
  746. if (hid->claimed & HID_CLAIMED_INPUT)
  747. hidinput_disconnect(hid);
  748. if (hid->claimed & HID_CLAIMED_HIDDEV)
  749. hiddev_disconnect(hid);
  750. usb_free_urb(usbhid->urbin);
  751. usb_free_urb(usbhid->urbctrl);
  752. usb_free_urb(usbhid->urbout);
  753. hid_free_buffers(hid_to_usb_dev(hid), hid);
  754. hid_free_device(hid);
  755. }
  756. static int hid_probe(struct usb_interface *intf, const struct usb_device_id *id)
  757. {
  758. struct hid_device *hid;
  759. char path[64];
  760. int i;
  761. char *c;
  762. dbg_hid("HID probe called for ifnum %d\n",
  763. intf->altsetting->desc.bInterfaceNumber);
  764. if (!(hid = usb_hid_configure(intf)))
  765. return -ENODEV;
  766. usbhid_init_reports(hid);
  767. hid_dump_device(hid);
  768. if (hid->quirks & HID_QUIRK_RESET_LEDS)
  769. usbhid_set_leds(hid);
  770. if (!hidinput_connect(hid))
  771. hid->claimed |= HID_CLAIMED_INPUT;
  772. if (!hiddev_connect(hid))
  773. hid->claimed |= HID_CLAIMED_HIDDEV;
  774. usb_set_intfdata(intf, hid);
  775. if (!hid->claimed) {
  776. printk ("HID device not claimed by input or hiddev\n");
  777. hid_disconnect(intf);
  778. return -ENODEV;
  779. }
  780. if ((hid->claimed & HID_CLAIMED_INPUT))
  781. hid_ff_init(hid);
  782. if (hid->quirks & HID_QUIRK_SONY_PS3_CONTROLLER)
  783. hid_fixup_sony_ps3_controller(interface_to_usbdev(intf),
  784. intf->cur_altsetting->desc.bInterfaceNumber);
  785. printk(KERN_INFO);
  786. if (hid->claimed & HID_CLAIMED_INPUT)
  787. printk("input");
  788. if (hid->claimed == (HID_CLAIMED_INPUT | HID_CLAIMED_HIDDEV))
  789. printk(",");
  790. if (hid->claimed & HID_CLAIMED_HIDDEV)
  791. printk("hiddev%d", hid->minor);
  792. c = "Device";
  793. for (i = 0; i < hid->maxcollection; i++) {
  794. if (hid->collection[i].type == HID_COLLECTION_APPLICATION &&
  795. (hid->collection[i].usage & HID_USAGE_PAGE) == HID_UP_GENDESK &&
  796. (hid->collection[i].usage & 0xffff) < ARRAY_SIZE(hid_types)) {
  797. c = hid_types[hid->collection[i].usage & 0xffff];
  798. break;
  799. }
  800. }
  801. usb_make_path(interface_to_usbdev(intf), path, 63);
  802. printk(": USB HID v%x.%02x %s [%s] on %s\n",
  803. hid->version >> 8, hid->version & 0xff, c, hid->name, path);
  804. return 0;
  805. }
  806. static int hid_suspend(struct usb_interface *intf, pm_message_t message)
  807. {
  808. struct hid_device *hid = usb_get_intfdata (intf);
  809. struct usbhid_device *usbhid = hid->driver_data;
  810. spin_lock_irq(&usbhid->inlock); /* Sync with error handler */
  811. set_bit(HID_SUSPENDED, &usbhid->iofl);
  812. spin_unlock_irq(&usbhid->inlock);
  813. del_timer(&usbhid->io_retry);
  814. usb_kill_urb(usbhid->urbin);
  815. dev_dbg(&intf->dev, "suspend\n");
  816. return 0;
  817. }
  818. static int hid_resume(struct usb_interface *intf)
  819. {
  820. struct hid_device *hid = usb_get_intfdata (intf);
  821. struct usbhid_device *usbhid = hid->driver_data;
  822. int status;
  823. clear_bit(HID_SUSPENDED, &usbhid->iofl);
  824. usbhid->retry_delay = 0;
  825. status = hid_start_in(hid);
  826. dev_dbg(&intf->dev, "resume status %d\n", status);
  827. return status;
  828. }
  829. /* Treat USB reset pretty much the same as suspend/resume */
  830. static int hid_pre_reset(struct usb_interface *intf)
  831. {
  832. /* FIXME: What if the interface is already suspended? */
  833. hid_suspend(intf, PMSG_ON);
  834. return 0;
  835. }
  836. /* Same routine used for post_reset and reset_resume */
  837. static int hid_post_reset(struct usb_interface *intf)
  838. {
  839. struct usb_device *dev = interface_to_usbdev (intf);
  840. hid_set_idle(dev, intf->cur_altsetting->desc.bInterfaceNumber, 0, 0);
  841. /* FIXME: Any more reinitialization needed? */
  842. return hid_resume(intf);
  843. }
  844. static struct usb_device_id hid_usb_ids [] = {
  845. { .match_flags = USB_DEVICE_ID_MATCH_INT_CLASS,
  846. .bInterfaceClass = USB_INTERFACE_CLASS_HID },
  847. { } /* Terminating entry */
  848. };
  849. MODULE_DEVICE_TABLE (usb, hid_usb_ids);
  850. static struct usb_driver hid_driver = {
  851. .name = "usbhid",
  852. .probe = hid_probe,
  853. .disconnect = hid_disconnect,
  854. .suspend = hid_suspend,
  855. .resume = hid_resume,
  856. .reset_resume = hid_post_reset,
  857. .pre_reset = hid_pre_reset,
  858. .post_reset = hid_post_reset,
  859. .id_table = hid_usb_ids,
  860. };
  861. static int __init hid_init(void)
  862. {
  863. int retval;
  864. retval = usbhid_quirks_init(quirks_param);
  865. if (retval)
  866. goto usbhid_quirks_init_fail;
  867. retval = hiddev_init();
  868. if (retval)
  869. goto hiddev_init_fail;
  870. retval = usb_register(&hid_driver);
  871. if (retval)
  872. goto usb_register_fail;
  873. info(DRIVER_VERSION ":" DRIVER_DESC);
  874. return 0;
  875. usb_register_fail:
  876. hiddev_exit();
  877. hiddev_init_fail:
  878. usbhid_quirks_exit();
  879. usbhid_quirks_init_fail:
  880. return retval;
  881. }
  882. static void __exit hid_exit(void)
  883. {
  884. usb_deregister(&hid_driver);
  885. hiddev_exit();
  886. usbhid_quirks_exit();
  887. }
  888. module_init(hid_init);
  889. module_exit(hid_exit);
  890. MODULE_AUTHOR(DRIVER_AUTHOR);
  891. MODULE_DESCRIPTION(DRIVER_DESC);
  892. MODULE_LICENSE(DRIVER_LICENSE);