hid-core.c 30 KB

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