/** ****************************************************************************** * @file Demonstrations/Src/usbd_desc.c * @author MCD Application Team * @brief This file provides the USBD descriptors and string formatting method. ****************************************************************************** * @attention * * Copyright (c) 2017 STMicroelectronics. * All rights reserved. * * This software is licensed under terms that can be found in the LICENSE file * in the root directory of this software component. * If no LICENSE file comes with this software, it is provided AS-IS. * ****************************************************************************** *//* ... */ /* Includes ------------------------------------------------------------------*/ #include "usbd_core.h" #include "usbd_desc.h" #include "usbd_conf.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 0x572B #define USBD_LANGID_STRING 0x409 #define USBD_MANUFACTURER_STRING "STMicroelectronics" #define USBD_PRODUCT_HS_STRING "HID Joystick in HS Mode" #define USBD_SERIALNUMBER_HS_STRING "00000000001A" #define USBD_PRODUCT_FS_STRING "HID Joystick in FS Mode" #define USBD_SERIALNUMBER_FS_STRING "00000000001B" #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" 12 defines/** * @} *//* ... */ /** @defgroup USBD_DESC_Private_Macros * @{ *//* ... */ /** * @} *//* ... */ /** @defgroup USBD_DESC_Private_Variables * @{ *//* ... */ uint8_t * USBD_HID_DeviceDescriptor( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_LangIDStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_ManufacturerStrDescriptor ( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_ProductStrDescriptor ( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_SerialStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_ConfigStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length); uint8_t * USBD_HID_InterfaceStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length); USBD_DescriptorsTypeDef HID_Desc = { USBD_HID_DeviceDescriptor, USBD_HID_LangIDStrDescriptor, USBD_HID_ManufacturerStrDescriptor, USBD_HID_ProductStrDescriptor, USBD_HID_SerialStrDescriptor, USBD_HID_ConfigStrDescriptor, USBD_HID_InterfaceStrDescriptor, ...}; /* USB Standard Device Descriptor */ #if defined ( __ICCARM__ ) /*!< IAR Compiler */ #pragma data_alignment=4 #endif __ALIGN_BEGIN uint8_t hUSBDDeviceDesc[USB_LEN_DEV_DESC] __ALIGN_END = { 0x12, /*bLength */ USB_DESC_TYPE_DEVICE, /*bDescriptorType*/ 0x00, /*bcdUSB */ 0x02, 0x00, /*bDeviceClass*/ 0x00, /*bDeviceSubClass*/ 0x00, /*bDeviceProtocol*/ USB_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_MAX_NUM_CONFIGURATION /*bNumConfigurations*/ ...}; /* USB_DeviceDescriptor */ /* USB Standard Device Descriptor */ #if defined ( __ICCARM__ ) /*!< IAR Compiler */ #pragma data_alignment=4 #endif __ALIGN_BEGIN uint8_t USBD_LangIDDesc[USB_LEN_LANGID_STR_DESC] __ALIGN_END = { USB_LEN_LANGID_STR_DESC, USB_DESC_TYPE_STRING, LOBYTE(USBD_LANGID_STRING), HIBYTE(USBD_LANGID_STRING), ...}; #if defined ( __ICCARM__ ) /*!< IAR Compiler */ #pragma data_alignment=4 #endif __ALIGN_BEGIN uint8_t USBD_StrDesc[USBD_MAX_STR_DESC_SIZ] __ALIGN_END; /** * @} *//* ... */ /** @defgroup USBD_DESC_Private_FunctionPrototypes * @{ *//* ... */ /** * @} *//* ... */ /** @defgroup USBD_DESC_Private_Functions * @{ *//* ... */ /** * @brief USBD_HID_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_HID_DeviceDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { *length = sizeof(hUSBDDeviceDesc); return hUSBDDeviceDesc; }{ ... } /** * @brief USBD_HID_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_HID_LangIDStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { *length = sizeof(USBD_LangIDDesc); return USBD_LangIDDesc; }{ ... } /** * @brief USBD_HID_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_HID_ProductStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { if(speed == 0) { USBD_GetString ((uint8_t *)USBD_PRODUCT_HS_STRING, USBD_StrDesc, length); }if (speed == 0) { ... } else { USBD_GetString ((uint8_t *)USBD_PRODUCT_FS_STRING, USBD_StrDesc, length); }else { ... } return USBD_StrDesc; }{ ... } /** * @brief USBD_HID_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_HID_ManufacturerStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { USBD_GetString ((uint8_t *)USBD_MANUFACTURER_STRING, USBD_StrDesc, length); return USBD_StrDesc; }{ ... } /** * @brief USBD_HID_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_HID_SerialStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { if(speed == USBD_SPEED_HIGH) { USBD_GetString ((uint8_t *)USBD_SERIALNUMBER_HS_STRING, USBD_StrDesc, length); }if (speed == USBD_SPEED_HIGH) { ... } else { USBD_GetString ((uint8_t *)USBD_SERIALNUMBER_FS_STRING, USBD_StrDesc, length); }else { ... } return USBD_StrDesc; }{ ... } /** * @brief USBD_HID_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_HID_ConfigStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { if(speed == USBD_SPEED_HIGH) { USBD_GetString ((uint8_t *)USBD_CONFIGURATION_HS_STRING, USBD_StrDesc, length); }if (speed == USBD_SPEED_HIGH) { ... } else { USBD_GetString ((uint8_t *)USBD_CONFIGURATION_FS_STRING, USBD_StrDesc, length); }else { ... } return USBD_StrDesc; }{ ... } /** * @brief USBD_HID_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_HID_InterfaceStrDescriptor( USBD_SpeedTypeDef speed , uint16_t *length) { if(speed == 0) { USBD_GetString ((uint8_t *)USBD_INTERFACE_HS_STRING, USBD_StrDesc, length); }if (speed == 0) { ... } else { USBD_GetString ((uint8_t *)USBD_INTERFACE_FS_STRING, USBD_StrDesc, length); }else { ... } return USBD_StrDesc; }{ ... } /** * @} *//* ... */ /** * @} *//* ... */ /** * @} *//* ... */