hid-core.c 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137
  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("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("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("submitting out urb");
  210. if (usb_submit_urb(usbhid->urbout, GFP_ATOMIC)) {
  211. err("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("submitting ctrl urb: %s wValue=0x%04x wIndex=0x%04x wLength=%u",
  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("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("timeout waiting for ctrl or out queue to clear");
  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("%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("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("weird size of report descriptor (%u)", rsize);
  634. return NULL;
  635. }
  636. if (!(rdesc = kmalloc(rsize, GFP_KERNEL))) {
  637. dbg("couldn't allocate rdesc memory");
  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("reading report descriptor failed");
  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. #ifdef CONFIG_HID_DEBUG
  653. printk(KERN_DEBUG __FILE__ ": report descriptor (size %u, read %d) = ", rsize, n);
  654. for (n = 0; n < rsize; n++)
  655. printk(" %02x", (unsigned char) rdesc[n]);
  656. printk("\n");
  657. #endif
  658. if (!(hid = hid_parse_report(rdesc, n))) {
  659. dbg("parsing report descriptor failed");
  660. kfree(rdesc);
  661. return NULL;
  662. }
  663. kfree(rdesc);
  664. hid->quirks = quirks;
  665. if (!(usbhid = kzalloc(sizeof(struct usbhid_device), GFP_KERNEL)))
  666. goto fail;
  667. hid->driver_data = usbhid;
  668. usbhid->hid = hid;
  669. usbhid->bufsize = HID_MIN_BUFFER_SIZE;
  670. hid_find_max_report(hid, HID_INPUT_REPORT, &usbhid->bufsize);
  671. hid_find_max_report(hid, HID_OUTPUT_REPORT, &usbhid->bufsize);
  672. hid_find_max_report(hid, HID_FEATURE_REPORT, &usbhid->bufsize);
  673. if (usbhid->bufsize > HID_MAX_BUFFER_SIZE)
  674. usbhid->bufsize = HID_MAX_BUFFER_SIZE;
  675. hid_find_max_report(hid, HID_INPUT_REPORT, &insize);
  676. if (insize > HID_MAX_BUFFER_SIZE)
  677. insize = HID_MAX_BUFFER_SIZE;
  678. if (hid_alloc_buffers(dev, hid)) {
  679. hid_free_buffers(dev, hid);
  680. goto fail;
  681. }
  682. for (n = 0; n < interface->desc.bNumEndpoints; n++) {
  683. struct usb_endpoint_descriptor *endpoint;
  684. int pipe;
  685. int interval;
  686. endpoint = &interface->endpoint[n].desc;
  687. if ((endpoint->bmAttributes & 3) != 3) /* Not an interrupt endpoint */
  688. continue;
  689. interval = endpoint->bInterval;
  690. /* Change the polling interval of mice. */
  691. if (hid->collection->usage == HID_GD_MOUSE && hid_mousepoll_interval > 0)
  692. interval = hid_mousepoll_interval;
  693. if (usb_endpoint_dir_in(endpoint)) {
  694. if (usbhid->urbin)
  695. continue;
  696. if (!(usbhid->urbin = usb_alloc_urb(0, GFP_KERNEL)))
  697. goto fail;
  698. pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);
  699. usb_fill_int_urb(usbhid->urbin, dev, pipe, usbhid->inbuf, insize,
  700. hid_irq_in, hid, interval);
  701. usbhid->urbin->transfer_dma = usbhid->inbuf_dma;
  702. usbhid->urbin->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  703. } else {
  704. if (usbhid->urbout)
  705. continue;
  706. if (!(usbhid->urbout = usb_alloc_urb(0, GFP_KERNEL)))
  707. goto fail;
  708. pipe = usb_sndintpipe(dev, endpoint->bEndpointAddress);
  709. usb_fill_int_urb(usbhid->urbout, dev, pipe, usbhid->outbuf, 0,
  710. hid_irq_out, hid, interval);
  711. usbhid->urbout->transfer_dma = usbhid->outbuf_dma;
  712. usbhid->urbout->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  713. }
  714. }
  715. if (!usbhid->urbin) {
  716. err("couldn't find an input interrupt endpoint");
  717. goto fail;
  718. }
  719. init_waitqueue_head(&hid->wait);
  720. INIT_WORK(&usbhid->reset_work, hid_reset);
  721. setup_timer(&usbhid->io_retry, hid_retry_timeout, (unsigned long) hid);
  722. spin_lock_init(&usbhid->inlock);
  723. spin_lock_init(&usbhid->outlock);
  724. spin_lock_init(&usbhid->ctrllock);
  725. hid->version = le16_to_cpu(hdesc->bcdHID);
  726. hid->country = hdesc->bCountryCode;
  727. hid->dev = &intf->dev;
  728. usbhid->intf = intf;
  729. usbhid->ifnum = interface->desc.bInterfaceNumber;
  730. hid->name[0] = 0;
  731. if (dev->manufacturer)
  732. strlcpy(hid->name, dev->manufacturer, sizeof(hid->name));
  733. if (dev->product) {
  734. if (dev->manufacturer)
  735. strlcat(hid->name, " ", sizeof(hid->name));
  736. strlcat(hid->name, dev->product, sizeof(hid->name));
  737. }
  738. if (!strlen(hid->name))
  739. snprintf(hid->name, sizeof(hid->name), "HID %04x:%04x",
  740. le16_to_cpu(dev->descriptor.idVendor),
  741. le16_to_cpu(dev->descriptor.idProduct));
  742. hid->bus = BUS_USB;
  743. hid->vendor = le16_to_cpu(dev->descriptor.idVendor);
  744. hid->product = le16_to_cpu(dev->descriptor.idProduct);
  745. usb_make_path(dev, hid->phys, sizeof(hid->phys));
  746. strlcat(hid->phys, "/input", sizeof(hid->phys));
  747. len = strlen(hid->phys);
  748. if (len < sizeof(hid->phys) - 1)
  749. snprintf(hid->phys + len, sizeof(hid->phys) - len,
  750. "%d", intf->altsetting[0].desc.bInterfaceNumber);
  751. if (usb_string(dev, dev->descriptor.iSerialNumber, hid->uniq, 64) <= 0)
  752. hid->uniq[0] = 0;
  753. usbhid->urbctrl = usb_alloc_urb(0, GFP_KERNEL);
  754. if (!usbhid->urbctrl)
  755. goto fail;
  756. usb_fill_control_urb(usbhid->urbctrl, dev, 0, (void *) usbhid->cr,
  757. usbhid->ctrlbuf, 1, hid_ctrl, hid);
  758. usbhid->urbctrl->setup_dma = usbhid->cr_dma;
  759. usbhid->urbctrl->transfer_dma = usbhid->ctrlbuf_dma;
  760. usbhid->urbctrl->transfer_flags |= (URB_NO_TRANSFER_DMA_MAP | URB_NO_SETUP_DMA_MAP);
  761. hid->hidinput_input_event = usb_hidinput_input_event;
  762. hid->hid_open = usbhid_open;
  763. hid->hid_close = usbhid_close;
  764. #ifdef CONFIG_USB_HIDDEV
  765. hid->hiddev_hid_event = hiddev_hid_event;
  766. hid->hiddev_report_event = hiddev_report_event;
  767. #endif
  768. return hid;
  769. fail:
  770. usb_free_urb(usbhid->urbin);
  771. usb_free_urb(usbhid->urbout);
  772. usb_free_urb(usbhid->urbctrl);
  773. hid_free_buffers(dev, hid);
  774. hid_free_device(hid);
  775. return NULL;
  776. }
  777. static void hid_disconnect(struct usb_interface *intf)
  778. {
  779. struct hid_device *hid = usb_get_intfdata (intf);
  780. struct usbhid_device *usbhid;
  781. if (!hid)
  782. return;
  783. usbhid = hid->driver_data;
  784. spin_lock_irq(&usbhid->inlock); /* Sync with error handler */
  785. usb_set_intfdata(intf, NULL);
  786. spin_unlock_irq(&usbhid->inlock);
  787. usb_kill_urb(usbhid->urbin);
  788. usb_kill_urb(usbhid->urbout);
  789. usb_kill_urb(usbhid->urbctrl);
  790. del_timer_sync(&usbhid->io_retry);
  791. flush_scheduled_work();
  792. if (hid->claimed & HID_CLAIMED_INPUT)
  793. hidinput_disconnect(hid);
  794. if (hid->claimed & HID_CLAIMED_HIDDEV)
  795. hiddev_disconnect(hid);
  796. usb_free_urb(usbhid->urbin);
  797. usb_free_urb(usbhid->urbctrl);
  798. usb_free_urb(usbhid->urbout);
  799. hid_free_buffers(hid_to_usb_dev(hid), hid);
  800. hid_free_device(hid);
  801. }
  802. static int hid_probe(struct usb_interface *intf, const struct usb_device_id *id)
  803. {
  804. struct hid_device *hid;
  805. char path[64];
  806. int i;
  807. char *c;
  808. dbg("HID probe called for ifnum %d",
  809. intf->altsetting->desc.bInterfaceNumber);
  810. if (!(hid = usb_hid_configure(intf)))
  811. return -ENODEV;
  812. usbhid_init_reports(hid);
  813. hid_dump_device(hid);
  814. if (hid->quirks & HID_QUIRK_RESET_LEDS)
  815. usbhid_set_leds(hid);
  816. if (!hidinput_connect(hid))
  817. hid->claimed |= HID_CLAIMED_INPUT;
  818. if (!hiddev_connect(hid))
  819. hid->claimed |= HID_CLAIMED_HIDDEV;
  820. usb_set_intfdata(intf, hid);
  821. if (!hid->claimed) {
  822. printk ("HID device not claimed by input or hiddev\n");
  823. hid_disconnect(intf);
  824. return -ENODEV;
  825. }
  826. if ((hid->claimed & HID_CLAIMED_INPUT))
  827. hid_ff_init(hid);
  828. if (hid->quirks & HID_QUIRK_SONY_PS3_CONTROLLER)
  829. hid_fixup_sony_ps3_controller(interface_to_usbdev(intf),
  830. intf->cur_altsetting->desc.bInterfaceNumber);
  831. printk(KERN_INFO);
  832. if (hid->claimed & HID_CLAIMED_INPUT)
  833. printk("input");
  834. if (hid->claimed == (HID_CLAIMED_INPUT | HID_CLAIMED_HIDDEV))
  835. printk(",");
  836. if (hid->claimed & HID_CLAIMED_HIDDEV)
  837. printk("hiddev%d", hid->minor);
  838. c = "Device";
  839. for (i = 0; i < hid->maxcollection; i++) {
  840. if (hid->collection[i].type == HID_COLLECTION_APPLICATION &&
  841. (hid->collection[i].usage & HID_USAGE_PAGE) == HID_UP_GENDESK &&
  842. (hid->collection[i].usage & 0xffff) < ARRAY_SIZE(hid_types)) {
  843. c = hid_types[hid->collection[i].usage & 0xffff];
  844. break;
  845. }
  846. }
  847. usb_make_path(interface_to_usbdev(intf), path, 63);
  848. printk(": USB HID v%x.%02x %s [%s] on %s\n",
  849. hid->version >> 8, hid->version & 0xff, c, hid->name, path);
  850. return 0;
  851. }
  852. static int hid_suspend(struct usb_interface *intf, pm_message_t message)
  853. {
  854. struct hid_device *hid = usb_get_intfdata (intf);
  855. struct usbhid_device *usbhid = hid->driver_data;
  856. spin_lock_irq(&usbhid->inlock); /* Sync with error handler */
  857. set_bit(HID_SUSPENDED, &usbhid->iofl);
  858. spin_unlock_irq(&usbhid->inlock);
  859. del_timer(&usbhid->io_retry);
  860. usb_kill_urb(usbhid->urbin);
  861. dev_dbg(&intf->dev, "suspend\n");
  862. return 0;
  863. }
  864. static int hid_resume(struct usb_interface *intf)
  865. {
  866. struct hid_device *hid = usb_get_intfdata (intf);
  867. struct usbhid_device *usbhid = hid->driver_data;
  868. int status;
  869. clear_bit(HID_SUSPENDED, &usbhid->iofl);
  870. usbhid->retry_delay = 0;
  871. status = hid_start_in(hid);
  872. dev_dbg(&intf->dev, "resume status %d\n", status);
  873. return status;
  874. }
  875. /* Treat USB reset pretty much the same as suspend/resume */
  876. static void hid_pre_reset(struct usb_interface *intf)
  877. {
  878. /* FIXME: What if the interface is already suspended? */
  879. hid_suspend(intf, PMSG_ON);
  880. }
  881. static void hid_post_reset(struct usb_interface *intf)
  882. {
  883. struct usb_device *dev = interface_to_usbdev (intf);
  884. hid_set_idle(dev, intf->cur_altsetting->desc.bInterfaceNumber, 0, 0);
  885. /* FIXME: Any more reinitialization needed? */
  886. hid_resume(intf);
  887. }
  888. static struct usb_device_id hid_usb_ids [] = {
  889. { .match_flags = USB_DEVICE_ID_MATCH_INT_CLASS,
  890. .bInterfaceClass = USB_INTERFACE_CLASS_HID },
  891. { } /* Terminating entry */
  892. };
  893. MODULE_DEVICE_TABLE (usb, hid_usb_ids);
  894. static struct usb_driver hid_driver = {
  895. .name = "usbhid",
  896. .probe = hid_probe,
  897. .disconnect = hid_disconnect,
  898. .suspend = hid_suspend,
  899. .resume = hid_resume,
  900. .pre_reset = hid_pre_reset,
  901. .post_reset = hid_post_reset,
  902. .id_table = hid_usb_ids,
  903. };
  904. static int __init hid_init(void)
  905. {
  906. int retval;
  907. retval = usbhid_quirks_init(quirks_param);
  908. if (retval)
  909. goto usbhid_quirks_init_fail;
  910. retval = hiddev_init();
  911. if (retval)
  912. goto hiddev_init_fail;
  913. retval = usb_register(&hid_driver);
  914. if (retval)
  915. goto usb_register_fail;
  916. info(DRIVER_VERSION ":" DRIVER_DESC);
  917. return 0;
  918. usb_register_fail:
  919. hiddev_exit();
  920. hiddev_init_fail:
  921. usbhid_quirks_exit();
  922. usbhid_quirks_init_fail:
  923. return retval;
  924. }
  925. static void __exit hid_exit(void)
  926. {
  927. usb_deregister(&hid_driver);
  928. hiddev_exit();
  929. usbhid_quirks_exit();
  930. }
  931. module_init(hid_init);
  932. module_exit(hid_exit);
  933. MODULE_AUTHOR(DRIVER_AUTHOR);
  934. MODULE_DESCRIPTION(DRIVER_DESC);
  935. MODULE_LICENSE(DRIVER_LICENSE);