usbd_desc.c 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416
  1. /* USER CODE BEGIN Header */
  2. /**
  3. ******************************************************************************
  4. * @file : usbd_desc.c
  5. * @version : v2.0_Cube
  6. * @brief : This file implements the USB device descriptors.
  7. ******************************************************************************
  8. * @attention
  9. *
  10. * <h2><center>&copy; Copyright (c) 2020 STMicroelectronics.
  11. * All rights reserved.</center></h2>
  12. *
  13. * This software component is licensed by ST under Ultimate Liberty license
  14. * SLA0044, the "License"; You may not use this file except in compliance with
  15. * the License. You may obtain a copy of the License at:
  16. * www.st.com/SLA0044
  17. *
  18. ******************************************************************************
  19. */
  20. /* USER CODE END Header */
  21. /* Includes ------------------------------------------------------------------*/
  22. #include "usbd_core.h"
  23. #include "usbd_desc.h"
  24. #include "usbd_conf.h"
  25. /* USER CODE BEGIN INCLUDE */
  26. /* USER CODE END INCLUDE */
  27. /* Private typedef -----------------------------------------------------------*/
  28. /* Private define ------------------------------------------------------------*/
  29. /* Private macro -------------------------------------------------------------*/
  30. /* USER CODE BEGIN PV */
  31. /* Private variables ---------------------------------------------------------*/
  32. /* USER CODE END PV */
  33. /** @addtogroup STM32_USB_OTG_DEVICE_LIBRARY
  34. * @{
  35. */
  36. /** @addtogroup USBD_DESC
  37. * @{
  38. */
  39. /** @defgroup USBD_DESC_Private_TypesDefinitions USBD_DESC_Private_TypesDefinitions
  40. * @brief Private types.
  41. * @{
  42. */
  43. /* USER CODE BEGIN PRIVATE_TYPES */
  44. /* USER CODE END PRIVATE_TYPES */
  45. /**
  46. * @}
  47. */
  48. /** @defgroup USBD_DESC_Private_Defines USBD_DESC_Private_Defines
  49. * @brief Private defines.
  50. * @{
  51. */
  52. #define USBD_VID 1155
  53. #define USBD_LANGID_STRING 1033
  54. #define USBD_MANUFACTURER_STRING "STMicroelectronics"
  55. #define USBD_PID_FS 22336
  56. #define USBD_PRODUCT_STRING_FS "Flipper Zero Virtual ComPort"
  57. #define USBD_CONFIGURATION_STRING_FS "CDC Config"
  58. #define USBD_INTERFACE_STRING_FS "CDC Interface"
  59. #define USB_SIZ_BOS_DESC 0x0C
  60. /* USER CODE BEGIN PRIVATE_DEFINES */
  61. /* USER CODE END PRIVATE_DEFINES */
  62. /**
  63. * @}
  64. */
  65. /* USER CODE BEGIN 0 */
  66. /* USER CODE END 0 */
  67. /** @defgroup USBD_DESC_Private_Macros USBD_DESC_Private_Macros
  68. * @brief Private macros.
  69. * @{
  70. */
  71. /* USER CODE BEGIN PRIVATE_MACRO */
  72. /* USER CODE END PRIVATE_MACRO */
  73. /**
  74. * @}
  75. */
  76. /** @defgroup USBD_DESC_Private_FunctionPrototypes USBD_DESC_Private_FunctionPrototypes
  77. * @brief Private functions declaration.
  78. * @{
  79. */
  80. static void Get_SerialNum(void);
  81. static void IntToUnicode(uint32_t value, uint8_t* pbuf, uint8_t len);
  82. /**
  83. * @}
  84. */
  85. /** @defgroup USBD_DESC_Private_FunctionPrototypes USBD_DESC_Private_FunctionPrototypes
  86. * @brief Private functions declaration for FS.
  87. * @{
  88. */
  89. uint8_t* USBD_FS_DeviceDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  90. uint8_t* USBD_FS_LangIDStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  91. uint8_t* USBD_FS_ManufacturerStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  92. uint8_t* USBD_FS_ProductStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  93. uint8_t* USBD_FS_SerialStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  94. uint8_t* USBD_FS_ConfigStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  95. uint8_t* USBD_FS_InterfaceStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  96. #if(USBD_LPM_ENABLED == 1)
  97. uint8_t* USBD_FS_USR_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t* length);
  98. #endif /* (USBD_LPM_ENABLED == 1) */
  99. /**
  100. * @}
  101. */
  102. /** @defgroup USBD_DESC_Private_Variables USBD_DESC_Private_Variables
  103. * @brief Private variables.
  104. * @{
  105. */
  106. USBD_DescriptorsTypeDef FS_Desc = {USBD_FS_DeviceDescriptor,
  107. USBD_FS_LangIDStrDescriptor,
  108. USBD_FS_ManufacturerStrDescriptor,
  109. USBD_FS_ProductStrDescriptor,
  110. USBD_FS_SerialStrDescriptor,
  111. USBD_FS_ConfigStrDescriptor,
  112. USBD_FS_InterfaceStrDescriptor
  113. #if(USBD_LPM_ENABLED == 1)
  114. ,
  115. USBD_FS_USR_BOSDescriptor
  116. #endif /* (USBD_LPM_ENABLED == 1) */
  117. };
  118. #if defined(__ICCARM__) /* IAR Compiler */
  119. #pragma data_alignment = 4
  120. #endif /* defined ( __ICCARM__ ) */
  121. /** USB standard device descriptor. */
  122. __ALIGN_BEGIN uint8_t USBD_FS_DeviceDesc[USB_LEN_DEV_DESC] __ALIGN_END = {
  123. 0x12, /*bLength */
  124. USB_DESC_TYPE_DEVICE, /*bDescriptorType*/
  125. #if(USBD_LPM_ENABLED == 1)
  126. 0x01,
  127. /*bcdUSB */ /* changed to USB version 2.01
  128. in order to support LPM L1 suspend
  129. resume test of USBCV3.0*/
  130. #else
  131. 0x00, /*bcdUSB */
  132. #endif /* (USBD_LPM_ENABLED == 1) */
  133. 0x02,
  134. 0x02, /*bDeviceClass*/
  135. 0x02, /*bDeviceSubClass*/
  136. 0x00, /*bDeviceProtocol*/
  137. USB_MAX_EP0_SIZE, /*bMaxPacketSize*/
  138. LOBYTE(USBD_VID), /*idVendor*/
  139. HIBYTE(USBD_VID), /*idVendor*/
  140. LOBYTE(USBD_PID_FS), /*idProduct*/
  141. HIBYTE(USBD_PID_FS), /*idProduct*/
  142. 0x00, /*bcdDevice rel. 2.00*/
  143. 0x02,
  144. USBD_IDX_MFC_STR, /*Index of manufacturer string*/
  145. USBD_IDX_PRODUCT_STR, /*Index of product string*/
  146. USBD_IDX_SERIAL_STR, /*Index of serial number string*/
  147. USBD_MAX_NUM_CONFIGURATION /*bNumConfigurations*/
  148. };
  149. /* USB_DeviceDescriptor */
  150. /** BOS descriptor. */
  151. #if(USBD_LPM_ENABLED == 1)
  152. #if defined(__ICCARM__) /* IAR Compiler */
  153. #pragma data_alignment = 4
  154. #endif /* defined ( __ICCARM__ ) */
  155. __ALIGN_BEGIN uint8_t USBD_FS_BOSDesc[USB_SIZ_BOS_DESC] __ALIGN_END = {
  156. 0x5,
  157. USB_DESC_TYPE_BOS,
  158. 0xC,
  159. 0x0,
  160. 0x1, /* 1 device capability*/
  161. /* device capability*/
  162. 0x7,
  163. USB_DEVICE_CAPABITY_TYPE,
  164. 0x2,
  165. 0x2, /* LPM capability bit set*/
  166. 0x0,
  167. 0x0,
  168. 0x0};
  169. #endif /* (USBD_LPM_ENABLED == 1) */
  170. /**
  171. * @}
  172. */
  173. /** @defgroup USBD_DESC_Private_Variables USBD_DESC_Private_Variables
  174. * @brief Private variables.
  175. * @{
  176. */
  177. #if defined(__ICCARM__) /* IAR Compiler */
  178. #pragma data_alignment = 4
  179. #endif /* defined ( __ICCARM__ ) */
  180. /** USB lang indentifier descriptor. */
  181. __ALIGN_BEGIN uint8_t USBD_LangIDDesc[USB_LEN_LANGID_STR_DESC] __ALIGN_END = {
  182. USB_LEN_LANGID_STR_DESC,
  183. USB_DESC_TYPE_STRING,
  184. LOBYTE(USBD_LANGID_STRING),
  185. HIBYTE(USBD_LANGID_STRING)};
  186. #if defined(__ICCARM__) /* IAR Compiler */
  187. #pragma data_alignment = 4
  188. #endif /* defined ( __ICCARM__ ) */
  189. /* Internal string descriptor. */
  190. __ALIGN_BEGIN uint8_t USBD_StrDesc[USBD_MAX_STR_DESC_SIZ] __ALIGN_END;
  191. #if defined(__ICCARM__) /*!< IAR Compiler */
  192. #pragma data_alignment = 4
  193. #endif
  194. __ALIGN_BEGIN uint8_t USBD_StringSerial[USB_SIZ_STRING_SERIAL] __ALIGN_END = {
  195. USB_SIZ_STRING_SERIAL,
  196. USB_DESC_TYPE_STRING,
  197. };
  198. /**
  199. * @}
  200. */
  201. /** @defgroup USBD_DESC_Private_Functions USBD_DESC_Private_Functions
  202. * @brief Private functions.
  203. * @{
  204. */
  205. /**
  206. * @brief Return the device descriptor
  207. * @param speed : Current device speed
  208. * @param length : Pointer to data length variable
  209. * @retval Pointer to descriptor buffer
  210. */
  211. uint8_t* USBD_FS_DeviceDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  212. UNUSED(speed);
  213. *length = sizeof(USBD_FS_DeviceDesc);
  214. return USBD_FS_DeviceDesc;
  215. }
  216. /**
  217. * @brief Return the LangID string descriptor
  218. * @param speed : Current device speed
  219. * @param length : Pointer to data length variable
  220. * @retval Pointer to descriptor buffer
  221. */
  222. uint8_t* USBD_FS_LangIDStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  223. UNUSED(speed);
  224. *length = sizeof(USBD_LangIDDesc);
  225. return USBD_LangIDDesc;
  226. }
  227. /**
  228. * @brief Return the product string descriptor
  229. * @param speed : Current device speed
  230. * @param length : Pointer to data length variable
  231. * @retval Pointer to descriptor buffer
  232. */
  233. uint8_t* USBD_FS_ProductStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  234. if(speed == 0) {
  235. USBD_GetString((uint8_t*)USBD_PRODUCT_STRING_FS, USBD_StrDesc, length);
  236. } else {
  237. USBD_GetString((uint8_t*)USBD_PRODUCT_STRING_FS, USBD_StrDesc, length);
  238. }
  239. return USBD_StrDesc;
  240. }
  241. /**
  242. * @brief Return the manufacturer string descriptor
  243. * @param speed : Current device speed
  244. * @param length : Pointer to data length variable
  245. * @retval Pointer to descriptor buffer
  246. */
  247. uint8_t* USBD_FS_ManufacturerStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  248. UNUSED(speed);
  249. USBD_GetString((uint8_t*)USBD_MANUFACTURER_STRING, USBD_StrDesc, length);
  250. return USBD_StrDesc;
  251. }
  252. /**
  253. * @brief Return the serial number string descriptor
  254. * @param speed : Current device speed
  255. * @param length : Pointer to data length variable
  256. * @retval Pointer to descriptor buffer
  257. */
  258. uint8_t* USBD_FS_SerialStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  259. UNUSED(speed);
  260. *length = USB_SIZ_STRING_SERIAL;
  261. /* Update the serial number string descriptor with the data from the unique
  262. * ID */
  263. Get_SerialNum();
  264. /* USER CODE BEGIN USBD_FS_SerialStrDescriptor */
  265. /* USER CODE END USBD_FS_SerialStrDescriptor */
  266. return (uint8_t*)USBD_StringSerial;
  267. }
  268. /**
  269. * @brief Return the configuration string descriptor
  270. * @param speed : Current device speed
  271. * @param length : Pointer to data length variable
  272. * @retval Pointer to descriptor buffer
  273. */
  274. uint8_t* USBD_FS_ConfigStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  275. if(speed == USBD_SPEED_HIGH) {
  276. USBD_GetString((uint8_t*)USBD_CONFIGURATION_STRING_FS, USBD_StrDesc, length);
  277. } else {
  278. USBD_GetString((uint8_t*)USBD_CONFIGURATION_STRING_FS, USBD_StrDesc, length);
  279. }
  280. return USBD_StrDesc;
  281. }
  282. /**
  283. * @brief Return the interface string descriptor
  284. * @param speed : Current device speed
  285. * @param length : Pointer to data length variable
  286. * @retval Pointer to descriptor buffer
  287. */
  288. uint8_t* USBD_FS_InterfaceStrDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  289. if(speed == 0) {
  290. USBD_GetString((uint8_t*)USBD_INTERFACE_STRING_FS, USBD_StrDesc, length);
  291. } else {
  292. USBD_GetString((uint8_t*)USBD_INTERFACE_STRING_FS, USBD_StrDesc, length);
  293. }
  294. return USBD_StrDesc;
  295. }
  296. #if(USBD_LPM_ENABLED == 1)
  297. /**
  298. * @brief Return the BOS descriptor
  299. * @param speed : Current device speed
  300. * @param length : Pointer to data length variable
  301. * @retval Pointer to descriptor buffer
  302. */
  303. uint8_t* USBD_FS_USR_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t* length) {
  304. UNUSED(speed);
  305. *length = sizeof(USBD_FS_BOSDesc);
  306. return (uint8_t*)USBD_FS_BOSDesc;
  307. }
  308. #endif /* (USBD_LPM_ENABLED == 1) */
  309. /**
  310. * @brief Create the serial number string descriptor
  311. * @param None
  312. * @retval None
  313. */
  314. static void Get_SerialNum(void) {
  315. uint32_t deviceserial0, deviceserial1, deviceserial2;
  316. deviceserial0 = *(uint32_t*)DEVICE_ID1;
  317. deviceserial1 = *(uint32_t*)DEVICE_ID2;
  318. deviceserial2 = *(uint32_t*)DEVICE_ID3;
  319. deviceserial0 += deviceserial2;
  320. if(deviceserial0 != 0) {
  321. IntToUnicode(deviceserial0, &USBD_StringSerial[2], 8);
  322. IntToUnicode(deviceserial1, &USBD_StringSerial[18], 4);
  323. }
  324. }
  325. /**
  326. * @brief Convert Hex 32Bits value into char
  327. * @param value: value to convert
  328. * @param pbuf: pointer to the buffer
  329. * @param len: buffer length
  330. * @retval None
  331. */
  332. static void IntToUnicode(uint32_t value, uint8_t* pbuf, uint8_t len) {
  333. uint8_t idx = 0;
  334. for(idx = 0; idx < len; idx++) {
  335. if(((value >> 28)) < 0xA) {
  336. pbuf[2 * idx] = (value >> 28) + '0';
  337. } else {
  338. pbuf[2 * idx] = (value >> 28) + 'A' - 10;
  339. }
  340. value = value << 4;
  341. pbuf[2 * idx + 1] = 0;
  342. }
  343. }
  344. /**
  345. * @}
  346. */
  347. /**
  348. * @}
  349. */
  350. /**
  351. * @}
  352. */
  353. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/