USB描述符解析

https://blog.csdn.net/leumber/article/details/72765902

USB描述符信息会被存储在USB设备中，在设备枚举过程中，USB主机会向USB设备发送GetDescriptor请求，USB设备在收到这个请求之后，会将USB描述符信息返回给USB主机，USB主机分析返回来的数据，判断出该设备是哪一种USB设备，按照描述符中的一些配置信息与设备建立相应的数据通道。USB描述符信息在USB协议中有详细描述。

标准的USB设备有5种USB描述符：设备描述符，配置描述符，字符串描述符，接口描述符，端点描述符。下面详解：

1.设备描述符 一个设备只有一个设备描述符，列出这个设备的配置参数

typedef struct _USB_DEVICE_DESCRIPTOR_
{
BYTE bLength,
BYTE bDescriptorType,
WORD bcdUSB,
BYTE bDeviceClass,
BTYE bDeviceSubClass,
BYTE bDeviceProtol,
BYTE bMaxPacketSize0,
WORD idVenderI,
WORD idProduct,
WORD bcdDevice,
BYTE iManufacturer,
BYTE iProduct,
BYTE iSerialNumber,
BYTE iNumConfiguations
}USB_DEVICE_DESCRIPTOR;

bLength : 描述符大小．固定为0x12．
bDescriptorType : 设备描述符类型．固定为0x01．
bcdUSB : USB 规范发布号．表示了本设备能适用于那种协议，如2.0=0200，1.1=0110等．
bDeviceClass :类型代码（由USB指定）当它的值是0时，表示所有接口在配置描述符里，并且所有接口是独立的。当它的值是1到FEH时，表示不同的接口关联的。当它的值是FFH时，它是厂商自己定义的．
bDeviceSubClass : 子类型代码（由USB分配）．如果bDeviceClass值是0，一定要设置为0．其它情况就跟据USB-IF组织定义的编码．
bDeviceProtocol : 协议代码（由USB分配）．如果使用USB-IF组织定义的协议，就需要设置这里的值，否则直接设置为0。如果厂商自己定义的可以设置为FFH．
bMaxPacketSize0 : 端点0最大分组大小（只有8,16,32,64有效）．
idVendor : 供应商ID（由USB分配）．
idProduct : 产品ID（由厂商分配）．由供应商ID和产品ID，就可以让操作系统加载不同的驱动程序．
bcdDevice : 设备出产编码．由厂家自行设置．
iManufacturer : 厂商描述符字符串索引．索引到对应的字符串描述符.为０则表示没有.
iProduct : :产品描述符字符串索引．同上．
iSerialNumber : 设备序列号字符串索引．同上．
bNumConfigurations : 可能的配置数．指配置字符串的个数

2.配置描述符 一个设备中可以有多个配置描述符，每套配置描述符含有接口描述符，端点描述符

typedef struct _USB_CONFIGURATION_DESCRIPTOR_
{
    BYTE bLength,
    BYTE bDescriptorType,
    WORD wTotalLength,
    BYTE bNumInterfaces,
    BYTE bConfigurationValue,
    BYTE iConfiguration,
    BYTE bmAttributes,
    BYTE MaxPower
}USB_CONFIGURATION_DESCRIPTOR;

bLength: 描述符大小．固定为0x09．
bDescriptorType: 配置描述符类型．固定为0x02．
wTotalLength: 整个数据的长度．指此配置返回的配置描述符，接口描述符以及端点描述符的全部大小．
bNumInterfaces: 配置所支持的接口数．指该配置配备的接口数量，也表示该配置下接口描述符数量．
bConfigurationValue:当使用SetConfiguration和GetConfiguration请求时所指定的配置索引值
iConfiguration: 用于描述该配置字符串描述符的索引．
bmAttributes: 供电模式选择．D7:总线供电，D6:自供电，D5:远程唤醒，D4～D0:保留
MaxPower: 总线供电的USB设备的最大消耗电流．以2mA为单位．例如0x32为50*2=100mA

3.接口描述符 一个配置描述符内可以含有多个接口，数量由配置描述符决定

typedef struct _USB_INTERFACE_DESCRIPTOR_
{
    BYTE bLength,
    BYTE bDescriptorType,
    BYTE bInterfaceNumber,
    BYTE bAlternateSetting,
    BYTE bNumEndpoint,
    BYTE bInterfaceClass,
    BYTE bInterfaceSubClass,
    BYTE bInterfaceProtocol,
    BYTE iInterface
}USB_INTERFACE_DESCRIPTOR;

