lib/main/STM32F7/Drivers/STM32F7xx_HAL_Driver/Inc/stm32f7xx_hal_hcd.h

   1 /**
   2   ******************************************************************************
   3   * @file    stm32f7xx_hal_hcd.h
   4   * @author  MCD Application Team
   5   * @brief   Header file of HCD HAL module.
   6   ******************************************************************************
   7   * @attention
   8   *
   9   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
  10   * All rights reserved.</center></h2>
  11   *
  12   * This software component is licensed by ST under BSD 3-Clause license,
  13   * the "License"; You may not use this file except in compliance with the
  14   * License. You may obtain a copy of the License at:
  15   *                        opensource.org/licenses/BSD-3-Clause
  16   *
  17   ******************************************************************************
  18   */
  19
  20 /* Define to prevent recursive inclusion -------------------------------------*/
  21 #ifndef STM32F7xx_HAL_HCD_H
  22 #define STM32F7xx_HAL_HCD_H
  23
  24 #ifdef __cplusplus
  25 extern "C" {
  26 #endif
  27
  28 /* Includes ------------------------------------------------------------------*/
  29 #include "stm32f7xx_ll_usb.h"
  30
  31 #if defined (USB_OTG_FS) || defined (USB_OTG_HS)
  32 /** @addtogroup STM32F7xx_HAL_Driver
  33   * @{
  34   */
  35
  36 /** @addtogroup HCD
  37   * @{
  38   */
  39
  40 /* Exported types ------------------------------------------------------------*/
  41 /** @defgroup HCD_Exported_Types HCD Exported Types
  42   * @{
  43   */
  44
  45 /** @defgroup HCD_Exported_Types_Group1 HCD State Structure definition
  46   * @{
  47   */
  48 typedef enum
  49 {
  50   HAL_HCD_STATE_RESET    = 0x00,
  51   HAL_HCD_STATE_READY    = 0x01,
  52   HAL_HCD_STATE_ERROR    = 0x02,
  53   HAL_HCD_STATE_BUSY     = 0x03,
  54   HAL_HCD_STATE_TIMEOUT  = 0x04
  55 } HCD_StateTypeDef;
  56
  57 typedef USB_OTG_GlobalTypeDef   HCD_TypeDef;
  58 typedef USB_OTG_CfgTypeDef      HCD_InitTypeDef;
  59 typedef USB_OTG_HCTypeDef       HCD_HCTypeDef;
  60 typedef USB_OTG_URBStateTypeDef HCD_URBStateTypeDef;
  61 typedef USB_OTG_HCStateTypeDef  HCD_HCStateTypeDef;
  62 /**
  63   * @}
  64   */
  65
  66 /** @defgroup HCD_Exported_Types_Group2 HCD Handle Structure definition
  67   * @{
  68   */
  69 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
  70 typedef struct __HCD_HandleTypeDef
  71 #else
  72 typedef struct
  73 #endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
  74 {
  75   HCD_TypeDef               *Instance;  /*!< Register base address    */
  76   HCD_InitTypeDef           Init;       /*!< HCD required parameters  */
  77   HCD_HCTypeDef             hc[16];     /*!< Host channels parameters */
  78   HAL_LockTypeDef           Lock;       /*!< HCD peripheral status    */
  79   __IO HCD_StateTypeDef     State;      /*!< HCD communication state  */
  80   __IO  uint32_t            ErrorCode;  /*!< HCD Error code           */
  81   void                      *pData;     /*!< Pointer Stack Handler    */
  82 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
  83   void (* SOFCallback)(struct __HCD_HandleTypeDef *hhcd);                               /*!< USB OTG HCD SOF callback                */
  84   void (* ConnectCallback)(struct __HCD_HandleTypeDef *hhcd);                           /*!< USB OTG HCD Connect callback            */
  85   void (* DisconnectCallback)(struct __HCD_HandleTypeDef *hhcd);                        /*!< USB OTG HCD Disconnect callback         */
  86   void (* PortEnabledCallback)(struct __HCD_HandleTypeDef *hhcd);                       /*!< USB OTG HCD Port Enable callback        */
  87   void (* PortDisabledCallback)(struct __HCD_HandleTypeDef *hhcd);                      /*!< USB OTG HCD Port Disable callback       */
  88   void (* HC_NotifyURBChangeCallback)(struct __HCD_HandleTypeDef *hhcd, uint8_t chnum,
  89                                       HCD_URBStateTypeDef urb_state);                   /*!< USB OTG HCD Host Channel Notify URB Change callback  */
  90
  91   void (* MspInitCallback)(struct __HCD_HandleTypeDef *hhcd);                           /*!< USB OTG HCD Msp Init callback           */
  92   void (* MspDeInitCallback)(struct __HCD_HandleTypeDef *hhcd);                         /*!< USB OTG HCD Msp DeInit callback         */
  93 #endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
  94 } HCD_HandleTypeDef;
  95 /**
  96   * @}
  97   */
  98
  99 /**
 100   * @}
 101   */
 102
 103 /* Exported constants --------------------------------------------------------*/
 104 /** @defgroup HCD_Exported_Constants HCD Exported Constants
 105   * @{
 106   */
 107
 108 /** @defgroup HCD_Speed HCD Speed
 109   * @{
 110   */
 111 #define HCD_SPEED_HIGH               0U
 112 #define HCD_SPEED_LOW                2U
 113 #define HCD_SPEED_FULL               3U
 114 /**
 115   * @}
 116   */
 117
 118 /** @defgroup HCD_PHY_Module HCD PHY Module
 119   * @{
 120   */
 121 #define HCD_PHY_ULPI                 1U
 122 #define HCD_PHY_EMBEDDED             2U
 123 /**
 124   * @}
 125   */
 126
 127 /** @defgroup HCD_Error_Code_definition HCD Error Code definition
 128   * @brief  HCD Error Code definition
 129   * @{
 130   */
 131 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
 132 #define  HAL_HCD_ERROR_INVALID_CALLBACK                        (0x00000010U)    /*!< Invalid Callback error  */
 133 #endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
 134
 135 /**
 136   * @}
 137   */
 138
 139 /**
 140   * @}
 141   */
 142
 143 /* Exported macro ------------------------------------------------------------*/
 144 /** @defgroup HCD_Exported_Macros HCD Exported Macros
 145  *  @brief macros to handle interrupts and specific clock configurations
 146  * @{
 147  */
 148 #define __HAL_HCD_ENABLE(__HANDLE__)                   (void)USB_EnableGlobalInt ((__HANDLE__)->Instance)
 149 #define __HAL_HCD_DISABLE(__HANDLE__)                  (void)USB_DisableGlobalInt ((__HANDLE__)->Instance)
 150
 151 #define __HAL_HCD_GET_FLAG(__HANDLE__, __INTERRUPT__)      ((USB_ReadInterrupts((__HANDLE__)->Instance) & (__INTERRUPT__)) == (__INTERRUPT__))
 152 #define __HAL_HCD_CLEAR_FLAG(__HANDLE__, __INTERRUPT__)    (((__HANDLE__)->Instance->GINTSTS) = (__INTERRUPT__))
 153 #define __HAL_HCD_IS_INVALID_INTERRUPT(__HANDLE__)         (USB_ReadInterrupts((__HANDLE__)->Instance) == 0U)
 154
 155 #define __HAL_HCD_CLEAR_HC_INT(chnum, __INTERRUPT__)  (USBx_HC(chnum)->HCINT = (__INTERRUPT__))
 156 #define __HAL_HCD_MASK_HALT_HC_INT(chnum)             (USBx_HC(chnum)->HCINTMSK &= ~USB_OTG_HCINTMSK_CHHM)
 157 #define __HAL_HCD_UNMASK_HALT_HC_INT(chnum)           (USBx_HC(chnum)->HCINTMSK |= USB_OTG_HCINTMSK_CHHM)
 158 #define __HAL_HCD_MASK_ACK_HC_INT(chnum)              (USBx_HC(chnum)->HCINTMSK &= ~USB_OTG_HCINTMSK_ACKM)
 159 #define __HAL_HCD_UNMASK_ACK_HC_INT(chnum)            (USBx_HC(chnum)->HCINTMSK |= USB_OTG_HCINTMSK_ACKM)
 160 /**
 161   * @}
 162   */
 163
 164 /* Exported functions --------------------------------------------------------*/
 165 /** @addtogroup HCD_Exported_Functions HCD Exported Functions
 166   * @{
 167   */
 168
 169 /** @defgroup HCD_Exported_Functions_Group1 Initialization and de-initialization functions
 170   * @{
 171   */
 172 HAL_StatusTypeDef      HAL_HCD_Init(HCD_HandleTypeDef *hhcd);
 173 HAL_StatusTypeDef      HAL_HCD_DeInit(HCD_HandleTypeDef *hhcd);
 174 HAL_StatusTypeDef      HAL_HCD_HC_Init(HCD_HandleTypeDef *hhcd,
 175                                        uint8_t ch_num,
 176                                        uint8_t epnum,
 177                                        uint8_t dev_address,
 178                                        uint8_t speed,
 179                                        uint8_t ep_type,
 180                                        uint16_t mps);
 181
 182 HAL_StatusTypeDef     HAL_HCD_HC_Halt(HCD_HandleTypeDef *hhcd, uint8_t ch_num);
 183 void                  HAL_HCD_MspInit(HCD_HandleTypeDef *hhcd);
 184 void                  HAL_HCD_MspDeInit(HCD_HandleTypeDef *hhcd);
 185
 186 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
 187 /** @defgroup HAL_HCD_Callback_ID_enumeration_definition HAL USB OTG HCD Callback ID enumeration definition
 188   * @brief  HAL USB OTG HCD Callback ID enumeration definition
 189   * @{
 190   */
 191 typedef enum
 192 {
 193   HAL_HCD_SOF_CB_ID           = 0x01,       /*!< USB HCD SOF callback ID           */
 194   HAL_HCD_CONNECT_CB_ID       = 0x02,       /*!< USB HCD Connect callback ID       */
 195   HAL_HCD_DISCONNECT_CB_ID   = 0x03,       /*!< USB HCD Disconnect callback ID    */
 196   HAL_HCD_PORT_ENABLED_CB_ID   = 0x04,      /*!< USB HCD Port Enable callback ID   */
 197   HAL_HCD_PORT_DISABLED_CB_ID  = 0x05,      /*!< USB HCD Port Disable callback ID  */
 198
 199   HAL_HCD_MSPINIT_CB_ID       = 0x06,       /*!< USB HCD MspInit callback ID       */
 200   HAL_HCD_MSPDEINIT_CB_ID     = 0x07        /*!< USB HCD MspDeInit callback ID     */
 201
 202 } HAL_HCD_CallbackIDTypeDef;
 203 /**
 204   * @}
 205   */
 206
 207 /** @defgroup HAL_HCD_Callback_pointer_definition HAL USB OTG HCD Callback pointer definition
 208   * @brief  HAL USB OTG HCD Callback pointer definition
 209   * @{
 210   */
 211
 212 typedef void (*pHCD_CallbackTypeDef)(HCD_HandleTypeDef *hhcd);                   /*!< pointer to a common USB OTG HCD callback function  */
 213 typedef void (*pHCD_HC_NotifyURBChangeCallbackTypeDef)(HCD_HandleTypeDef *hhcd,
 214                                                        uint8_t epnum,
 215                                                        HCD_URBStateTypeDef urb_state);   /*!< pointer to USB OTG HCD host channel  callback */
 216 /**
 217   * @}
 218   */
 219
 220 HAL_StatusTypeDef HAL_HCD_RegisterCallback(HCD_HandleTypeDef *hhcd, HAL_HCD_CallbackIDTypeDef CallbackID, pHCD_CallbackTypeDef pCallback);
 221 HAL_StatusTypeDef HAL_HCD_UnRegisterCallback(HCD_HandleTypeDef *hhcd, HAL_HCD_CallbackIDTypeDef CallbackID);
 222
 223 HAL_StatusTypeDef HAL_HCD_RegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd, pHCD_HC_NotifyURBChangeCallbackTypeDef pCallback);
 224 HAL_StatusTypeDef HAL_HCD_UnRegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd);
 225 #endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
 226 /**
 227   * @}
 228   */
 229
 230 /* I/O operation functions  ***************************************************/
 231 /** @addtogroup HCD_Exported_Functions_Group2 Input and Output operation functions
 232   * @{
 233   */
 234 HAL_StatusTypeDef       HAL_HCD_HC_SubmitRequest(HCD_HandleTypeDef *hhcd,
 235                                                  uint8_t ch_num,
 236                                                  uint8_t direction,
 237                                                  uint8_t ep_type,
 238                                                  uint8_t token,
 239                                                  uint8_t *pbuff,
 240                                                  uint16_t length,
 241                                                  uint8_t do_ping);
 242
 243 /* Non-Blocking mode: Interrupt */
 244 void             HAL_HCD_IRQHandler(HCD_HandleTypeDef *hhcd);
 245 void             HAL_HCD_SOF_Callback(HCD_HandleTypeDef *hhcd);
 246 void             HAL_HCD_Connect_Callback(HCD_HandleTypeDef *hhcd);
 247 void             HAL_HCD_Disconnect_Callback(HCD_HandleTypeDef *hhcd);
 248 void             HAL_HCD_PortEnabled_Callback(HCD_HandleTypeDef *hhcd);
 249 void             HAL_HCD_PortDisabled_Callback(HCD_HandleTypeDef *hhcd);
 250 void             HAL_HCD_HC_NotifyURBChange_Callback(HCD_HandleTypeDef *hhcd,
 251                                                      uint8_t chnum,
 252                                                      HCD_URBStateTypeDef urb_state);
 253 /**
 254   * @}
 255   */
 256
 257 /* Peripheral Control functions  **********************************************/
 258 /** @addtogroup HCD_Exported_Functions_Group3 Peripheral Control functions
 259   * @{
 260   */
 261 HAL_StatusTypeDef       HAL_HCD_ResetPort(HCD_HandleTypeDef *hhcd);
 262 HAL_StatusTypeDef       HAL_HCD_Start(HCD_HandleTypeDef *hhcd);
 263 HAL_StatusTypeDef       HAL_HCD_Stop(HCD_HandleTypeDef *hhcd);
 264 /**
 265   * @}
 266   */
 267
 268 /* Peripheral State functions  ************************************************/
 269 /** @addtogroup HCD_Exported_Functions_Group4 Peripheral State functions
 270   * @{
 271   */
 272 HCD_StateTypeDef        HAL_HCD_GetState(HCD_HandleTypeDef *hhcd);
 273 HCD_URBStateTypeDef     HAL_HCD_HC_GetURBState(HCD_HandleTypeDef *hhcd, uint8_t chnum);
 274 uint32_t                HAL_HCD_HC_GetXferCount(HCD_HandleTypeDef *hhcd, uint8_t chnum);
 275 HCD_HCStateTypeDef      HAL_HCD_HC_GetState(HCD_HandleTypeDef *hhcd, uint8_t chnum);
 276 uint32_t                HAL_HCD_GetCurrentFrame(HCD_HandleTypeDef *hhcd);
 277 uint32_t                HAL_HCD_GetCurrentSpeed(HCD_HandleTypeDef *hhcd);
 278 /**
 279   * @}
 280   */
 281
 282 /**
 283   * @}
 284   */
 285
 286 /* Private macros ------------------------------------------------------------*/
 287 /** @defgroup HCD_Private_Macros HCD Private Macros
 288  * @{
 289  */
 290
 291 /**
 292   * @}
 293   */
 294
 295 /* Private functions prototypes ----------------------------------------------*/
 296 /** @defgroup HCD_Private_Functions_Prototypes HCD Private Functions Prototypes
 297   * @{
 298   */
 299
 300 /**
 301   * @}
 302   */
 303
 304 /* Private functions ---------------------------------------------------------*/
 305 /** @defgroup HCD_Private_Functions HCD Private Functions
 306   * @{
 307   */
 308
 309 /**
 310   * @}
 311   */
 312
 313 /**
 314   * @}
 315   */
 316
 317 /**
 318   * @}
 319   */
 320 #endif /* defined (USB_OTG_FS) || defined (USB_OTG_HS) */
 321
 322 #ifdef __cplusplus
 323 }
 324 #endif
 325
 326 #endif /* STM32F7xx_HAL_HCD_H */
 327
 328 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/