鼠标（HID）设备描述符含义

最新推荐文章于 2024-03-20 23:09:44 发布
最新推荐文章于 2024-03-20 23:09:44 发布
阅读量1.3k 收藏 2
点赞数
分类专栏： Linux USB驱动开发 嵌入式 计算机 硬件 文章标签： linux 驱动开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41483419/article/details/128937088
版权

在这里插入图片描述
USB 设备功能按接口来分类，一个接口代表一种功能，接口下的端点用于实现该接口下的数据通讯功能。
Report 描述符用于描述 HID 设备的功能和设备上报的数据信息格式，Physical 描述符集（可选）,它携带如人体的哪个部位操作此设备的信息。
HID 描述符中定义了Report 描述符的个数和长度，Report描述符的获取通过向接口发送标准请求实现（81 06 00 22 xx xx xx xx）。

struct _DEVICE_DESCRIPTOR_STRUCT {     
    BYTE bLength;           //设备描述符的字节数大小，为0x12     
    BYTE bDescriptorType;   //描述符类型编号，为0x01     
    WORD bcdUSB;           	//USB版本号     
    BYTE bDeviceClass;   	//USB分配的设备类代码，0x01~0xfe为标准设备类，0xff为厂商自定义类型
    						//0x00不是在设备描述符中定义的，如HID      
    BYTE bDeviceSubClass;   //usb分配的子类代码，同上，值由USB规定和分配的      
    BYTE bDeviceProtocol;     //USB分配的设备协议代码，同上      
    BYTE bMaxPacketSize0;   //端点0的最大包的大小      
    WORD idVendor;           //厂商编号      
    WORD idProduct;         //产品编号      
    WORD bcdDevice;         //设备出厂编号      
    BYTE iManufacturer;     //描述厂商字符串的索引      
    BYTE iProduct;           //描述产品字符串的索引      
    BYTE iSerialNumber;     //描述设备序列号字符串的索引      
    BYTE bNumConfiguration; //可能的配置数量 
}

通过USB2.0 Monitor 枚举过程中获取鼠标 描述符:
一个鼠标，只有一个端点

		===>> Device Desc		<<===
bLength:						0x12    //设备描述符的字节数大小，为0x12
bDescriptorType:					0x01	//描述符类型编号，为0x01     
bcdUSB:							0x02 00	// USB 版本号
bDeviceClass:						0x00 	// 这个字节为0，则设备信息在interface
bDeviceSubClass:					0x00
bDeviceProtocol:					0x00
bMaxPacketSize0:					0x08	// 端点0 的最大包长
idVendor:						0x41 3C	// 厂商编号   
idProduct:						0x30 1A	// 产品编号
bcdDevice:						0x01 00	// 设备出厂编号
iManufacturer:						0x01	// 描述厂商字符串的索引
iProduct					    0x02	// 描述产品字符串的索引    
iSerialNumber					    0x00	// 描述设备序列号字符串的索引
bNumConfiguration  	  			    0x01	// 可能的配置数量 
    
		===>Configuration Descriptor<===
bLength:                        0x09
bDescriptorType:            	0x02	// constant
wTotalLength:                   0x0022  // 请求配置所返回的所有长度
bNumInterfaces:                 0x01  	// 此配置支持接口数
bConfigurationValue:            0x01	// Set_Configuration命令需要的参数
iConfiguration:                 0x00	// 此配置字符串的索引（第 1 个配置字符串）
bmAttributes:                   0xA0  -> 1010_0000 Bus Powered + 远程唤醒
MaxPower:                       0x32   // 设备从总线提取的最大电流: 0x32*2 mA = 100 mA
     
    ===>Interface Descriptor<===
bLength:                           0x09
bDescriptorType:                   0x04 // Interface Type
bInterfaceNumber:                  0x00 // 接口编号
bAlternateSetting:                 0x00 // 备用的接口描述符编号
bNumEndpoints:                     0x01 // 该接口使用端点数，不包括端点0
bInterfaceClass:                   0x03 // HID 设备
bInterfaceSubClass:                0x01 // Boot Interface SubClass=1表示USB设备支持 BOOT
// 意思是BIOS启动时就能识别并使用你的设别,且只有标准鼠标或键盘类设备才能成为Boot device,
// 为0则只有在操作系统启动后才能识别并使用你的HID设备. https://www.cnblogs.com/AlwaysOnLines/p/5085211.html
bInterfaceProtocol:                0x02 // 遵循的协议(前提是BOOT Interface) 1->Keyboard	2->Mouse
iInterface:                        0x00 // 描述该接口的字符串描述符的索引值
	===>HID class Descriptor<===
