HID 报告描述符精细说明.

1,报告描述符概述
    1.1) 报表描述符
        报表描述符和USB的其他描述符是不一样的,它不是一个简单的表格,报表描述符是USB所有描述符中最复杂的。报表描述符非常复杂而有弹性,因为它需要处理各种用途的设备。
报表的数据必须以简洁的格式来储存,这样才不会浪费设备内的储存空间以及数据传输时的总线时间。实际上可以这样理解,报表内容的简洁,是通过报表描述符全面的、复杂的数据描述实现的。
报表描述符必须先描述数据的大小与内容。报表描述符的内容与大小因设备的不同而不同,在进行报表传输之前,主机必须先请求设备的报表描述符,只有得到了报表描述符才可正确解析报表的数据。
报表描述符是报表描述项目(Item)的集合,每一个描述项目都有相对统一的数据结构,项目很多,通过编码实现。

1.2) 项目(Item)
          HID的项目有短项目长项两种。
          其中 :项目的第一个字节(项目前缀)由三部分构成,即项目类型(item type)、项目标志(item tag)和项目长度(item size)。
其中项目类型说明项目的数据类型,项目标签说明项目的功能,项目长度说明项目的数据部分的长度。
          
        短项目的数据字节数由bSize的值定义,bSize为0、1、2、3时Data部分的字节数分别为0、1、2、4个字节。短项目的项目类型由bType定义,bType为0、1、2时分别为MainGlobalLocal类型。

长项目:
          
          项目中的第一个字节为上图中的特定值时表明该项目是一个长项目。长项目中的bDataSize说明Data部分的字节数,bLongItemTag在HID规范中没有定义。

1.3) 项目(Item) 类型
        报表的项目有Main、Global和Local三大类,每一类都有多个不同的项目,实现不同的描述。
        Main类项目用于定义报表描述符中的数据项。也可以组合其中的若干数据项成为一个集合。Main项目可以分为带数据的Main项目和不带数据的Main项目。带数据项的Main用于生成报表中的数据项,包括Input、Output和Feature项目。不带数据的Main项目不生成报表中的数据项,包括Collection和End Collection项目。
        Global类项目实现对数据的描述,用来识别报表并且描述报表内的数据,包括数据的功能、最大与最小允许值以及数据项的大小与数目等。改变由Main类项目生成的项目状态表。Global类项目描述对后续的所有项目有效,除非遇到有新的Global类项目。
        Local类项目定义控制的特征,这一类项目的作用域不超过下一个Main项目,所以在每一Main项目之前可能有多个Local项目。Local项目用于描述后面的Input、Output和Feature项目。
        
        
        在这些项目中,Usage Page用来指定设备的功能,而Usage项目用来指定个别报表的功能。Usage Page项目相当于是HID的子集合,Usage相当于是Usage Page的子集合。

1.4) 鼠标的报告描述符的实现
            Usage Page (Generic Desktop), 
            Usage (Mouse), 
            Collection (Application), 
                Usage (Pointer), 
                Collection (Physical), 
                    Report Count (3), 
                    Report Size (1), 
                    Usage Page (Buttons), 
                    Usage Minimum (1), 
                    Usage Maximum (3), 
                    Logical Minimum (0), 
                    Logical Maximum (1),  
                    Input (Data, Variable, Absolute), 
                    Report Count (1), 
                    Report Size (5), 
                    Input (Constant), 
                    Report Size (8), 
                    Report Count (2), 
                    Usage Page (Generic Desktop), 
                    Usage (X), 
                    Usage (Y), 
                    Logical Minimum (-127), 
                    Logical Maximum (127), 
                    Input (Data, Variable, Relative), 
                End Collection, 
            End Collection
            

