USB协议详解第4讲（USB描述符-标准配置描述符）

1.USB描述符

USB描述符有设备描述符、标准配置描述符、接口描述符、端点描述符、字符串描述符，HID设备有HID描述符、报告描述符和物理描述符。今天主要是学习USB标准配置描述符的组成。

2.标准配置描述符组成

一个USB设备至少有一个或者多个配置，这一点可以从设备描述符的最后一项bNumConfigurations得到，但是当前只能选择其中一种配置，每一种配置都对应一个配置描述符集合，为什么说是一个集合呢，因为这个配置包括标准配置描述符、接口描述符、端点描述符，如果是HID设备还会包括HID描述符，我们今天讲的是标准配置描述符，后期会讲解其他的描述符。标准配置描述符只有9个字节，组成如下：

**3.STM32配置描述符集合代码（必须按照顺序）**

/* USB Configuration Descriptor */

const uint8_t CustomHID_ConfigDescriptor[CUSTOMHID_SIZ_CONFIG_DESC] =

{

//

// 标准配置描述符

//

    0x09, /* bLength: Configuation Descriptor size */

    USB_CONFIGURATION_DESCRIPTOR_TYPE, 	/* bDescriptorType: Configuration */

    CUSTOMHID_SIZ_CONFIG_DESC,			/* wTotalLength low : Bytes returned */

    0x00,								/* wTotalLength high: Bytes returned */

    0x01,         /* bNumInterfaces: 1 interface */

    0x01,         /* bConfigurationValue: Configuration value */

    0x00,         /* iConfiguration: Index of string descriptor describing the configuration*/

    0xC0,         /* bmAttributes: Bus powered */

                  /*Bus powered: 7th bit, Self Powered: 6th bit, Remote wakeup: 5th bit, reserved: 4..0 bits */

    0x96,         /* MaxPower 300 mA: this current is used for detecting Vbus */

//

// 接口描述符

//

	/************** Descriptor of Custom HID interface ****************/

    /* 09 */

    0x09,         						/* bLength: Interface Descriptor size */

    USB_INTERFACE_DESCRIPTOR_TYPE,		/* bDescriptorType: Interface descriptor type */

    0x00,         /* bInterfaceNumber: Number of Interface */

    0x00,         /* bAlternateSetting: Alternate setting */

    0x02,         /* bNumEndpoints 此接口有两个端点 */

    0x03,         /* bInterfaceClass: HID */

    0x00,         /* bInterfaceSubClass : 1=BOOT, 0=no boot */

    0x00,         /* nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse */

    0,            /* iInterface: Index of string descriptor */

//

// HID描述符（后续讲解）

//

	/******************** Descriptor of Custom HID HID ********************/

    /* 18 */

    0x09,         /* bLength: HID Descriptor size */

    HID_DESCRIPTOR_TYPE, /* bDescriptorType: HID */

    0x10,         /* bcdHID: HID Class Spec release number */

    0x01,

    0x00,         /* bCountryCode: Hardware target country 国家代码 */

	0x01,         /* bNumDescriptors: Number of HID class descriptors to follow

					 类别描述符数目（至少有一个报表描述符）*/

    0x22,         /* bDescriptorType 报告描述符 */

    CUSTOMHID_SIZ_REPORT_DESC,	/* wItemLength: Total length of Report descriptor 报告描述符大小 */

    0x00,						/* 标志类别描述符说明结束 */ 

//

// 端点1描述符

//

	/******************** Descriptor of Custom HID endpoints ******************/

    /* 27 */

    0x07,          /* bLength: Endpoint Descriptor size */

    USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: */

    0x82,          /* bEndpointAddress: Endpoint Address (IN) */

                   // bit 3...0 : the endpoint number

                   // bit 6...4 : reserved

                    // bit 7     : 0(OUT), 1(IN)

    0x03,          /* bmAttributes: Interrupt endpoint */

    0x40,          /* wMaxPacketSize: 64 Bytes max */

    0x00,

    0x02,          /* bInterval: Polling Interval (2 ms) */

    /* 34 */

//

// 端点2描述符

//

    0x07,	/* bLength: Endpoint Descriptor size */

    USB_ENDPOINT_DESCRIPTOR_TYPE,	/* bDescriptorType: */

			/*	Endpoint descriptor type */

    0x01,	/* bEndpointAddress: */

			/*	Endpoint Address (OUT) */

    0x03,	/* bmAttributes: Interrupt endpoint */

    0x40,	/* wMaxPacketSize: 64 Bytes max  */

    0x00,

    0x02,	/* bInterval: Polling Interval (2 ms) */

    /* 41 */

}; /* CustomHID_ConfigDescriptor */

4.标准配置描述符组成详解

1.bLength

配置描述符的长度。

2.bDescriptorType

描述符类型，配置描述符为0x02。描述符的结构开头是一样的，都是先说描述符长度，然后说类型，每种描述符的类型是不一样的，如下表格，可速查。

3.wTotalLength

配置描述符集合总长度，也就是说总共有多少个字节。第二节讲了，配置描述符是以集合的形式，集合里包含了标准配置描述符，接口描述符，端点描述符，HID描述符，wTotalLength就是配置描述符集合的长度。

3.wTotalLength

4.bNumInterfaces，

当前配置下面有多少个接口，单一功能设备只有一个接口，如鼠标或者键盘,如果是复合设备，如果是鼠键一体的设备，那么它可能有两个接口，其实一个接口对应于一种功能，如果我们在软件实现的时候，把鼠标键盘当做一个功能实现的时候，那就是一个接口的设备（也就是单功能设备）。

5.bConfigurationValue，

前面说了，一个USB设备可能有多个配置，但是当前只能选择一种配置。bConfigurationValue就是当前配置的标识，如果主机想选择哪种配置，是通过标识去选择的，后面枚举的时候会详细讲解。

6.iConfiguration

描述该配置的字符串的索引值，如果没有字符串，那这个值就是0。

7.bmAttributes

在这个配置下，设备的一些特性。D7是保留位，默认为1；D6表示供电方式，0是自供电，1是总线供电；D5表示是否支持远程唤醒，为1表示设备支持远程唤醒；D4~D0保留，默认为0。大家可能会问为什么不把这些特性放在设备描述符里面，这些可都是设备的属性啊，在这里要告诉大家，USB设备会有多种配置，每种配置下的设备属性是不一样的，主机可以灵活的选择使用那种配置，从而实现对应配置上的功能，这样增加了总线设计的灵活性和可配置性，从而达到通用性。

8.bMaxPower

在这个配置下，设备需要的电流，单位是2ma。如果一个设备耗电量100ma，那么本字节设置为0x32即可。