bLength:描述符大小．固定为0x09
bDescriptorType:接口描述符类型．固定为0x04
bInterfaceNumber:该接口的编号
bAlternateSetting:用于为上一个字段选择可供替换的位置．即备用的接口描述符标号
bNumEndpoint:使用的端点数目．端点0除外
bInterfaceClass:类型代码（由USB分配）
bInterfaceSubClass:子类型代码（由USB分配）
bInterfaceProtocol:协议代码（由USB分配）
iInterface:字符串描述符的索引

4.端点描述符 每个接口所需要的端点及其设置，数量由配置描述符决定

typedef struct _USB_ENDPOINT_DESCRIPTOR_
{
    BYTE bLength,
    BYTE bDescriptorType,
    BYTE bEndpointAddress,
    BYTE bmAttributes,
    WORD wMaxPacketSize,
    BYTE bInterval
}USB_ENDPOINT_DESCRIPTOR;

bLength : 描述符大小．固定为0x07．
bDescriptorType : 接口描述符类型．固定为0x05．
bEndpointType : USB设备的端点地址．D7端点方向，对于控制端点可以忽略，1/0:IN/OUT．D6-D4，保留．D3-D0：端点号．
bmAttributes : 端点属性．D7-D2，保留．D1-D0,传输类型：00控制，01同步，02批量，03中断．
wMaxPacketSize : 本端点接收或发送的最大信息包大小．
bInterval : 轮询数据传送端点的时间间隔．对于批量传送和控制传送的端点忽略．对于同步传送的端点，必须为1，对于中断传送的端点，范围为1-255．

5.字符串描述符 字符串描述符是可选的．如果不支持字符串描述符，其设备，配置，接口描述符内的所有字符串描述符索引都必须为0，每个字符串描述符都有一个索引，USB主机会在请求时按照顺序获取对应的字符串描述符，默认0位语言字符串描述符，后边都由每个描述符内容中指定，一般1为设备厂商字符串描述符，2为产品描述符，3为设备序列号字符串描述符，4为接口描述符

typedef struct _USB_STRING_DESCRIPTION_
{
    BYTE bLength,
    BYTE bDescriptionType,
    BYTE bString[];
}USB_STRING_DESCRIPTION;

bLength : 描述符大小．由整个字符串的长度加上bLength和bDescriptorType的长度决定．
bDescriptorType : 接口描述符类型．固定为0x03．
bString[] : Unicode编码字符串．

下边是一套USB_CCID的设备描述符、配置描述符、接口描述符、端点描述符和字符串描述符

CCID描述符配置

[cpp]  view plain  copy

