开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Linux/Unix编程 > 查看源码
hid-core.c
资源名称：linux-2.4.20.tar.gz　[点击查看]
上传用户：jlfgdled
上传日期：2013-04-10
资源大小：33168k
文件大小：33k
源码类别：

Linux/Unix编程

开发平台：

Unix_Linux

hid-core.c：源码内容
  1. /*
  2.  * $Id: hid-core.c,v 1.8 2001/05/23 12:02:18 vojtech Exp $
  3.  *
  4.  *  Copyright (c) 1999 Andreas Gal
  5.  *  Copyright (c) 2000-2001 Vojtech Pavlik
  6.  *
  7.  *  USB HID support for Linux
  8.  *
  9.  *  Sponsored by SuSE
  10.  */
  12. /*
  13.  * This program is free software; you can redistribute it and/or modify
  14.  * it under the terms of the GNU General Public License as published by
  15.  * the Free Software Foundation; either version 2 of the License, or
  16.  * (at your option) any later version.
  17.  *
  18.  * This program is distributed in the hope that it will be useful,
  19.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21.  * GNU General Public License for more details.
  22.  *
  23.  * You should have received a copy of the GNU General Public License
  24.  * along with this program; if not, write to the Free Software
  25.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  26.  *
  27.  * Should you need to contact me, the author, you can do so either by
  28.  * e-mail - mail your message to <vojtech@suse.cz>, or by paper mail:
  29.  * Vojtech Pavlik, Ucitelska 1576, Prague 8, 182 00 Czech Republic
  30.  */
  32. #include <linux/module.h>
  33. #include <linux/slab.h>
  34. #include <linux/init.h>
  35. #include <linux/kernel.h>
  36. #include <linux/sched.h>
  37. #include <linux/list.h>
  38. #include <linux/mm.h>
  39. #include <linux/smp_lock.h>
  40. #include <linux/spinlock.h>
  41. #include <asm/unaligned.h>
  42. #include <linux/input.h>
  44. #undef DEBUG
  45. #undef DEBUG_DATA
  47. #include <linux/usb.h>
  49. #include "hid.h"
  50. #include <linux/hiddev.h>
  52. /*
  53.  * Version Information
  54.  */
  56. #define DRIVER_VERSION "v1.8.1"
  57. #define DRIVER_AUTHOR "Andreas Gal, Vojtech Pavlik <vojtech@suse.cz>"
  58. #define DRIVER_DESC "USB HID support drivers"
  60. static char *hid_types[] = {"Device", "Pointer", "Mouse", "Device", "Joystick",
  61. "Gamepad", "Keyboard", "Keypad", "Multi-Axis Controller"};
  63. /*
  64.  * Register a new report for a device.
  65.  */
  67. static struct hid_report *hid_register_report(struct hid_device *device, unsigned type, unsigned id)
  68. {
  69. struct hid_report_enum *report_enum = device->report_enum + type;
  70. struct hid_report *report;
  72. if (report_enum->report_id_hash[id])
  73. return report_enum->report_id_hash[id];
  75. if (!(report = kmalloc(sizeof(struct hid_report), GFP_KERNEL)))
  76. return NULL;
  77. memset(report, 0, sizeof(struct hid_report));
  79. if (id != 0) report_enum->numbered = 1;
  81. report->id = id;
  82. report->type = type;
  83. report->size = 0;
  84. report->device = device;
  85. report_enum->report_id_hash[id] = report;
  87. list_add_tail(&report->list, &report_enum->report_list);
  89. return report;
  90. }
  92. /*
  93.  * Register a new field for this report.
  94.  */
  96. static struct hid_field *hid_register_field(struct hid_report *report, unsigned usages, unsigned values)
  97. {
  98. struct hid_field *field;
  100. if (report->maxfield == HID_MAX_FIELDS) {
  101. dbg("too many fields in report");
  102. return NULL;
  103. }
  105. if (!(field = kmalloc(sizeof(struct hid_field) + usages * sizeof(struct hid_usage)
  106. + values * sizeof(unsigned), GFP_KERNEL))) return NULL;
  108. memset(field, 0, sizeof(struct hid_field) + usages * sizeof(struct hid_usage)
  109. + values * sizeof(unsigned));
  111. report->field[report->maxfield++] = field;
  112. field->usage = (struct hid_usage *)(field + 1);
  113. field->value = (unsigned *)(field->usage + usages);
  114. field->report = report;
  116. return field;
  117. }
  119. /*
  120.  * Open a collection. The type/usage is pushed on the stack.
  121.  */
  123. static int open_collection(struct hid_parser *parser, unsigned type)
  124. {
  125. struct hid_collection *collection;
  126. unsigned usage;
  128. usage = parser->local.usage[0];
  130. if (type == HID_COLLECTION_APPLICATION
  131. && parser->device->maxapplication < HID_MAX_APPLICATIONS)
  132. parser->device->application[parser->device->maxapplication++] = usage;
  134. if (parser->collection_stack_ptr == HID_COLLECTION_STACK_SIZE) {
  135. dbg("collection stack overflow");
  136. return -1;
  137. }
  139. collection = parser->collection_stack + parser->collection_stack_ptr++;
  140. collection->type = type;
  141. collection->usage = usage;
  143. return 0;
  144. }
  146. /*
  147.  * Close a collection.
  148.  */
  150. static int close_collection(struct hid_parser *parser)
  151. {
  152. if (!parser->collection_stack_ptr) {
  153. dbg("collection stack underflow");
  154. return -1;
  155. }
  156. parser->collection_stack_ptr--;
  157. return 0;
  158. }
  160. /*
  161.  * Climb up the stack, search for the specified collection type
  162.  * and return the usage.
  163.  */
  165. static unsigned hid_lookup_collection(struct hid_parser *parser, unsigned type)
  166. {
  167. int n;
  168. for (n = parser->collection_stack_ptr - 1; n >= 0; n--)
  169. if (parser->collection_stack[n].type == type)
  170. return parser->collection_stack[n].usage;
  171. return 0; /* we know nothing about this usage type */
  172. }
  174. /*
  175.  * Add a usage to the temporary parser table.
  176.  */
  178. static int hid_add_usage(struct hid_parser *parser, unsigned usage)
  179. {
  180. if (parser->local.usage_index >= HID_MAX_USAGES) {
  181. dbg("usage index exceeded");
  182. return -1;
  183. }
  184. parser->local.usage[parser->local.usage_index++] = usage;
  185. return 0;
  186. }
  188. /*
  189.  * Register a new field for this report.
  190.  */
  192. static int hid_add_field(struct hid_parser *parser, unsigned report_type, unsigned flags)
  193. {
  194. struct hid_report *report;
  195. struct hid_field *field;
  196. int usages;
  197. unsigned offset;
  198. int i;
  200. if (!(report = hid_register_report(parser->device, report_type, parser->global.report_id))) {
  201. dbg("hid_register_report failed");
  202. return -1;
  203. }
  205. if (parser->global.logical_maximum <= parser->global.logical_minimum) {
  206. dbg("logical range invalid %d %d", parser->global.logical_minimum, parser->global.logical_maximum);
  207. return -1;
  208. }
  210. usages = parser->local.usage_index;
  212. offset = report->size;
  213. report->size += parser->global.report_size * parser->global.report_count;
  215. if (usages == 0)
  216. return 0; /* ignore padding fields */
  218. if ((field = hid_register_field(report, usages, parser->global.report_count)) == NULL)
  219. return 0;
  221. field->physical = hid_lookup_collection(parser, HID_COLLECTION_PHYSICAL);
  222. field->logical = hid_lookup_collection(parser, HID_COLLECTION_LOGICAL);
  223. field->application = hid_lookup_collection(parser, HID_COLLECTION_APPLICATION);
  225. for (i = 0; i < usages; i++)
  226. field->usage[i].hid = parser->local.usage[i];
  228. field->maxusage = usages;
  229. field->flags = flags;
  230. field->report_offset = offset;
  231. field->report_type = report_type;
  232. field->report_size = parser->global.report_size;
  233. field->report_count = parser->global.report_count;
  234. field->logical_minimum = parser->global.logical_minimum;
  235. field->logical_maximum = parser->global.logical_maximum;
  236. field->physical_minimum = parser->global.physical_minimum;
  237. field->physical_maximum = parser->global.physical_maximum;
  238. field->unit_exponent = parser->global.unit_exponent;
  239. field->unit = parser->global.unit;
  241. return 0;
  242. }
  244. /*
  245.  * Read data value from item.
  246.  */
  248. static __inline__ __u32 item_udata(struct hid_item *item)
  249. {
  250. switch (item->size) {
  251. case 1: return item->data.u8;
  252. case 2: return item->data.u16;
  253. case 4: return item->data.u32;
  254. }
  255. return 0;
  256. }
  258. static __inline__ __s32 item_sdata(struct hid_item *item)
  259. {
  260. switch (item->size) {
  261. case 1: return item->data.s8;
  262. case 2: return item->data.s16;
  263. case 4: return item->data.s32;
  264. }
  265. return 0;
  266. }
  268. /*
  269.  * Process a global item.
  270.  */
  272. static int hid_parser_global(struct hid_parser *parser, struct hid_item *item)
  273. {
  274. switch (item->tag) {
  276. case HID_GLOBAL_ITEM_TAG_PUSH:
  278. if (parser->global_stack_ptr == HID_GLOBAL_STACK_SIZE) {
  279. dbg("global enviroment stack overflow");
  280. return -1;
  281. }
  283. memcpy(parser->global_stack + parser->global_stack_ptr++,
  284. &parser->global, sizeof(struct hid_global));
  285. return 0;
  287. case HID_GLOBAL_ITEM_TAG_POP:
  289. if (!parser->global_stack_ptr) {
  290. dbg("global enviroment stack underflow");
  291. return -1;
  292. }
  294. memcpy(&parser->global, parser->global_stack + --parser->global_stack_ptr,
  295. sizeof(struct hid_global));
  296. return 0;
  298. case HID_GLOBAL_ITEM_TAG_USAGE_PAGE:
  299. parser->global.usage_page = item_udata(item);
  300. return 0;
  302. case HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM:
  303. parser->global.logical_minimum = item_sdata(item);
  304. return 0;
  306. case HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM:
  307. if (parser->global.logical_minimum < 0)
  308. parser->global.logical_maximum = item_sdata(item);
  309. else
  310. parser->global.logical_maximum = item_udata(item);
  311. return 0;
  313. case HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM:
  314. parser->global.physical_minimum = item_sdata(item);
  315. return 0;
  317. case HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM:
  318. if (parser->global.physical_minimum < 0)
  319. parser->global.physical_maximum = item_sdata(item);
  320. else
  321. parser->global.physical_maximum = item_udata(item);
  322. return 0;
  324. case HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT:
  325. parser->global.unit_exponent = item_udata(item);
  326. return 0;
  328. case HID_GLOBAL_ITEM_TAG_UNIT:
  329. parser->global.unit = item_udata(item);
  330. return 0;
  332. case HID_GLOBAL_ITEM_TAG_REPORT_SIZE:
  333. if ((parser->global.report_size = item_udata(item)) > 32) {
  334. dbg("invalid report_size %d", parser->global.report_size);
  335. return -1;
  336. }
  337. return 0;
  339. case HID_GLOBAL_ITEM_TAG_REPORT_COUNT:
  340. if ((parser->global.report_count = item_udata(item)) > HID_MAX_USAGES) {
  341. dbg("invalid report_count %d", parser->global.report_count);
  342. return -1;
  343. }
  344. return 0;
  346. case HID_GLOBAL_ITEM_TAG_REPORT_ID:
  347. if ((parser->global.report_id = item_udata(item)) == 0) {
  348. dbg("report_id 0 is invalid");
  349. return -1;
  350. }
  351. return 0;
  353. default:
  354. dbg("unknown global tag 0x%x", item->tag);
  355. return -1;
  356. }
  357. }
  359. /*
  360.  * Process a local item.
  361.  */
  363. static int hid_parser_local(struct hid_parser *parser, struct hid_item *item)
  364. {
  365. __u32 data;
  366. unsigned n;
  368. if (item->size == 0) {
  369. dbg("item data expected for local item");
  370. return -1;
  371. }
  373. data = item_udata(item);
  375. switch (item->tag) {
  377. case HID_LOCAL_ITEM_TAG_DELIMITER:
  379. if (data) {
  380. /*
  381.  * We treat items before the first delimiter
  382.  * as global to all usage sets (branch 0).
  383.  * In the moment we process only these global
  384.  * items and the first delimiter set.
  385.  */
  386. if (parser->local.delimiter_depth != 0) {
  387. dbg("nested delimiters");
  388. return -1;
  389. }
  390. parser->local.delimiter_depth++;
  391. parser->local.delimiter_branch++;
  392. } else {
  393. if (parser->local.delimiter_depth < 1) {
  394. dbg("bogus close delimiter");
  395. return -1;
  396. }
  397. parser->local.delimiter_depth--;
  398. }
  399. return 1;
  401. case HID_LOCAL_ITEM_TAG_USAGE:
  403. if (parser->local.delimiter_branch > 1) {
  404. dbg("alternative usage ignored");
  405. return 0;
  406. }
  408. if (item->size <= 2)
  409. data = (parser->global.usage_page << 16) + data;
  411. return hid_add_usage(parser, data);
  413. case HID_LOCAL_ITEM_TAG_USAGE_MINIMUM:
  415. if (parser->local.delimiter_branch > 1) {
  416. dbg("alternative usage ignored");
  417. return 0;
  418. }
  420. if (item->size <= 2)
  421. data = (parser->global.usage_page << 16) + data;
  423. parser->local.usage_minimum = data;
  424. return 0;
  426. case HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM:
  428. if (parser->local.delimiter_branch > 1) {
  429. dbg("alternative usage ignored");
  430. return 0;
  431. }
  433. if (item->size <= 2)
  434. data = (parser->global.usage_page << 16) + data;
  436. for (n = parser->local.usage_minimum; n <= data; n++)
  437. if (hid_add_usage(parser, n)) {
  438. dbg("hid_add_usage failedn");
  439. return -1;
  440. }
  441. return 0;
  443. default:
  445. dbg("unknown local item tag 0x%x", item->tag);
  446. return 0;
  447. }
  448. return 0;
  449. }
  451. /*
  452.  * Process a main item.
  453.  */
  455. static int hid_parser_main(struct hid_parser *parser, struct hid_item *item)
  456. {
  457. __u32 data;
  458. int ret;
  460. data = item_udata(item);
  462. switch (item->tag) {
  463. case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION:
  464. ret = open_collection(parser, data & 3);
  465. break;
  466. case HID_MAIN_ITEM_TAG_END_COLLECTION:
  467. ret = close_collection(parser);
  468. break;
  469. case HID_MAIN_ITEM_TAG_INPUT:
  470. ret = hid_add_field(parser, HID_INPUT_REPORT, data);
  471. break;
  472. case HID_MAIN_ITEM_TAG_OUTPUT:
  473. ret = hid_add_field(parser, HID_OUTPUT_REPORT, data);
  474. break;
  475. case HID_MAIN_ITEM_TAG_FEATURE:
  476. ret = hid_add_field(parser, HID_FEATURE_REPORT, data);
  477. break;
  478. default:
  479. dbg("unknown main item tag 0x%x", item->tag);
  480. ret = 0;
  481. }
  483. memset(&parser->local, 0, sizeof(parser->local)); /* Reset the local parser environment */
  485. return ret;
  486. }
  488. /*
  489.  * Process a reserved item.
  490.  */
  492. static int hid_parser_reserved(struct hid_parser *parser, struct hid_item *item)
  493. {
  494. dbg("reserved item type, tag 0x%x", item->tag);
  495. return 0;
  496. }
  498. /*
  499.  * Free a report and all registered fields. The field->usage and
  500.  * field->value table's are allocated behind the field, so we need
  501.  * only to free(field) itself.
  502.  */
  504. static void hid_free_report(struct hid_report *report)
  505. {
  506. unsigned n;
  508. for (n = 0; n < report->maxfield; n++)
  509. kfree(report->field[n]);
  510. if (report->data)
  511. kfree(report->data);
  512. kfree(report);
  513. }
  515. /*
  516.  * Free a device structure, all reports, and all fields.
  517.  */
  519. static void hid_free_device(struct hid_device *device)
  520. {
  521. unsigned i,j;
  523. for (i = 0; i < HID_REPORT_TYPES; i++) {
  524. struct hid_report_enum *report_enum = device->report_enum + i;
  526. for (j = 0; j < 256; j++) {
  527. struct hid_report *report = report_enum->report_id_hash[j];
  528. if (report) hid_free_report(report);
  529. }
  530. }
  532. if (device->rdesc) kfree(device->rdesc);
  533. }
  535. /*
  536.  * Fetch a report description item from the data stream. We support long
  537.  * items, though they are not used yet.
  538.  */
  540. static __u8 *fetch_item(__u8 *start, __u8 *end, struct hid_item *item)
  541. {
  542. if ((end - start) > 0) {
  544. __u8 b = *start++;
  545. item->type = (b >> 2) & 3;
  546. item->tag  = (b >> 4) & 15;
  548. if (item->tag == HID_ITEM_TAG_LONG) {
  550. item->format = HID_ITEM_FORMAT_LONG;
  552. if ((end - start) >= 2) {
  554. item->size = *start++;
  555. item->tag  = *start++;
  557. if ((end - start) >= item->size) {
  558. item->data.longdata = start;
  559. start += item->size;
  560. return start;
  561. }
  562. }
  563. } else {
  565. item->format = HID_ITEM_FORMAT_SHORT;
  566. item->size = b & 3;
  567. switch (item->size) {
  569. case 0:
  570. return start;
  572. case 1:
  573. if ((end - start) >= 1) {
  574. item->data.u8 = *start++;
  575. return start;
  576. }
  577. break;
  579. case 2:
  580. if ((end - start) >= 2) {
  581. item->data.u16 = le16_to_cpu( get_unaligned(((__u16*)start)++));
  582. return start;
  583. }
  585. case 3:
  586. item->size++;
  587. if ((end - start) >= 4) {
  588. item->data.u32 = le32_to_cpu( get_unaligned(((__u32*)start)++));
  589. return start;
  590. }
  591. }
  592. }
  593. }
  594. return NULL;
  595. }
  597. /*
  598.  * Parse a report description into a hid_device structure. Reports are
  599.  * enumerated, fields are attached to these reports.
  600.  */
  602. static struct hid_device *hid_parse_report(__u8 *start, unsigned size)
  603. {
  604. struct hid_device *device;
  605. struct hid_parser *parser;
  606. struct hid_item item;
  607. __u8 *end;
  608. unsigned i;
  609. static int (*dispatch_type[])(struct hid_parser *parser,
  610.       struct hid_item *item) = {
  611. hid_parser_main,
  612. hid_parser_global,
  613. hid_parser_local,
  614. hid_parser_reserved
  615. };
  617. if (!(device = kmalloc(sizeof(struct hid_device), GFP_KERNEL)))
  618. return NULL;
  619. memset(device, 0, sizeof(struct hid_device));
  621. for (i = 0; i < HID_REPORT_TYPES; i++)
  622. INIT_LIST_HEAD(&device->report_enum[i].report_list);
  624. if (!(device->rdesc = (__u8 *)kmalloc(size, GFP_KERNEL))) {
  625. kfree(device);
  626. return NULL;
  627. }
  628. memcpy(device->rdesc, start, size);
  630. if (!(parser = kmalloc(sizeof(struct hid_parser), GFP_KERNEL))) {
  631. kfree(device->rdesc);
  632. kfree(device);
  633. return NULL;
  634. }
  635. memset(parser, 0, sizeof(struct hid_parser));
  636. parser->device = device;
  638. end = start + size;
  639. while ((start = fetch_item(start, end, &item)) != 0) {
  640. if (item.format != HID_ITEM_FORMAT_SHORT) {
  641. dbg("unexpected long global item");
  642. hid_free_device(device);
  643. kfree(parser);
  644. return NULL;
  645. }
  646. if (dispatch_type[item.type](parser, &item)) {
  647. dbg("item %u %u %u %u parsing failedn",
  648. item.format, (unsigned)item.size, (unsigned)item.type, (unsigned)item.tag);
  649. hid_free_device(device);
  650. kfree(parser);
  651. return NULL;
  652. }
  654. if (start == end) {
  655. if (parser->collection_stack_ptr) {
  656. dbg("unbalanced collection at end of report description");
  657. hid_free_device(device);
  658. kfree(parser);
  659. return NULL;
  660. }
  661. if (parser->local.delimiter_depth) {
  662. dbg("unbalanced delimiter at end of report description");
  663. hid_free_device(device);
  664. kfree(parser);
  665. return NULL;
  666. }
  667. kfree(parser);
  668. return device;
  669. }
  670. }
  672. dbg("item fetching failed at offset %dn", (int)(end - start));
  673. hid_free_device(device);
  674. kfree(parser);
  675. return NULL;
  676. }
  678. /*
  679.  * Convert a signed n-bit integer to signed 32-bit integer. Common
  680.  * cases are done through the compiler, the screwed things has to be
  681.  * done by hand.
  682.  */
  684. static __inline__ __s32 snto32(__u32 value, unsigned n)
  685. {
  686. switch (n) {
  687. case 8:  return ((__s8)value);
  688. case 16: return ((__s16)value);
  689. case 32: return ((__s32)value);
  690. }
  691. return value & (1 << (n - 1)) ? value | (-1 << n) : value;
  692. }
  694. /*
  695.  * Convert a signed 32-bit integer to a signed n-bit integer.
  696.  */
  698. static __inline__ __u32 s32ton(__s32 value, unsigned n)
  699. {
  700. __s32 a = value >> (n - 1);
  701. if (a && a != -1) return value < 0 ? 1 << (n - 1) : (1 << (n - 1)) - 1;
  702. return value & ((1 << n) - 1);
  703. }
  705. /*
  706.  * Extract/implement a data field from/to a report.
  707.  */
  709. static __inline__ __u32 extract(__u8 *report, unsigned offset, unsigned n)
  710. {
  711. report += (offset >> 5) << 2; offset &= 31;
  712. return (le64_to_cpu(get_unaligned((__u64*)report)) >> offset) & ((1 << n) - 1);
  713. }
  715. static __inline__ void implement(__u8 *report, unsigned offset, unsigned n, __u32 value)
  716. {
  717. report += (offset >> 5) << 2; offset &= 31;
  718. put_unaligned((get_unaligned((__u64*)report)
  719. & cpu_to_le64(~((((__u64) 1 << n) - 1) << offset)))
  720. | cpu_to_le64((__u64)value << offset), (__u64*)report);
  721. }
  723. /*
  724.  * Search an array for a value.
  725.  */
  727. static __inline__ int search(__s32 *array, __s32 value, unsigned n)
  728. {
  729. while (n--) if (*array++ == value) return 0;
  730. return -1;
  731. }
  733. static void hid_process_event(struct hid_device *hid, struct hid_field *field, struct hid_usage *usage, __s32 value)
  734. {
  735. hid_dump_input(usage, value);
  736. if (hid->claimed & HID_CLAIMED_INPUT)
  737. hidinput_hid_event(hid, field, usage, value);
  738. if (hid->claimed & HID_CLAIMED_HIDDEV)
  739. hiddev_hid_event(hid, usage->hid, value);
  740. }
  743. /*
  744.  * Analyse a received field, and fetch the data from it. The field
  745.  * content is stored for next report processing (we do differential
  746.  * reporting to the layer).
  747.  */
  749. static void hid_input_field(struct hid_device *hid, struct hid_field *field, __u8 *data)
  750. {
  751. unsigned n;
  752. unsigned count = field->report_count;
  753. unsigned offset = field->report_offset;
  754. unsigned size = field->report_size;
  755. __s32 min = field->logical_minimum;
  756. __s32 max = field->logical_maximum;
  757. __s32 value[count]; /* WARNING: gcc specific */
  759. for (n = 0; n < count; n++) {
  761. value[n] = min < 0 ? snto32(extract(data, offset + n * size, size), size) :
  762.     extract(data, offset + n * size, size);
  764. if (!(field->flags & HID_MAIN_ITEM_VARIABLE) /* Ignore report if ErrorRollOver */
  765.     && value[n] >= min && value[n] <= max
  766.     && field->usage[value[n] - min].hid == HID_UP_KEYBOARD + 1)
  767. return;
  768. }
  770. for (n = 0; n < count; n++) {
  772. if (HID_MAIN_ITEM_VARIABLE & field->flags) {
  774. if (field->flags & HID_MAIN_ITEM_RELATIVE) {
  775. if (!value[n]) continue;
  776. } else {
  777. if (value[n] == field->value[n]) continue;
  778. }
  779. hid_process_event(hid, field, &field->usage[n], value[n]);
  780. continue;
  781. }
  783. if (field->value[n] >= min && field->value[n] <= max
  784. && field->usage[field->value[n] - min].hid
  785. && search(value, field->value[n], count))
  786. hid_process_event(hid, field, &field->usage[field->value[n] - min], 0);
  788. if (value[n] >= min && value[n] <= max
  789. && field->usage[value[n] - min].hid
  790. && search(field->value, value[n], count))
  791. hid_process_event(hid, field, &field->usage[value[n] - min], 1);
  792. }
  794. memcpy(field->value, value, count * sizeof(__s32));
  795. }
  797. static int hid_input_report(int type, u8 *data, int len, struct hid_device *hid)
  798. {
  799. struct hid_report_enum *report_enum = hid->report_enum + type;
  800. struct hid_report *report;
  801. int n, size;
  803. if (!len) {
  804. dbg("empty report");
  805. return -1;
  806. }
  808. #ifdef DEBUG_DATA
  809. printk(KERN_DEBUG __FILE__ ": report (size %u) (%snumbered)n", len, report_enum->numbered ? "" : "un");
  810. #endif
  812. n = 0; /* Normally report number is 0 */
  813. if (report_enum->numbered) { /* Device uses numbered reports, data[0] is report number */
  814. n = *data++;
  815. len--;
  816. }
  818. if (!(report = report_enum->report_id_hash[n])) {
  819. dbg("undefined report_id %d received", n);
  820. #ifdef DEBUG
  821. printk(KERN_DEBUG __FILE__ ": report (size %u) = ", len);
  822. for (n = 0; n < len; n++)
  823. printk(" %02x", data[n]);
  824. printk("n");
  825. #endif
  827. return -1;
  828. }
  830. size = ((report->size - 1) >> 3) + 1;
  832. if (len < size) {
  834. if (size <= 8) {
  835. dbg("report %d is too short, (%d < %d)", report->id, len, size);
  836. return -1;
  837. }
  839. /*
  840.  * Some low-speed devices have large reports and maxpacketsize 8.
  841.  * We buffer the data in that case and parse it when we got it all.
  842.  * Works only for unnumbered reports. Doesn't make sense for numbered
  843.  * reports anyway - then they don't need to be large.
  844.  */
  846. if (!report->data)
  847. if (!(report->data = kmalloc(size, GFP_ATOMIC))) {
  848. dbg("couldn't allocate report buffer");
  849. return -1;
  850. }
  852. if (report->idx + len > size) {
  853. dbg("report data buffer overflow");
  854. report->idx = 0;
  855. return -1;
  856. }
  858. memcpy(report->data + report->idx, data, len);
  859. report->idx += len;
  861. if (report->idx < size)
  862. return 0;
  864. data = report->data;
  865. }
  867. for (n = 0; n < report->maxfield; n++)
  868. hid_input_field(hid, report->field[n], data);
  870. report->idx = 0;
  871. return 0;
  872. }
  874. /*
  875.  * Interrupt input handler.
  876.  */
  878. static void hid_irq(struct urb *urb)
  879. {
  880. if (urb->status) {
  881. dbg("nonzero status in irq %d", urb->status);
  882. return;
  883. }
  885. hid_input_report(HID_INPUT_REPORT, urb->transfer_buffer, urb->actual_length, urb->context);
  886. }
  888. /*
  889.  * hid_read_report() reads in report values without waiting for an irq urb.
  890.  */
  892. void hid_read_report(struct hid_device *hid, struct hid_report *report)
  893. {
  894. int len = ((report->size - 1) >> 3) + 1 + hid->report_enum[report->type].numbered;
  895. u8 data[len];
  896. int read;
  898. if (hid->quirks & HID_QUIRK_NOGET)
  899. return;
  901. if ((read = usb_get_report(hid->dev, hid->ifnum, report->type + 1, report->id, data, len)) != len) {
  902. dbg("reading report type %d id %d failed len %d read %d", report->type + 1, report->id, len, read);
  903. return;
  904. }
  906. hid_input_report(report->type, data, len, hid);
  907. }
  909. /*
  910.  * Output the field into the report.
  911.  */
  913. static void hid_output_field(struct hid_field *field, __u8 *data)
  914. {
  915. unsigned count = field->report_count;
  916. unsigned offset = field->report_offset;
  917. unsigned size = field->report_size;
  918. unsigned n;
  920. for (n = 0; n < count; n++) {
  921. if (field->logical_minimum < 0) /* signed values */
  922. implement(data, offset + n * size, size, s32ton(field->value[n], size));
  923.  else /* unsigned values */
  924. implement(data, offset + n * size, size, field->value[n]);
  925. }
  926. }
  928. /*
  929.  * Create a report.
  930.  */
  932. void hid_output_report(struct hid_report *report, __u8 *data)
  933. {
  934. unsigned n;
  935. for (n = 0; n < report->maxfield; n++)
  936. hid_output_field(report->field[n], data);
  937. }
  939. /*
  940.  * Set a field value. The report this field belongs to has to be
  941.  * created and transfered to the device, to set this value in the
  942.  * device.
  943.  */
  945. int hid_set_field(struct hid_field *field, unsigned offset, __s32 value)
  946. {
  947. unsigned size = field->report_size;
  949. hid_dump_input(field->usage + offset, value);
  951. if (offset >= field->report_count) {
  952. dbg("offset exceeds report_count");
  953. return -1;
  954. }
  955. if (field->logical_minimum < 0) {
  956. if (value != snto32(s32ton(value, size), size)) {
  957. dbg("value %d is out of range", value);
  958. return -1;
  959. }
  960. }
  961. if (   (value > field->logical_maximum)
  962.     || (value < field->logical_minimum)) {
  963. dbg("value %d is invalid", value);
  964. return -1;
  965. }
  966. field->value[offset] = value;
  967. return 0;
  968. }
  970. int hid_find_field(struct hid_device *hid, unsigned int type, unsigned int code, struct hid_field **field)
  971. {
  972. struct hid_report_enum *report_enum = hid->report_enum + HID_OUTPUT_REPORT;
  973. struct list_head *list = report_enum->report_list.next;
  974. int i, j;
  976. while (list != &report_enum->report_list) {
  977. struct hid_report *report = (struct hid_report *) list;
  978. list = list->next;
  979. for (i = 0; i < report->maxfield; i++) {
  980. *field = report->field[i];
  981. for (j = 0; j < (*field)->maxusage; j++)
  982. if ((*field)->usage[j].type == type && (*field)->usage[j].code == code)
  983. return j;
  984. }
  985. }
  986. return -1;
  987. }
  989. static int hid_submit_out(struct hid_device *hid)
  990. {
  991. hid->urbout.transfer_buffer_length = le16_to_cpup(&hid->out[hid->outtail].dr.wLength);
  992. hid->urbout.transfer_buffer = hid->out[hid->outtail].buffer;
  993. hid->urbout.setup_packet = (void *) &(hid->out[hid->outtail].dr);
  994. hid->urbout.dev = hid->dev;
  996. if (usb_submit_urb(&hid->urbout)) {
  997. err("usb_submit_urb(out) failed");
  998. return -1;
  999. }
  1001. return 0;
  1002. }
  1004. static void hid_ctrl(struct urb *urb)
  1005. {
  1006. struct hid_device *hid = urb->context;
  1008. if (urb->status)
  1009. warn("ctrl urb status %d received", urb->status);
  1011. hid->outtail = (hid->outtail + 1) & (HID_CONTROL_FIFO_SIZE - 1);
  1013. if (hid->outhead != hid->outtail)
  1014. hid_submit_out(hid);
  1015. }
  1017. void hid_write_report(struct hid_device *hid, struct hid_report *report)
  1018. {
  1019. hid_output_report(report, hid->out[hid->outhead].buffer);
  1021. hid->out[hid->outhead].dr.wValue = cpu_to_le16(0x200 | report->id);
  1022. hid->out[hid->outhead].dr.wLength = cpu_to_le16((report->size + 7) >> 3);
  1024. hid->outhead = (hid->outhead + 1) & (HID_CONTROL_FIFO_SIZE - 1);
  1026. if (hid->outhead == hid->outtail)
  1027. hid->outtail = (hid->outtail + 1) & (HID_CONTROL_FIFO_SIZE - 1);
  1029. if (hid->urbout.status != -EINPROGRESS)
  1030. hid_submit_out(hid);
  1031. }
  1033. int hid_open(struct hid_device *hid)
  1034. {
  1035. if (hid->open++)
  1036. return 0;
  1038. hid->urb.dev = hid->dev;
  1040. if (usb_submit_urb(&hid->urb))
  1041. return -EIO;
  1043. return 0;
  1044. }
  1046. void hid_close(struct hid_device *hid)
  1047. {
  1048. if (!--hid->open)
  1049. usb_unlink_urb(&hid->urb);
  1050. }
  1052. /*
  1053.  * Initialize all readable reports
  1054.  */
  1055. void hid_init_reports(struct hid_device *hid)
  1056. {
  1057. int i;
  1058. struct hid_report *report;
  1059. struct hid_report_enum *report_enum;
  1060. struct list_head *list;
  1062. for (i = 0; i < HID_REPORT_TYPES; i++) {
  1063. if (i == HID_FEATURE_REPORT || i == HID_INPUT_REPORT) {
  1064. report_enum = hid->report_enum + i;
  1065. list = report_enum->report_list.next;
  1066. while (list != &report_enum->report_list) {
  1067. report = (struct hid_report *) list;
  1068. hid_read_report(hid, report);
  1069. usb_set_idle(hid->dev, hid->ifnum, 0, report->id);
  1070. list = list->next;
  1071. }
  1072. }
  1073. }
  1074. }
  1076. #define USB_VENDOR_ID_WACOM 0x056a
  1077. #define USB_DEVICE_ID_WACOM_PENPARTNER 0x0000
  1078. #define USB_DEVICE_ID_WACOM_GRAPHIRE 0x0010
  1079. #define USB_DEVICE_ID_WACOM_INTUOS 0x0020
  1080. #define USB_DEVICE_ID_WACOM_PL 0x0030
  1081. #define USB_DEVICE_ID_WACOM_INTUOS2 0x0041
  1083. #define USB_VENDOR_ID_ATEN 0x0557
  1084. #define USB_DEVICE_ID_ATEN_UC100KM 0x2004
  1085. #define USB_DEVICE_ID_ATEN_CS124U 0x2202
  1086. #define USB_DEVICE_ID_ATEN_2PORTKVM 0x2204
  1087. #define USB_DEVICE_ID_ATEN_4PORTKVM 0x2205
  1089. struct hid_blacklist {
  1090. __u16 idVendor;
  1091. __u16 idProduct;
  1092. unsigned quirks;
  1093. } hid_blacklist[] = {
  1094. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PENPARTNER, HID_QUIRK_IGNORE },
  1095. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_GRAPHIRE, HID_QUIRK_IGNORE },
  1096. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_GRAPHIRE + 1, HID_QUIRK_IGNORE },
  1097. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_GRAPHIRE + 2, HID_QUIRK_IGNORE },
  1098. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS, HID_QUIRK_IGNORE },
  1099. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS + 1, HID_QUIRK_IGNORE },
  1100. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS + 2, HID_QUIRK_IGNORE },
  1101. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS + 3, HID_QUIRK_IGNORE },
  1102. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS + 4, HID_QUIRK_IGNORE },
  1103. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL, HID_QUIRK_IGNORE },
  1104. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL + 1, HID_QUIRK_IGNORE },
  1105. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL + 2, HID_QUIRK_IGNORE },
  1106. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL + 3, HID_QUIRK_IGNORE },
  1107. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL + 4, HID_QUIRK_IGNORE },
  1108. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_PL + 5, HID_QUIRK_IGNORE },
  1109. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS2, HID_QUIRK_IGNORE },
  1110. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS2 + 1, HID_QUIRK_IGNORE },
  1111. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS2 + 2, HID_QUIRK_IGNORE },
  1112. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS2 + 3, HID_QUIRK_IGNORE },
  1113. { USB_VENDOR_ID_WACOM, USB_DEVICE_ID_WACOM_INTUOS2 + 4, HID_QUIRK_IGNORE },
  1114. { USB_VENDOR_ID_ATEN, USB_DEVICE_ID_ATEN_UC100KM, HID_QUIRK_NOGET },
  1115. { USB_VENDOR_ID_ATEN, USB_DEVICE_ID_ATEN_CS124U, HID_QUIRK_NOGET },
  1116. { USB_VENDOR_ID_ATEN, USB_DEVICE_ID_ATEN_2PORTKVM, HID_QUIRK_NOGET },
  1117. { USB_VENDOR_ID_ATEN, USB_DEVICE_ID_ATEN_4PORTKVM, HID_QUIRK_NOGET },
  1118. { 0, 0 }
  1119. };
  1121. static struct hid_device *usb_hid_configure(struct usb_device *dev, int ifnum)
  1122. {
  1123. struct usb_interface_descriptor *interface = dev->actconfig->interface[ifnum].altsetting + 0;
  1124. struct hid_descriptor *hdesc;
  1125. struct hid_device *hid;
  1126. unsigned quirks = 0, rsize = 0;
  1127. char *buf;
  1128. int n;
  1130. for (n = 0; hid_blacklist[n].idVendor; n++)
  1131. if ((hid_blacklist[n].idVendor == dev->descriptor.idVendor) &&
  1132. (hid_blacklist[n].idProduct == dev->descriptor.idProduct))
  1133. quirks = hid_blacklist[n].quirks;
  1135. if (quirks & HID_QUIRK_IGNORE)
  1136. return NULL;
  1138. if (usb_get_extra_descriptor(interface, USB_DT_HID, &hdesc) && ((!interface->bNumEndpoints) ||
  1139. usb_get_extra_descriptor(&interface->endpoint[0], USB_DT_HID, &hdesc))) {
  1140. dbg("class descriptor not presentn");
  1141. return NULL;
  1142. }
  1144. for (n = 0; n < hdesc->bNumDescriptors; n++)
  1145. if (hdesc->desc[n].bDescriptorType == USB_DT_REPORT)
  1146. rsize = le16_to_cpu(hdesc->desc[n].wDescriptorLength);
  1148. if (!rsize || rsize > HID_MAX_DESCRIPTOR_SIZE) {
  1149. dbg("weird size of report descriptor (%u)", rsize);
  1150. return NULL;
  1151. }
  1153. {
  1154. __u8 rdesc[rsize];
  1156. if ((n = usb_get_class_descriptor(dev, interface->bInterfaceNumber, USB_DT_REPORT, 0, rdesc, rsize)) < 0) {
  1157. dbg("reading report descriptor failed");
  1158. return NULL;
  1159. }
  1161. #ifdef DEBUG_DATA
  1162. printk(KERN_DEBUG __FILE__ ": report descriptor (size %u, read %d) = ", rsize, n);
  1163. for (n = 0; n < rsize; n++)
  1164. printk(" %02x", (unsigned) rdesc[n]);
  1165. printk("n");
  1166. #endif
  1168. if (!(hid = hid_parse_report(rdesc, rsize))) {
  1169. dbg("parsing report descriptor failed");
  1170. return NULL;
  1171. }
  1172. }
  1174. hid->quirks = quirks;
  1176. for (n = 0; n < interface->bNumEndpoints; n++) {
  1178. struct usb_endpoint_descriptor *endpoint = &interface->endpoint[n];
  1179. int pipe, maxp;
  1181. if ((endpoint->bmAttributes & 3) != 3) /* Not an interrupt endpoint */
  1182. continue;
  1184. if (!(endpoint->bEndpointAddress & 0x80)) /* Not an input endpoint */
  1185. continue;
  1187. pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);
  1188. maxp = usb_maxpacket(dev, pipe, usb_pipeout(pipe));
  1190. FILL_INT_URB(&hid->urb, dev, pipe, hid->buffer, maxp > 32 ? 32 : maxp, hid_irq, hid, endpoint->bInterval);
  1192. break;
  1193. }
  1195. if (n == interface->bNumEndpoints) {
  1196. dbg("couldn't find an input interrupt endpoint");
  1197. hid_free_device(hid);
  1198. return NULL;
  1199. }
  1201. hid->version = hdesc->bcdHID;
  1202. hid->country = hdesc->bCountryCode;
  1203. hid->dev = dev;
  1204. hid->ifnum = interface->bInterfaceNumber;
  1206. for (n = 0; n < HID_CONTROL_FIFO_SIZE; n++) {
  1207. hid->out[n].dr.bRequestType = USB_TYPE_CLASS | USB_RECIP_INTERFACE;
  1208. hid->out[n].dr.bRequest = USB_REQ_SET_REPORT;
  1209. hid->out[n].dr.wIndex = cpu_to_le16(hid->ifnum);
  1210. }
  1212. hid->name[0] = 0;
  1214. if (!(buf = kmalloc(63, GFP_KERNEL)))
  1215. return NULL;
  1217. if (usb_string(dev, dev->descriptor.iManufacturer, buf, 63) > 0) {
  1218. strcat(hid->name, buf);
  1219. if (usb_string(dev, dev->descriptor.iProduct, buf, 63) > 0)
  1220. sprintf(hid->name, "%s %s", hid->name, buf);
  1221. } else
  1222. sprintf(hid->name, "%04x:%04x", dev->descriptor.idVendor, dev->descriptor.idProduct);
  1224. kfree(buf);
  1226. FILL_CONTROL_URB(&hid->urbout, dev, usb_sndctrlpipe(dev, 0),
  1227. (void*) &hid->out[0].dr, hid->out[0].buffer, 1, hid_ctrl, hid);
  1229. /*
  1230.  * Some devices don't like this and crash. I don't know of any devices
  1231.  * needing this, so it is disabled for now.
  1232.  */
  1234. #if 0
  1235. if (interface->bInterfaceSubClass == 1)
  1236. usb_set_protocol(dev, hid->ifnum, 1);
  1237. #endif
  1239. return hid;
  1240. }
  1242. static void* hid_probe(struct usb_device *dev, unsigned int ifnum,
  1243.        const struct usb_device_id *id)
  1244. {
  1245. struct hid_device *hid;
  1246. int i;
  1247. char *c;
  1249. dbg("HID probe called for ifnum %d", ifnum);
  1251. if (!(hid = usb_hid_configure(dev, ifnum)))
  1252. return NULL;
  1254. hid_init_reports(hid);
  1255. hid_dump_device(hid);
  1257. if (!hidinput_connect(hid))
  1258. hid->claimed |= HID_CLAIMED_INPUT;
  1259. if (!hiddev_connect(hid))
  1260. hid->claimed |= HID_CLAIMED_HIDDEV;
  1261. printk(KERN_INFO);
  1263. if (hid->claimed & HID_CLAIMED_INPUT)
  1264. printk("input%d", hid->input.number);
  1265. if (hid->claimed == (HID_CLAIMED_INPUT | HID_CLAIMED_HIDDEV))
  1266. printk(",");
  1267. if (hid->claimed & HID_CLAIMED_HIDDEV)
  1268. printk("hiddev%d", hid->minor);
  1270. c = "Device";
  1271. for (i = 0; i < hid->maxapplication; i++)
  1272. if ((hid->application[i] & 0xffff) < ARRAY_SIZE(hid_types)) {
  1273. c = hid_types[hid->application[i] & 0xffff];
  1274. break;
  1275. }
  1277. printk(": USB HID v%x.%02x %s [%s] on usb%d:%d.%dn",
  1278. hid->version >> 8, hid->version & 0xff, c, hid->name,
  1279. dev->bus->busnum, dev->devnum, ifnum);
  1281. return hid;
  1282. }
  1284. static void hid_disconnect(struct usb_device *dev, void *ptr)
  1285. {
  1286. struct hid_device *hid = ptr;
  1288. dbg("cleanup called");
  1289. usb_unlink_urb(&hid->urb);
  1290. if (hid->claimed & HID_CLAIMED_INPUT)
  1291. hidinput_disconnect(hid);
  1292. if (hid->claimed & HID_CLAIMED_HIDDEV)
  1293. hiddev_disconnect(hid);
  1294. hid_free_device(hid);
  1295. }
  1297. static struct usb_device_id hid_usb_ids [] = {
  1298. { match_flags: USB_DEVICE_ID_MATCH_INT_CLASS,
  1299.     bInterfaceClass: USB_INTERFACE_CLASS_HID },
  1300. { } /* Terminating entry */
  1301. };
  1303. MODULE_DEVICE_TABLE (usb, hid_usb_ids);
  1305. static struct usb_driver hid_driver = {
  1306. name: "hid",
  1307. probe: hid_probe,
  1308. disconnect: hid_disconnect,
  1309. id_table: hid_usb_ids,
  1310. };
  1312. static int __init hid_init(void)
  1313. {
  1314. hiddev_init();
  1315. usb_register(&hid_driver);
  1316. info(DRIVER_VERSION " " DRIVER_AUTHOR);
  1317. info(DRIVER_DESC);
  1319. return 0;
  1320. }
  1322. static void __exit hid_exit(void)
  1323. {
  1324. hiddev_exit();
  1325. usb_deregister(&hid_driver);
  1326. }
  1328. module_init(hid_init);
  1329. module_exit(hid_exit);
  1331. MODULE_AUTHOR( DRIVER_AUTHOR );
  1332. MODULE_DESCRIPTION( DRIVER_DESC );
  1333. MODULE_LICENSE("GPL");