自定义HID协议、应用说明

基本框架：

    HID设备支持USB标准描述符中的五个：设备描述符、配置描述符、接口描述符、端点描述符、字符串描述符。除此之外，HID设备还有三种特殊的描述符：HID描述符、报告描述符、物理描述符。一个USB设备只能支持一个HID描述符，但可以支持多个报告描述符，而物理描述符则可以有也可以没有。

USB描述符：

1、设备描述符

    一个USB设备只有一个设备描述符。设备描述符主要记录的信息有：设备所使用的USB协议版本号、设备类型、端点0的最大包大小、厂商ID（VID）和产品ID（PID）、设备版本号、厂商字符串索引、产品字符串索引、设备序列号索引、可能的配置数等。

偏移量	Demo值	域	大小/字节	说明
0	0x12	bLength	1	该描述符的长度（0x12=18字节）
1	0x01	bDescriptorType	1	描述符类型（0x01设备描述符）
2	0x00,0x02	bcdUSB	2	本设备使用的USB协议版本
4	0x00	bDeviceClass	1	类代码
5	0x00	bDeviceSubClass	1	子类代码
6	0x00	bDeviceProtocol	1	协议码
7	0x40	bMaxPacketSize	1	端点0最大包长
8	0x0483	idVendor	2	厂商ID
10	0x5750	idProduct	2	产品ID
12	0x00,0x02	bcdDevice	2	设备版本号
14	0x01	iManufacturer	1	描述厂商的字符串索引
15	0x02	iProduct	1	描述产品的字符串索引
16	0x03	iSerialNumber	1	产品序列号的字符串索引
17	0x01	bNumConfigurations	1	可能的配置数

2、配置描述符

    设备描述符里决定了该设备有多少种配置，每种配置都有一个配置描述符。配置描述符主要记录的信息有：配置所包含的接口数、配置的编号、供电方式、是否支持远程唤醒、电流需求量等。
 

偏移量	Demo值	域	大小	说明
0	0x09	bLength	1	该描述符的长度（0x09字节）
1	0x02	bDescriptorType	1	描述符类型（0x02配置描述符）
2	0x29,0x00	wTotalLength	2	配置、接口、端点和类描述符字节总和
4	0x01	bNumInterfaces	1	支持接口数
5	0x01	bConfigurationValue	1	本配置描述符标识
6	0x00	iConfiguration	1	配置描述符说明字符串索引
7	0xC0	bmAttributes	1	电源及唤醒
8	0x32	MaxPower	1	设备耗电电流

3、接口描述符

    在每个配置描述符中又定义了该配置有多少个接口，每个接口都有一个接口描述符。接口描述符主要记录的信息有：接口的编号、接口的端点数、接口所使用的类、子类、协议等。
 

偏移量	Demo值	域	大小/字节	说明
0	0x09	bLength	1	该描述符的长度（0x09字节）
1	0x04	bDescriptorType	1	描述符类型（0x04接口描述符）
2	0x00	bInterfaceNumber	1	本接口描述符标识
3	0x00	bAlternateSetting	1	可改变的设置
4	0x02	bNumEndpoints	1	接口端点数
5	0x03	bInterfaceClass	1	接口类代码(0x03 HID)
6	0x00	bInterfaceSubClass	1	启动类型1=BOOT, 0=No BOOT
7	0x00	bInterfaceProtocol	1	0=None, 1=Keyboard, 2=Mouse
8	0x00	iInterface	1	接口描述符说明字符串索引

4、类描述符

    该描述符不是必须的，如果配置的USB类型有类特殊描述符（如HID类），它跟在相应的接口描述符之后。具体数值参见HID类描述符。
5、端点描述符

    在接口描述符里又定义了该接口有多少个端点，每个端点都有一个端点描述符。端点描述符主要记录的信息有：端点号及方向、端点的传输类型、最大包长度、查询时间间隔等。
 

偏移量	Demo EP1	Demo EP2	域	字节	说明
0	0x07	0x07	bLength	1	该描述符的长度（0x07字节）
1	0x05	0x05	bDescriptorType	1	描述符类型（0x5端点描述符）
2	0x81	0x01	bEndpointAddress	1	端点地址
3	0x03	0x03	bmAttributes	1	端点类型(0x03 中断端点)
4	0x40,0x00	0x40,0x00	wMaxPacketSize	2	端点发送接收最大包长
6	0x05	0x05	bInterval	1	中断端点轮训时间间隔

