mirror of
https://github.com/STMicroelectronics/STM32CubeF4.git
synced 2025-05-03 22:17:07 +08:00
295 lines
8.0 KiB
C
295 lines
8.0 KiB
C
/**
|
|
******************************************************************************
|
|
* @file Demonstrations/Src/usbd_desc.c
|
|
* @author MCD Application Team
|
|
* @brief This file provides the USBD descriptors and string formating method.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© Copyright (c) 2017 STMicroelectronics.
|
|
* All rights reserved.</center></h2>
|
|
*
|
|
* This software component is licensed by ST under Ultimate Liberty license
|
|
* SLA0044, the "License"; You may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at:
|
|
* www.st.com/SLA0044
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* 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"
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/** @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);
|
|
}
|
|
else
|
|
{
|
|
USBD_GetString ((uint8_t *)USBD_PRODUCT_FS_STRING, USBD_StrDesc, length);
|
|
}
|
|
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);
|
|
}
|
|
else
|
|
{
|
|
USBD_GetString ((uint8_t *)USBD_SERIALNUMBER_FS_STRING, USBD_StrDesc, length);
|
|
}
|
|
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);
|
|
}
|
|
else
|
|
{
|
|
USBD_GetString ((uint8_t *)USBD_CONFIGURATION_FS_STRING, USBD_StrDesc, length);
|
|
}
|
|
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);
|
|
}
|
|
else
|
|
{
|
|
USBD_GetString ((uint8_t *)USBD_INTERFACE_FS_STRING, USBD_StrDesc, length);
|
|
}
|
|
return USBD_StrDesc;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
|
|