/** ****************************************************************************** * @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 * *

© COPYRIGHT 2015 STMicroelectronics

* * 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 #define USB_REQ_RECIPIENT_MASK 0x1F #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_REQ_VENDOR_FEATURE 0x21 #define USB_REQ_MS_OS_STRING_DESCRIPTOR 0xEE #define USB_REQ_EXT_COMPAT_ID_OS_FEATURE_DESCRIPTOR 0x04 #define USB_REQ_EXT_PROPERTIES_OS_FEATURE_DESCRIPTOR 0x05 #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 #define USB_DESC_TYPE_BOS 0x0F #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_DEVICE_CAPABITY_TYPE 0x10 //#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; /* Following USB Device Speed */ typedef enum { USBD_SPEED_HIGH = 0, // not supported USBD_SPEED_FULL = 1, USBD_SPEED_LOW = 2, }USBD_SpeedTypeDef; /* Following USB Device status */ typedef enum { USBD_OK = 0, USBD_BUSY, USBD_FAIL, USBD_CONTINUE, // added for vendor driver }USBD_StatusTypeDef; // @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ #if USBD_GETDESCRIPTORS_ALTMETHOD == 0 typedef enum { eGetDescriptorHandlerType_Device = 0, // refer to USBD_DescriptorsTypeDef.GetDeviceDescriptor eGetDescriptorHandlerType_LangIdStr = 1, // refer to USBD_DescriptorsTypeDef.GetLangIDStrDescriptor eGetDescriptorHandlerType_ManufacturerStr = 2, // refer to USBD_DescriptorsTypeDef.GetManufacturerStrDescriptor eGetDescriptorHandlerType_ProductStr = 3, // refer to USBD_DescriptorsTypeDef.GetProductStrDescriptor eGetDescriptorHandlerType_SerialStr = 4, // refer to USBD_DescriptorsTypeDef.GetSerialStrDescriptor eGetDescriptorHandlerType_ConfigurationStr = 5, // refer to USBD_DescriptorsTypeDef.GetConfigurationStrDescriptor eGetDescriptorHandlerType_InterfaceStr = 6, // refer to USBD_DescriptorsTypeDef.GetInterfaceStrDescriptor eGetDescriptorHandlerType_Config = 7, // refer to USBD_DescriptorsTypeDef.GetConfigDescriptor eGetDescriptorHandlerType_MsOsString = 8, // refer to USBD_DescriptorsTypeDef.GetMsOsStringDescriptor eGetDescriptorHandlerType_ExtCompatIdOsFeat = 9, // refer to USBD_DescriptorsTypeDef.GetExtCompatIdOsFeatureDescriptor eGetDescriptorHandlerType_ExtPropertiesOsFeat = 10, // refer to USBD_DescriptorsTypeDef.GetMsOsStringDescriptor eGetDescriptorHandlerType_MAX // DO NOT ADD @GetUsrStrDescriptor, this is the other type routine (see prototype!) } eGetDescriptorHandlerType_t; typedef const uint8_t *(*fGetDescriptorRoutine_t)( USBD_SpeedTypeDef speed , uint16_t *length); // USB Device descriptors structure typedef union { struct { // NOTE: DO NOT CHANGE THIS STRUCTURE CONTENTS AND FILEDS ORDER WITHOUT // CHANGING THE @eGetDescriptorHandlerType_t TYPE! // These routines are used indirectly by position in @arrayGetDescriptorRoutines field! const uint8_t *(*GetDeviceDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetLangIDStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetManufacturerStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetProductStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetSerialStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetConfigurationStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetInterfaceStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetConfigDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); #if (USBD_SUPPORT_USER_STRING == 1) // This routine is optional, it is used directly only ( pDesc->GetUsrStrDescriptor(...) ) const uint8_t *(*GetUsrStrDescriptor)(struct _USBD_HandleTypeDef *pdev ,uint8_t index, uint16_t *length); #endif }; // @arrayGetDescriptorRoutines // used by @GetDescriptorHandler fGetDescriptorRoutine_t arrayGetDescriptorRoutines[ eGetDescriptorHandlerType_MAX ]; } USBD_DescriptorsTypeDef; // @GetDescriptorHandler // This function returns the routine address from the @USBD_DescriptorsTypeDef descriptor (@pGetDescriptorHanders) // by the specified type (@desc_type) // @pGetDescriptorHanders - the pointer to the get-descriptor routines set, MUST NOT BE NULL! // @desc_type - the descriptor type static inline fGetDescriptorRoutine_t GetDescriptorHandler( const USBD_DescriptorsTypeDef * pGetDescriptorHanders, eGetDescriptorHandlerType_t desc_type ) { return pGetDescriptorHanders->arrayGetDescriptorRoutines[ desc_type % eGetDescriptorHandlerType_MAX ]; } // @ChooseDescriptorHandler // This function returns the routine address from the @USBD_DescriptorsTypeDef descriptor (@pGetDescriptorHanders) // by the specified type (@desc_type). // @pGetDescriptorHandersSetA - the pointer to the first get-descriptor routines set, can be NULL // @pGetDescriptorHandersSetB - the pointer to the second get-descriptor routines set, can be NULL // @desc_type - the descriptor type // The function chooses the valid non-null handler between two options: either from the first set, // or the second set. // If the @pGetDescriptorHandersSetA is not NULL, and the specified handler is not null, // this handler will be returned. // If the @pGetDescriptorHandersSetA is not NULL, and the specified handler is null, // the function will try to get handler from the @pGetDescriptorHandersSetB. // If the @pGetDescriptorHandersSetA is NULL, or the specified handler in @pGetDescriptorHandersSetA is NULL, // and @pGetDescriptorHandersSetB is not NULL, the function returns the specified handler from // the @pGetDescriptorHandersSetB set without cheching for NULL. // Returns: the first non-null specified handler either from @pGetDescriptorHandersSetA // or pGetDescriptorHandersSetB set. static inline fGetDescriptorRoutine_t ChooseDescriptorHandler( const USBD_DescriptorsTypeDef * pGetDescriptorHandersSetA, const USBD_DescriptorsTypeDef * pGetDescriptorHandersSetB, eGetDescriptorHandlerType_t desc_type ) { fGetDescriptorRoutine_t routine = NULL; if( NULL != pGetDescriptorHandersSetA ) { routine = GetDescriptorHandler( pGetDescriptorHandersSetA, desc_type ); } if( (NULL == routine) && (NULL != pGetDescriptorHandersSetA) ) { routine = GetDescriptorHandler( pGetDescriptorHandersSetB, desc_type ); } return routine; } // @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ // USB Device descriptors structure // for compatibility with option @USBD_GETDESCRIPTORS_ALTMETHOD=1 #define USBD_GETDESCRIPTOR_DEFAULT_HANDLERS_SET // empty #else typedef struct { const uint8_t *(*GetDeviceDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetLangIDStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetManufacturerStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetProductStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetSerialStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetConfigurationStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetInterfaceStrDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetConfigDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetMsOsStringDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetExtCompatIdOsFeatureDescriptor)( USBD_SpeedTypeDef speed , uint16_t *length); const uint8_t *(*GetExtPropertiesOsFeatureDescriptor)(USBD_SpeedTypeDef speed , uint16_t *length); #if (USBD_SUPPORT_USER_STRING == 1) // This routine is optional, it is used directly only ( pDesc->GetUsrStrDescriptor(...) ) const uint8_t *(*GetUsrStrDescriptor)(struct _USBD_HandleTypeDef *pdev ,uint8_t index, uint16_t *length); #endif } USBD_DescriptorsTypeDef; #endif // @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ typedef struct _Device_cb { uint8_t (*Init) (struct _USBD_HandleTypeDef *pdev , uint8_t cfgidx); uint8_t (*DeInit) (struct _USBD_HandleTypeDef *pdev , uint8_t cfgidx); uint8_t (*Error) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum); /* Control Endpoints*/ uint8_t (*Setup) (struct _USBD_HandleTypeDef *pdev , USBD_SetupReqTypedef *req); uint8_t (*EP0_TxSent) (struct _USBD_HandleTypeDef *pdev , size_t * pRollbackBytes ); uint8_t (*EP0_RxReady) (struct _USBD_HandleTypeDef *pdev , size_t * pRollbackBytes ); /* Class Specific Endpoints*/ uint8_t (*DataIn) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum); uint8_t (*DataOut) (struct _USBD_HandleTypeDef *pdev , uint8_t epnum, bool bShortPacketRcvd ); uint8_t (*SOF) (struct _USBD_HandleTypeDef *pdev); const USBD_DescriptorsTypeDef * pDesc; // class-defined GetDescriptor-handlers } USBD_ClassTypeDef; /* 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; #if USBD_GETDESCRIPTORS_ALTMETHOD == 0 USBD_DescriptorsTypeDef *pDesc; #endif #if USBD_CONSTCLASS_IFACE const USBD_ClassTypeDef *pClass; #else USBD_ClassTypeDef *pClass; #endif void *pClassData; #if USBD_CONSTCLASS_IFACE const void *pUserData; #else void *pUserData; #endif 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****/