STM32 USB On-The-Go Host and Device Library复合设备分析

最近在搞USB，需要用到复合设备，网上看来看去都是用的旧版本的USB库。

看官网ST更新了USB的固件库，适用于STM32F105/7xx, STM32F2xx 和STM32F4xx等系列。决定采用最新的，毕竟应该是优化了不少功能的。

目前最新的版本，Device库为1.2.1，Host库为2.2.1，OTG库为2.2.1

这个版本的库在文件分类上做得很好，一眼就能知道这个文件是关于什么方面的驱动的。关于新版库的文件结构解析可以参考STM32 之 标准外设版USB驱动库详解（架构+文件+函数+使用说明+示例程序）这篇博文，说的很详细。

下面讲解我在使用这个USB库时遇到的问题及解决办法。

我需要用STM32F207的开发板通过USB口来模拟鼠标+键盘+HID通讯的功能。硬件连接是接到单片机的PB14,PB15脚，也即OTG_HS端口。我没有用到外置的PHY，只想用HS端口实现FS的功能。网上关于用OTG_HS端口实现OTG_FS功能的文章比较少，折腾了了半天才弄明白。具体如何修改可以参见我的博文：STM32 HS端口改为FS步骤。

鼠标+键盘的功能好实现，主要是配置好HID配置描述符和报告描述符即可。2种设备共用1个端点（输入端点1），网上关于鼠标和键盘的报告描述符有很多现成的，我们主要操作是把他们放在一个报告描述符里面，设置好报告ID就可。

__ALIGN_BEGIN static uint8_t USBD_HID_CfgDesc[USB_HID_CONFIG_DESC_SIZ] __ALIGN_END =
{
	
	0x09, /* bLength: Configuration Descriptor size */
  USB_DESC_TYPE_CONFIGURATION, /* bDescriptorType: Configuration */
  USB_HID_CONFIG_DESC_SIZ,
  /* wTotalLength: Bytes returned */
  0x00,
  MAX_INTERFACE_NUM,         /*bNumInterfaces: 2 interface*/
  0x01,         /*bConfigurationValue: Configuration value*/
  0x00,         /*iConfiguration: Index of string descriptor describing
  the configuration*/
  0xE0,         /*bmAttributes: bus powered and Support Remote Wake-up */
  0x32,         /*MaxPower 100 mA: this current is used for detecting Vbus*/
  
  /************** Descriptor of Joystick Mouse interface ****************/
  /* 09 */
  0x09,         /*bLength: Interface Descriptor size*/
  USB_DESC_TYPE_INTERFACE,/*bDescriptorType: Interface descriptor type*/
  KEYBOARD_MOUSE_IF,         /*bInterfaceNumber: Number of Interface*/
  0x00,         /*bAlternateSetting: Alternate setting*/
  0x01,         /*bNumEndpoints*/
  0x03,         /*bInterfaceClass: HID*/
  0x01,         /*bInterfaceSubClass : 1=BOOT, 0=no boot*/
  0x01,         /*nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse*/
  0,            /*iInterface: Index of string descriptor*/
  /******************** Descriptor of Joystick Mouse HID ********************/
  /* 18 */
  0x09,         /*bLength: HID Descriptor size*/
  HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
  0x11,         /*bcdHID: HID Class S