21 #ifndef STM32F4xx_HAL_HCD_H
22 #define STM32F4xx_HAL_HCD_H
29 #include "stm32f4xx_ll_usb.h"
31 #if defined (USB_OTG_FS) || defined (USB_OTG_HS)
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
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;
69 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
70 typedef struct __HCD_HandleTypeDef
75 HCD_TypeDef *Instance;
79 __IO HCD_StateTypeDef State;
80 __IO uint32_t ErrorCode;
82 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
83 void (* SOFCallback)(
struct __HCD_HandleTypeDef *hhcd);
84 void (* ConnectCallback)(
struct __HCD_HandleTypeDef *hhcd);
85 void (* DisconnectCallback)(
struct __HCD_HandleTypeDef *hhcd);
86 void (* PortEnabledCallback)(
struct __HCD_HandleTypeDef *hhcd);
87 void (* PortDisabledCallback)(
struct __HCD_HandleTypeDef *hhcd);
88 void (* HC_NotifyURBChangeCallback)(
struct __HCD_HandleTypeDef *hhcd, uint8_t chnum,
89 HCD_URBStateTypeDef urb_state);
91 void (* MspInitCallback)(
struct __HCD_HandleTypeDef *hhcd);
92 void (* MspDeInitCallback)(
struct __HCD_HandleTypeDef *hhcd);
111 #define HCD_SPEED_HIGH USBH_HS_SPEED
112 #define HCD_SPEED_FULL USBH_FSLS_SPEED
113 #define HCD_SPEED_LOW USBH_FSLS_SPEED
122 #define HCD_PHY_ULPI 1U
123 #define HCD_PHY_EMBEDDED 2U
132 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
133 #define HAL_HCD_ERROR_INVALID_CALLBACK (0x00000010U)
149 #define __HAL_HCD_ENABLE(__HANDLE__) (void)USB_EnableGlobalInt ((__HANDLE__)->Instance)
150 #define __HAL_HCD_DISABLE(__HANDLE__) (void)USB_DisableGlobalInt ((__HANDLE__)->Instance)
152 #define __HAL_HCD_GET_FLAG(__HANDLE__, __INTERRUPT__) ((USB_ReadInterrupts((__HANDLE__)->Instance) & (__INTERRUPT__)) == (__INTERRUPT__))
153 #define __HAL_HCD_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->GINTSTS) = (__INTERRUPT__))
154 #define __HAL_HCD_IS_INVALID_INTERRUPT(__HANDLE__) (USB_ReadInterrupts((__HANDLE__)->Instance) == 0U)
156 #define __HAL_HCD_CLEAR_HC_INT(chnum, __INTERRUPT__) (USBx_HC(chnum)->HCINT = (__INTERRUPT__))
157 #define __HAL_HCD_MASK_HALT_HC_INT(chnum) (USBx_HC(chnum)->HCINTMSK &= ~USB_OTG_HCINTMSK_CHHM)
158 #define __HAL_HCD_UNMASK_HALT_HC_INT(chnum) (USBx_HC(chnum)->HCINTMSK |= USB_OTG_HCINTMSK_CHHM)
159 #define __HAL_HCD_MASK_ACK_HC_INT(chnum) (USBx_HC(chnum)->HCINTMSK &= ~USB_OTG_HCINTMSK_ACKM)
160 #define __HAL_HCD_UNMASK_ACK_HC_INT(chnum) (USBx_HC(chnum)->HCINTMSK |= USB_OTG_HCINTMSK_ACKM)
176 uint8_t epnum, uint8_t dev_address,
177 uint8_t speed, uint8_t ep_type, uint16_t mps);
180 void HAL_HCD_MspInit(HCD_HandleTypeDef *hhcd);
181 void HAL_HCD_MspDeInit(HCD_HandleTypeDef *hhcd);
183 #if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
190 HAL_HCD_SOF_CB_ID = 0x01,
191 HAL_HCD_CONNECT_CB_ID = 0x02,
192 HAL_HCD_DISCONNECT_CB_ID = 0x03,
193 HAL_HCD_PORT_ENABLED_CB_ID = 0x04,
194 HAL_HCD_PORT_DISABLED_CB_ID = 0x05,
196 HAL_HCD_MSPINIT_CB_ID = 0x06,
197 HAL_HCD_MSPDEINIT_CB_ID = 0x07
199 } HAL_HCD_CallbackIDTypeDef;
209 typedef void (*pHCD_CallbackTypeDef)(HCD_HandleTypeDef *hhcd);
210 typedef void (*pHCD_HC_NotifyURBChangeCallbackTypeDef)(HCD_HandleTypeDef *hhcd,
212 HCD_URBStateTypeDef urb_state);
218 HAL_HCD_CallbackIDTypeDef CallbackID,
219 pHCD_CallbackTypeDef pCallback);
222 HAL_HCD_CallbackIDTypeDef CallbackID);
224 HAL_StatusTypeDef HAL_HCD_RegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd,
225 pHCD_HC_NotifyURBChangeCallbackTypeDef pCallback);
227 HAL_StatusTypeDef HAL_HCD_UnRegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd);
237 HAL_StatusTypeDef HAL_HCD_HC_SubmitRequest(HCD_HandleTypeDef *hhcd, uint8_t ch_num,
238 uint8_t direction, uint8_t ep_type,
239 uint8_t token, uint8_t *pbuff,
240 uint16_t length, uint8_t do_ping);
243 void HAL_HCD_IRQHandler(HCD_HandleTypeDef *hhcd);
244 void HAL_HCD_WKUP_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, uint8_t chnum,
251 HCD_URBStateTypeDef urb_state);
274 HCD_StateTypeDef HAL_HCD_GetState(HCD_HandleTypeDef *hhcd);
275 HCD_URBStateTypeDef HAL_HCD_HC_GetURBState(HCD_HandleTypeDef *hhcd, uint8_t chnum);
276 HCD_HCStateTypeDef HAL_HCD_HC_GetState(HCD_HandleTypeDef *hhcd, uint8_t chnum);
277 uint32_t HAL_HCD_HC_GetXferCount(HCD_HandleTypeDef *hhcd, uint8_t chnum);
278 uint32_t HAL_HCD_GetCurrentFrame(HCD_HandleTypeDef *hhcd);
279 uint32_t HAL_HCD_GetCurrentSpeed(HCD_HandleTypeDef *hhcd);