USBHID协议详情

1、标准文档USBHID类设备属于人机交互操作的设备，是一个比较大的类，用于控制计算机 操作的某些方面，如 USB鼠标、USB键盘、USB游戏操作杆、USB触摸板、USB 轨迹球、电话拨号设备、VCR遥控等等设备。另外，使用HID设备的一个好处就 是操作系统自带了 HID类的驱动程序，用户无需开发很麻烦的驱动程序，只有直 接使用API调用即可完成通信，所有很多简单的 USB设备喜欢枚举成HID设备， 这样就可以不用安装驱动而直接使用。1、HID设备描述符当插入USB设备后，主机会向设备请求各种描述符来识别设备。为了 把一个设备识别为HID类，设备在定义描述符的时候必须遵守 HID规范。HID设 备

2、的描述符除了 5个USB的标准描述符（设备描述符、配置描述符、接口描述符、 端点描述符、字符串描述符）外，还包括 3个HID设备类特定描述符：HID描述 符、报告描述符、物理描述符。HID描述符是关联于接口（而不是端点）的，所 以设备不需要为每个端点都提供一个 HID描述符。设备和主机的通信是通过报告 的形式来实现的。而物理描述符不是必需的。5个标准描述符中与HID设备有关的部分有：设备描述符中 bDeviceClass、bDeviceSubClass 和 bDeviceProtocol 三个字段的值必须为0。接口描述符中 bIntefaceClass 的值必须为 0x03， bIntefac

