The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/dev/usb/usbhid.h

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 /* $FreeBSD: releng/11.2/sys/dev/usb/usbhid.h 331722 2018-03-29 02:50:57Z eadler $ */
    2 /*-
    3  * Copyright (c) 2008 Hans Petter Selasky. All rights reserved.
    4  * Copyright (c) 1998 The NetBSD Foundation, Inc. All rights reserved.
    5  * Copyright (c) 1998 Lennart Augustsson. All rights reserved.
    6  *
    7  * Redistribution and use in source and binary forms, with or without
    8  * modification, are permitted provided that the following conditions
    9  * are met:
   10  * 1. Redistributions of source code must retain the above copyright
   11  *    notice, this list of conditions and the following disclaimer.
   12  * 2. Redistributions in binary form must reproduce the above copyright
   13  *    notice, this list of conditions and the following disclaimer in the
   14  *    documentation and/or other materials provided with the distribution.
   15  *
   16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
   17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
   20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   26  * SUCH DAMAGE.
   27  */
   28 
   29 #ifndef _USB_HID_H_
   30 #define _USB_HID_H_
   31 
   32 #ifndef USB_GLOBAL_INCLUDE_FILE
   33 #include <dev/usb/usb_endian.h>
   34 #endif
   35 
   36 #define UR_GET_HID_DESCRIPTOR   0x06
   37 #define UDESC_HID               0x21
   38 #define UDESC_REPORT            0x22
   39 #define UDESC_PHYSICAL          0x23
   40 #define UR_SET_HID_DESCRIPTOR   0x07
   41 #define UR_GET_REPORT           0x01
   42 #define UR_SET_REPORT           0x09
   43 #define UR_GET_IDLE             0x02
   44 #define UR_SET_IDLE             0x0a
   45 #define UR_GET_PROTOCOL         0x03
   46 #define UR_SET_PROTOCOL         0x0b
   47 
   48 struct usb_hid_descriptor {
   49         uByte   bLength;
   50         uByte   bDescriptorType;
   51         uWord   bcdHID;
   52         uByte   bCountryCode;
   53         uByte   bNumDescriptors;
   54         struct {
   55                 uByte   bDescriptorType;
   56                 uWord   wDescriptorLength;
   57         }       descrs[1];
   58 } __packed;
   59 
   60 #define USB_HID_DESCRIPTOR_SIZE(n) (9+((n)*3))
   61 
   62 /* Usage pages */
   63 #define HUP_UNDEFINED           0x0000
   64 #define HUP_GENERIC_DESKTOP     0x0001
   65 #define HUP_SIMULATION          0x0002
   66 #define HUP_VR_CONTROLS         0x0003
   67 #define HUP_SPORTS_CONTROLS     0x0004
   68 #define HUP_GAMING_CONTROLS     0x0005
   69 #define HUP_KEYBOARD            0x0007
   70 #define HUP_LEDS                0x0008
   71 #define HUP_BUTTON              0x0009
   72 #define HUP_ORDINALS            0x000a
   73 #define HUP_TELEPHONY           0x000b
   74 #define HUP_CONSUMER            0x000c
   75 #define HUP_DIGITIZERS          0x000d
   76 #define HUP_PHYSICAL_IFACE      0x000e
   77 #define HUP_UNICODE             0x0010
   78 #define HUP_ALPHANUM_DISPLAY    0x0014
   79 #define HUP_MONITOR             0x0080
   80 #define HUP_MONITOR_ENUM_VAL    0x0081
   81 #define HUP_VESA_VC             0x0082
   82 #define HUP_VESA_CMD            0x0083
   83 #define HUP_POWER               0x0084
   84 #define HUP_BATTERY_SYSTEM      0x0085
   85 #define HUP_BARCODE_SCANNER     0x008b
   86 #define HUP_SCALE               0x008c
   87 #define HUP_CAMERA_CONTROL      0x0090
   88 #define HUP_ARCADE              0x0091
   89 #define HUP_MICROSOFT           0xff00
   90 
   91 /* Usages, generic desktop */
   92 #define HUG_POINTER             0x0001
   93 #define HUG_MOUSE               0x0002
   94 #define HUG_JOYSTICK            0x0004
   95 #define HUG_GAME_PAD            0x0005
   96 #define HUG_KEYBOARD            0x0006
   97 #define HUG_KEYPAD              0x0007
   98 #define HUG_X                   0x0030
   99 #define HUG_Y                   0x0031
  100 #define HUG_Z                   0x0032
  101 #define HUG_RX                  0x0033
  102 #define HUG_RY                  0x0034
  103 #define HUG_RZ                  0x0035
  104 #define HUG_SLIDER              0x0036
  105 #define HUG_DIAL                0x0037
  106 #define HUG_WHEEL               0x0038
  107 #define HUG_HAT_SWITCH          0x0039
  108 #define HUG_COUNTED_BUFFER      0x003a
  109 #define HUG_BYTE_COUNT          0x003b
  110 #define HUG_MOTION_WAKEUP       0x003c
  111 #define HUG_VX                  0x0040
  112 #define HUG_VY                  0x0041
  113 #define HUG_VZ                  0x0042
  114 #define HUG_VBRX                0x0043
  115 #define HUG_VBRY                0x0044
  116 #define HUG_VBRZ                0x0045
  117 #define HUG_VNO                 0x0046
  118 #define HUG_TWHEEL              0x0048  /* M$ Wireless Intellimouse Wheel */
  119 #define HUG_SYSTEM_CONTROL      0x0080
  120 #define HUG_SYSTEM_POWER_DOWN   0x0081
  121 #define HUG_SYSTEM_SLEEP        0x0082
  122 #define HUG_SYSTEM_WAKEUP       0x0083
  123 #define HUG_SYSTEM_CONTEXT_MENU 0x0084
  124 #define HUG_SYSTEM_MAIN_MENU    0x0085
  125 #define HUG_SYSTEM_APP_MENU     0x0086
  126 #define HUG_SYSTEM_MENU_HELP    0x0087
  127 #define HUG_SYSTEM_MENU_EXIT    0x0088
  128 #define HUG_SYSTEM_MENU_SELECT  0x0089
  129 #define HUG_SYSTEM_MENU_RIGHT   0x008a
  130 #define HUG_SYSTEM_MENU_LEFT    0x008b
  131 #define HUG_SYSTEM_MENU_UP      0x008c
  132 #define HUG_SYSTEM_MENU_DOWN    0x008d
  133 #define HUG_APPLE_EJECT         0x00b8
  134 
  135 /* Usages Digitizers */
  136 #define HUD_UNDEFINED           0x0000
  137 #define HUD_DIGITIZER           0x0001
  138 #define HUD_PEN                 0x0002
  139 #define HUD_TOUCHSCREEN         0x0004
  140 #define HUD_TOUCHPAD            0x0005
  141 #define HUD_CONFIG              0x000e
  142 #define HUD_FINGER              0x0022
  143 #define HUD_TIP_PRESSURE        0x0030
  144 #define HUD_BARREL_PRESSURE     0x0031
  145 #define HUD_IN_RANGE            0x0032
  146 #define HUD_TOUCH               0x0033
  147 #define HUD_UNTOUCH             0x0034
  148 #define HUD_TAP                 0x0035
  149 #define HUD_QUALITY             0x0036
  150 #define HUD_DATA_VALID          0x0037
  151 #define HUD_TRANSDUCER_INDEX    0x0038
  152 #define HUD_TABLET_FKEYS        0x0039
  153 #define HUD_PROGRAM_CHANGE_KEYS 0x003a
  154 #define HUD_BATTERY_STRENGTH    0x003b
  155 #define HUD_INVERT              0x003c
  156 #define HUD_X_TILT              0x003d
  157 #define HUD_Y_TILT              0x003e
  158 #define HUD_AZIMUTH             0x003f
  159 #define HUD_ALTITUDE            0x0040
  160 #define HUD_TWIST               0x0041
  161 #define HUD_TIP_SWITCH          0x0042
  162 #define HUD_SEC_TIP_SWITCH      0x0043
  163 #define HUD_BARREL_SWITCH       0x0044
  164 #define HUD_ERASER              0x0045
  165 #define HUD_TABLET_PICK         0x0046
  166 #define HUD_CONFIDENCE          0x0047
  167 #define HUD_WIDTH               0x0048
  168 #define HUD_HEIGHT              0x0049
  169 #define HUD_CONTACTID           0x0051
  170 #define HUD_INPUT_MODE          0x0052
  171 #define HUD_DEVICE_INDEX        0x0053
  172 #define HUD_CONTACTCOUNT        0x0054
  173 #define HUD_CONTACT_MAX         0x0055
  174 #define HUD_SCAN_TIME           0x0056
  175 #define HUD_BUTTON_TYPE         0x0059
  176 
  177 /* Usages, Consumer */
  178 #define HUC_AC_PAN              0x0238
  179 
  180 #define HID_USAGE2(p,u) (((p) << 16) | (u))
  181 
  182 #define UHID_INPUT_REPORT 0x01
  183 #define UHID_OUTPUT_REPORT 0x02
  184 #define UHID_FEATURE_REPORT 0x03
  185 
  186 /* Bits in the input/output/feature items */
  187 #define HIO_CONST       0x001
  188 #define HIO_VARIABLE    0x002
  189 #define HIO_RELATIVE    0x004
  190 #define HIO_WRAP        0x008
  191 #define HIO_NONLINEAR   0x010
  192 #define HIO_NOPREF      0x020
  193 #define HIO_NULLSTATE   0x040
  194 #define HIO_VOLATILE    0x080
  195 #define HIO_BUFBYTES    0x100
  196 
  197 /* Units of Measure */
  198 #define HUM_CENTIMETER  0x11
  199 #define HUM_RADIAN      0x12
  200 #define HUM_INCH        0x13
  201 #define HUM_DEGREE      0x14
  202 
  203 #ifdef _KERNEL
  204 struct usb_config_descriptor;
  205 
  206 enum hid_kind {
  207         hid_input, hid_output, hid_feature, hid_collection, hid_endcollection
  208 };
  209 
  210 struct hid_location {
  211         uint32_t size;
  212         uint32_t count;
  213         uint32_t pos;
  214 };
  215 
  216 struct hid_item {
  217         /* Global */
  218         int32_t _usage_page;
  219         int32_t logical_minimum;
  220         int32_t logical_maximum;
  221         int32_t physical_minimum;
  222         int32_t physical_maximum;
  223         int32_t unit_exponent;
  224         int32_t unit;
  225         int32_t report_ID;
  226         /* Local */
  227         int32_t usage;
  228         int32_t usage_minimum;
  229         int32_t usage_maximum;
  230         int32_t designator_index;
  231         int32_t designator_minimum;
  232         int32_t designator_maximum;
  233         int32_t string_index;
  234         int32_t string_minimum;
  235         int32_t string_maximum;
  236         int32_t set_delimiter;
  237         /* Misc */
  238         int32_t collection;
  239         int     collevel;
  240         enum hid_kind kind;
  241         uint32_t flags;
  242         /* Location */
  243         struct hid_location loc;
  244 };
  245 
  246 /* prototypes from "usb_hid.c" */
  247 
  248 struct hid_data *hid_start_parse(const void *d, usb_size_t len, int kindset);
  249 void    hid_end_parse(struct hid_data *s);
  250 int     hid_get_item(struct hid_data *s, struct hid_item *h);
  251 int     hid_report_size(const void *buf, usb_size_t len, enum hid_kind k,
  252             uint8_t *id);
  253 int     hid_locate(const void *desc, usb_size_t size, int32_t usage,
  254             enum hid_kind kind, uint8_t index, struct hid_location *loc,
  255             uint32_t *flags, uint8_t *id);
  256 int32_t hid_get_data(const uint8_t *buf, usb_size_t len,
  257             struct hid_location *loc);
  258 uint32_t hid_get_data_unsigned(const uint8_t *buf, usb_size_t len,
  259             struct hid_location *loc);
  260 void hid_put_data_unsigned(uint8_t *buf, usb_size_t len,
  261             struct hid_location *loc, unsigned int value);
  262 int     hid_is_collection(const void *desc, usb_size_t size, int32_t usage);
  263 struct usb_hid_descriptor *hid_get_descriptor_from_usb(
  264             struct usb_config_descriptor *cd,
  265             struct usb_interface_descriptor *id);
  266 usb_error_t usbd_req_get_hid_desc(struct usb_device *udev, struct mtx *mtx,
  267             void **descp, uint16_t *sizep, struct malloc_type *mem,
  268             uint8_t iface_index);
  269 int32_t hid_item_resolution(struct hid_item *hi);
  270 int     hid_is_mouse(const void *d_ptr, uint16_t d_len);
  271 int     hid_is_keyboard(const void *d_ptr, uint16_t d_len);
  272 #endif                                  /* _KERNEL */
  273 #endif                                  /* _USB_HID_H_ */

Cache object: 72923faedccf4db394a495b8b4690c78


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.