USB设备驱动6:usb HID 报告描述符

在网上看了许多前辈的文章,就是无法理解报告描述符中的那些数字字符所表达的含义,几经周折,总算大致了解了。

code char MouseReportDescriptor[63] = {    
    0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)    
    0x09, 0x06,                  // USAGE (Keyboard)    
    0xa1, 0x01,                    // COLLECTION (Application)   

    0x05, 0x07,                    //   USAGE_PAGE (Keyboard)    
    0x19, 0xe0,                    //   USAGE_MINIMUM (Keyboard LeftControl)    
    0x29, 0xe7,                    //   USAGE_MAXIMUM (Keyboard Right GUI)    
    0x15, 0x00,                    //   LOGICAL_MINIMUM (0)    
    0x25, 0x01,                    //   LOGICAL_MAXIMUM (1)    
    0x75, 0x01,                    //   REPORT_SIZE (1)    
    0x95, 0x08,                    //   REPORT_COUNT (8)    
    0x81, 0x02,                    //   INPUT (Data,Var,Abs)  
    0x95, 0x01,                    //   REPORT_COUNT (1)    
    0x75, 0x08,                    //   REPORT_SIZE (8)    
    0x81, 0x03,                    //   INPUT (Cnst,Var,Abs) 

    0x95, 0x05,                    //   REPORT_COUNT (5)    
    0x75, 0x01,                    //   REPORT_SIZE (1)    
    0x05, 0x08,                    //   USAGE_PAGE (LEDs)    
    0x19, 0x01,                    //   USAGE_MINIMUM (Num Lock)    
    0x29, 0x05,                    //   USAGE_MAXIMUM (Kana)    
    0x91, 0x02,                    //   OUTPUT (Data,Var,Abs)   

    0x95, 0x01,                    //   REPORT_COUNT (1)    
    0x75, 0x03,                    //   REPORT_SIZE (3)    
    0x91, 0x03,                    //   OUTPUT (Cnst,Var,Abs) 

    0x95, 0x06,                    //   REPORT_COUNT (6)    
    0x75, 0x08,                    //   REPORT_SIZE (8)    
    0x15, 0x00,                    //   LOGICAL_MINIMUM (0)    
    0x25, 0xFF,                    //   LOGICAL_MAXIMUM (255)    
    0x05, 0x07,                    //   USAGE_PAGE (Keyboard)    
    0x19, 0x00,                    //   USAGE_MINIMUM (Reserved (no event indicated))    
    0x29, 0x65,                    //   USAGE_MAXIMUM (Keyboard Application)    
    0x81, 0x00,                    //   INPUT (Data,Ary,Abs)  

    0xc0                           // END_COLLECTION   

}; 

一般的,网文多是如上的报告描述符,据说是用一个工具产生的,有一些还配上了中文的说明,但也多是描述性的,而不是拆分解释这些字符所代表的含义,比如,数组第一行的 0x05, 0x01,                    // USAGE_PAGE (Generic Desktop) 

我们一眼就能看出双斜线后面的文字,是对前面数字的说明,即0x05,0x01所表达的是USAGE_PAGE (Generic Desktop) 的含义,但是,为何如此表达,则描述的不太清楚,对于熟悉的人而言,这自然不是问题,但对于新手,可就要费点功夫了。

 

0x05, 0x01,代表USAGE_PAGE (Generic Desktop) 的功能,是由《device class definition for human interface device (HID)》第24页的Report Descriptors 规定的。

分两部分,0x05为一部分,表示前缀,0x01为数据部分。

0x05转换成二进制,就是0000  01001,按照HID类协议5.3 generic item format的定义,这个字节被分成3个部分,bit0~bit1代表的是这个前缀后面跟的数据长度,两位可以表示最大4字节的数据,即bsize;bit2~bit3代表的是这个前缀的类型,总共可以有三种类型:0=main,1=global,2=local,3=reserved;bit4~bit7代表前缀的tag,一般分为input(二进制的1000 00 nn,即bit4~bit7=1000,代表一个tag,bit2~bit3=00,代表main,bit0~bit1=nn,代表这个前缀后面还有nn所代表的数据),output(二进制的 1001 00 nn),feature(1011 00 nn),collection(1010 00 nn),end collection(1100 00 nn),遵照这个原则,我们就可以解析0x05所表达的含义。

 

0x05转换为二进制就是0000 0101,其高4位全为0,表示的tag为usage page  tag(协议45页),bit2~bit3=01,表示的是类型,从协议中可以知道,这是一个全局类型的item(协议36页),bit0~bit1=01,表示的是这个前缀后面跟着的数据长度为1字节,即0x05后面,有0x01作为这个前缀的数据部分,而0x01表示的是general desktop page(《universal serial bus HID usage table》第五页,目录),因此,这两个数字合起来就是USAGE_PAGE (Generic Desktop)的含义。

 

总之,要了解报告描述符,需要两份资料:《device class definition for human interface device (HID)》, 《Universal Serial Bus HID Usage Tables》

posted on 2012-02-28 20:25  image eye  阅读(3731)  评论(2编辑  收藏  举报