(USB HID) Configuration Descriptor

最近完成了HID的基本收發，使用的配置用了2個Endpoint，把一些特別重要要的地方紀錄下來

整個Configuration 分成4大部分 :

1. Configuration

2. Interface

3. HID descriptor

4. Endpoint

以下分散開來記錄，首先紀錄Configurations

 1 #define USB_CONFIGURATION_DESCRIPTOR_TYPE       0x02
 2 #define USB_HID_CONFIG_DESC_SIZ       41
 3 
 4   0x09, /* bLength: Configuration Descriptor size */
 5   USB_CONFIGURATION_DESCRIPTOR_TYPE, /* bDescriptorType: Configuration */
 6   USB_HID_CONFIG_DESC_SIZ, /* wTotalLength: Bytes returned */
 7   0x00,
 8   0x01,         /*bNumInterfaces: 1 interface*/
 9   0x01,         /*bConfigurationValue: Configuration value*/
10   0x00,         /*iConfiguration: Index of string descriptor describing the configuration*/
11   0x80,         /*bmAttributes: bus powered and Support Remote Wake-up */
12   0xFA,         /*MaxPower 100 mA: this current is used for detecting Vbus*/

Interface Descriptor，這邊interface class要配成 HID, 而且protocol不能配成keyboard & mouse會影響收發

1   0x09,         /*bLength: Interface Descriptor size*/
2   USB_INTERFACE_DESCRIPTOR_TYPE,/*bDescriptorType: Interface descriptor type*/
3   0x00,         /*bInterfaceNumber: Number of Interface*/
4   0x00,         /*bAlternateSetting: Alternate setting*/
5   0x02,         /*bNumEndpoints*/
6   0x03,         /*bInterfaceClass: HID*/
7   0x00,         /*bInterfaceSubClass : 1=BOOT, 0=no boot*/
8   0x00,         /*nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse*/
9   0x04,         /*iInterface: Index of string descriptor || origianl = 0x04*/ 

在來是HID descriptor

1   0x09,         /*bLength: HID Descriptor size*/
2   HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
3   0x00,         /*bcdHID: HID Class Spec release number*/
4   0x02,
5   0x00,         /*bCountryCode: Hardware target country*/
6   0x01,         /*bNumDescriptors: Number of HID class descriptors to follow*/
7   0x22,         /*bDescriptorType*/
8   CUSTOMHID_SIZ_REPORT_DESC,/*wItemLength: Total length of Report descriptor*/
9   0x00,

 最後就是Endpoint Descriptor，這部分重複性也非常高，但是也是收發的關鍵。

 1   0x07,          /*bLength: Endpoint Descriptor size*/
 2   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
 3   HID_IN_EP,     /*bEndpointAddress: Endpoint Address (IN)*/
 4   0x03,          /*bmAttributes: Interrupt endpoint*/
 5   HID_IN_PACKET, /*wMaxPacketSize: 4 Byte max */
 6   0x00,
 7   0x0a,          /*bInterval: Polling Interval (10 ms)*/
 8   /* 34 */
 9   0x07,          /*bLength: Endpoint Descriptor size*/
10   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
11   HID_OUT_EP,     /*bEndpointAddress: Endpoint Address (OUT)*/
12   0x03,          /*bmAttributes: Interrupt endpoint*/
13   HID_OUT_PACKET, /*wMaxPacketSize: 4 Byte max */
14   0x00,
15   0x0a,          /*bInterval: Polling Interval (10 ms)*/

整段Configuration Descriptor

 1 __ALIGN_BEGIN static uint8_t USBD_HID_CfgDesc[USB_HID_CONFIG_DESC_SIZ] __ALIGN_END =
 2 {
 3   0x09, /* bLength: Configuration Descriptor size */
 4   USB_CONFIGURATION_DESCRIPTOR_TYPE, /* bDescriptorType: Configuration */
 5   USB_HID_CONFIG_DESC_SIZ, /* wTotalLength: Bytes returned */
 6   0x00,
 7   0x01,         /*bNumInterfaces: 1 interface*/
 8   0x01,         /*bConfigurationValue: Configuration value*/
 9   0x00,         /*iConfiguration: Index of string descriptor describing the configuration*/
10   0x80,         /*bmAttributes: bus powered and Support Remote Wake-up */
11   0xFA,         /*MaxPower 100 mA: this current is used for detecting Vbus*/
12   
13   /************** Descriptor of Joystick Mouse interface ****************/
14   /* 09 */
15   0x09,         /*bLength: Interface Descriptor size*/
16   USB_INTERFACE_DESCRIPTOR_TYPE,/*bDescriptorType: Interface descriptor type*/
17   0x00,         /*bInterfaceNumber: Number of Interface*/
18   0x00,         /*bAlternateSetting: Alternate setting*/
19   0x02,         /*bNumEndpoints*/
20   0x03,         /*bInterfaceClass: HID*/
21   0x00,         /*bInterfaceSubClass : 1=BOOT, 0=no boot*/
22   0x00,         /*nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse*/
23   0x04,         /*iInterface: Index of string descriptor || origianl = 0x04*/ 
24   /******************** Descriptor of Joystick Mouse HID ********************/
25   /* 18 */
26   0x09,         /*bLength: HID Descriptor size*/
27   HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
28   0x00,         /*bcdHID: HID Class Spec release number*/
29   0x02,
30   0x00,         /*bCountryCode: Hardware target country*/
31   0x01,         /*bNumDescriptors: Number of HID class descriptors to follow*/
32   0x22,         /*bDescriptorType*/
33   CUSTOMHID_SIZ_REPORT_DESC,/*wItemLength: Total length of Report descriptor*/
34   0x00,
35   /******************** Descriptor of Mouse endpoint ********************/
36   /* 27 */
37   0x07,          /*bLength: Endpoint Descriptor size*/
38   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
39   HID_IN_EP,     /*bEndpointAddress: Endpoint Address (IN)*/
40   0x03,          /*bmAttributes: Interrupt endpoint*/
41   HID_IN_PACKET, /*wMaxPacketSize: 4 Byte max */
42   0x00,
43   0x0a,          /*bInterval: Polling Interval (10 ms)*/
44   /* 34 */
45   0x07,          /*bLength: Endpoint Descriptor size*/
46   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
47   HID_OUT_EP,     /*bEndpointAddress: Endpoint Address (OUT)*/
48   0x03,          /*bmAttributes: Interrupt endpoint*/
49   HID_OUT_PACKET, /*wMaxPacketSize: 4 Byte max */
50   0x00,
51   0x0a,          /*bInterval: Polling Interval (10 ms)*/
52 };