3、eSubClass 的值为0或1,为1表示HID设备是一个启动设备（Boot Device，一般对PC机而言才有意义，意思是BIOS启动时能识别并使用您的 HID 设备，且只有标准鼠标或键盘类设备才能成为 Boot Device。如果为0则只有在 操作系统启动后才能识别并使用您的 HID设备）。HID接口描述符中bln terfaceProtocol的含义bln terfaceProtocol的取值含0N(1键2鼠3255保1.1 HID描述符HID描述符关联于接口描述符，因而如果一个设备只有一个接口描述 符，则无论它有几个端点描述符，HID设备只有一个HID描述符。HID设备描述 符主要描述

4、HID规范的版本号、HID设备所用的额外描述符、报告描述符的长度USB HID类描述符的结构偏移量域大小描述0bLe ngth1描述符的字节数1bDescriptorType1描述符类型，HID类描述符为0x212bcdHID2HID版本号，如1.0版本的BCD码为0x000，版本1.1的BCD码4bCo un tryCode1硬件目的国家的识别码（BCD码）5bNumDescrioptors1支持的附属描述符数目6bDescrioptorType1HID相关描述符的类型0x21 : HID描述符0x22 :报告描述符0x23 :物理描述符7wDescriptorLe ngth2报告描述符总长

5、度9bDescriptorType1用于识别描述符类型的常量，使用一个以上描述符的设备10wDescrioptorLe ngth2描述符总长度，使用一个以上描述符的设备1.2报告描述符HID设备的报告描述符比较复杂也比较难理解。它以item形式排列组合而成，无固定长度，用户可以自定义长度以及每一bit的含义。HID报告描述符已经不是简简单单地描述某个值对应某个固定意义了，它已经能够组合出很多种情况，并且需要PC上的HID驱动程序提供parser解释器来对描述的设备情形 进行重新解释，进而组合生成出本HID硬件设备独特的数据流格式，所以可以把 它理解为“报告描述符脚本语言”更为贴切。我们使用“报

6、告描述符”专用脚本 语言，让用户来自己定义他们的HID设备都有什么数据以及这些数据各 bit都有什么意义。USB协会提供了一个 HID描述符编辑工具 HIDDescrioptor Tool ，用 它可以方便生成报告描述符。item类型分为三种：mai n, global 和local。其中ma in类型又可以 分为5种tag :* in put item tag:指的是从设备的一个或多个类似控制管道得到的数据* output item tag:指的是发送给一个或多个类似控制管道的数据* feature item tag:表示设备的输入输出不面向最终用户* collectio n item ta

7、g : 一个有意义的 in put, output 和 feature 的组合项 目* end collect ion item tag :指定一个 collect ion item的终止每一个 mainitem tag (input ， output，feature ) 都表明了来自一个特定管道 的数据的大小，数据相对还是独立，以及其他相关信息。在此之前，global和local item定义了数据的最大值和最小值，等等。local item仅仅描述下一个main item定义的数据域，而global item是这一个报告描述符中所有后续数据段的默认属性。一个报告描述符可能包含多个 main

8、 item，为了准确描述来自一个控制管道的数 据，一个报告描述符必须包括以下内容：* in put ( output，feature )* usage* usage page* Logical Minimum* Logical Maximum* Report Size* Report Count下面用一个三键鼠标举例说明：UsagePage (Ge neric Desktop);/global itemUsage(Mouse);/global itemCollectio n( Applicatio n);/Start Mousecollecti onUsage(Poi nter);/Colle

9、ctio n(Physical);/Start Poi nter collectio nUsagePage (Butt ons)UsageMi nimum (1),UsageMaximum (3),Logica IMin imum (0),LogicalMaximum (1) ;/Fields return valuesfrom 0 to 1ReportCou nt (3),ReportSize (1);/Create three 1 bit fields(butt on 1,2, & 3)In put(Data, Variable, Absolute);/Addfields to the i

10、n put report.ReportCou nt (1),ReportSize (5);/Create 5 bit con sta nt fieldIn put(C on sta nt), ;Add field to the in put reportUsagePage (Ge neric Desktop),Usage(X),Usage(Y),LogicalMi nimum (-127),Logical Maximum(127);/Fields return values from-127 to 127ReportSize (8),ReportCou nt (2);/Create two 8

11、 bit fields(X & Y positio n)In put(Data, Variable, Relative);/Addfields to the in put reportEn dCollectio n;/Close Poin ter collectio nEn dCollectio n;/Close Mouse collecti onitem的数据格式有两种，分别是短item和长item。短item格式bSize0:0个字节 1:1个字节 2:2个字节 3:3个字节bType0:main1:global2:local3:保留bTagitem类型8:i nput9:outputA:

12、collect ionB: featureC:end collecti on长item，其bType位值为3, bTag值为FbDataSize0:0个字节 1:1个字节 2:2 个字节 3:3 个字节bLon gItemTag0:main1:global2:local3:保留data数据1.3物理描述符物理描述符被用来描述设备的行为特性，物理描述符是可选的，HID设备可以根据其本体的设备特性选择是否包含物理描述符。 下表是HID的物理描 述符结构。HID物理描述符的结构偏移量域大小描述0bDesig nator1用来指定本体的哪一部分影响项目1bFlags1位指定标志位 04： Effort

13、位 57: QualifierbDesig nator 取值含义表取值含义取值含0x00无0x15小0x01手0x16头0x02眼球0x17肩0x03眉0x18腰0x04眼皮0x19腰0x05耳0x1A大0x06鼻0x1B膝0x07嘴0x1C小0x08上唇0x1D足0x09下唇0x1E脚0x0A颚0x1F脚0x0B颈0x20拇0x0C上臂0x21大0x0D手肘0x22第0x0E前臂0x23第0x0F手腕0x24第0x10手掌0x25小0x11拇指0x26眉0x12食指0x27脸0x13中指0x280xFF保0x14无名指Qualifier 取值含义取值含义取值含义0x00无0x04其中之一0x

14、01右0x05中间0x02左0x06保留0x03同时0x07保留2、HID类可采用的通信管道所有的HID设备通过USB的控制管道（默认管道，即端点 0）和中断 管道与主机通信。USB HID规范定义的HID设备可用端点管道要求说明控制（端点）必须传输USB描述符、类请求代码以及供查询的消息数据等中断输入必须传输从设备到主机的输入数据中断输出可选传输从主机到设备的输出数据控制管道主要用于以下3个方面:接收/响应USB主机的控制请示及相关的类数据在USB主机查询时传输数据（如响应Get_Report请求等）接收USB主机的数据中断管道主要用于以下两个方面：* USBfc机接收USB设备的异步传输数

15、据 USBfc机发送有实时性要求的数据给 USB设备从USB主机到USB设备的中断输出数据传输是可选的，当不支持中断 输出数据传输时，USBi机通过控制管道将数据传输给 USB设备。3、HID设备类特定的命令（请求）HID设备类特定的命令（请求）有 6个，它们分别是 Get_Report,Get_ldle, Get_Protocol,Set_Report, Set_Idle和 Set_Procotol。HID类请求（命令）数据包格式如下表所示:HID类请求(命令)包格式偏移量域大小描述0bmRequestType1D7数据传输方向0=从 USB HOST到 USB设备1=从 USB设备至U U

16、SB HOSTD6:5类型0仁请求类型为设备类请求D4:0接收端000仁请求对象为接口因而针对 HID的设备类请求，仅仅 10100001和00100001有效1bRequest1HID类请求2wValue2高字节说明描述符的类型0x21: HID描述符0x22 :报告描述符0x23 :物理描述符低字节非0时被用来选定物理描述符4win dex2根据不同的bRequest有不同的意义6wLe ngth2该请求的数据段长度HID 类请求 bRequest数值HID类请求描述符注释0x01GET_REPORT主机用控制传输从设备接收数据，所有HID类设备都要支持这个请求;0x02GET_IDLE主

17、机读取设备当前的空闲速率，设备可以不支持此请求；0x03GET_PROTOCOL仅仅适应于支持启动功能的HID设备(Boot Device )0x09SET_REPORT设备用控制传输接收主机的数据，设备可以不支持此请求；0x0ASET_IDLE设置闲置状态，设备可不支持此请求；0x0BSET_PROTOCOL仅仅适应于支持启动功能的HID设备(Boot Device )3.1 GET_REPORT主机通过控制端点获取一个Report域值bmRequestType0xA1bRequest0x01wValue高字节表示报告类型0x01: in put0x02: output0x03: featu

18、reOther: reserved低字节表示 ReportID，如不使用设为 0win dexHID的in terface 索引值wLe ngthReport长度DataReport内容3.2 SET_REPORT主机发送一个Report给设备，用以设置in put , output或者feature域值bmRequestType0x21bRequest0x09wValue高字节表示报告类型0x01: in put0x02: output0x03: featureOther: reserved低字节表示 ReportID，如不使用设为 0win dexHID的in terface 索引值wLe ngthReport长度DataReport内容3.3 GET IDLE域值bmRequestType0xA1bRequest0x02wValue高字节0低子节表示 ReportID，如不使用设为 0win dexHID的in terface 索引值wLe ngth1Data空闲速率3.4 SET_IDLE域值bmRequestType0x21bRequest0x0AwValue咼字节新的速率低字节表示 ReportI