Merge pull request #93 from zyp/master
[fw/stlink] / example / stm32f4 / Projects / discovery_demo / usbd_desc.h
1 /**
2   ******************************************************************************
3   * @file    usbd_desc.h
4   * @author  MCD Application Team
5   * @version V1.0.0
6   * @date    19-September-2011
7   * @brief   header file for the usbd_desc.c file
8   ******************************************************************************
9   * @attention 
10   *
11   * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
12   * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
13   * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
14   * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
15   * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
16   * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS. 
17   *
18   * <h2><center>&copy; COPYRIGHT 2011 STMicroelectronics</center></h2>
19   ******************************************************************************
20   */ 
21
22 /* Define to prevent recursive inclusion -------------------------------------*/
23
24 #ifndef __USB_DESC_H
25 #define __USB_DESC_H
26
27 /* Includes ------------------------------------------------------------------*/
28 #include "usbd_def.h"
29
30 /** @addtogroup STM32_USB_OTG_DEVICE_LIBRARY
31   * @{
32   */
33   
34 /** @defgroup USB_DESC
35   * @brief general defines for the usb device library file
36   * @{
37   */ 
38
39 /** @defgroup USB_DESC_Exported_Defines
40   * @{
41   */
42 #define USB_DEVICE_DESCRIPTOR_TYPE              0x01
43 #define USB_CONFIGURATION_DESCRIPTOR_TYPE       0x02
44 #define USB_STRING_DESCRIPTOR_TYPE              0x03
45 #define USB_INTERFACE_DESCRIPTOR_TYPE           0x04
46 #define USB_ENDPOINT_DESCRIPTOR_TYPE            0x05
47 #define USB_SIZ_DEVICE_DESC                     18
48 #define USB_SIZ_STRING_LANGID                   4
49
50 /**
51   * @}
52   */ 
53
54
55 /** @defgroup USBD_DESC_Exported_TypesDefinitions
56   * @{
57   */
58 /**
59   * @}
60   */ 
61
62
63
64 /** @defgroup USBD_DESC_Exported_Macros
65   * @{
66   */ 
67 /**
68   * @}
69   */ 
70
71 /** @defgroup USBD_DESC_Exported_Variables
72   * @{
73   */ 
74 extern  uint8_t USBD_DeviceDesc  [USB_SIZ_DEVICE_DESC];
75 extern  uint8_t USBD_StrDesc[USB_MAX_STR_DESC_SIZ];
76 extern  uint8_t USBD_OtherSpeedCfgDesc[USB_LEN_CFG_DESC]; 
77 extern  uint8_t USBD_DeviceQualifierDesc[USB_LEN_DEV_QUALIFIER_DESC];
78 extern  uint8_t USBD_LangIDDesc[USB_SIZ_STRING_LANGID];
79 extern  USBD_DEVICE USR_desc; 
80 /**
81   * @}
82   */ 
83
84 /** @defgroup USBD_DESC_Exported_FunctionsPrototype
85   * @{
86   */ 
87
88
89 uint8_t *     USBD_USR_DeviceDescriptor( uint8_t speed , uint16_t *length);
90 uint8_t *     USBD_USR_LangIDStrDescriptor( uint8_t speed , uint16_t *length);
91 uint8_t *     USBD_USR_ManufacturerStrDescriptor ( uint8_t speed , uint16_t *length);
92 uint8_t *     USBD_USR_ProductStrDescriptor ( uint8_t speed , uint16_t *length);
93 uint8_t *     USBD_USR_SerialStrDescriptor( uint8_t speed , uint16_t *length);
94 uint8_t *     USBD_USR_ConfigStrDescriptor( uint8_t speed , uint16_t *length);
95 uint8_t *     USBD_USR_InterfaceStrDescriptor( uint8_t speed , uint16_t *length);
96
97 #ifdef USB_SUPPORT_USER_STRING_DESC
98 uint8_t *     USBD_USR_USRStringDesc (uint8_t speed, uint8_t idx , uint16_t *length);  
99 #endif /* USB_SUPPORT_USER_STRING_DESC */  
100   
101 /**
102   * @}
103   */ 
104
105 #endif /* __USBD_DESC_H */
106
107 /**
108   * @}
109   */ 
110
111 /**
112 * @}
113 */ 
114 /******************* (C) COPYRIGHT 2011 STMicroelectronics *****END OF FILE****/