2017-04-10 15:52:18 +00:00
|
|
|
/**
|
|
|
|
|
******************************************************************************
|
|
|
|
|
* @file usbd_def.h
|
|
|
|
|
* @author MCD Application Team
|
|
|
|
|
* @version V2.4.2
|
|
|
|
|
* @date 11-December-2015
|
|
|
|
|
* @brief General defines for the usb device library
|
|
|
|
|
******************************************************************************
|
|
|
|
|
* @attention
|
|
|
|
|
*
|
|
|
|
|
* <h2><center>© COPYRIGHT 2015 STMicroelectronics</center></h2>
|
|
|
|
|
*
|
|
|
|
|
* Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
|
|
|
|
|
* You may not use this file except in compliance with the License.
|
|
|
|
|
* You may obtain a copy of the License at:
|
|
|
|
|
*
|
|
|
|
|
* http://www.st.com/software_license_agreement_liberty_v2
|
|
|
|
|
*
|
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
|
* limitations under the License.
|
|
|
|
|
*
|
|
|
|
|
******************************************************************************
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
|
|
|
#ifndef __USBD_DEF_H
|
|
|
|
|
#define __USBD_DEF_H
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
|
|
|
#include "usbd_conf.h"
|
|
|
|
|
|
|
|
|
|
/** @addtogroup STM32_USBD_DEVICE_LIBRARY
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** @defgroup USB_DEF
|
|
|
|
|
* @brief general defines for the usb device library file
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** @defgroup USB_DEF_Exported_Defines
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef NULL
|
|
|
|
|
#define NULL 0
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#define USB_LEN_DEV_QUALIFIER_DESC 0x0A
|
|
|
|
|
#define USB_LEN_DEV_DESC 0x12
|
|
|
|
|
#define USB_LEN_CFG_DESC 0x09
|
|
|
|
|
#define USB_LEN_IF_DESC 0x09
|
|
|
|
|
#define USB_LEN_EP_DESC 0x07
|
|
|
|
|
#define USB_LEN_OTG_DESC 0x03
|
|
|
|
|
#define USB_LEN_LANGID_STR_DESC 0x04
|
|
|
|
|
#define USB_LEN_OTHER_SPEED_DESC_SIZ 0x09
|
|
|
|
|
|
|
|
|
|
#define USBD_IDX_LANGID_STR 0x00
|
|
|
|
|
#define USBD_IDX_MFC_STR 0x01
|
|
|
|
|
#define USBD_IDX_PRODUCT_STR 0x02
|
|
|
|
|
#define USBD_IDX_SERIAL_STR 0x03
|
|
|
|
|
#define USBD_IDX_CONFIG_STR 0x04
|
|
|
|
|
#define USBD_IDX_INTERFACE_STR 0x05
|
|
|
|
|
|
|
|
|
|
#define USB_REQ_TYPE_STANDARD 0x00
|
|
|
|
|
#define USB_REQ_TYPE_CLASS 0x20
|
|
|
|
|
#define USB_REQ_TYPE_VENDOR 0x40
|
|
|
|
|
#define USB_REQ_TYPE_MASK 0x60
|
|
|
|
|
|
|
|
|
|
#define USB_REQ_RECIPIENT_DEVICE 0x00
|
|
|
|
|
#define USB_REQ_RECIPIENT_INTERFACE 0x01
|
|
|
|
|
#define USB_REQ_RECIPIENT_ENDPOINT 0x02
|
2018-01-21 14:40:31 +00:00
|
|
|
#define USB_REQ_RECIPIENT_MASK 0x1F
|
2017-04-10 15:52:18 +00:00
|
|
|
|
|
|
|
|
#define USB_REQ_GET_STATUS 0x00
|
|
|
|
|
#define USB_REQ_CLEAR_FEATURE 0x01
|
|
|
|
|
#define USB_REQ_SET_FEATURE 0x03
|
|
|
|
|
#define USB_REQ_SET_ADDRESS 0x05
|
|
|
|
|
#define USB_REQ_GET_DESCRIPTOR 0x06
|
|
|
|
|
#define USB_REQ_SET_DESCRIPTOR 0x07
|
|
|
|
|
#define USB_REQ_GET_CONFIGURATION 0x08
|
|
|
|
|
#define USB_REQ_SET_CONFIGURATION 0x09
|
|
|
|
|
#define USB_REQ_GET_INTERFACE 0x0A
|
|
|
|
|
#define USB_REQ_SET_INTERFACE 0x0B
|
|
|
|
|
#define USB_REQ_SYNCH_FRAME 0x0C
|
|
|
|
|
|
|
|
|
|
#define USB_DESC_TYPE_DEVICE 1
|
|
|
|
|
#define USB_DESC_TYPE_CONFIGURATION 2
|
|
|
|
|
#define USB_DESC_TYPE_STRING 3
|
|
|
|
|
#define USB_DESC_TYPE_INTERFACE 4
|
|
|
|
|
#define USB_DESC_TYPE_ENDPOINT 5
|
|
|
|
|
#define USB_DESC_TYPE_DEVICE_QUALIFIER 6
|
|
|
|
|
#define USB_DESC_TYPE_OTHER_SPEED_CONFIGURATION 7
|
2018-01-20 21:04:41 +00:00
|
|
|
#define USB_DESC_TYPE_BOS 15
|
|
|
|
|
#define USB_DESC_TYPE_DEVICE_CAPABILITY 16
|
|
|
|
|
|
|
|
|
|
#define USB_DEVICE_CAPABILITY_PLATFORM 5
|
2017-04-10 15:52:18 +00:00
|
|
|
|
|
|
|
|
#define USB_CONFIG_REMOTE_WAKEUP 2
|
|
|
|
|
#define USB_CONFIG_SELF_POWERED 1
|
|
|
|
|
|
|
|
|
|
#define USB_FEATURE_EP_HALT 0
|
|
|
|
|
#define USB_FEATURE_REMOTE_WAKEUP 1
|
|
|
|
|
#define USB_FEATURE_TEST_MODE 2
|
|
|
|
|
|
|
|
|
|
#define USB_HS_MAX_PACKET_SIZE 512
|
|
|
|
|
#define USB_FS_MAX_PACKET_SIZE 64
|
|
|
|
|
#define USB_MAX_EP0_SIZE 64
|
|
|
|
|
|
|
|
|
|
/* Device Status */
|
|
|
|
|
#define USBD_STATE_DEFAULT 1
|
|
|
|
|
#define USBD_STATE_ADDRESSED 2
|
|
|
|
|
#define USBD_STATE_CONFIGURED 3
|
|
|
|
|
#define USBD_STATE_SUSPENDED 4
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* EP0 State */
|
|
|
|
|
#define USBD_EP0_IDLE 0
|
|
|
|
|
#define USBD_EP0_SETUP 1
|
|
|
|
|
#define USBD_EP0_DATA_IN 2
|
|
|
|
|
#define USBD_EP0_DATA_OUT 3
|
|
|
|
|
#define USBD_EP0_STATUS_IN 4
|
|
|
|
|
#define USBD_EP0_STATUS_OUT 5
|
|
|
|
|
#define USBD_EP0_STALL 6
|
|
|
|
|
|
|
|
|
|
#define USBD_EP_TYPE_CTRL 0
|
|
|
|
|
#define USBD_EP_TYPE_ISOC 1
|
|
|
|
|
#define USBD_EP_TYPE_BULK 2
|
|
|
|
|
#define USBD_EP_TYPE_INTR 3
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** @defgroup USBD_DEF_Exported_TypesDefinitions
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
typedef struct usb_setup_req
|
|
|
|
|
{
|
|
|
|
|
|
|
|
|
|
uint8_t bmRequest;
|
|
|
|
|
uint8_t bRequest;
|
|
|
|
|
uint16_t wValue;
|
|
|
|
|
uint16_t wIndex;
|
|
|
|
|
uint16_t wLength;
|
|
|
|
|
}USBD_SetupReqTypedef;
|
|
|
|
|
|
|
|
|
|
struct _USBD_HandleTypeDef;
|
|
|
|
|
|
|
|
|
|
typedef struct _Device_cb
|
|
|
|
|
{
|
|
|
|
|
uint8_t (*Init) (struct _USBD_HandleTypeDef *pdev , uint8_t cfgidx);
|
|
|
|
|
uint8_t (*DeInit) (struct _USBD_HandleTypeDef *pdev , uint8_t cfgidx);
|
|
|
|
|
/* Control Endpoints*/
|
|
|
|
|
uint8_t (*Setup) (struct _USBD_HandleTypeDef *pdev , USBD_SetupReqTypedef *req);
|
|
|
|
|
uint8_t (*EP0_TxSent) (struct _USBD_HandleTypeDef *pdev );
|
|
|
|
|
uint8_t (*EP0_RxReady) (struct _USBD_HandleTypeDef *pdev );
|
|
|
|
|
/* Class Specific Endpoints*/
|
|
|
|
|
uint8_t (*DataIn) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum);
|
|
|
|
|
uint8_t (*DataOut) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum);
|
|
|
|
|
uint8_t (*SOF) (struct _USBD_HandleTypeDef *pdev);
|
|
|
|
|
uint8_t (*IsoINIncomplete) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum);
|
|
|
|
|
uint8_t (*IsoOUTIncomplete) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum);
|
|
|
|
|
|
|
|
|
|
uint8_t *(*GetHSConfigDescriptor)(uint16_t *length);
|
|
|
|
|
uint8_t *(*GetFSConfigDescriptor)(uint16_t *length);
|
|
|
|
|
uint8_t *(*GetOtherSpeedConfigDescriptor)(uint16_t *length);
|
|
|
|
|
uint8_t *(*GetDeviceQualifierDescriptor)(uint16_t *length);
|
|
|
|
|
#if (USBD_SUPPORT_USER_STRING == 1)
|
|
|
|
|
uint8_t *(*GetUsrStrDescriptor)(struct _USBD_HandleTypeDef *pdev ,uint8_t index, uint16_t *length);
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
} USBD_ClassTypeDef;
|
|
|
|
|
|
|
|
|
|
/* Following USB Device Speed */
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
USBD_SPEED_HIGH = 0,
|
|
|
|
|
USBD_SPEED_FULL = 1,
|
|
|
|
|
USBD_SPEED_LOW = 2,
|
|
|
|
|
}USBD_SpeedTypeDef;
|
|
|
|
|
|
|
|
|
|
/* Following USB Device status */
|
|
|
|
|
typedef enum {
|
|
|
|
|
USBD_OK = 0,
|
|
|
|
|
USBD_BUSY,
|
|
|
|
|
USBD_FAIL,
|
|
|
|
|
}USBD_StatusTypeDef;
|
|
|
|
|
|
|
|
|
|
/* USB Device descriptors structure */
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
uint8_t *(*GetDeviceDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetLangIDStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetManufacturerStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetProductStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetSerialStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetConfigurationStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
uint8_t *(*GetInterfaceStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
#if (USBD_LPM_ENABLED == 1)
|
|
|
|
|
uint8_t *(*GetBOSDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length);
|
|
|
|
|
#endif
|
|
|
|
|
} USBD_DescriptorsTypeDef;
|
|
|
|
|
|
|
|
|
|
/* USB Device handle structure */
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
uint32_t status;
|
|
|
|
|
uint32_t total_length;
|
|
|
|
|
uint32_t rem_length;
|
|
|
|
|
uint32_t maxpacket;
|
|
|
|
|
} USBD_EndpointTypeDef;
|
|
|
|
|
|
|
|
|
|
/* USB Device handle structure */
|
|
|
|
|
typedef struct _USBD_HandleTypeDef
|
|
|
|
|
{
|
|
|
|
|
uint8_t id;
|
|
|
|
|
uint32_t dev_config;
|
|
|
|
|
uint32_t dev_default_config;
|
|
|
|
|
uint32_t dev_config_status;
|
|
|
|
|
USBD_SpeedTypeDef dev_speed;
|
|
|
|
|
USBD_EndpointTypeDef ep_in[15];
|
|
|
|
|
USBD_EndpointTypeDef ep_out[15];
|
|
|
|
|
uint32_t ep0_state;
|
|
|
|
|
uint32_t ep0_data_len;
|
|
|
|
|
uint8_t dev_state;
|
|
|
|
|
uint8_t dev_old_state;
|
|
|
|
|
uint8_t dev_address;
|
|
|
|
|
uint8_t dev_connection_status;
|
|
|
|
|
uint8_t dev_test_mode;
|
|
|
|
|
uint32_t dev_remote_wakeup;
|
|
|
|
|
|
|
|
|
|
USBD_SetupReqTypedef request;
|
|
|
|
|
USBD_DescriptorsTypeDef *pDesc;
|
|
|
|
|
USBD_ClassTypeDef *pClass;
|
|
|
|
|
void *pClassData;
|
|
|
|
|
void *pUserData;
|
|
|
|
|
void *pData;
|
|
|
|
|
} USBD_HandleTypeDef;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** @defgroup USBD_DEF_Exported_Macros
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
#define SWAPBYTE(addr) (((uint16_t)(*((uint8_t *)(addr)))) + \
|
|
|
|
|
(((uint16_t)(*(((uint8_t *)(addr)) + 1))) << 8))
|
|
|
|
|
|
|
|
|
|
#define LOBYTE(x) ((uint8_t)(x & 0x00FF))
|
|
|
|
|
#define HIBYTE(x) ((uint8_t)((x & 0xFF00) >>8))
|
|
|
|
|
#define MIN(a, b) (((a) < (b)) ? (a) : (b))
|
|
|
|
|
#define MAX(a, b) (((a) > (b)) ? (a) : (b))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#if defined ( __GNUC__ )
|
|
|
|
|
#ifndef __weak
|
|
|
|
|
#define __weak __attribute__((weak))
|
|
|
|
|
#endif /* __weak */
|
|
|
|
|
#ifndef __packed
|
|
|
|
|
#define __packed __attribute__((__packed__))
|
|
|
|
|
#endif /* __packed */
|
|
|
|
|
#endif /* __GNUC__ */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* In HS mode and when the DMA is used, all variables and data structures dealing
|
|
|
|
|
with the DMA during the transaction process should be 4-bytes aligned */
|
|
|
|
|
|
|
|
|
|
#if defined (__GNUC__) /* GNU Compiler */
|
|
|
|
|
#define __ALIGN_END __attribute__ ((aligned (4)))
|
|
|
|
|
#define __ALIGN_BEGIN
|
|
|
|
|
#else
|
|
|
|
|
#define __ALIGN_END
|
|
|
|
|
#if defined (__CC_ARM) /* ARM Compiler */
|
|
|
|
|
#define __ALIGN_BEGIN __align(4)
|
|
|
|
|
#elif defined (__ICCARM__) /* IAR Compiler */
|
|
|
|
|
#define __ALIGN_BEGIN
|
|
|
|
|
#elif defined (__TASKING__) /* TASKING Compiler */
|
|
|
|
|
#define __ALIGN_BEGIN __align(4)
|
|
|
|
|
#endif /* __CC_ARM */
|
|
|
|
|
#endif /* __GNUC__ */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** @defgroup USBD_DEF_Exported_Variables
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/** @defgroup USBD_DEF_Exported_FunctionsPrototype
|
|
|
|
|
* @{
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif /* __USBD_DEF_H */
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @}
|
|
|
|
|
*/
|
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