bLength:                           0x09 // HID描述符长度
bDescriptorType:                   0x21 // 描述符类型 constant
bcdHID:			           0x01 11 // HID 版本号（BCD码）1.1
bCountryCode:		           0x00 // 国家/地区代码
bNumDescriptor:                    0x01 // 支持的其它类型描述符数量
    								// 由于HID设备至少需要包括一个报告描述符，故其值至小为0x01。
bDescriptorType:                   0x22  // 类别描述符的类型,报表描述符
b/wDescriptorLength:               0x00 2E  // 可选字段，用于表示HID描述符附属的类别描述符类型及长度。
    								// 报告描述符的总长度 ??????????
    
    ===>Endpoint Descriptor<===
bLength:                           0x07
bDescriptorType:                   0x05
bEndpointAddress:                  0x81  -> Bit7,Direction: IN ; Bit3-0, EndpointID: 1
bmAttributes:                      0x03  -> Interrupt Transfer Type
wMaxPacketSize:                  0x0004 = 4 max bytes
bInterval:                         0x0A		// 主机查询端点的时间间隔

另一个鼠标，两个端点的情况

		===>> Device Desc		<<===
bLength:						0x12    //设备描述符的字节数大小，为0x12
bDescriptorType:					0x01	//描述符类型编号，为0x01     
bcdUSB:							0x01 10	// USB 版本号
bDeviceClass:						0x00 	// 这个字节为0，则设备信息在interface
bDeviceSubClass:					0x00
bDeviceProtocol:					0x00
bMaxPacketSize0:					0x08	// 端点0 的最大包长
idVendor:							0x30 FA	// 厂商编号   
idProduct:							0x17 01	// 产品编号
bcdDevice:							0x01 00	// 设备出厂编号
iManufacturer:						0x02	// 描述厂商字符串的索引
iProduct			       		        0x01	// 描述产品字符串的索引    
iSerialNumber					        0x00	// 描述设备序列号字符串的索引
bNumConfiguration  	  				0x01	// 可能的配置数量 
    
		===>Configuration Descriptor<===
bLength:                        0x09
bDescriptorType:            	0x02	// constant
wTotalLength:                   0x003B  // 请求配置所返回的所有长度
bNumInterfaces:                 0x02  	// 此配置支持接口数
bConfigurationValue:            0x01	// Set_Configuration命令需要的参数
iConfiguration:                 0x00	// 此配置字符串的索引（第 1 个配置字符串）
bmAttributes:                   0xA0  -> 1010_0000 Bus Powered + 远程唤醒
MaxPower:                       0x32   // 设备从总线提取的最大电流: 0x32*2 mA = 100 mA
     
    ===>Interface Descriptor<===
bLength:                           0x09
bDescriptorType:                   0x04 // Interface Type
bInterfaceNumber:                  0x00 // 接口编号
bAlternateSetting:                 0x00 // 备用的接口描述符编号
bNumEndpoints:                     0x01 // 该接口使用端点数，不包括端点0
bInterfaceClass:                   0x03 // HID 设备
bInterfaceSubClass:                0x01 // Boot Interface // SubClass=1表示USB设备支持 BOOT
bInterfaceProtocol:                0x02 // 遵循的协议(前提是BOOT Interface) 1->Keyboard	2->Mouse
iInterface:                        0x00 // 描述该接口的字符串描述符的索引值
	===>HID class Descriptor<===
bLength:                           0x09 // HID描述符长度
bDescriptorType:                   0x21 // 描述符类型 constant
bcdHID:			           0x01 10 // HID 版本号（BCD码）1.1
bCountryCode:		           0x00 // 国家/地区代码
bNumDescriptor:                    0x01 // 支持的其它类型描述符数量
    								// 由于HID设备至少需要包括一个报告描述符，故其值至小为0x01。
bDescriptorType:                   0x22  // 类别描述符的类型,报表描述符
b/wDescriptorLength:               0x00 42  // 可选字段，用于表示HID描述符附属的类别描述符类型及长度。
    								// 报告描述符的总长度 ??????????
    
    ===>Endpoint Descriptor<===
