2019年07月30日 | STM32f103 USB移植之USB标准描述符

在对USB协议进行学习和移植的过程有个东西不可避免，肯定会遇到，那就是USB的设备描述符。这个东西始终在usb协议中发挥作用，从设备的枚举到设备的配置，都是由usb描述符进行修改的。今天在移植的时候这个整理了一下usb描述符有关的知识。

/********************************************不啰嗦的分割线***********************************************/

 参考资料：深入浅出USB系统开发——基于ARM Cortex-M3    王川北 刘强

圈圈教你玩usb

http://www.openedv.com/thread-10971-1-1.html

USB采用USB标准描述符说明一个USB设备，这些描述符包括设备描述符、配置描述符、接口描述符、端点描述符和字串描述符。在stm32 usb库中有关描述符在usb_desc.c和usb_desc.h中。

在上个例程中并未对描述符进行修改，直接使用了原来配置，现在我们对描述符进行修改，在该示例中的配置为usb键盘的描述符设置。

设备描述符给出了usb的一般信息，一个usb设备只能有一个设备描述符。在stm32 usb库中有关配置及含义如图所示。

在usb库中除设备描述符以外的其他所有描述符均在Joystick_ConfigDescriptor[JOYSTICK_SIZ_CONFIG_DESC]这个数组中

如果对描述符进行增删后，注意更改数组大小，在usb_desc.h中定义。

以下为配置描述符的说明，在一个usb设备描述符下可以有多个配置描述符。

以下为接口描述符的说明，在一个usb配置描述符下可以有多个接口描述符。

端点描述符，每个端点只能用作输入或输出的一种，端点0不可配置。

HID为人机交互设备（Human Interface Device）的缩写，HID设备类除了支持标准USB描述符外,还自行定义了3种设备描述符，分别为HID描述符、报告描述符、物理描述符。一个HID设备只支持一个HID描述符；可以支持一个或多个报告描述符；物理描述符是可选的，发多数HID设备不需要使用它。

下面为为HID描述符及说明

 //以下为HID描述符

/******************** Descriptor of Joystick Mouse HID ********************/

/* 18 */

0x09,         /*bLength: HID Descriptor size 字节数*/

HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID 配置描述符类型*/

0x00,         /*bcdHID: HID Class Spec release number         版本号*/

0x01,

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

0x01,         /*bNumDescriptors: Number of HID class descriptors to follow 描述符个数*/

0x22,         /*bDescriptorType 下一个描述符类型*/

JOYSTICK_SIZ_REPORT_DESC,/*wItemLength: Total length of Report descriptor 报告描述符总长度*/

0x00,

下面为HID的报告描述符

const uint8_t Joystick_ReportDescriptor[JOYSTICK_SIZ_REPORT_DESC] =

  {                                                                           

0x05, 0x01, // USAGE_PAGE (Generic Desktop)

0x09, 0x06, // USAGE (Keyboard)

0xa1, 0x01, // COLLECTION (Application)

0x05, 0x07, //         USAGE_PAGE (Keyboard/Keypad)

0x19, 0xe0, //         USAGE_MINIMUM (Keyboard LeftControl)

0x29, 0xe7, //         USAGE_MAXIMUM (Keyboard Right GUI)

0x15, 0x00, //         LOGICAL_MINIMUM (0)

0x25, 0x01, //         LOGICAL_MAXIMUM (1)

0x95, 0x08, //         REPORT_COUNT (8)

0x75, 0x01, //         REPORT_SIZE (1)

0x81, 0x02, //         INPUT (Data,Var,Abs)

0x95, 0x01, //         REPORT_COUNT (1)

0x75, 0x08, //         REPORT_SIZE (8)

0x81, 0x03, //         INPUT (Cnst,Var,Abs)

0x95, 0x06, //    REPORT_COUNT (6)

0x75, 0x08, //    REPORT_SIZE (8)

0x25, 0xFF, //    LOGICAL_MAXIMUM (255)

0x19, 0x00, //    USAGE_MINIMUM (Reserved (no event indicated))

0x29, 0x65, //    USAGE_MAXIMUM (Keyboard Application)

0x81, 0x00, //         INPUT (Data,Ary,Abs)

0x25, 0x01, //         LOGICAL_MAXIMUM (1)

0x95, 0x02, //    REPORT_COUNT (2)

0x75, 0x01, //    REPORT_SIZE (1)

0x05, 0x08, //    USAGE_PAGE (LEDs)

0x19, 0x01, //    USAGE_MINIMUM (Num Lock)

0x29, 0x02, //    USAGE_MAXIMUM (Caps Lock)

0x91, 0x02, //    OUTPUT (Data,Var,Abs)

0x95, 0x01, //    REPORT_COUNT (1)

0x75, 0x06, //    REPORT_SIZE (6)

0x91, 0x03, //    OUTPUT (Cnst,Var,Abs)

0xc0        // END_COLLECTION

  }

好了，我们对上面的描述符进行修改后，编译下载，在电脑上可以识别出键盘，在后面的会继续介绍usb键盘的移植过程