(1)Input、Outpot和Feature项目
                    这3个项目用来定义报告(Report)中的数据字段
                    Input项目可以应用到任何控制、计数器读数或其他设备传给主机的信息。一个输入报告(Report)包含一个或多个Input项目,主机使用中断输入传输来请求输入报告(Report)。
                    Ouput项目用来定义主机传送给设备的信息。一个输出报告(Report)包含一个或多个Outpot项目。输出报告(Report)包含控制状态的数据。如果有中断输出管道,HID1.1兼容主机使用中断输出传输来传送输出报告(Report),否则使用Set_Report控制请求。
                    Feature项目应用到主机传送给设备的信息,或是主机从设备读取Feature项目。一个特征报告(Report)包含一个或多个Feature项目,Feature项目通常是包合影响设备与其组件整体行为的配置。特征报告(Report)通常是控制可以使用实际的控制面板调整的设置,例如主机可以使用虚拟控制面板来让用户选择控制特征。主机使用Set_Report与Get_Report请求来传送与接收特征报告(Report)。
                    在每一个Input、Output和Feature项目的前缀字之后是32位描述数据,目前最多定义了9个位,余的位则是保留。位0~8的定义中只有位7不能应用于Input项目,除此之外其他的位定义都适应于Input、Output和Feature项目。
                    
                    
                    
                    注:①:该位不能应用到数组。
                            ②:只应用于Output和Feature项目,对于Input项目该位保留。

(2)Collection和End Collection项目
                        所有的报表类型都可以使用Collection与End Collection项目来将相关的Main类型项目组成群组。这两个项目分别用于打开和关闭集合。所有在Collection与End Collection项目之间的Main类型项目都是Collection的一部分。
                        Collection有3种类型:ApplicationPhysicalLogical,其项目的数据项的值分别为1、0和2。厂商也可以自己定义Collection类型,数据项的值为80h~FFh保留给厂商定义。End Collection项目无数据项。
                        Application Collection包含有共同用途的项目或执行单一功能的项目。例如键盘的开机描述符将键盘的按键与LED指示灯数据集合成一个Application Collection。所有的报表必须在一个Application Collection内。
                        Physical Collection包含在一个单一几何点上的数据项目,可以将每个位置的数据集合成一个Physical Collection。在设备报告多个传感器的位置的时候,使用Physical Collection指明不同的数据来自不同的传感器。
                        Logical Collection形成一个数据结构,包含由Collection所连结的不同类型的项目。例如数据缓冲区的内容以及缓冲区内字节数目的计数。

