Blame view
include/linux/hid.h
22.8 KB
1da177e4c Linux-2.6.12-rc2 |
1 2 3 4 |
#ifndef __HID_H #define __HID_H /* |
1da177e4c Linux-2.6.12-rc2 |
5 6 |
* Copyright (c) 1999 Andreas Gal * Copyright (c) 2000-2001 Vojtech Pavlik |
b55fd23cc HID: fix broken L... |
7 |
* Copyright (c) 2006-2007 Jiri Kosina |
1da177e4c Linux-2.6.12-rc2 |
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
*/ /* * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * * Should you need to contact me, the author, you can do so either by * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail: * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic */ |
1da177e4c Linux-2.6.12-rc2 |
29 30 31 32 33 34 35 |
/* * USB HID (Human Interface Device) interface class code */ #define USB_INTERFACE_CLASS_HID 3 /* |
0f28b55db [PATCH] usbhid: a... |
36 37 38 39 40 41 42 43 |
* USB HID interface subclass and protocol codes */ #define USB_INTERFACE_SUBCLASS_BOOT 1 #define USB_INTERFACE_PROTOCOL_KEYBOARD 1 #define USB_INTERFACE_PROTOCOL_MOUSE 2 /* |
1da177e4c Linux-2.6.12-rc2 |
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
* HID class requests */ #define HID_REQ_GET_REPORT 0x01 #define HID_REQ_GET_IDLE 0x02 #define HID_REQ_GET_PROTOCOL 0x03 #define HID_REQ_SET_REPORT 0x09 #define HID_REQ_SET_IDLE 0x0A #define HID_REQ_SET_PROTOCOL 0x0B /* * HID class descriptor types */ #define HID_DT_HID (USB_TYPE_CLASS | 0x01) #define HID_DT_REPORT (USB_TYPE_CLASS | 0x02) #define HID_DT_PHYSICAL (USB_TYPE_CLASS | 0x03) |
57d292bd7 HID: fix HIDIOCGR... |
61 62 63 64 65 66 67 |
#define HID_MAX_DESCRIPTOR_SIZE 4096 #ifdef __KERNEL__ #include <linux/types.h> #include <linux/slab.h> #include <linux/list.h> |
e8c84f9a5 modpost: add supp... |
68 |
#include <linux/mod_devicetable.h> /* hid_device_id */ |
57d292bd7 HID: fix HIDIOCGR... |
69 70 71 |
#include <linux/timer.h> #include <linux/workqueue.h> #include <linux/input.h> |
1da177e4c Linux-2.6.12-rc2 |
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 |
/* * We parse each description item into this structure. Short items data * values are expanded to 32-bit signed int, long items contain a pointer * into the data area. */ struct hid_item { unsigned format; __u8 size; __u8 type; __u8 tag; union { __u8 u8; __s8 s8; __u16 u16; __s16 s16; __u32 u32; __s32 s32; __u8 *longdata; } data; }; /* * HID report item format */ #define HID_ITEM_FORMAT_SHORT 0 #define HID_ITEM_FORMAT_LONG 1 /* * Special tag indicating long items */ #define HID_ITEM_TAG_LONG 15 /* * HID report descriptor item type (prefix bit 2,3) */ #define HID_ITEM_TYPE_MAIN 0 #define HID_ITEM_TYPE_GLOBAL 1 #define HID_ITEM_TYPE_LOCAL 2 #define HID_ITEM_TYPE_RESERVED 3 /* * HID report descriptor main item tags */ #define HID_MAIN_ITEM_TAG_INPUT 8 #define HID_MAIN_ITEM_TAG_OUTPUT 9 #define HID_MAIN_ITEM_TAG_FEATURE 11 #define HID_MAIN_ITEM_TAG_BEGIN_COLLECTION 10 #define HID_MAIN_ITEM_TAG_END_COLLECTION 12 /* * HID report descriptor main item contents */ #define HID_MAIN_ITEM_CONSTANT 0x001 #define HID_MAIN_ITEM_VARIABLE 0x002 #define HID_MAIN_ITEM_RELATIVE 0x004 |
05f091ab4 Input: whitespace... |
133 |
#define HID_MAIN_ITEM_WRAP 0x008 |
1da177e4c Linux-2.6.12-rc2 |
134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 |
#define HID_MAIN_ITEM_NONLINEAR 0x010 #define HID_MAIN_ITEM_NO_PREFERRED 0x020 #define HID_MAIN_ITEM_NULL_STATE 0x040 #define HID_MAIN_ITEM_VOLATILE 0x080 #define HID_MAIN_ITEM_BUFFERED_BYTE 0x100 /* * HID report descriptor collection item types */ #define HID_COLLECTION_PHYSICAL 0 #define HID_COLLECTION_APPLICATION 1 #define HID_COLLECTION_LOGICAL 2 /* * HID report descriptor global item tags */ #define HID_GLOBAL_ITEM_TAG_USAGE_PAGE 0 #define HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM 1 #define HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM 2 #define HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM 3 #define HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM 4 #define HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT 5 #define HID_GLOBAL_ITEM_TAG_UNIT 6 #define HID_GLOBAL_ITEM_TAG_REPORT_SIZE 7 #define HID_GLOBAL_ITEM_TAG_REPORT_ID 8 #define HID_GLOBAL_ITEM_TAG_REPORT_COUNT 9 #define HID_GLOBAL_ITEM_TAG_PUSH 10 #define HID_GLOBAL_ITEM_TAG_POP 11 /* * HID report descriptor local item tags */ #define HID_LOCAL_ITEM_TAG_USAGE 0 #define HID_LOCAL_ITEM_TAG_USAGE_MINIMUM 1 #define HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM 2 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_INDEX 3 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_MINIMUM 4 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_MAXIMUM 5 #define HID_LOCAL_ITEM_TAG_STRING_INDEX 7 #define HID_LOCAL_ITEM_TAG_STRING_MINIMUM 8 #define HID_LOCAL_ITEM_TAG_STRING_MAXIMUM 9 #define HID_LOCAL_ITEM_TAG_DELIMITER 10 /* * HID usage tables */ #define HID_USAGE_PAGE 0xffff0000 #define HID_UP_UNDEFINED 0x00000000 |
05f091ab4 Input: whitespace... |
187 |
#define HID_UP_GENDESK 0x00010000 |
0aebfdac0 Input: add HID si... |
188 |
#define HID_UP_SIMULATION 0x00020000 |
05f091ab4 Input: whitespace... |
189 190 191 192 |
#define HID_UP_KEYBOARD 0x00070000 #define HID_UP_LED 0x00080000 #define HID_UP_BUTTON 0x00090000 #define HID_UP_ORDINAL 0x000a0000 |
1da177e4c Linux-2.6.12-rc2 |
193 |
#define HID_UP_CONSUMER 0x000c0000 |
05f091ab4 Input: whitespace... |
194 195 |
#define HID_UP_DIGITIZER 0x000d0000 #define HID_UP_PID 0x000f0000 |
1da177e4c Linux-2.6.12-rc2 |
196 197 |
#define HID_UP_HPVENDOR 0xff7f0000 #define HID_UP_MSVENDOR 0xff000000 |
e875ce374 Input: HID - add ... |
198 199 |
#define HID_UP_CUSTOM 0x00ff0000 #define HID_UP_LOGIVENDOR 0xffbc0000 |
1da177e4c Linux-2.6.12-rc2 |
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 |
#define HID_USAGE 0x0000ffff #define HID_GD_POINTER 0x00010001 #define HID_GD_MOUSE 0x00010002 #define HID_GD_JOYSTICK 0x00010004 #define HID_GD_GAMEPAD 0x00010005 #define HID_GD_KEYBOARD 0x00010006 #define HID_GD_KEYPAD 0x00010007 #define HID_GD_MULTIAXIS 0x00010008 #define HID_GD_X 0x00010030 #define HID_GD_Y 0x00010031 #define HID_GD_Z 0x00010032 #define HID_GD_RX 0x00010033 #define HID_GD_RY 0x00010034 #define HID_GD_RZ 0x00010035 #define HID_GD_SLIDER 0x00010036 #define HID_GD_DIAL 0x00010037 #define HID_GD_WHEEL 0x00010038 #define HID_GD_HATSWITCH 0x00010039 #define HID_GD_BUFFER 0x0001003a #define HID_GD_BYTECOUNT 0x0001003b #define HID_GD_MOTION 0x0001003c #define HID_GD_START 0x0001003d #define HID_GD_SELECT 0x0001003e #define HID_GD_VX 0x00010040 #define HID_GD_VY 0x00010041 #define HID_GD_VZ 0x00010042 #define HID_GD_VBRX 0x00010043 #define HID_GD_VBRY 0x00010044 #define HID_GD_VBRZ 0x00010045 #define HID_GD_VNO 0x00010046 #define HID_GD_FEATURE 0x00010047 #define HID_GD_UP 0x00010090 #define HID_GD_DOWN 0x00010091 #define HID_GD_RIGHT 0x00010092 #define HID_GD_LEFT 0x00010093 /* * HID report types --- Ouch! HID spec says 1 2 3! */ #define HID_INPUT_REPORT 0 #define HID_OUTPUT_REPORT 1 #define HID_FEATURE_REPORT 2 /* |
93c10132a HID: move connect... |
247 248 249 250 251 252 253 254 255 256 257 258 259 |
* HID connect requests */ #define HID_CONNECT_HIDINPUT 0x01 #define HID_CONNECT_HIDINPUT_FORCE 0x02 #define HID_CONNECT_HIDRAW 0x04 #define HID_CONNECT_HIDDEV 0x08 #define HID_CONNECT_HIDDEV_FORCE 0x10 #define HID_CONNECT_FF 0x20 #define HID_CONNECT_DEFAULT (HID_CONNECT_HIDINPUT|HID_CONNECT_HIDRAW| \ HID_CONNECT_HIDDEV|HID_CONNECT_FF) /* |
1da177e4c Linux-2.6.12-rc2 |
260 261 |
* HID device quirks. */ |
876b9276b USB HID: add 'qui... |
262 263 264 265 |
/* * Increase this if you need to configure more HID quirks at module load time */ #define MAX_USBHID_BOOT_QUIRKS 4 |
eab9edd27 Input: HID - add ... |
266 267 |
#define HID_QUIRK_INVERT 0x00000001 #define HID_QUIRK_NOTOUCH 0x00000002 |
eab9edd27 Input: HID - add ... |
268 |
#define HID_QUIRK_NOGET 0x00000008 |
eab9edd27 Input: HID - add ... |
269 270 |
#define HID_QUIRK_BADPAD 0x00000020 #define HID_QUIRK_MULTI_INPUT 0x00000040 |
ea9a4a8b0 HID: separate qui... |
271 |
#define HID_QUIRK_SKIP_OUTPUT_REPORTS 0x00010000 |
f345c37c3 HID: fixup fullsp... |
272 |
#define HID_QUIRK_FULLSPEED_INTERVAL 0x10000000 |
ea9a4a8b0 HID: separate qui... |
273 274 |
/* |
1da177e4c Linux-2.6.12-rc2 |
275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 |
* This is the global environment of the parser. This information is * persistent for main-items. The global environment can be saved and * restored with PUSH/POP statements. */ struct hid_global { unsigned usage_page; __s32 logical_minimum; __s32 logical_maximum; __s32 physical_minimum; __s32 physical_maximum; __s32 unit_exponent; unsigned unit; unsigned report_id; unsigned report_size; unsigned report_count; }; /* * This is the local environment. It is persistent up the next main-item. */ |
5f1ab74f6 HID: Sunplus Wire... |
296 |
#define HID_MAX_USAGES 12288 |
1da177e4c Linux-2.6.12-rc2 |
297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 |
#define HID_DEFAULT_NUM_COLLECTIONS 16 struct hid_local { unsigned usage[HID_MAX_USAGES]; /* usage array */ unsigned collection_index[HID_MAX_USAGES]; /* collection index array */ unsigned usage_index; unsigned usage_minimum; unsigned delimiter_depth; unsigned delimiter_branch; }; /* * This is the collection stack. We climb up the stack to determine * application and function of each field. */ struct hid_collection { unsigned type; unsigned usage; unsigned level; }; struct hid_usage { unsigned hid; /* hid usage code */ unsigned collection_index; /* index into collection array */ /* hidinput data */ __u16 code; /* input driver code */ __u8 type; /* input driver type */ __s8 hat_min; /* hat switch fun */ __s8 hat_max; /* ditto */ __s8 hat_dir; /* ditto */ }; struct hid_input; struct hid_field { unsigned physical; /* physical usage for this field */ unsigned logical; /* logical usage for this field */ unsigned application; /* application usage for this field */ struct hid_usage *usage; /* usage table for this function */ unsigned maxusage; /* maximum usage index */ unsigned flags; /* main-item flags (i.e. volatile,array,constant) */ unsigned report_offset; /* bit offset in the report */ unsigned report_size; /* size of this field in the report */ unsigned report_count; /* number of this field in the report */ unsigned report_type; /* (input,output,feature) */ __s32 *value; /* last known value(s) */ __s32 logical_minimum; __s32 logical_maximum; __s32 physical_minimum; __s32 physical_maximum; __s32 unit_exponent; unsigned unit; struct hid_report *report; /* associated report */ unsigned index; /* index into report->field[] */ /* hidinput data */ struct hid_input *hidinput; /* associated input structure */ __u16 dpad; /* dpad input code */ }; #define HID_MAX_FIELDS 64 struct hid_report { struct list_head list; unsigned id; /* id of this report */ unsigned type; /* report type */ struct hid_field *field[HID_MAX_FIELDS]; /* fields of the report */ unsigned maxfield; /* maximum valid field index */ unsigned size; /* size of the report (bits) */ struct hid_device *device; /* associated device */ }; struct hid_report_enum { unsigned numbered; struct list_head report_list; struct hid_report *report_id_hash[256]; }; #define HID_REPORT_TYPES 3 |
bf0964dcd Input: HID - hand... |
376 377 |
#define HID_MIN_BUFFER_SIZE 64 /* make sure there is at least a packet size of space */ #define HID_MAX_BUFFER_SIZE 4096 /* 4kb */ |
1da177e4c Linux-2.6.12-rc2 |
378 379 380 381 382 383 |
#define HID_CONTROL_FIFO_SIZE 256 /* to init devices with >100 reports */ #define HID_OUTPUT_FIFO_SIZE 64 struct hid_control_fifo { unsigned char dir; struct hid_report *report; |
f129ea6d1 HID: fix a lockup... |
384 385 386 387 388 389 |
char *raw_report; }; struct hid_output_fifo { struct hid_report *report; char *raw_report; |
1da177e4c Linux-2.6.12-rc2 |
390 391 392 393 |
}; #define HID_CLAIMED_INPUT 1 #define HID_CLAIMED_HIDDEV 2 |
86166b7bc HID: add hidraw i... |
394 |
#define HID_CLAIMED_HIDRAW 4 |
1da177e4c Linux-2.6.12-rc2 |
395 |
|
85cdaf524 HID: make a bus f... |
396 |
#define HID_STAT_ADDED 1 |
c500c9714 HID: hid, make pa... |
397 |
#define HID_STAT_PARSED 2 |
85cdaf524 HID: make a bus f... |
398 |
|
1da177e4c Linux-2.6.12-rc2 |
399 400 |
#define HID_CTRL_RUNNING 1 #define HID_OUT_RUNNING 2 |
aef4e2669 [PATCH] usbhid: a... |
401 402 403 |
#define HID_IN_RUNNING 3 #define HID_RESET_PENDING 4 #define HID_SUSPENDED 5 |
6d8fc4d28 USB HID: Handle S... |
404 |
#define HID_CLEAR_HALT 6 |
69626f23b HID: fix race bet... |
405 |
#define HID_DISCONNECTED 7 |
3d5afd324 HID: fix oops dur... |
406 |
#define HID_STARTED 8 |
1da177e4c Linux-2.6.12-rc2 |
407 408 409 410 |
struct hid_input { struct list_head list; struct hid_report *report; |
c5b7c7c39 [PATCH] drivers/u... |
411 |
struct input_dev *input; |
1da177e4c Linux-2.6.12-rc2 |
412 |
}; |
a73a63701 HID: add hid_type... |
413 414 415 416 |
enum hid_type { HID_TYPE_OTHER = 0, HID_TYPE_USBMOUSE }; |
85cdaf524 HID: make a bus f... |
417 |
struct hid_driver; |
c500c9714 HID: hid, make pa... |
418 |
struct hid_ll_driver; |
85cdaf524 HID: make a bus f... |
419 |
|
1da177e4c Linux-2.6.12-rc2 |
420 |
struct hid_device { /* device report descriptor */ |
85cdaf524 HID: make a bus f... |
421 |
__u8 *rdesc; |
1da177e4c Linux-2.6.12-rc2 |
422 423 424 425 426 |
unsigned rsize; struct hid_collection *collection; /* List of HID collections */ unsigned collection_size; /* Number of allocated hid_collections */ unsigned maxcollection; /* Number of parsed collections */ unsigned maxapplication; /* Number of applications */ |
85cdaf524 HID: make a bus f... |
427 428 429 430 |
__u16 bus; /* BUS ID */ __u32 vendor; /* Vendor ID */ __u32 product; /* Product ID */ __u32 version; /* HID version */ |
a73a63701 HID: add hid_type... |
431 |
enum hid_type type; /* device type (mouse, kbd, ...) */ |
1da177e4c Linux-2.6.12-rc2 |
432 433 |
unsigned country; /* HID country */ struct hid_report_enum report_enum[HID_REPORT_TYPES]; |
85cdaf524 HID: make a bus f... |
434 435 |
struct device dev; /* device */ struct hid_driver *driver; |
c500c9714 HID: hid, make pa... |
436 |
struct hid_ll_driver *ll_driver; |
1da177e4c Linux-2.6.12-rc2 |
437 |
|
85cdaf524 HID: make a bus f... |
438 |
unsigned int status; /* see STAT flags above */ |
05f091ab4 Input: whitespace... |
439 |
unsigned claimed; /* Claimed by hidinput, hiddev? */ |
1da177e4c Linux-2.6.12-rc2 |
440 441 442 443 |
unsigned quirks; /* Various quirks the device can pull on us */ struct list_head inputs; /* The list of inputs */ void *hiddev; /* The hiddev structure */ |
86166b7bc HID: add hidraw i... |
444 |
void *hidraw; |
1da177e4c Linux-2.6.12-rc2 |
445 |
int minor; /* Hiddev minor number */ |
1da177e4c Linux-2.6.12-rc2 |
446 447 448 449 |
int open; /* is the device open by anyone? */ char name[128]; /* Device name */ char phys[64]; /* Device physical location */ char uniq[64]; /* Device unique identifier (serial #) */ |
229695e51 [PATCH] Generic H... |
450 |
void *driver_data; |
93c10132a HID: move connect... |
451 452 |
/* temporary hid_ff handling (until moved to the drivers) */ int (*ff_init)(struct hid_device *); |
aa938f797 [PATCH] Generic H... |
453 |
/* hiddev event handler */ |
93c10132a HID: move connect... |
454 |
int (*hiddev_connect)(struct hid_device *, unsigned int); |
aa938f797 [PATCH] Generic H... |
455 456 |
void (*hiddev_hid_event) (struct hid_device *, struct hid_field *field, struct hid_usage *, __s32); |
aa8de2f03 [PATCH] Generic H... |
457 |
void (*hiddev_report_event) (struct hid_device *, struct hid_report *); |
86166b7bc HID: add hidraw i... |
458 459 460 |
/* handler for raw output data, used by hidraw */ int (*hid_output_raw_report) (struct hid_device *, __u8 *, size_t); |
1da177e4c Linux-2.6.12-rc2 |
461 |
}; |
85cdaf524 HID: make a bus f... |
462 463 464 465 466 467 468 469 470 |
static inline void *hid_get_drvdata(struct hid_device *hdev) { return dev_get_drvdata(&hdev->dev); } static inline void hid_set_drvdata(struct hid_device *hdev, void *data) { dev_set_drvdata(&hdev->dev, data); } |
1da177e4c Linux-2.6.12-rc2 |
471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 |
#define HID_GLOBAL_STACK_SIZE 4 #define HID_COLLECTION_STACK_SIZE 4 struct hid_parser { struct hid_global global; struct hid_global global_stack[HID_GLOBAL_STACK_SIZE]; unsigned global_stack_ptr; struct hid_local local; unsigned collection_stack[HID_COLLECTION_STACK_SIZE]; unsigned collection_stack_ptr; struct hid_device *device; }; struct hid_class_descriptor { __u8 bDescriptorType; |
01d7b3698 usbhid endianness... |
486 |
__le16 wDescriptorLength; |
1da177e4c Linux-2.6.12-rc2 |
487 488 489 490 491 |
} __attribute__ ((packed)); struct hid_descriptor { __u8 bLength; __u8 bDescriptorType; |
01d7b3698 usbhid endianness... |
492 |
__le16 bcdHID; |
1da177e4c Linux-2.6.12-rc2 |
493 494 495 496 497 |
__u8 bCountryCode; __u8 bNumDescriptors; struct hid_class_descriptor desc[1]; } __attribute__ ((packed)); |
85cdaf524 HID: make a bus f... |
498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 |
#define HID_DEVICE(b, ven, prod) \ .bus = (b), \ .vendor = (ven), .product = (prod) #define HID_USB_DEVICE(ven, prod) HID_DEVICE(BUS_USB, ven, prod) #define HID_BLUETOOTH_DEVICE(ven, prod) HID_DEVICE(BUS_BLUETOOTH, ven, prod) #define HID_REPORT_ID(rep) \ .report_type = (rep) #define HID_USAGE_ID(uhid, utype, ucode) \ .usage_hid = (uhid), .usage_type = (utype), .usage_code = (ucode) /* we don't want to catch types and codes equal to 0 */ #define HID_TERMINATOR (HID_ANY_ID - 1) struct hid_report_id { __u32 report_type; }; struct hid_usage_id { __u32 usage_hid; __u32 usage_type; __u32 usage_code; }; /** * struct hid_driver * @name: driver name (e.g. "Footech_bar-wheel") * @id_table: which devices is this driver for (must be non-NULL for probe * to be called) * @probe: new device inserted * @remove: device removed (NULL if not a hot-plug capable driver) * @report_table: on which reports to call raw_event (NULL means all) * @raw_event: if report in report_table, this hook is called (NULL means nop) * @usage_table: on which events to call event (NULL means all) * @event: if usage in usage_table, this hook is called (NULL means nop) |
c500c9714 HID: hid, make pa... |
532 533 534 |
* @report_fixup: called before report descriptor parsing (NULL means nop) * @input_mapping: invoked on input registering before mapping an usage * @input_mapped: invoked on input registering after mapping an usage |
85cdaf524 HID: make a bus f... |
535 536 537 |
* * raw_event and event should return 0 on no action performed, 1 when no * further processing should be done and negative on error |
c500c9714 HID: hid, make pa... |
538 539 540 541 542 543 544 545 546 547 |
* * input_mapping shall return a negative value to completely ignore this usage * (e.g. doubled or invalid usage), zero to continue with parsing of this * usage by generic code (no special handling needed) or positive to skip * generic parsing (needed special handling which was done in the hook already) * input_mapped shall return negative to inform the layer that this usage * should not be considered for further processing or zero to notify that * no processing was performed and should be done in a generic manner * Both these functions may be NULL which means the same behavior as returning * zero from them. |
85cdaf524 HID: make a bus f... |
548 549 550 551 552 553 554 555 556 557 558 559 560 561 |
*/ struct hid_driver { char *name; const struct hid_device_id *id_table; int (*probe)(struct hid_device *dev, const struct hid_device_id *id); void (*remove)(struct hid_device *dev); const struct hid_report_id *report_table; int (*raw_event)(struct hid_device *hdev, struct hid_report *report, u8 *data, int size); const struct hid_usage_id *usage_table; int (*event)(struct hid_device *hdev, struct hid_field *field, struct hid_usage *usage, __s32 value); |
c500c9714 HID: hid, make pa... |
562 563 564 565 566 567 568 569 570 571 |
void (*report_fixup)(struct hid_device *hdev, __u8 *buf, unsigned int size); int (*input_mapping)(struct hid_device *hdev, struct hid_input *hidinput, struct hid_field *field, struct hid_usage *usage, unsigned long **bit, int *max); int (*input_mapped)(struct hid_device *hdev, struct hid_input *hidinput, struct hid_field *field, struct hid_usage *usage, unsigned long **bit, int *max); |
85cdaf524 HID: make a bus f... |
572 573 574 |
/* private: */ struct device_driver driver; }; |
c500c9714 HID: hid, make pa... |
575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 |
/** * hid_ll_driver - low level driver callbacks * @start: called on probe to start the device * @stop: called on remove * @open: called by input layer on open * @close: called by input layer on close * @hidinput_input_event: event input event (e.g. ff or leds) * @parse: this method is called only once to parse the device data, * shouldn't allocate anything to not leak memory */ struct hid_ll_driver { int (*start)(struct hid_device *hdev); void (*stop)(struct hid_device *hdev); int (*open)(struct hid_device *hdev); void (*close)(struct hid_device *hdev); int (*hidinput_input_event) (struct input_dev *idev, unsigned int type, unsigned int code, int value); int (*parse)(struct hid_device *hdev); }; |
1da177e4c Linux-2.6.12-rc2 |
597 598 |
/* Applications from HID Usage Tables 4/8/99 Version 1.1 */ /* We ignore a few input applications that are not widely used */ |
f472f8003 HID: add n-trig d... |
599 |
#define IS_INPUT_APPLICATION(a) (((a >= 0x00010000) && (a <= 0x00010008)) || (a == 0x00010080) || (a == 0x000c0001) || (a == 0x000d0002)) |
229695e51 [PATCH] Generic H... |
600 601 |
/* HID core API */ |
58037eb96 HID: make debuggi... |
602 603 604 605 |
#ifdef CONFIG_HID_DEBUG extern int hid_debug; #endif |
85cdaf524 HID: make a bus f... |
606 607 608 609 610 611 612 613 614 615 |
extern int hid_add_device(struct hid_device *); extern void hid_destroy_device(struct hid_device *); extern int __must_check __hid_register_driver(struct hid_driver *, struct module *, const char *mod_name); static inline int __must_check hid_register_driver(struct hid_driver *driver) { return __hid_register_driver(driver, THIS_MODULE, KBUILD_MODNAME); } extern void hid_unregister_driver(struct hid_driver *); |
7d12e780e IRQ: Maintain reg... |
616 |
extern void hidinput_hid_event(struct hid_device *, struct hid_field *, struct hid_usage *, __s32); |
1da177e4c Linux-2.6.12-rc2 |
617 |
extern void hidinput_report_event(struct hid_device *hid, struct hid_report *report); |
93c10132a HID: move connect... |
618 |
extern int hidinput_connect(struct hid_device *hid, unsigned int force); |
1da177e4c Linux-2.6.12-rc2 |
619 |
extern void hidinput_disconnect(struct hid_device *); |
1da177e4c Linux-2.6.12-rc2 |
620 |
|
1da177e4c Linux-2.6.12-rc2 |
621 |
int hid_set_field(struct hid_field *, unsigned, __s32); |
aa8de2f03 [PATCH] Generic H... |
622 |
int hid_input_report(struct hid_device *, int type, u8 *, int, int); |
dde5845a5 [PATCH] Generic H... |
623 |
int hidinput_find_field(struct hid_device *hid, unsigned int type, unsigned int code, struct hid_field **field); |
dde5845a5 [PATCH] Generic H... |
624 |
void hid_output_report(struct hid_report *report, __u8 *data); |
85cdaf524 HID: make a bus f... |
625 626 |
struct hid_device *hid_allocate_device(void); int hid_parse_report(struct hid_device *hid, __u8 *start, unsigned size); |
93c10132a HID: move connect... |
627 |
int hid_connect(struct hid_device *hid, unsigned int connect_mask); |
85cdaf524 HID: make a bus f... |
628 |
|
c500c9714 HID: hid, make pa... |
629 |
/** |
022e8c4d0 HID: move usage i... |
630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 |
* hid_map_usage - map usage input bits * * @hidinput: hidinput which we are interested in * @usage: usage to fill in * @bit: pointer to input->{}bit (out parameter) * @max: maximal valid usage->code to consider later (out parameter) * @type: input event type (EV_KEY, EV_REL, ...) * @c: code which corresponds to this usage and type */ static inline void hid_map_usage(struct hid_input *hidinput, struct hid_usage *usage, unsigned long **bit, int *max, __u8 type, __u16 c) { struct input_dev *input = hidinput->input; usage->type = type; usage->code = c; switch (type) { case EV_ABS: *bit = input->absbit; *max = ABS_MAX; break; case EV_REL: *bit = input->relbit; *max = REL_MAX; break; case EV_KEY: *bit = input->keybit; *max = KEY_MAX; break; case EV_LED: *bit = input->ledbit; *max = LED_MAX; break; } } /** * hid_map_usage_clear - map usage input bits and clear the input bit * * The same as hid_map_usage, except the @c bit is also cleared in supported * bits (@bit). */ static inline void hid_map_usage_clear(struct hid_input *hidinput, struct hid_usage *usage, unsigned long **bit, int *max, __u8 type, __u16 c) { hid_map_usage(hidinput, usage, bit, max, type, c); clear_bit(c, *bit); } /** |
c500c9714 HID: hid, make pa... |
683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 |
* hid_parse - parse HW reports * * @hdev: hid device * * Call this from probe after you set up the device (if needed). Your * report_fixup will be called (if non-NULL) after reading raw report from * device before passing it to hid layer for real parsing. */ static inline int __must_check hid_parse(struct hid_device *hdev) { int ret; if (hdev->status & HID_STAT_PARSED) return 0; ret = hdev->ll_driver->parse(hdev); if (!ret) hdev->status |= HID_STAT_PARSED; return ret; } /** * hid_hw_start - start underlaying HW * * @hdev: hid device |
93c10132a HID: move connect... |
709 |
* @connect_mask: which outputs to connect, see HID_CONNECT_* |
c500c9714 HID: hid, make pa... |
710 711 712 713 714 |
* * Call this in probe function *after* hid_parse. This will setup HW buffers * and start the device (if not deffered to device open). hid_hw_stop must be * called if this was successfull. */ |
93c10132a HID: move connect... |
715 716 |
static inline int __must_check hid_hw_start(struct hid_device *hdev, unsigned int connect_mask) |
c500c9714 HID: hid, make pa... |
717 |
{ |
93c10132a HID: move connect... |
718 719 720 721 722 723 724 |
int ret = hdev->ll_driver->start(hdev); if (ret || !connect_mask) return ret; ret = hid_connect(hdev, connect_mask); if (ret) hdev->ll_driver->stop(hdev); return ret; |
c500c9714 HID: hid, make pa... |
725 726 727 728 729 730 731 732 733 734 735 736 737 738 |
} /** * hid_hw_stop - stop underlaying HW * * @hdev: hid device * * This is usually called from remove function or from probe when something * failed and hid_hw_start was called already. */ static inline void hid_hw_stop(struct hid_device *hdev) { hdev->ll_driver->stop(hdev); } |
85cdaf524 HID: make a bus f... |
739 740 741 742 743 |
void hid_report_raw_event(struct hid_device *hid, int type, u8 *data, int size, int interrupt); extern int hid_generic_init(void); extern void hid_generic_exit(void); |
1da177e4c Linux-2.6.12-rc2 |
744 |
|
876b9276b USB HID: add 'qui... |
745 |
/* HID quirks API */ |
2eb5dc30e USB HID: encapsul... |
746 |
u32 usbhid_lookup_quirk(const u16 idVendor, const u16 idProduct); |
876b9276b USB HID: add 'qui... |
747 748 |
int usbhid_quirks_init(char **quirks_param); void usbhid_quirks_exit(void); |
6edfa8dc3 HID: move reset l... |
749 |
void usbhid_set_leds(struct hid_device *hid); |
2eb5dc30e USB HID: encapsul... |
750 |
|
224ee88fe Input: add force ... |
751 752 753 |
#ifdef CONFIG_HID_PID int hid_pidff_init(struct hid_device *hid); #else |
76483cf4d HID: remove hid-ff |
754 |
#define hid_pidff_init NULL |
1da177e4c Linux-2.6.12-rc2 |
755 |
#endif |
58037eb96 HID: make debuggi... |
756 757 758 759 760 761 762 |
#ifdef CONFIG_HID_DEBUG #define dbg_hid(format, arg...) if (hid_debug) \ printk(KERN_DEBUG "%s: " format ,\ __FILE__ , ## arg) #define dbg_hid_line(format, arg...) if (hid_debug) \ printk(format, ## arg) |
229695e51 [PATCH] Generic H... |
763 |
#else |
1b184cf37 HID: make functio... |
764 765 766 767 768 |
static inline int __attribute__((format(printf, 1, 2))) dbg_hid(const char *fmt, ...) { return 0; } |
58037eb96 HID: make debuggi... |
769 |
#define dbg_hid_line dbg_hid |
02ae9a1a8 HID: add compat s... |
770 |
#endif /* HID_DEBUG */ |
229695e51 [PATCH] Generic H... |
771 |
|
58037eb96 HID: make debuggi... |
772 773 |
#define err_hid(format, arg...) printk(KERN_ERR "%s: " format " " , \ |
229695e51 [PATCH] Generic H... |
774 |
__FILE__ , ## arg) |
02ae9a1a8 HID: add compat s... |
775 776 777 778 779 780 781 782 783 784 785 786 787 |
#endif /* HID_FF */ #ifdef CONFIG_HID_COMPAT #define HID_COMPAT_LOAD_DRIVER(name) \ void hid_compat_##name(void) { } \ EXPORT_SYMBOL(hid_compat_##name) #else #define HID_COMPAT_LOAD_DRIVER(name) #endif /* HID_COMPAT */ #define HID_COMPAT_CALL_DRIVER(name) do { \ extern void hid_compat_##name(void); \ hid_compat_##name(); \ } while (0) |
57d292bd7 HID: fix HIDIOCGR... |
788 |
#endif |
224ee88fe Input: add force ... |
789 |