6、字符串描述符

    字符串描述符主要是提供一些方便人们阅读的信息，它不是必需的。
 

偏移量	Demo值	域	大小/字节	说明
0	0x04	bLength	1	该描述符的长度（0x04/0xXX字节），第一个字符串描述符0x04
1	0x03	bDescriptorType	1	描述符类型（0x3字符串描述符）
2	1033	wLANGID	2/XX	第一个字符串描述符时2字节，表示语言编码，其他自定义

 
 

HID描述符：

    为了把一个设备识别为HID类别，设备在定义描述符的时候必须遵守HID规范。除了USB标准定义的一些描述符外，HID设备还必须定义HID描述符。另外设备和主机的通信是通过报告的形式来实现的，所以还必须定义报告描述符；而物理描述符不是必需的。
HID描述符是关联于接口（而不是端点）的，所以设备不需要为每个端点都提供一个HID描述符。详情参看《USB HID协议中文版_USB HID 设备》
1、      HID类描述符

HID描述符是HID类特有的描述符，保证设备正确识别，遵循规定的格式。
 

偏移量	Demo值	域	大小/字节	说明
0	0x09	bLength	1	该描述符的长度（0x09字节）
1	0x21	bDescriptorType	1	描述符类型（0x21 HID类）
2	0x11,0x01	bcdHID	2	HID规范版本
4	0x00	bCountryCode	1	国家代码
5	0x01	bNumDescriptors	1	支持的描述符个数
6	0x22	bDescriptorType	1	支持的描述类型（0x22是报表）
7	0x34,0x00	wDescriptorLength	2	Report描述符长度

2、      报告描述符

    报告描述符比较复杂，它是以item形式排列组合而成，无固定长度。为了准确描述来自主机的数据，一个报告描述符必须包括以下内容：

偏移量	域	大小/字节	说明
0	USAGE_PAGE	2
2	USAGE	2
4	COLLECTION	2
6	USAGE ID	2
8	LOGICAL_MINIMUM	2
10	LOGICAL_MAXIMUM	3
13	REPORT_SIZE	2
15	REPORT_COUNT	2
17	INPUT/OUTPUT	2
	…上述重复
XX	END_COLLECTION

 

        报表描述符是报表描述项目（Item）的集合，每一个描述项目都有相对统一的数据结构，项目很多，通过编码实现项目的第一个字节（项目前缀）由三部分构成，即项目类型（itemtype）、 项目标签（itemtag）和项目长度（itemsize），其中短项目的格式如下图：



    其中bTag占4个位，其余二者各占2个位。短项目的数据字节数由 bSize 的值定义， bSize 为0、 1、 2、 3 时 Data 部分的字节数分别为0、 1、 2、 4 个字节。短项目的项目类型由 bType 定义， bType 为 0、 1、 2 时分别为 Main、 Global和 Local 类型。
    bTag于下表中描述，例如Input 的标签代码『0x8?』中8 即bTag=8，再如标签Feature 之bTag=11，而Unit之bTag=6。Main Item的bType=0，Global Item的bType=1，而Local Item 的bType= 2。Main Item卷标代码中的『?』可以改为『00nnB』，Global Item的可以改为『01nnB』，而Local Item的可以改为『10nnB』，其中nn 代表bSize。

Main Item	Global Item	Local Item
Item	Prefix Code	Item	Prefix Code	Item	Prefix Code
Input	0x8?	Usage Page	0x0?	Usage	0x0?
Output	0x9?	Logical Minimum	0x1?	Usage Minimum	0x1?
Feature	0x0b?	Logical Maximum	0x2?	Usage Maximum	0x2?
		Physical Minimum	0x3?	Designator_Index	0x3?
Collection	0xa1	Physical Maximum	0x4?	Designator Minimum	0x4?
End Collection	0xc0	Unit Exponent	0x5?	Designator Maximum	0x5?
		Unit	0x6?	String_Index	0x6?
		Report Size	0x7?	String Minimum	0x7?
		Report ID	0x8?	String Maximum	0x8?
		Report Count	0x9?	Delimiter	0xa?
		Push	0xA4
		Pop	0xB4