(3)Usage Page和Usage项目
                        Usage page项目的数据部分为1~2个字节,目前的定义全部都是一个字节。Usage Page定义了常用的设备功能,关于Usage Page(以及其他项目)的具体定义内容,可以查阅HID Usage tables(http://www.usb.org/developers/hidpage/#Class_Definition),下表是来自HID Usage tables的Usage Page定义。
                        
                        

关于Usage Page的每一个有效定义项,都有一个相应的下一级定义,如Usage Page的数据项数值为1,则设备定义为Generic Desktop Controls,关于该类设备的具体功能可以在HID Usage Tables中查到具体的定义。下表是HID Usage Tables中对Generic Desktop Controls设备的功能定义。
                                                    
                        
                        

(4)Report ID项目
                        Report ID放在信息包中报表数据之前,设备可以支持多个相同类型的报表,每一个报表包含不同的数据与其特有的ID。
                        在报表描述符中,Report ID项目作用于其后续所有的项目,直到遇到下一个Report ID为止。如果报表描述符中没有Report ID项目,默认的ID值是0,描述符不能定义一个为0的Report ID,输入报表、输出报表与特征报表可以分享同一个Report ID。
                        在Set_Report和Get_Report请求传输中,主机在设置事务的wValue字段的低字节中指定一个Report ID。在中断传输中如果接口支持一个以上的Report ID,Report ID必须是传送报表中的第一个字节。如果接口只支持数值为0的默认Report ID,此Report ID不应该在中断传输中随着报表一起传送。

(5)Report Size和Report Count项目
                        Report Size项目指定Input、Output与Feature项目字段的大小,以位为单位。
                        Report Count项目指定Input、Output与Feature项目包含的字段数目。
                        例如两个8位的字段,Report Size等于8,而Report Count等于2。8个1位的字段,Report Size等于1,而Report Count等于8。
                        Input、Output与Feature项目报表可以有多个项目,每一个项目可以有自己的Report Size和Report Count项目。

(6)Logical Minimum和Logical Maximum项目
                        Logical Minimum与Logical Maximum项目定义报表的变量(Variable)或阵列(Array)数据的限制范围,此限制范围以逻辑单位来表示。例如设备报表的一个电流值读数是500mA,而一个单位是2mA,则Logical Maximum值等于250。
                        负数值以2的补码来表示。如果Logical Minimum与Logical Maximum都是正数,就不需要有正负号位。不管Logical Minimum与Logical Maximum是以有正负号或是无正负号的数值来表示,设备都可以正确地传输数据。数据的接收者必须知道数据是否可以是负值。

(7)Physical Minimum和Physical Maximum项目
                        Physical Minimum和Physical Maximum项目定义数值的限制范围,该限制范围使用Unit项目定义的单位来表示。上例中设备报表的一个电流值读数是500mA,单位是2mA,Logical Maximum值等于250,而Physical Maximum值是500。
                        Logical Minimum与Logical Maximum值说明了设备返回数值的边界,可以根据Physical Minimum和Physical Maximum值对数据进行偏移和比例变换。

(8)Usage、Usage Minimum和Usage Maximum项目
                        这3个项目输入Local类型项目。
                        Usage项目和Global类型的Usage Page项目协同描述项目或集合的功能。一个报表可以指定一个Usage给许多个控制,或是指定不同的Usage给每一个控制。如果一个报表项目之前有一个Usage,此Usage应用到该项目的所有控制。如果一个报表项目之前有一个以上的Usage,每一个Usage应用到一个控制,Usage与控制是按顺序结合的。

例如下面报表描述符的一个局部,报表含有2个输入字节,第一个字节的用法是x,第2个字节是y。
                        

如果一个报表项目之前有一个以上的Usage,而且控制的数目多于Usage的数目,每一个Usage与一个控制对应,最后一个Usage则应用到所有剩余的控制。例如在下面报表包含16个字节输入数据,第一个字节对应用法x,第2个字节对应用法y,剩余的14个字节对应厂商定义的用法。
                        

Usage Minimum和Usage Maximum可以指定一个Usage给多个控制或是数组项目。将从Usage Minimum到Usgae Maximun定义的用法顺序对应到多个控制中。例如在一个键盘描述符中定义的标准键盘的左、右修饰键的输入项目中,使用一个字节的8位分别输入键盘的左、右Ctrl键、Shift键、Alt键和GUI键,从HID Usage tables文档中的第10节可以查到关于键盘用法的定义,其中上述8个修饰键的用法定义值为224到231。以下是报表描述符的修饰键部分描述。
                        

时间: 2024-10-10 23:48:11

HID 报告描述符精细说明.的相关文章

转 关于USB HID报告描述符

原文地址 USB HID报告及报告描述符简介 在USB中,USBHOST是通过各种描述符来识别设备的,有设备描述符,配置描述符,接口描述符,端点描述符,字符串描述符,报告描述符等等.USB报 告描述符(ReportDescriptor)是HID设备中的一个描述符,它是比较复杂的一个描述符.USBHID设备是通过报告来给传送数据的,报告 有输入报告和输出报告.输入报告是USB设备发送给主机的,例如USB鼠标将鼠标移动和鼠标点击等信息返回给电脑,键盘将按键数据数据返回给电脑等:输出 报告是主机发送在

浅析USB HID ReportDesc (HID报告描述符)

在USB中,USB Host是通过各种描述符来识别识别设备的,一般在设备枚举的过程将会获取有设备描述符/配置描述符/接口描述符/端点描述符/字符串描述符等 现在我们来介绍一下HID ReportDesc. 我们看一下在其内容为 我们先来使用HID Descriptor Tool来生成上面的数据 参考资料 1.Device Class Definition for Human Interface Devices (HID) Version 1.11 .PDF 2.HID Usage Tables

USB HID报告及报告描述符简介

在USB中,USB HOST是通过各种描述符来识别设备的,有设备描述符,配置描述符,接口描述符,端点描述符,字符串描述符,报告描述符等等.USB报告描述符(Report Descriptor)是HID设备中的一个描述符,它是比较复杂的一个描述符.        USB HID设备是通过报告来给传送数据的,报告有输入报告和输出报告.输入报告是USB设备发送给主机的,例如USB鼠标将鼠标移动和鼠标点击等信息返回给电脑,键盘将按键数据数据返回给电脑等:输出报告是主机发送给USB设备的,例如键盘上的数字

USB HID Report Descriptor 报告描述符详解

Report descriptors are composed of pieces of information. Each piece of information is called an Item.报告描述符由一些数据片组成.这些数据片被叫做Item.All items have a one-byte prefix that contains the item tag, item type, and item size. 每一个Item都包含一个字节的前缀,这个前缀中包含了三个信息--it

USB报告描述符的理解

报告描述符是用来描述一个报告的结构以及该报告里面的数据是用来干什么的 通过控制端点0来返回 bSize用来表示后面跟的数据的字节数 bType 用来表示条目的类型 0为主条目 1为全局条目 2为局部条目 bTag用来表示该条目的功能 主条目共有五个  输入input 输出output 特性feature 集合collection 关集合 end collection 全局条目 Usage page 用途页 Logical minimum 逻辑最小值 logical maximum逻辑最大值 ph

圈圈.报告描述符__ZC记录

1.ZC:到目前(20181126)为止,对 报告描述符的整体理解还是 有些困难,不能准确的说出(指明)其中的细节.还需要一边看报告描述符 一边对照资料查阅理解含义. ZC:现在,只理解了 一个大框架,和 其中的一部分细节(数据传输 在Collection中的 格式) ZC:下面我把 至今为止,对于 报告描述符的理解 都记录下来,方便以后查阅(隔得时间一长,我就会忘,又要重新翻资料 重新理解 甚是痛苦...) 2. 每行开始的第一字节为该条目的前缀,前缀的格式为: D7~D4:bTag(4位):

lpc1768usb端点响应以及描述符定义

#ifndef __USBEP1_H_ #define __USBEP1_H_ #include "usb.h" #include "usbhw.h" extern s8 sendBuffer[4];    //鼠标数据发送缓冲区 extern u8 mouse_connect;    //鼠标连接标志 void usb_ep1_in_process(void); void usb_ep1_out_process(void); #endif #include &qu

USB HID描述符【转】

本文转载自: USB是个通用的总线,端口都是统一的.但是USB设备却各种各样,例如USB鼠标,USB键盘,U盘等等,那么USB主机是如何识别出不同的设备的呢?这就要依赖于描述符了.USB的描述符主要有设备描述符,配置描述符,接口描述符,端点描述符,字符串描述符,HID描述符,报告描述符等等.关于报告描述符,请看我以前写的:<USB HID报告及报告描述符简介 > http://group.ednchina.com/93/198.aspx.一个USB设备有一个设备描述符,设备描述符里面决定了该设

USB描述符【转载】

USB描述符 USB描述符信息存储在USB设备中,在枚举过程中,USB主机会向USB设备发送GetDescriptor请求,USB设备在收到这个请求之后,会将USB描述符信息返回给USB主机,USB主机分析返回来的数据,判断出该设备是哪一种USB设备,建立相应的数据链接通道.那么USB描述符信息到底是一个什么样的数据呢,USB协议中有详细描述. 通用的USB描述符信息包括设备描述符.配置描述符.接口描述符和端点描述符,具体不同的USB设备还包括其它类型的描述符,例如,USB鼠标.键盘还包括HID