bLength:                           0x07
bDescriptorType:                   0x05
bEndpointAddress:                  0x81  -> Direction: IN - EndpointID: 1
bmAttributes:                      0x03  -> Interrupt Transfer Type
wMaxPacketSize:                  0x0008 = 8 max bytes
bInterval:                         0x0A		// 主机查询端点的时间间隔
    
        ===>Interface Descriptor<===
bLength:                           0x09
bDescriptorType:                   0x04 // Interface Type
bInterfaceNumber:                  0x01 // 接口编号
bAlternateSetting:                 0x00 // 备用的接口描述符编号
bNumEndpoints:                     0x01 // 该接口使用端点数，不包括端点0
bInterfaceClass:                   0x03 // HID 设备
bInterfaceSubClass:                0x00 // No Subclass
bInterfaceProtocol:                0x01 // 遵循的协议 1->Keyboard	2->Mouse
iInterface:                        0x00 // 描述该接口的字符串描述符的索引值
    
    	===>HID class Descriptor<===
bLength:                           0x09 // HID描述符长度
bDescriptorType:                   0x21 // 描述符类型 constant
bcdHID:			           0x01 10 // HID 版本号（BCD码）1.1
bCountryCode:		           0x00 // 国家/地区代码
bNumDescriptor:                    0x01 // 支持的其它类型描述符数量
    								// 由于HID设备至少需要包括一个报告描述符，故其值至小为0x01。
bDescriptorType:                   0x22  // 类别描述符的类型:0x22->报表描述符
b/wDescriptorLength:       	   0x00 8C  // 可选字段，用于表示HID描述符附属的类别描述符类型及长度。
    								// 报告描述符的总长度 ??????????
    
        ===>Endpoint Descriptor<===
