text: /**
    ******************************************************************************
    * @file    usbd_desc.c
    * @author  MCD Application Team
    * @version V1.0.0
    * @date    19-September-2011
    * @brief   This file provides the USBD descriptors and string formating method.
    ******************************************************************************
    * @attention
    *
    * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
    * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
    * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
    * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
    * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
    * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
    *
    * <h2><center>&copy; COPYRIGHT 2011 STMicroelectronics</center></h2>
    ******************************************************************************
    */ 
  
  /* Includes ------------------------------------------------------------------*/
  #include "usbd_core.h"
  #include "usbd_desc.h"
  #include "usbd_req.h"
  #include "usbd_conf.h"
  #include "usb_regs.h"
  
  /** @addtogroup STM32_USB_OTG_DEVICE_LIBRARY
    * @{
    */
  
  
  /** @defgroup USBD_DESC 
    * @brief USBD descriptors module
    * @{
    */ 
  
  /** @defgroup USBD_DESC_Private_TypesDefinitions
    * @{
    */ 
  /**
    * @}
    */ 
  
  
  /** @defgroup USBD_DESC_Private_Defines
    * @{
    */ 
  
  #define USBD_VID                     0x0483
  #define USBD_PID                     0x5710
  
  #define USBD_LANGID_STRING            0x409
  #define USBD_MANUFACTURER_STRING      "STMicroelectronics"
  
  #define USBD_PRODUCT_HS_STRING        "Joystick in HS mode"
  #define USBD_SERIALNUMBER_HS_STRING   "00000000011B"
  
  #define USBD_PRODUCT_FS_STRING        "Joystick in FS Mode"
  #define USBD_SERIALNUMBER_FS_STRING   "00000000011C"
  
  #define USBD_CONFIGURATION_HS_STRING  "HID Config"
  #define USBD_INTERFACE_HS_STRING      "HID Interface"
  
  #define USBD_CONFIGURATION_FS_STRING  "HID Config"
  #define USBD_INTERFACE_FS_STRING      "HID Interface"
  /**
    * @}
    */ 
  
  
  /** @defgroup USBD_DESC_Private_Macros
    * @{
    */ 
  /**
    * @}
    */ 
  
  
  /** @defgroup USBD_DESC_Private_Variables
    * @{
    */ 
  
  USBD_DEVICE USR_desc =
  {
    USBD_USR_DeviceDescriptor,
    USBD_USR_LangIDStrDescriptor, 
    USBD_USR_ManufacturerStrDescriptor,
    USBD_USR_ProductStrDescriptor,
    USBD_USR_SerialStrDescriptor,
    USBD_USR_ConfigStrDescriptor,
    USBD_USR_InterfaceStrDescriptor,
    
  };
  
  #ifdef USB_OTG_HS_INTERNAL_DMA_ENABLED
    #if defined ( __ICCARM__ ) /*!< IAR Compiler */
      #pragma data_alignment=4   
    #endif
  #endif /* USB_OTG_HS_INTERNAL_DMA_ENABLED */
  /* USB Standard Device Descriptor */
  __ALIGN_BEGIN uint8_t USBD_DeviceDesc[USB_SIZ_DEVICE_DESC] __ALIGN_END =
    {
      0x12,                       /*bLength */
      USB_DEVICE_DESCRIPTOR_TYPE, /*bDescriptorType*/
      0x00,                       /*bcdUSB */
      0x02,
      0x00,                       /*bDeviceClass*/
      0x00,                       /*bDeviceSubClass*/
      0x00,                       /*bDeviceProtocol*/
      USB_OTG_MAX_EP0_SIZE,      /*bMaxPacketSize*/
      LOBYTE(USBD_VID),           /*idVendor*/
      HIBYTE(USBD_VID),           /*idVendor*/
      LOBYTE(USBD_PID),           /*idVendor*/
      HIBYTE(USBD_PID),           /*idVendor*/
      0x00,                       /*bcdDevice rel. 2.00*/
      0x02,
      USBD_IDX_MFC_STR,           /*Index of manufacturer  string*/
      USBD_IDX_PRODUCT_STR,       /*Index of product string*/
      USBD_IDX_SERIAL_STR,        /*Index of serial number string*/
      USBD_CFG_MAX_NUM            /*bNumConfigurations*/
    } ; /* USB_DeviceDescriptor */
  
  #ifdef USB_OTG_HS_INTERNAL_DMA_ENABLED
    #if defined ( __ICCARM__ ) /*!< IAR Compiler */
      #pragma data_alignment=4   
    #endif
  #endif /* USB_OTG_HS_INTERNAL_DMA_ENABLED */
  /* USB Standard Device Descriptor */
  __ALIGN_BEGIN uint8_t USBD_DeviceQualifierDesc[USB_LEN_DEV_QUALIFIER_DESC] __ALIGN_END =
  {
    USB_LEN_DEV_QUALIFIER_DESC,
    USB_DESC_TYPE_DEVICE_QUALIFIER,
    0x00,
    0x02,
    0x00,
    0x00,
    0x00,
    0x40,
    0x01,
    0x00,
  };
  
  #ifdef USB_OTG_HS_INTERNAL_DMA_ENABLED
    #if defined ( __ICCARM__ ) /*!< IAR Compiler */
      #pragma data_alignment=4   
    #endif
  #endif /* USB_OTG_HS_INTERNAL_DMA_ENABLED */
  /* USB Standard Device Descriptor */
  __ALIGN_BEGIN uint8_t USBD_LangIDDesc[USB_SIZ_STRING_LANGID] __ALIGN_END =
  {
       USB_SIZ_STRING_LANGID,         
       USB_DESC_TYPE_STRING,       
       LOBYTE(USBD_LANGID_STRING),
       HIBYTE(USBD_LANGID_STRING), 
  };
  /**
    * @}
    */ 
  
  
  /** @defgroup USBD_DESC_Private_FunctionPrototypes
    * @{
    */ 
  /**
    * @}
    */ 
  
  
  /** @defgroup USBD_DESC_Private_Functions
    * @{
    */ 
  
  /**
  * @brief  USBD_USR_DeviceDescriptor 
  *         return the device descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_DeviceDescriptor( uint8_t speed , uint16_t *length)
  {
    *length = sizeof(USBD_DeviceDesc);
    return USBD_DeviceDesc;
  }
  
  /**
  * @brief  USBD_USR_LangIDStrDescriptor 
  *         return the LangID string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_LangIDStrDescriptor( uint8_t speed , uint16_t *length)
  {
    *length =  sizeof(USBD_LangIDDesc);  
    return USBD_LangIDDesc;
  }
  
  
  /**
  * @brief  USBD_USR_ProductStrDescriptor 
  *         return the product string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_ProductStrDescriptor( uint8_t speed , uint16_t *length)
  {
   
    
    if(speed == 0)
    {   
      USBD_GetString ((uint8_t *)USBD_PRODUCT_HS_STRING, USBD_StrDesc, length);
    }
    else
    {
      USBD_GetString ((uint8_t *)USBD_PRODUCT_FS_STRING, USBD_StrDesc, length);    
    }
    return USBD_StrDesc;
  }
  
  /**
  * @brief  USBD_USR_ManufacturerStrDescriptor 
  *         return the manufacturer string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_ManufacturerStrDescriptor( uint8_t speed , uint16_t *length)
  {
    USBD_GetString ((uint8_t *)USBD_MANUFACTURER_STRING, USBD_StrDesc, length);
    return USBD_StrDesc;
  }
  
  /**
  * @brief  USBD_USR_SerialStrDescriptor 
  *         return the serial number string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_SerialStrDescriptor( uint8_t speed , uint16_t *length)
  {
    if(speed  == USB_OTG_SPEED_HIGH)
    {    
      USBD_GetString ((uint8_t *)USBD_SERIALNUMBER_HS_STRING, USBD_StrDesc, length);
    }
    else
    {
      USBD_GetString ((uint8_t *)USBD_SERIALNUMBER_FS_STRING, USBD_StrDesc, length);    
    }
    return USBD_StrDesc;
  }
  
  /**
  * @brief  USBD_USR_ConfigStrDescriptor 
  *         return the configuration string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_ConfigStrDescriptor( uint8_t speed , uint16_t *length)
  {
    if(speed  == USB_OTG_SPEED_HIGH)
    {  
      USBD_GetString ((uint8_t *)USBD_CONFIGURATION_HS_STRING, USBD_StrDesc, length);
    }
    else
    {
      USBD_GetString ((uint8_t *)USBD_CONFIGURATION_FS_STRING, USBD_StrDesc, length); 
    }
    return USBD_StrDesc;  
  }
  
  
  /**
  * @brief  USBD_USR_InterfaceStrDescriptor 
  *         return the interface string descriptor
  * @param  speed : current device speed
  * @param  length : pointer to data length variable
  * @retval pointer to descriptor buffer
  */
  uint8_t *  USBD_USR_InterfaceStrDescriptor( uint8_t speed , uint16_t *length)
  {
    if(speed == 0)
    {
      USBD_GetString ((uint8_t *)USBD_INTERFACE_HS_STRING, USBD_StrDesc, length);
    }
    else
    {
      USBD_GetString ((uint8_t *)USBD_INTERFACE_FS_STRING, USBD_StrDesc, length);
    }
    return USBD_StrDesc;  
  }
  
  /**
    * @}
    */ 
  
  
  /**
    * @}
    */ 
  
  
  /**
    * @}
    */ 
  
  /******************* (C) COPYRIGHT 2011 STMicroelectronics *****END OF FILE****/
  
  