hiddev.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:6k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. #ifndef _HIDDEV_H
  2. #define _HIDDEV_H
  3. /*
  4.  * $Id: hiddev.h,v 1.2 2001/04/26 11:26:09 vojtech Exp $
  5.  *
  6.  *  Copyright (c) 1999-2000 Vojtech Pavlik
  7.  *
  8.  *  Sponsored by SuSE
  9.  */
  10. /*
  11.  * This program is free software; you can redistribute it and/or modify
  12.  * it under the terms of the GNU General Public License as published by
  13.  * the Free Software Foundation; either version 2 of the License, or 
  14.  * (at your option) any later version.
  15.  * 
  16.  * This program is distributed in the hope that it will be useful,
  17.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19.  * GNU General Public License for more details.
  20.  * 
  21.  * You should have received a copy of the GNU General Public License
  22.  * along with this program; if not, write to the Free Software
  23.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  24.  * 
  25.  * Should you need to contact me, the author, you can do so either by
  26.  * e-mail - mail your message to <vojtech@suse.cz>, or by paper mail:
  27.  * Vojtech Pavlik, Ucitelska 1576, Prague 8, 182 00 Czech Republic
  28.  */
  29. /*
  30.  * The event structure itself
  31.  */
  32. struct hiddev_event {
  33. unsigned hid;
  34. signed int value;
  35. };
  36. struct hiddev_devinfo {
  37. unsigned int bustype;
  38. unsigned int busnum;
  39. unsigned int devnum;
  40. unsigned int ifnum;
  41. short vendor;
  42. short product;
  43. short version;
  44. unsigned num_applications;
  45. };
  46. #define HID_STRING_SIZE 256
  47. struct hiddev_string_descriptor {
  48. int index;
  49. char value[HID_STRING_SIZE];
  50. };
  51. struct hiddev_report_info {
  52. unsigned report_type;
  53. unsigned report_id;
  54. unsigned num_fields;
  55. };
  56. /* To do a GUSAGE/SUSAGE, fill in at least usage_code,  report_type and 
  57.  * report_id.  Set report_id to REPORT_ID_UNKNOWN if the rest of the fields 
  58.  * are unknown.  Otherwise use a usage_ref struct filled in from a previous 
  59.  * successful GUSAGE/SUSAGE call to save time.  To actually send a value
  60.  * to the device, perform a SUSAGE first, followed by a SREPORT.  If an
  61.  * INITREPORT is done, a GREPORT isn't necessary before a GUSAGE.
  62.  */
  63. #define HID_REPORT_ID_UNKNOWN 0xffffffff
  64. #define HID_REPORT_ID_FIRST   0x00000100
  65. #define HID_REPORT_ID_NEXT    0x00000200
  66. #define HID_REPORT_ID_MASK    0x000000ff
  67. #define HID_REPORT_ID_MAX     0x000000ff
  68. #define HID_REPORT_TYPE_INPUT 1
  69. #define HID_REPORT_TYPE_OUTPUT 2
  70. #define HID_REPORT_TYPE_FEATURE 3
  71. #define HID_REPORT_TYPE_MIN     1
  72. #define HID_REPORT_TYPE_MAX     3
  73. struct hiddev_field_info {
  74. unsigned report_type;
  75. unsigned report_id;
  76. unsigned field_index;
  77. unsigned maxusage;
  78. unsigned flags;
  79. unsigned physical; /* physical usage for this field */
  80. unsigned logical; /* logical usage for this field */
  81. unsigned application; /* application usage for this field */
  82. __s32 logical_minimum;
  83. __s32 logical_maximum;
  84. __s32 physical_minimum;
  85. __s32 physical_maximum;
  86. unsigned unit_exponent;
  87. unsigned unit;
  88. };
  89. /* Fill in report_type, report_id and field_index to get the information on a
  90.  * field.
  91.  */
  92. #define HID_FIELD_CONSTANT 0x001
  93. #define HID_FIELD_VARIABLE 0x002
  94. #define HID_FIELD_RELATIVE 0x004
  95. #define HID_FIELD_WRAP 0x008
  96. #define HID_FIELD_NONLINEAR 0x010
  97. #define HID_FIELD_NO_PREFERRED 0x020
  98. #define HID_FIELD_NULL_STATE 0x040
  99. #define HID_FIELD_VOLATILE 0x080
  100. #define HID_FIELD_BUFFERED_BYTE 0x100
  101. struct hiddev_usage_ref {
  102. unsigned report_type;
  103. unsigned report_id;
  104. unsigned field_index;
  105. unsigned usage_index;
  106. unsigned usage_code;
  107. __s32 value;
  108. };
  109. /*
  110.  * Protocol version.
  111.  */
  112. #define HID_VERSION 0x010002
  113. /*
  114.  * IOCTLs (0x00 - 0x7f)
  115.  */
  116. #define HIDIOCGVERSION _IOR('H', 0x01, int)
  117. #define HIDIOCAPPLICATION _IO('H', 0x02)
  118. #define HIDIOCGDEVINFO _IOR('H', 0x03, struct hiddev_devinfo)
  119. #define HIDIOCGSTRING _IOR('H', 0x04, struct hiddev_string_descriptor)
  120. #define HIDIOCINITREPORT _IO('H', 0x05)
  121. #define HIDIOCGNAME(len) _IOC(_IOC_READ, 'H', 0x06, len)
  122. #define HIDIOCGREPORT _IOW('H', 0x07, struct hiddev_report_info)
  123. #define HIDIOCSREPORT _IOW('H', 0x08, struct hiddev_report_info)
  124. #define HIDIOCGREPORTINFO       _IOWR('H', 0x09, struct hiddev_report_info)
  125. #define HIDIOCGFIELDINFO        _IOWR('H', 0x0A, struct hiddev_field_info)
  126. #define HIDIOCGUSAGE            _IOWR('H', 0x0B, struct hiddev_usage_ref)
  127. #define HIDIOCSUSAGE            _IOW('H', 0x0C, struct hiddev_usage_ref)
  128. #define HIDIOCGUCODE            _IOWR('H', 0x0D, struct hiddev_usage_ref)
  129. /* To traverse the input report descriptor info for a HID device, perform the 
  130.  * following:
  131.  *
  132.  *  rinfo.report_type = HID_REPORT_TYPE_INPUT;
  133.  *  rinfo.report_id = HID_REPORT_ID_FIRST;
  134.  *  ret = ioctl(fd, HIDIOCGREPORTINFO, &rinfo);
  135.  *
  136.  *  while (ret >= 0) {
  137.  *      for (i = 0; i < rinfo.num_fields; i++) { 
  138.  *     finfo.report_type = rinfo.report_type;
  139.  *          finfo.report_id = rinfo.report_id;
  140.  *          finfo.field_index = i;
  141.  *          ioctl(fd, HIDIOCGFIELDINFO, &finfo);
  142.  *          for (j = 0; j < finfo.maxusage; j++) {
  143.  *              uref.field_index = i;
  144.  * uref.usage_index = j;
  145.  * ioctl(fd, HIDIOCGUCODE, &uref);
  146.  * ioctl(fd, HIDIOCGUSAGE, &uref);
  147.  *          }
  148.  * }
  149.  * uref.report_id |= HID_REPORT_ID_NEXT;
  150.  * ret = ioctl(fd, HIDIOCGREPORTINFO, &uref);
  151.  *  }
  152.  */
  153. #ifdef __KERNEL__
  154. /*
  155.  * In-kernel definitions.
  156.  */
  157. #ifdef CONFIG_USB_HIDDEV
  158. int hiddev_connect(struct hid_device *);
  159. void hiddev_disconnect(struct hid_device *);
  160. void hiddev_hid_event(struct hid_device *, unsigned int usage, int value);
  161. int __init hiddev_init(void);
  162. void __exit hiddev_exit(void);
  163. #else
  164. static inline void *hiddev_connect(struct hid_device *hid) { return NULL; }
  165. static inline void hiddev_disconnect(struct hid_device *hid) { }
  166. static inline void hiddev_event(struct hid_device *hid, unsigned int usage, int value) { }
  167. static inline int hiddev_init(void) { return 0; }
  168. static inline void hiddev_exit(void) { }
  169. #endif
  170. #endif
  171. #endif