(USB HID) Configuration Descriptor

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

整個Configuration 分成4大部分 :

1. Configuration

2. Interface

3. HID descriptor

4. Endpoint

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

 #define USB_CONFIGURATION_DESCRIPTOR_TYPE       0x02
 #define USB_HID_CONFIG_DESC_SIZ       41

   0x09, /* bLength: Configuration Descriptor size */
   USB_CONFIGURATION_DESCRIPTOR_TYPE, /* bDescriptorType: Configuration */
   USB_HID_CONFIG_DESC_SIZ, /* wTotalLength: Bytes returned */
   0x00,
   0x01,         /*bNumInterfaces: 1 interface*/
   0x01,         /*bConfigurationValue: Configuration value*/
   0x00,         /*iConfiguration: Index of string descriptor describing the configuration*/
   0x80,         /*bmAttributes: bus powered and Support Remote Wake-up */
   0xFA,         /*MaxPower 100 mA: this current is used for detecting Vbus*/

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

   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*/
   0x04,         /*iInterface: Index of string descriptor || origianl = 0x04*/ 

在來是HID descriptor

   0x09,         /*bLength: HID Descriptor size*/
   HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
   0x00,         /*bcdHID: HID Class Spec release number*/
   0x02,
   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,

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

   0x07,          /*bLength: Endpoint Descriptor size*/
   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
   HID_IN_EP,     /*bEndpointAddress: Endpoint Address (IN)*/
   0x03,          /*bmAttributes: Interrupt endpoint*/
   HID_IN_PACKET, /*wMaxPacketSize: 4 Byte max */
   0x00,
   0x0a,          /*bInterval: Polling Interval (10 ms)*/
   /* 34 */
   0x07,          /*bLength: Endpoint Descriptor size*/
   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
   HID_OUT_EP,     /*bEndpointAddress: Endpoint Address (OUT)*/
   0x03,          /*bmAttributes: Interrupt endpoint*/
   HID_OUT_PACKET, /*wMaxPacketSize: 4 Byte max */
   0x00,
   0x0a,          /*bInterval: Polling Interval (10 ms)*/

整段Configuration Descriptor

 __ALIGN_BEGIN static uint8_t USBD_HID_CfgDesc[USB_HID_CONFIG_DESC_SIZ] __ALIGN_END =
 {
   0x09, /* bLength: Configuration Descriptor size */
   USB_CONFIGURATION_DESCRIPTOR_TYPE, /* bDescriptorType: Configuration */
   USB_HID_CONFIG_DESC_SIZ, /* wTotalLength: Bytes returned */
   0x00,
   0x01,         /*bNumInterfaces: 1 interface*/
   0x01,         /*bConfigurationValue: Configuration value*/
   0x00,         /*iConfiguration: Index of string descriptor describing the configuration*/
   0x80,         /*bmAttributes: bus powered and Support Remote Wake-up */
   0xFA,         /*MaxPower 100 mA: this current is used for detecting Vbus*/

   /************** Descriptor of Joystick Mouse 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*/
   0x04,         /*iInterface: Index of string descriptor || origianl = 0x04*/
   /******************** Descriptor of Joystick Mouse HID ********************/
   /* 18 */
   0x09,         /*bLength: HID Descriptor size*/
   HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
   0x00,         /*bcdHID: HID Class Spec release number*/
   0x02,
   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,
   /******************** Descriptor of Mouse endpoint ********************/
   /* 27 */
   0x07,          /*bLength: Endpoint Descriptor size*/
   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
   HID_IN_EP,     /*bEndpointAddress: Endpoint Address (IN)*/
   0x03,          /*bmAttributes: Interrupt endpoint*/
   HID_IN_PACKET, /*wMaxPacketSize: 4 Byte max */
   0x00,
   0x0a,          /*bInterval: Polling Interval (10 ms)*/
   /* 34 */
   0x07,          /*bLength: Endpoint Descriptor size*/
   USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
   HID_OUT_EP,     /*bEndpointAddress: Endpoint Address (OUT)*/
   0x03,          /*bmAttributes: Interrupt endpoint*/
   HID_OUT_PACKET, /*wMaxPacketSize: 4 Byte max */
   0x00,
   0x0a,          /*bInterval: Polling Interval (10 ms)*/
 };