usb hid

一、应用场合

usb hid 类是比较大的一个类，hid类设备属于人机交互操作的设备。用于控制计算机操作的一些场合，如usb鼠标、usb键盘、usb游戏操纵杆、usb触摸板、usb轨迹球、电话拨号设备、VCR遥控等等设备。另外，使用hid设备的一个好处就是，操作系统自到了hid类的驱动程序，而用户无需去开发很麻烦的驱动程序，只要直接使用api调用即可完成通信。所以很多简单的usb设备，喜欢枚举成hid设备。这样就可以不用安装驱动而直接使用。

二、usb hid类可采用的通信管道

所有的hid设备通过usb的控制管道（默认管道,即端点0）和中断管道与主机通信。

控制管道（端点0）：必选，用于传输usb描述符，类请求代码以及供查询的消息数据等。

中断输入                ：必选，用于传输从设备到主机的输入数据。

中断输出                ：可选，用于传输从主机到设备的输出数据。

控制管道用于以下三个方面：

1。接受/相应usb主机的控制请示及相关的类数据

2。在USB主机查询时传输数据（如相应Get_Report请求等）

3。接受USB主机的数据

从usb主机到usb设备的终端输入数据传输是可选的，当不支持终端输出数据传输时，usb主机通过控制管道将数据传输给usb设备。

三、与usb hid设备有关的描述符

       hid设备的描述除了5个usb的标准描述符（设备描述符、配置描述符、接口描述符、端点描述符、字符串描述符）外，还包括3个hid设备类特定描述符：hid描述符、报告描述符、实体描述符。

      除了hid的三个特定描述符组成对hid设备的解释外，5个标准描述符中与hid设备有关的部分有：

1。设备描述符中bDeviceClass、bDeviceSubClass和bDeviceProtocal三个字段的值必须为零。

2。接口描述符中bInterfaceClass的值必须为ox03，bInterfaceSubClass的值为0或1，为1表示HID设备符是一个启动设备（BootDevice，一般对PC机而言才有意义，意思是BIOS启动时能识别并使用您的HID设备，且只有标准鼠标或键盘类设备才能成为BootDevice。如果为0则只有在操作系统启动后才能识别并使用您的HID设备）。另外bInterfaceProtocol的取值含义如下所示：

bInterfaceProtocol的取值（十进制）                                含义

0                                                                                       NONE

1                                                                                       键盘

2                                                                                       鼠标

3~255                                                                               保留

下面分别对3个hid设备类特定描述符进行说明。

1。hid描述符

hid描述符关联于接口描述符，因而如果一个设备只有一个接口描述符，则无论它有几个端点描述符，hid设备只有一个hid描述符。hid设备描述符主要描述hid规范的版本号、hid通信所使用的额外描述符、报表描述符的长度等。下表为HID描述符的结构：

偏移量                      域                          大小                          值                             描述

0                              bLength                 1                              数字                        此描述符的长度（以字节为单位）

1                              bDescriptorType    1                             常量                        描述符种类（此处为0X21，即hid类描述符）

2                              bcdHID                   2                             数字                        hid规范版本号（BCD码），采用4个16进制的BCD编码

4                              bCountry                1                            数字                      硬件目的国家的识别码

5                              bNumDescriptors    1                           数字                      支持的附属描述符数目

6                              bDescriptorType    1                           数字                      hid相关描述符的类型

7                              wDescriptorLength 2                            数字                      报告描述符长度

9                               bDescriptorType   1                            常量                    用于识别描述符类型的常量，使用在有一个以上描述符的设备

10                          wDescriptorLength  2                             数字                     描述符总长度，使用在有一个以上描述符的设备  

 表 hid相关描述符类型定义

描述符类型值                               hid相关描述符类型

0x21                                             hid描述符

0x22                                             报表描述符

0x23                                             实体描述符

2。报告描述符

HID设备的报告描述符比较复杂也比较难理解。

报告描述符的语法不同于USB标准描述符，它是以项目（items）方式排列而成，无一定的长度。HID的报告描述符已经不是简简单单的描述某个值对应某个固定的意义了，它已经能够组合出很多种情况，并且需要PC上的HID驱动程序提供Parser解释器来对描述的设备情况进行重新解释，进而组合生成出本HID硬件设备独特的数据流格式，所以我觉得可以它理解为“报告描述符脚本语言”更为贴切。我们使用“报告描述符”专用脚本语言，让用户来自己定义他们的HID设备都有什么数据、以及这些数据各个位（bit）都有什么意义。

      有关报告描述符的详细信息可参考USB HID 设备类协议及HID usage table，这里还有篇关于文章：《USB/HID设备报告描述符详解》。

      另外，USB协会还提供了一个HID描述符编辑工具称为 HID Descriptor Tool，用它可方便生成我们的报告描述符。

3。实体描述符

       实体描述符被用来描述设备的行为特性。实体描述符是可选的描述符，HID设备可以根据其本体的设备特性选择是否包含实体描述符。

四、usb hid类命令（请求）

       HID设备类特定的命令（请求）有6个，他们分别是Get_Report、 Get_Idle、Get_Protocol、Set_Report、Set_Idle和Set_Protocol。

HID类请求（命令）数据报格式下表所示：

表 9、HID 类请求（命令）包格式
偏移量                          域                              大小                             说明
0                       bmRequestType                     1                          HID 设备类请求特性如下：

                                                                                                     位 7：
                                                                                                    0＝从USB HOST 到USB 设备
                                                                                                    1＝从USB 设备到USB HOST
                                                                                                    位6~5：
                                                                                                    01＝请求类型为设备类请求
                                                                                                    位 4~0：
                                                                                                    0001＝请求对象为接口（interface）
                                                                                                    因而，针对 HID 的设备类请求，仅仅10100001 和00100001有效

1        bRequest               1                                                       HID类请求

2        wValue                   2                                                     高字节说明描述符的类型，而低字节为非0值时被用来选定实体描述符。

4        wIndex                   2                                                      2个字节数值，根据不同的bRequest有不同的意义。

6        wLength                2                                                     该请求的数据段长度

 

表  ：HID类请求

数值             HID类请求描述符                      注释

0x01              GET_REPORT                       

0x02              GET_IDLE

0x03              GET_PROTOCOL                      仅仅适应于支持启动功能的HID设备（boot device）

0x09              SET_REPORT                           

0x0a              SET_IDLE

0X0B              SET_PROTOCOL