bLength:                           0x07
bDescriptorType:                   0x05
bEndpointAddress:                  0x82  -> Direction: IN - EndpointID: 2
bmAttributes:                      0x03  -> Interrupt Transfer Type
wMaxPacketSize:                  0x0008 = 8 max bytes
bInterval:                         0x0A		// 主机查询端点的时间间隔
Twinkle544
关注
专栏目录
USB鼠标分析——HID 描述符(五)
tyustli
01-16 1702
HID 类的设备在配置描述符中还需要一个 HID 描述符。它是一个类描述符，跟在接口描述符后面，HID描述符的结构如下所示bLength：该描述符的长度。它的大小与该描述符中下级描述符的个数有关。例如，只有一个下级描述符时，总长度为：1 + 1 +2 + 1 + 1 + 1 + 2 = 9 字节bDescriptorType：描述符的编号。HID 描述符的编号为 0x21bcdHID：2 字节，是该设备所使用的 HID 协议的版本号。
鼠标（ HID 类）设备描述符解析——借助 WCH_USB2.0Monitor 解码功能
最新发布
sang123_的博客
08-16 1968
在USB协议中，描述符（Descriptor）是用来定义USB设备的特性和能力的数据结构。不同的类设备可以类特定的描述符。描述符通过标准的USB请求获取，主机通过解析这些描述符来了解设备的配置、接口、端点等信息。这篇文章记录一下鼠标设备的枚举过程中的描述符信息。以上记录了鼠标设备在枚举过程中的描述符信息，包括HID类描述符及其相关的报告描述符。
HID描述符
Z1799369927的博客
03-20 1438
键盘，鼠标就是HID设备，它们如果要将自己枚举成HID设备类，就必须要有对应的HID描述符，报告描述符，以及可选的实体描述符。设备描述符的第四个字段（bDeviceClass）就是表示USB设备所属的设备类，如果是0，那么我们就在接口描述符中进一步定义其具体功能为0x03，设置为HID设备。低五位就是表示用户需要用多大的力气才能影响相应的控制项，我们为0的时候就越容易，越大越难，高三位就是进一步修饰身体部位，左手，右手，左脚，右脚。获取特定类描述符的请求数据和之前的标准描述符有所不同，但是结构是一样的。
自己做的一款手柄的HID设备描述符
03-23
通过以上对描述符的逐行分析可以看出，这款自定义手柄的设计涵盖了常见的游戏手柄功能，包括按钮、轴等，并且采用了标准的HID描述符格式来定义其与主机之间的通信协议。这不仅有助于确保设备能够被广泛支持的操作...
USB HID Report详解 以及游戏手柄HID报告描述符分析.pdf
04-25
这篇文章主要分析了游戏手柄的HID报告描述符，包括对报告描述符的格式、字段以及如何解析这些字段来理解游戏手柄输入数据的含义。 首先，HID报告描述符是二进制数据，它定义了HID设备的输入输出报告格式。报告描述...
USB学习笔记-HID设备报告描述符详解.pdf
10-26
USB HID (Human Interface Device) 设备的报告描述符是理解HID设备如何与主机通信的关键。报告描述符是一个定义了设备能够发送和接收的数据结构的二进制编码，它描述了设备的输入、输出和特征报告，以及这些报告中每...
USB-HID设备报告描述符及相关协议
02-19
报告描述符是HID设备的重要组成部分，它定义了设备如何与主机通信，包括设备支持的各种输入、输出和特征报告的结构。本资料集合将帮助我们理解USB-HID设备报告描述符及相关协议的基础知识。 USB-HID协议是基于USB...
USB报告描述符自动生成工具 HID Descriptor tool
04-07
至于“hid descriptor tool”这个文件名，很可能是该工具的执行程序或者源代码文件，用户可以通过运行或编译这个文件来使用HID描述符自动生成的功能。 USB报告描述符是HID设备的关键部分，它定义了设备如何与主机...
hid鼠标和键盘
10-13
使用c语言编写的hid鼠标键盘，共两个鼠标和键盘程序
键盘鼠标描述符
01-15
实用，本人测试过
stm32 HID鼠标
11-01
stm32f103 HID-USB鼠标KEIL5工程，本例中晶振使用的是12M，如果是8M晶振需改回来，具体自行百度
HID 免驱 描述符
12-09
你还在为你的USB设备需要在各种系统上装驱动而烦恼么？
HID 报告描述
热门推荐
sK.坤
09-17 1万+
HID 报告描述 1 报告描述简介  Report Description，即上报事件的描述，描述所支持事件的格式及取值意义，比如鼠标按键上报格式、左键右键中间键分别对应的值等；报告描述跟JSON有些类似，都是结构数据，格式类似{usage:1, {id:0,usage:1.1,size:1,count:1,min:0,max:5,format:xx}} 2 描述符结构 几个主要的名词
HID用作鼠标的报告描述符解析
yhl_sophia的博客
09-14 4852
const uint8_t HID_ReportDescriptor[] = { USAGE_PAGE(Generic Desktop)             //全局项目，用途页用作通用桌面 USAGE (Mouse)                                   //局部项目，说明接下来的应用集合用途用作鼠标 COLLECTION (Application)   ...
USB鼠标分析——HID 类特殊请求(八)
tyustli
01-17 1746
USB 鼠标获取完字符串描述符之后，又请求了几次设备描述符和配置描述符，这些描述符在上面已经解析过了，这里就不再重复。在请求 HID 报告描述符之前，主机会有一些类特殊请求。下图为 HID 协议文档中的 HID 报告描述符的示例。关于报告描述符的详细解释参考 HID 协议文档。获取报告描述符的请求如下所示。
USB HID设备描述符
07-16
USB HID（Human Interface Device）设备描述符是一种用于描述USB设备的数据结构。它提供了关于设备的基本信息，包括设备的厂商ID、产品ID、设备版本号以及设备的功能和能力等。 USB HID设备描述符通常包含在设备的配置描述符中，它定义了设备的接口和端点，并提供了与设备交互所需的信息。其中最重要的是HID报告描述符，它定义了设备的输入和输出报告格式，描述了设备支持的按键、鼠标、游戏控制器或其他人机交互功能。 HID设备描述符具有以下结构： 1. bLength：描述符长度。 2. bDescriptorType：描述符类型，对于HID设备描述符，该值为0x21。 3. bcdHID：HID规范的版本号。 4. bCountryCode：国家/地区代码。 5. bNumDescriptors：附加描述符的数量，例如HID报告描述符。 6. bDescriptorType：附加描述符的类型。 7. wDescriptorLength：附加描述符的长度。 通过解析USB HID设备描述符，主机可以了解设备的基本信息和功能，从而正确地与设备进行通信和交互。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值