1. /*------------Descriptor of USB Device---------------------------*/   
2. const UINT8 DeviceDescFS[18]=   
3. {       
4.     0x12,  //bLength          //设备描述符的字节数大小，为0x12  
5.     0x01,  //bDescriptorType  //设备描述符类型编号，为0x01  
6.     0x00,  //bcdUSB           //USB规范版本号（BCD码）  0x0110  
7.     0x02,    
8.     0x00,  //bDeviceClass     //USB分配的设备类代码，0x01~0xfe 为标准设备类，0xff 为厂商自定义类型 0x00 不是在设备描述符中定义的，如HID  
9.     0x00,  //bDeviceSubClass  //USB分配的设备子类代码，同上，值由USB 规定和分配的  
10.     0x00,  //bDeviceProtocl   //USB分配的设备协议代码，同上  
11.     CTRL_PACKET_LEN, //bMaxPacketSize0 //端点0控制传输所支持的最大数据包长度，单位字节  
12.     0x12,  //idVendor         //厂商编号VID=0x2012  
13.     0x20,  
14.     0x02,  //idProduct        //产品编号PID=0x1402  
15.     0x14,  
16.     0x01,  //bcdDevice        //设备出厂编号bcdDevice=0x0100  
17.     0x02,    
18.     0x04,  //iManufacturer    //描述厂商字符串的索引Index of Vendor  
19.     0x1C,  //iProduct         //描述产品字符串的索引Index of Producr  
20.     0x14,  //iSerialNumber    //描述设备序列号字符串的索引0x03;//Index of SN  
21.     0x01   //bNumConfiguration//可能的配置数量  
22. };   
23.   
24. /*------------Descriptor of USB Configuation---------------------------*/   
25. #define USB_SIZ_CONFIG_DESC     (93 + 77)  
26. UINT8 USBD_CCID_ConfigDescriptor[] =  
27. {  
28.     /*Configuation Descriptor*/  
29.     0x09,/* bLength: Configuation Descriptor size */  
30.     0x02,/* bDescriptorType: Configuration */  
31.     LOBYTE(USB_SIZ_CONFIG_DESC),/* wTotalLength:no of returned bytes low*/  
32.     HIBYTE(USB_SIZ_CONFIG_DESC),,/* wTotalLength:no of returned bytes higt*/  
33.     0x02,   /* bNumInterfaces: 2 interface */  
34.     0x01,   /* bConfigurationValue: Configuration value */  
35.     0x04,   /* iConfiguration: Index of string descriptor describing the configuration */  
36.     0x80,   /* bmAttributes:bus powered */      
37.     0x32,   /* MaxPower 200 mA */  
38.   
39.     /*Interface Descriptor*/  
40.     0x09,   /* bLength: Interface Descriptor size */  
41.     0x04,   /* bDescriptorType: Interface descriptor type*/  
42.     0x01,   /* bInterfaceNumber: Number of Interface */     //接口号  
43.     0x00,   /* bAlternateSetting: Alternate setting */  
44.     0x03,   /* bNumEndpoints*/                              //接口端点数量  
45.     0x0B,   /* bInterfaceClass: Smart Card */               //接口类型：0x0B智能卡类型  
46.     0x00,   /* bInterfaceSubClass : SCSI transparent*/  
47.     0x00,   /* nInterfaceProtocol */  
48.     0X05,   /* iInterface: */                               //接口字符串描述符的索引  
49.   
50.     //CCID class desc  
51.     0x36,                   //bLength                      //描述符长度， = 36H  
52.     0x21,                   //bDescriptorType              //描述符类型， = 21H  
53.     0x10,0x01,              //bcdCCID                      //CCID类规范版本号  = 1.1  
54.     0x00,                   //bMaxSlotIndex                //所支持的最大插槽数 1个     
55.     0x03,                   //bVoltageSupport  5.0V        //所支持卡的操作电压 01--5V; 02--3V; 04--1.8V 5V&3V  
56.     0x03,0x00,0x00,0x00,    //dwProtocols  T = 0           //所支持的卡通讯协议T=0&T=1  
57.     0xb8,0x0b,0x00,0x00,    //dwDefaultClock  3MHz         //默认卡操作时钟,以KHz为单位 3000KHz  
58.     0xb8,0x0b,0x00,0x00,    //dwMaximumClock  3MHz         //所支持的最小时钟 3000KHz  
59.     0x00,                   //bNumClockSupported  1        //所支持的时钟数 仅支持默认时钟  
60.     0x80,0x25,0x00,0x00,    //dwDataRate  9600bps          //默认IC卡通讯的位速率 9600  
61.     0x80,0x25,0x00,0x00,    //dwMaxDataRate  115200bps     //所支持的与IC卡通讯的最大位速率 9600  
62.     0x00,                   //bNumDataRatesSupported  1    //所支持的位速率数 仅支持默认速率  
63.     0xFE,0x00,0x00,0x00,    //dwMaxIFSD                    //T=1协议下的最大FSD 254  
64.     0x00,0x00,0x00,0x00,    //dwSynchProtocols             //所支持的同步协议 当前版本为0x00000000  
65.     0x00,0x00,0x00,0x00,    //dwMechanical                 //所支持的机械特性,00-无任何特性  
66.     0xBA,0x00,0x02,0x00,    //dwFeatures                   //卡片特性 0x0002008A/0x0004023A  
67.     0x80,0x01,0x00,0x00,    //dwMaxCCIDMessageLength       //最大CCID信息长度 短格式下为261+10,此处设为384  
68.     0x00,                   //bClassGetResponse            //GetReponse指令获取数据的缺省值 00  
69.     0x00,                   //bClassEnvelope               //Envelope指令缺省值 00  
70.     0x00,0x00,              //wLcdLayout                   //液晶尺寸0x0000 没有液晶  
71.     0x00,                   //bPINSupport                  //密码支持 不支持PIN  
72.     0x01,                   //bMaxCCIDBusySlots            //所支持的可同时操作的插槽数 1个  
73.   
74.     /*Endpoint 1 Descriptor*/  
75.     0x07, //bLength                         //端点描述符的字节数大小  
76.     0x05, //bDescriptorType                 //端点描述符类型编号   
77.     EP1IN_NUMBER, //bEndpointAddress        //端点地址及输入输出属性   
78.     0x02, //bmAttributes                    //端点的传输类型属性  
79.     0x40, //wMaxPacketSize                  //端点收、发的最大包的大小  
80.     0x00,   
81.     0x01, //bInterval                      //主机查询端点的时间间隔      
82.     /*Endpoint 1 Descriptor*/  
83.     0x07, //bLength                        //端点描述符的字节数大小  
84.     0x05, //bDescriptorType                //端点描述符类型编号    
85.     EP1OUT_NUMBER, //bEndpointAddress      //端点地址及输入输出属性    
86.     0x02, //bmAttributes                   //端点的传输类型属性  
87.     0x40, //wMaxPacketSize                  //端点收、发的最大包的大小  
88.     0x00,   
89.     0x01,  //bInterval                     //主机查询端点的时间间隔   
90.     /*Endpoint 2 Descriptor*/  
91.     0x07, //bLength                        //端点描述符的字节数大小  
92.     0x05, //bDescriptorType                //端点描述符类型编号    
93.     EP2IN_NUMBER, //bEndpointAddress       //端点地址及输入输出属性    
94.     0x03, //bmAttributes                   //端点的传输类型属性  
95.     0x08, //wMaxPacketSize                 //端点收、发的最大包的大小//产生 xact error  
96.     0x00,   
97.     0x0a, //bInterval                      //主机查询端点的时间间隔  
98.   
99.     /*Interface Descriptor*/  
100.     0x09,   /* bLength: Interface Descriptor size */  
101.     0x04,   /* bDescriptorType: Interface */     
102.     0x00,   /* bInterfaceNumber: Number of Interface */  
103.     0x00,   /* bAlternateSetting: Alternate setting */  
104.     0x02,   /* bNumEndpoints*/  
105.     0x0B,   /* bInterfaceClass: Smart Card */  
106.     0x00,   /* bInterfaceSubClass : SCSI transparent*/  
107.     0x00,   /* nInterfaceProtocol */  
108.     0X06,   /* iInterface: */  
109.   
110.     0x36,  
111.     0x21,  
112.     0x10,0x01,  
113.     0x00,  
114.     0x03,  
115.     0x03,0x00,0x00,0x00,  
116.     0xb8,0x0b,0x00,0x00,  
117.     0xb8,0x0b,0x00,0x00,  
118.     0x00,  
119.     0x80,0x25,0x00,0x00,  
120.     0x80,0x25,0x00,0x00,  
121.     0x00,  
122.     0xfe,0x00,0x00,0x00,  
123.     0x00,0x00,0x00,0x00,  
124.     0x00,0x00,0x00,0x00,  
125.     0xba,0x00,0x02,0x00,  
126.     0x80,0x01,0x00,0x00,  
127.     0x00,  
128.     0x00,  
129.     0x00,0x00,  
130.     0x00,  
131.     0x01,  
132.   
133.     /*Endpoint 3 Descriptor*/  
134.     0x07,           /* bLength: Endpoint Descriptor size */  
135.     0x05,           /* bDescriptorType: Endpoint */  
136.     EP3OUT_NUMBER,  /* bEndpointAddress: (OUT3) */  
137.     0x02,           /* bmAttributes: Bulk */  
138.     0x40,           /* wMaxPacketSize: */  
139.     0x00,  
140.     0x0A,           /* bInterval: ignore for Bulk transfer */  
141.   
142.     /*Endpoint 3 Descriptor*/  
143.     0x07,           /* bLength: Endpoint Descriptor size */  
144.     0x05,           /* bDescriptorType: Endpoint */  
145.     EP3IN_NUMBER,   /* bEndpointAddress: (IN3) */  
146.     0x02,           /* bmAttributes: Bulk */  
147.     0x40,           /* wMaxPacketSize: */  
148.     0x00,  
149.     0x0A,           /* bInterval: ignore for Bulk transfer */  
150.       
151. };  
152. /*------------Descriptor of Device String---------------------------*/   
153.   
154. uint8_t USBD_LangIDDesc[0x04] =  
155. {  
156.     0x04,   /* bLength */        
157.     0x03,   /* bDescriptorType */  
158.     0x09,   /*English(US)*/  
159.     0x04,   
160. };  
161.   
162. #define USB_SIZ_STRING_SERIAL       (10)  
163. uint8_t USBD_StringSerial[USB_SIZ_STRING_SERIAL] =  
164. {  
165.     USB_SIZ_STRING_SERIAL,  /* bLength */  
166.     0x03,  /* bDescriptorType */  
167.     '8', 0, '0', 0, '0', 0, '0', 0  
168. };  
169. uint8_t USBD_Interface1Strings[USB_DESCRIPTOR_LENGTH_STRING3] = {  
170.     sizeof(USBD_Interface1Strings),  
171.     0x03,                                                               
172.     'S',0,'M',0,'A',0,'R',0,'T',0,' ',0,'C',0,'A',0,'R',0,'D',0,   
173. };