WebSVN – LedShow – Diff – /trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_hcd.c

 /**
   ******************************************************************************
   * @file    stm32f1xx_hal_hcd.c
   * @author  MCD Application Team
   * @brief   HCD HAL module driver.
   *          This file provides firmware functions to manage the following
   *          functionalities of the USB Peripheral Controller:
   *           + Initialization and de-initialization functions
   *           + IO operation functions
   *           + Peripheral Control functions
   *           + Peripheral State functions
+  *
   @verbatim
   ==============================================================================
                     ##### How to use this driver #####
   ==============================================================================
   [..]
     (#)Declare a HCD_HandleTypeDef handle structure, for example:
        HCD_HandleTypeDef  hhcd;
     (#)Fill parameters of Init structure in HCD handle
     (#)Call HAL_HCD_Init() API to initialize the HCD peripheral (Core, Host core, ...)
     (#)Initialize the HCD low level resources through the HAL_HCD_MspInit() API:
-        (##) Enable the HCD/USB Low Level interface clock using the following macro
+        (##) Enable the HCD/USB Low Level interface clock using the following macros
-             (+++) __HAL_RCC_USB_OTG_FS_CLK_ENABLE()
+             (+++) __HAL_RCC_USB_OTG_FS_CLK_ENABLE();
         (##) Initialize the related GPIO clocks
         (##) Configure HCD pin-out
         (##) Configure HCD NVIC interrupt
     (#)Associate the Upper USB Host stack to the HAL HCD Driver:
   @endverbatim
   ******************************************************************************
   * @attention
+  *
-  * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
+  * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
-  *
-  * Redistribution and use in source and binary forms, with or without modification,
-  * are permitted provided that the following conditions are met:
-  *   1. Redistributions of source code must retain the above copyright notice,
-  *      this list of conditions and the following disclaimer.
-  *   2. Redistributions in binary form must reproduce the above copyright notice,
-  *      this list of conditions and the following disclaimer in the documentation
-  *      and/or other materials provided with the distribution.
-  *   3. Neither the name of STMicroelectronics nor the names of its contributors
-  *      may be used to endorse or promote products derived from this software
-  *      without specific prior written permission.
+  * All rights reserved.</center></h2>
+  *
-  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  * This software component is licensed by ST under BSD 3-Clause license,
-  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+  * the "License"; You may not use this file except in compliance with the
-  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+  * License. You may obtain a copy of the License at:
-  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+  *                        opensource.org/licenses/BSD-3-Clause
+  *
   ******************************************************************************
   */
 /* Includes ------------------------------------------------------------------*/
 #include "stm32f1xx_hal.h"
 /** @addtogroup STM32F1xx_HAL_Driver
   * @{
   */
 #ifdef HAL_HCD_MODULE_ENABLED
-#if defined(STM32F105xC) || defined(STM32F107xC)
+#if defined (USB_OTG_FS)
 /** @defgroup HCD HCD
   * @brief HCD HAL module driver
   * @{
   */
-/* Private types -------------------------------------------------------------*/
+/* Private typedef -----------------------------------------------------------*/
+/* Private define ------------------------------------------------------------*/
+/* Private macro -------------------------------------------------------------*/
 /* Private variables ---------------------------------------------------------*/
-/* Private constants ---------------------------------------------------------*/
-/* Private macros ------------------------------------------------------------*/
-/* Private function ----------------------------------------------------------*/
+/* Private function prototypes -----------------------------------------------*/
 /** @defgroup HCD_Private_Functions HCD Private Functions
   * @{
   */
 static void HCD_HC_IN_IRQHandler(HCD_HandleTypeDef *hhcd, uint8_t chnum);
 static void HCD_HC_OUT_IRQHandler(HCD_HandleTypeDef *hhcd, uint8_t chnum);
 /* Exported functions --------------------------------------------------------*/
 /** @defgroup HCD_Exported_Functions HCD Exported Functions
   * @{
   */
 /** @defgroup HCD_Exported_Functions_Group1 Initialization and de-initialization functions
- *  @brief    Initialization and Configuration functions
+  *  @brief    Initialization and Configuration functions
- *
+  *
 @verbatim
  ===============================================================================
           ##### Initialization and de-initialization functions #####
  ===============================================================================
     [..]  This section provides functions allowing to:
 @endverbatim
   * @{
   */
 /**
-  * @brief  Initialize the host driver
+  * @brief  Initialize the host driver.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_Init(HCD_HandleTypeDef *hhcd)
 {
+  USB_OTG_GlobalTypeDef *USBx;
   /* Check the HCD handle allocation */
-  if(hhcd == NULL)
+  if (hhcd == NULL)
+  {
     return HAL_ERROR;
+  }
   /* Check the parameters */
   assert_param(IS_HCD_ALL_INSTANCE(hhcd->Instance));
+  USBx = hhcd->Instance;
-  if(hhcd->State == HAL_HCD_STATE_RESET)
+  if (hhcd->State == HAL_HCD_STATE_RESET)
   {
     /* Allocate lock resource and initialize it */
     hhcd->Lock = HAL_UNLOCKED;
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+    hhcd->SOFCallback = HAL_HCD_SOF_Callback;
+    hhcd->ConnectCallback = HAL_HCD_Connect_Callback;
+    hhcd->DisconnectCallback = HAL_HCD_Disconnect_Callback;
+    hhcd->PortEnabledCallback = HAL_HCD_PortEnabled_Callback;
+    hhcd->PortDisabledCallback = HAL_HCD_PortDisabled_Callback;
+    hhcd->HC_NotifyURBChangeCallback = HAL_HCD_HC_NotifyURBChange_Callback;
+    if (hhcd->MspInitCallback == NULL)
+    {
+      hhcd->MspInitCallback = HAL_HCD_MspInit;
+    }
+    /* Init the low level hardware */
+    hhcd->MspInitCallback(hhcd);
+#else
     /* Init the low level hardware : GPIO, CLOCK, NVIC... */
     HAL_HCD_MspInit(hhcd);
+#endif /* (USE_HAL_HCD_REGISTER_CALLBACKS) */
+  }
   hhcd->State = HAL_HCD_STATE_BUSY;
+  /* Disable DMA mode for FS instance */
+  if ((USBx->CID & (0x1U << 8)) == 0U)
+  {
+    hhcd->Init.dma_enable = 0U;
+  }
   /* Disable the Interrupts */
   __HAL_HCD_DISABLE(hhcd);
   /* Init the Core (common init.) */
-  USB_CoreInit(hhcd->Instance, hhcd->Init);
+  (void)USB_CoreInit(hhcd->Instance, hhcd->Init);
   /* Force Host Mode*/
-  USB_SetCurrentMode(hhcd->Instance , USB_HOST_MODE);
+  (void)USB_SetCurrentMode(hhcd->Instance, USB_HOST_MODE);
   /* Init Host */
-  USB_HostInit(hhcd->Instance, hhcd->Init);
+  (void)USB_HostInit(hhcd->Instance, hhcd->Init);
-  hhcd->State= HAL_HCD_STATE_READY;
+  hhcd->State = HAL_HCD_STATE_READY;
   return HAL_OK;
+}
 /**
-  * @brief  Initialize a host channel
+  * @brief  Initialize a host channel.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  ch_num: Channel number.
+  * @param  ch_num Channel number.
   *         This parameter can be a value from 1 to 15
-  * @param  epnum: Endpoint number.
+  * @param  epnum Endpoint number.
   *          This parameter can be a value from 1 to 15
-  * @param  dev_address : Current device address
+  * @param  dev_address Current device address
   *          This parameter can be a value from 0 to 255
-  * @param  speed: Current device speed.
+  * @param  speed Current device speed.
   *          This parameter can be one of these values:
   *            HCD_SPEED_FULL: Full speed mode,
   *            HCD_SPEED_LOW: Low speed mode
-  * @param  ep_type: Endpoint Type.
+  * @param  ep_type Endpoint Type.
   *          This parameter can be one of these values:
   *            EP_TYPE_CTRL: Control type,
   *            EP_TYPE_ISOC: Isochronous type,
   *            EP_TYPE_BULK: Bulk type,
   *            EP_TYPE_INTR: Interrupt type
-  * @param  mps: Max Packet Size.
+  * @param  mps Max Packet Size.
   *          This parameter can be a value from 0 to32K
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_HC_Init(HCD_HandleTypeDef *hhcd,
                                   uint8_t ch_num,
                                   uint8_t dev_address,
                                   uint8_t speed,
                                   uint8_t ep_type,
                                   uint16_t mps)
+{
-  HAL_StatusTypeDef status = HAL_OK;
+  HAL_StatusTypeDef status;
   __HAL_LOCK(hhcd);
+  hhcd->hc[ch_num].do_ping = 0U;
   hhcd->hc[ch_num].dev_addr = dev_address;
   hhcd->hc[ch_num].max_packet = mps;
   hhcd->hc[ch_num].ch_num = ch_num;
   hhcd->hc[ch_num].ep_type = ep_type;
   hhcd->hc[ch_num].ep_num = epnum & 0x7FU;
+  if ((epnum & 0x80U) == 0x80U)
+  {
+    hhcd->hc[ch_num].ep_is_in = 1U;
+  }
+  else
+  {
-  hhcd->hc[ch_num].ep_is_in = ((epnum & 0x80U) == 0x80U);
+    hhcd->hc[ch_num].ep_is_in = 0U;
+  }
   hhcd->hc[ch_num].speed = speed;
   status =  USB_HC_Init(hhcd->Instance,
                         ch_num,
                         epnum,
                         dev_address,
                         speed,
                         ep_type,
                         mps);
   __HAL_UNLOCK(hhcd);
   return status;
+}
 /**
-  * @brief  Halt a host channel
+  * @brief  Halt a host channel.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  ch_num: Channel number.
+  * @param  ch_num Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval HAL status
   */
-HAL_StatusTypeDef HAL_HCD_HC_Halt(HCD_HandleTypeDef *hhcd,
+HAL_StatusTypeDef HAL_HCD_HC_Halt(HCD_HandleTypeDef *hhcd, uint8_t ch_num)
-                                  uint8_t ch_num)
+{
+  HAL_StatusTypeDef status = HAL_OK;
   __HAL_LOCK(hhcd);
-  USB_HC_Halt(hhcd->Instance, ch_num);
+  (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
   __HAL_UNLOCK(hhcd);
-  return HAL_OK;
+  return status;
+}
 /**
-  * @brief  DeInitialize the host driver
+  * @brief  DeInitialize the host driver.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_DeInit(HCD_HandleTypeDef *hhcd)
+{
   /* Check the HCD handle allocation */
-  if(hhcd == NULL)
+  if (hhcd == NULL)
+  {
     return HAL_ERROR;
+  }
   hhcd->State = HAL_HCD_STATE_BUSY;
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+  if (hhcd->MspDeInitCallback == NULL)
+  {
+    hhcd->MspDeInitCallback = HAL_HCD_MspDeInit; /* Legacy weak MspDeInit  */
+  }
   /* DeInit the low level hardware */
+  hhcd->MspDeInitCallback(hhcd);
+#else
+  /* DeInit the low level hardware: CLOCK, NVIC.*/
   HAL_HCD_MspDeInit(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
   __HAL_HCD_DISABLE(hhcd);
   hhcd->State = HAL_HCD_STATE_RESET;
   return HAL_OK;
+}
 /**
-  * @brief  Initializes the HCD MSP.
+  * @brief  Initialize the HCD MSP.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 __weak void  HAL_HCD_MspInit(HCD_HandleTypeDef *hhcd)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_MspInit could be implemented in the user file
    */
+}
 /**
-  * @brief  DeInitializes HCD MSP.
+  * @brief  DeInitialize the HCD MSP.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 __weak void  HAL_HCD_MspDeInit(HCD_HandleTypeDef *hhcd)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_MspDeInit could be implemented in the user file
    */
+}
 /**
   * @}
   */
-/** @defgroup HCD_Exported_Functions_Group2 IO operation functions
+/** @defgroup HCD_Exported_Functions_Group2 Input and Output operation functions
   *  @brief   HCD IO operation functions
+  *
 @verbatim
  ===============================================================================
                       ##### IO operation functions #####
  ===============================================================================
-    This subsection provides a set of functions allowing to manage the USB Host Data
+ [..] This subsection provides a set of functions allowing to manage the USB Host Data
     Transfer
 @endverbatim
   * @{
   */
 /**
-  * @brief  Submit a new URB for processing
+  * @brief  Submit a new URB for processing.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  ch_num: Channel number.
+  * @param  ch_num Channel number.
   *         This parameter can be a value from 1 to 15
-  * @param  direction: Channel number.
+  * @param  direction Channel number.
   *          This parameter can be one of these values:
   *           0 : Output / 1 : Input
-  * @param  ep_type: Endpoint Type.
+  * @param  ep_type Endpoint Type.
   *          This parameter can be one of these values:
   *            EP_TYPE_CTRL: Control type/
   *            EP_TYPE_ISOC: Isochronous type/
   *            EP_TYPE_BULK: Bulk type/
   *            EP_TYPE_INTR: Interrupt type/
-  * @param  token: Endpoint Type.
+  * @param  token Endpoint Type.
   *          This parameter can be one of these values:
   *            0: HC_PID_SETUP / 1: HC_PID_DATA1
-  * @param  pbuff: pointer to URB data
+  * @param  pbuff pointer to URB data
-  * @param  length: Length of URB data
+  * @param  length Length of URB data
-  * @param  do_ping: activate do ping protocol (for high speed only).
+  * @param  do_ping activate do ping protocol (for high speed only).
   *          This parameter can be one of these values:
   *           0 : do ping inactive / 1 : do ping active
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_HC_SubmitRequest(HCD_HandleTypeDef *hhcd,
                                            uint8_t ch_num,
                                            uint8_t direction,
                                            uint8_t ep_type,
                                            uint8_t token,
-                                           uint8_t* pbuff,
+                                           uint8_t *pbuff,
                                            uint16_t length,
                                            uint8_t do_ping)
+{
   hhcd->hc[ch_num].ep_is_in = direction;
   hhcd->hc[ch_num].ep_type  = ep_type;
-  if(token == 0U)
+  if (token == 0U)
+  {
     hhcd->hc[ch_num].data_pid = HC_PID_SETUP;
+    hhcd->hc[ch_num].do_ping = do_ping;
+  }
   else
+  {
     hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+  }
   /* Manage Data Toggle */
-  switch(ep_type)
+  switch (ep_type)
+  {
-  case EP_TYPE_CTRL:
+    case EP_TYPE_CTRL:
-    if((token == 1U) && (direction == 0U)) /*send data */
+      if ((token == 1U) && (direction == 0U)) /*send data */
-    {
-      if (length == 0U)
-      { /* For Status OUT stage, Length==0, Status Out PID = 1 */
-        hhcd->hc[ch_num].toggle_out = 1U;
-      }
-      /* Set the Data Toggle bit as per the Flag */
-      if ( hhcd->hc[ch_num].toggle_out == 0U)
-      { /* Put the PID 0 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
-      }
-      else
-      { /* Put the PID 1 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
-      }
-      if(hhcd->hc[ch_num].urb_state  != URB_NOTREADY)
+      {
-        hhcd->hc[ch_num].do_ping = do_ping;
+        if (length == 0U)
-      }
+        {
+          /* For Status OUT stage, Length==0, Status Out PID = 1 */
-    }
+          hhcd->hc[ch_num].toggle_out = 1U;
-    break;
+        }
-  case EP_TYPE_BULK:
-    if(direction == 0U)
-    {
-      /* Set the Data Toggle bit as per the Flag */
+        /* Set the Data Toggle bit as per the Flag */
-      if ( hhcd->hc[ch_num].toggle_out == 0U)
+        if (hhcd->hc[ch_num].toggle_out == 0U)
+        {
-      { /* Put the PID 0 */
+          /* Put the PID 0 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
-      }
+        }
-      else
+        else
+        {
-      { /* Put the PID 1 */
+          /* Put the PID 1 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
-      }
+        }
-      if(hhcd->hc[ch_num].urb_state  != URB_NOTREADY)
-      {
-        hhcd->hc[ch_num].do_ping = do_ping;
+      }
-    }
+      break;
-    else
-    {
+    case EP_TYPE_BULK:
-      if( hhcd->hc[ch_num].toggle_in == 0U)
+      if (direction == 0U)
+      {
+        /* Set the Data Toggle bit as per the Flag */
+        if (hhcd->hc[ch_num].toggle_out == 0U)
+        {
+          /* Put the PID 0 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+        }
+        else
+        {
+          /* Put the PID 1 */
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+        }
+      }
       else
+      {
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+        if (hhcd->hc[ch_num].toggle_in == 0U)
-      }
+        {
-    }
-    break;
-  case EP_TYPE_INTR:
-    if(direction == 0U)
-    {
-      /* Set the Data Toggle bit as per the Flag */
-      if ( hhcd->hc[ch_num].toggle_out == 0U)
-      { /* Put the PID 0 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
-      }
+        }
-      else
+        else
-      { /* Put the PID 1 */
+        {
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+        }
+      }
-    }
-    else
+      break;
-    {
+    case EP_TYPE_INTR:
-      if( hhcd->hc[ch_num].toggle_in == 0U)
+      if (direction == 0U)
+      {
+        /* Set the Data Toggle bit as per the Flag */
+        if (hhcd->hc[ch_num].toggle_out == 0U)
+        {
+          /* Put the PID 0 */
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+        }
+        else
+        {
+          /* Put the PID 1 */
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+        }
+      }
       else
+      {
+        if (hhcd->hc[ch_num].toggle_in == 0U)
+        {
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+        }
+        else
+        {
-        hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+          hhcd->hc[ch_num].data_pid = HC_PID_DATA1;
+        }
+      }
-    }
-    break;
+      break;
-  case EP_TYPE_ISOC:
+    case EP_TYPE_ISOC:
-    hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+      hhcd->hc[ch_num].data_pid = HC_PID_DATA0;
+      break;
+    default:
-    break;
+      break;
+  }
   hhcd->hc[ch_num].xfer_buff = pbuff;
   hhcd->hc[ch_num].xfer_len  = length;
   hhcd->hc[ch_num].urb_state = URB_IDLE;
   hhcd->hc[ch_num].xfer_count = 0U;
   hhcd->hc[ch_num].ch_num = ch_num;
   hhcd->hc[ch_num].state = HC_IDLE;
-  return USB_HC_StartXfer(hhcd->Instance, &(hhcd->hc[ch_num]));
+  return USB_HC_StartXfer(hhcd->Instance, &hhcd->hc[ch_num]);
+}
 /**
-  * @brief  handle HCD interrupt request.
+  * @brief  Handle HCD interrupt request.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 void HAL_HCD_IRQHandler(HCD_HandleTypeDef *hhcd)
+{
   USB_OTG_GlobalTypeDef *USBx = hhcd->Instance;
+  uint32_t USBx_BASE = (uint32_t)USBx;
-  uint32_t index = 0U, interrupt = 0U;
+  uint32_t i, interrupt;
-  /* ensure that we are in device mode */
+  /* Ensure that we are in device mode */
   if (USB_GetMode(hhcd->Instance) == USB_OTG_MODE_HOST)
+  {
     /* Avoid spurious interrupt */
-    if(__HAL_HCD_IS_INVALID_INTERRUPT(hhcd))
+    if (__HAL_HCD_IS_INVALID_INTERRUPT(hhcd))
+    {
       return;
+    }
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_PXFR_INCOMPISOOUT))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_PXFR_INCOMPISOOUT))
+    {
-     /* Incorrect mode, acknowledge the interrupt */
+      /* Incorrect mode, acknowledge the interrupt */
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_PXFR_INCOMPISOOUT);
+    }
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_IISOIXFR))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_IISOIXFR))
+    {
-     /* Incorrect mode, acknowledge the interrupt */
+      /* Incorrect mode, acknowledge the interrupt */
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_IISOIXFR);
+    }
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_PTXFE))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_PTXFE))
+    {
-     /* Incorrect mode, acknowledge the interrupt */
+      /* Incorrect mode, acknowledge the interrupt */
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_PTXFE);
+    }
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_MMIS))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_MMIS))
+    {
-     /* Incorrect mode, acknowledge the interrupt */
+      /* Incorrect mode, acknowledge the interrupt */
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_MMIS);
+    }
     /* Handle Host Disconnect Interrupts */
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_DISCINT))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_DISCINT))
+    {
-      /* Cleanup HPRT */
-      USBx_HPRT0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |\
-        USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG );
-      /* Handle Host Port Interrupts */
-      HAL_HCD_Disconnect_Callback(hhcd);
-      USB_InitFSLSPClkSel(hhcd->Instance ,HCFG_48_MHZ);
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_DISCINT);
+      if ((USBx_HPRT0 & USB_OTG_HPRT_PCSTS) == 0U)
+      {
+        /* Handle Host Port Disconnect Interrupt */
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+        hhcd->DisconnectCallback(hhcd);
+#else
+        HAL_HCD_Disconnect_Callback(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+        (void)USB_InitFSLSPClkSel(hhcd->Instance, HCFG_48_MHZ);
+      }
+    }
     /* Handle Host Port Interrupts */
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_HPRTINT))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_HPRTINT))
+    {
-      HCD_Port_IRQHandler (hhcd);
+      HCD_Port_IRQHandler(hhcd);
+    }
-    /* Handle Host SOF Interrupts */
+    /* Handle Host SOF Interrupt */
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_SOF))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_SOF))
+    {
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+      hhcd->SOFCallback(hhcd);
+#else
       HAL_HCD_SOF_Callback(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_SOF);
+    }
-    /* Handle Host channel Interrupts */
+    /* Handle Host channel Interrupt */
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_HCINT))
+    if (__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_HCINT))
+    {
       interrupt = USB_HC_ReadInterrupt(hhcd->Instance);
-      for (index = 0U; index < hhcd->Init.Host_channels ; index++)
+      for (i = 0U; i < hhcd->Init.Host_channels; i++)
+      {
-        if (interrupt & (1 << index))
+        if ((interrupt & (1UL << (i & 0xFU))) != 0U)
+        {
-          if ((USBx_HC(index)->HCCHAR) &  USB_OTG_HCCHAR_EPDIR)
+          if ((USBx_HC(i)->HCCHAR & USB_OTG_HCCHAR_EPDIR) == USB_OTG_HCCHAR_EPDIR)
+          {
-            HCD_HC_IN_IRQHandler (hhcd, index);
+            HCD_HC_IN_IRQHandler(hhcd, (uint8_t)i);
+          }
           else
+          {
-            HCD_HC_OUT_IRQHandler (hhcd, index);
+            HCD_HC_OUT_IRQHandler(hhcd, (uint8_t)i);
+          }
+        }
+      }
       __HAL_HCD_CLEAR_FLAG(hhcd, USB_OTG_GINTSTS_HCINT);
     }
     /* Handle Rx Queue Level Interrupts */
-    if(__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_RXFLVL))
+    if ((__HAL_HCD_GET_FLAG(hhcd, USB_OTG_GINTSTS_RXFLVL)) != 0U)
+    {
       USB_MASK_INTERRUPT(hhcd->Instance, USB_OTG_GINTSTS_RXFLVL);
-      HCD_RXQLVL_IRQHandler (hhcd);
+      HCD_RXQLVL_IRQHandler(hhcd);
       USB_UNMASK_INTERRUPT(hhcd->Instance, USB_OTG_GINTSTS_RXFLVL);
+    }
+  }
+}
+/**
+  * @brief  Handles HCD Wakeup interrupt request.
+  * @param  hhcd HCD handle
+  * @retval HAL status
+  */
+void HAL_HCD_WKUP_IRQHandler(HCD_HandleTypeDef *hhcd)
+{
+  UNUSED(hhcd);
+}
 /**
   * @brief  SOF callback.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 __weak void HAL_HCD_SOF_Callback(HCD_HandleTypeDef *hhcd)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_SOF_Callback could be implemented in the user file
    */
+}
 /**
-  * @brief Connexion Event callback.
+  * @brief Connection Event callback.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 __weak void HAL_HCD_Connect_Callback(HCD_HandleTypeDef *hhcd)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_Connect_Callback could be implemented in the user file
    */
+}
 /**
-  * @brief  Disonnection Event callback.
+  * @brief  Disconnection Event callback.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
 __weak void HAL_HCD_Disconnect_Callback(HCD_HandleTypeDef *hhcd)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_Disconnect_Callback could be implemented in the user file
    */
 }
+/**
+  * @brief  Port Enabled  Event callback.
+  * @param  hhcd HCD handle
+  * @retval None
+  */
+__weak void HAL_HCD_PortEnabled_Callback(HCD_HandleTypeDef *hhcd)
+{
+  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hhcd);
+  /* NOTE : This function should not be modified, when the callback is needed,
+            the HAL_HCD_Disconnect_Callback could be implemented in the user file
+   */
+}
+/**
+  * @brief  Port Disabled  Event callback.
+  * @param  hhcd HCD handle
+  * @retval None
+  */
+__weak void HAL_HCD_PortDisabled_Callback(HCD_HandleTypeDef *hhcd)
+{
+  /* Prevent unused argument(s) compilation warning */
+  UNUSED(hhcd);
+  /* NOTE : This function should not be modified, when the callback is needed,
+            the HAL_HCD_Disconnect_Callback could be implemented in the user file
+   */
+}
 /**
   * @brief  Notify URB state change callback.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @param  urb_state:
   *          This parameter can be one of these values:
   *            URB_IDLE/
   *            URB_DONE/
   *            URB_NOTREADY/
   *            URB_NYET/
   *            URB_ERROR/
   *            URB_STALL/
   * @retval None
   */
 __weak void HAL_HCD_HC_NotifyURBChange_Callback(HCD_HandleTypeDef *hhcd, uint8_t chnum, HCD_URBStateTypeDef urb_state)
+{
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hhcd);
   UNUSED(chnum);
   UNUSED(urb_state);
-  /* NOTE : This function Should not be modified, when the callback is needed,
+  /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_HCD_HC_NotifyURBChange_Callback could be implemented in the user file
    */
+}
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+/**
+  * @brief  Register a User USB HCD Callback
+  *         To be used instead of the weak predefined callback
+  * @param  hhcd USB HCD handle
+  * @param  CallbackID ID of the callback to be registered
+  *         This parameter can be one of the following values:
+  *          @arg @ref HAL_HCD_SOF_CB_ID USB HCD SOF callback ID
+  *          @arg @ref HAL_HCD_CONNECT_CB_ID USB HCD Connect callback ID
+  *          @arg @ref HAL_HCD_DISCONNECT_CB_ID OTG HCD Disconnect callback ID
+  *          @arg @ref HAL_HCD_PORT_ENABLED_CB_ID USB HCD Port Enable callback ID
+  *          @arg @ref HAL_HCD_PORT_DISABLED_CB_ID USB HCD Port Disable callback ID
+  *          @arg @ref HAL_HCD_MSPINIT_CB_ID MspDeInit callback ID
+  *          @arg @ref HAL_HCD_MSPDEINIT_CB_ID MspDeInit callback ID
+  * @param  pCallback pointer to the Callback function
+  * @retval HAL status
+  */
+HAL_StatusTypeDef HAL_HCD_RegisterCallback(HCD_HandleTypeDef *hhcd,
+                                           HAL_HCD_CallbackIDTypeDef CallbackID,
+                                           pHCD_CallbackTypeDef pCallback)
+{
+  HAL_StatusTypeDef status = HAL_OK;
+  if (pCallback == NULL)
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    return HAL_ERROR;
+  }
+  /* Process locked */
+  __HAL_LOCK(hhcd);
+  if (hhcd->State == HAL_HCD_STATE_READY)
+  {
+    switch (CallbackID)
+    {
+      case HAL_HCD_SOF_CB_ID :
+        hhcd->SOFCallback = pCallback;
+        break;
+      case HAL_HCD_CONNECT_CB_ID :
+        hhcd->ConnectCallback = pCallback;
+        break;
+      case HAL_HCD_DISCONNECT_CB_ID :
+        hhcd->DisconnectCallback = pCallback;
+        break;
+      case HAL_HCD_PORT_ENABLED_CB_ID :
+        hhcd->PortEnabledCallback = pCallback;
+        break;
+      case HAL_HCD_PORT_DISABLED_CB_ID :
+        hhcd->PortDisabledCallback = pCallback;
+        break;
+      case HAL_HCD_MSPINIT_CB_ID :
+        hhcd->MspInitCallback = pCallback;
+        break;
+      case HAL_HCD_MSPDEINIT_CB_ID :
+        hhcd->MspDeInitCallback = pCallback;
+        break;
+      default :
+        /* Update the error code */
+        hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+        /* Return error status */
+        status =  HAL_ERROR;
+        break;
+    }
+  }
+  else if (hhcd->State == HAL_HCD_STATE_RESET)
+  {
+    switch (CallbackID)
+    {
+      case HAL_HCD_MSPINIT_CB_ID :
+        hhcd->MspInitCallback = pCallback;
+        break;
+      case HAL_HCD_MSPDEINIT_CB_ID :
+        hhcd->MspDeInitCallback = pCallback;
+        break;
+      default :
+        /* Update the error code */
+        hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+        /* Return error status */
+        status =  HAL_ERROR;
+        break;
+    }
+  }
+  else
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    /* Return error status */
+    status =  HAL_ERROR;
+  }
+  /* Release Lock */
+  __HAL_UNLOCK(hhcd);
+  return status;
+}
+/**
+  * @brief  Unregister an USB HCD Callback
+  *         USB HCD callback is redirected to the weak predefined callback
+  * @param  hhcd USB HCD handle
+  * @param  CallbackID ID of the callback to be unregistered
+  *         This parameter can be one of the following values:
+  *          @arg @ref HAL_HCD_SOF_CB_ID USB HCD SOF callback ID
+  *          @arg @ref HAL_HCD_CONNECT_CB_ID USB HCD Connect callback ID
+  *          @arg @ref HAL_HCD_DISCONNECT_CB_ID OTG HCD Disconnect callback ID
+  *          @arg @ref HAL_HCD_PORT_ENABLED_CB_ID USB HCD Port Enabled callback ID
+  *          @arg @ref HAL_HCD_PORT_DISABLED_CB_ID USB HCD Port Disabled callback ID
+  *          @arg @ref HAL_HCD_MSPINIT_CB_ID MspDeInit callback ID
+  *          @arg @ref HAL_HCD_MSPDEINIT_CB_ID MspDeInit callback ID
+  * @retval HAL status
+  */
+HAL_StatusTypeDef HAL_HCD_UnRegisterCallback(HCD_HandleTypeDef *hhcd, HAL_HCD_CallbackIDTypeDef CallbackID)
+{
+  HAL_StatusTypeDef status = HAL_OK;
+  /* Process locked */
+  __HAL_LOCK(hhcd);
+  /* Setup Legacy weak Callbacks  */
+  if (hhcd->State == HAL_HCD_STATE_READY)
+  {
+    switch (CallbackID)
+    {
+      case HAL_HCD_SOF_CB_ID :
+        hhcd->SOFCallback = HAL_HCD_SOF_Callback;
+        break;
+      case HAL_HCD_CONNECT_CB_ID :
+        hhcd->ConnectCallback = HAL_HCD_Connect_Callback;
+        break;
+      case HAL_HCD_DISCONNECT_CB_ID :
+        hhcd->DisconnectCallback = HAL_HCD_Disconnect_Callback;
+        break;
+      case HAL_HCD_PORT_ENABLED_CB_ID :
+        hhcd->PortEnabledCallback = HAL_HCD_PortEnabled_Callback;
+        break;
+      case HAL_HCD_PORT_DISABLED_CB_ID :
+        hhcd->PortDisabledCallback = HAL_HCD_PortDisabled_Callback;
+        break;
+      case HAL_HCD_MSPINIT_CB_ID :
+        hhcd->MspInitCallback = HAL_HCD_MspInit;
+        break;
+      case HAL_HCD_MSPDEINIT_CB_ID :
+        hhcd->MspDeInitCallback = HAL_HCD_MspDeInit;
+        break;
+      default :
+        /* Update the error code */
+        hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+        /* Return error status */
+        status =  HAL_ERROR;
+        break;
+    }
+  }
+  else if (hhcd->State == HAL_HCD_STATE_RESET)
+  {
+    switch (CallbackID)
+    {
+      case HAL_HCD_MSPINIT_CB_ID :
+        hhcd->MspInitCallback = HAL_HCD_MspInit;
+        break;
+      case HAL_HCD_MSPDEINIT_CB_ID :
+        hhcd->MspDeInitCallback = HAL_HCD_MspDeInit;
+        break;
+      default :
+        /* Update the error code */
+        hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+        /* Return error status */
+        status =  HAL_ERROR;
+        break;
+    }
+  }
+  else
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    /* Return error status */
+    status =  HAL_ERROR;
+  }
+  /* Release Lock */
+  __HAL_UNLOCK(hhcd);
+  return status;
+}
+/**
+  * @brief  Register USB HCD Host Channel Notify URB Change Callback
+  *         To be used instead of the weak HAL_HCD_HC_NotifyURBChange_Callback() predefined callback
+  * @param  hhcd HCD handle
+  * @param  pCallback pointer to the USB HCD Host Channel Notify URB Change Callback function
+  * @retval HAL status
+  */
+HAL_StatusTypeDef HAL_HCD_RegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd,
+                                                             pHCD_HC_NotifyURBChangeCallbackTypeDef pCallback)
+{
+  HAL_StatusTypeDef status = HAL_OK;
+  if (pCallback == NULL)
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    return HAL_ERROR;
+  }
+  /* Process locked */
+  __HAL_LOCK(hhcd);
+  if (hhcd->State == HAL_HCD_STATE_READY)
+  {
+    hhcd->HC_NotifyURBChangeCallback = pCallback;
+  }
+  else
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    /* Return error status */
+    status =  HAL_ERROR;
+  }
+  /* Release Lock */
+  __HAL_UNLOCK(hhcd);
+  return status;
+}
+/**
+  * @brief  Unregister the USB HCD Host Channel Notify URB Change Callback
+  *         USB HCD Host Channel Notify URB Change Callback is redirected to the weak HAL_HCD_HC_NotifyURBChange_Callback() predefined callback
+  * @param  hhcd HCD handle
+  * @retval HAL status
+  */
+HAL_StatusTypeDef HAL_HCD_UnRegisterHC_NotifyURBChangeCallback(HCD_HandleTypeDef *hhcd)
+{
+  HAL_StatusTypeDef status = HAL_OK;
+  /* Process locked */
+  __HAL_LOCK(hhcd);
+  if (hhcd->State == HAL_HCD_STATE_READY)
+  {
+    hhcd->HC_NotifyURBChangeCallback = HAL_HCD_HC_NotifyURBChange_Callback; /* Legacy weak DataOutStageCallback  */
+  }
+  else
+  {
+    /* Update the error code */
+    hhcd->ErrorCode |= HAL_HCD_ERROR_INVALID_CALLBACK;
+    /* Return error status */
+    status =  HAL_ERROR;
+  }
+  /* Release Lock */
+  __HAL_UNLOCK(hhcd);
+  return status;
+}
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
 /**
   * @}
   */
 /** @defgroup HCD_Exported_Functions_Group3 Peripheral Control functions
- *  @brief   management functions
+  *  @brief   Management functions
- *
+  *
 @verbatim
  ===============================================================================
                       ##### Peripheral Control functions #####
  ===============================================================================
     [..]
 @endverbatim
   * @{
   */
 /**
-  * @brief  Start the host driver
+  * @brief  Start the host driver.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_Start(HCD_HandleTypeDef *hhcd)
+{
   __HAL_LOCK(hhcd);
   __HAL_HCD_ENABLE(hhcd);
-  USB_DriveVbus(hhcd->Instance, 1U);
+  (void)USB_DriveVbus(hhcd->Instance, 1U);
   __HAL_UNLOCK(hhcd);
   return HAL_OK;
+}
 /**
-  * @brief  Stop the host driver
+  * @brief  Stop the host driver.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_Stop(HCD_HandleTypeDef *hhcd)
+{
   __HAL_LOCK(hhcd);
-  USB_StopHost(hhcd->Instance);
+  (void)USB_StopHost(hhcd->Instance);
   __HAL_UNLOCK(hhcd);
   return HAL_OK;
+}
 /**
-  * @brief  Reset the host port
+  * @brief  Reset the host port.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL status
   */
 HAL_StatusTypeDef HAL_HCD_ResetPort(HCD_HandleTypeDef *hhcd)
+{
   return (USB_ResetPort(hhcd->Instance));
 /**
   * @}
   */
 /** @defgroup HCD_Exported_Functions_Group4 Peripheral State functions
- *  @brief   Peripheral State functions
+  *  @brief   Peripheral State functions
- *
+  *
 @verbatim
  ===============================================================================
                       ##### Peripheral State functions #####
  ===============================================================================
     [..]
     This subsection permits to get in run-time the status of the peripheral
     and the data flow.
 @endverbatim
   * @{
   */
 /**
-  * @brief  Return the HCD handle state
+  * @brief  Return the HCD handle state.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval HAL state
   */
 HCD_StateTypeDef HAL_HCD_GetState(HCD_HandleTypeDef *hhcd)
+{
   return hhcd->State;
+}
 /**
-  * @brief  Return  URB state for a channel
+  * @brief  Return  URB state for a channel.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval URB state.
   *          This parameter can be one of these values:
   *            URB_IDLE/
   *            URB_DONE/
   *            URB_NOTREADY/
   *            URB_NYET/
   *            URB_ERROR/
-  *            URB_STALL/
+  *            URB_STALL
   */
 HCD_URBStateTypeDef HAL_HCD_HC_GetURBState(HCD_HandleTypeDef *hhcd, uint8_t chnum)
+{
   return hhcd->hc[chnum].urb_state;
+}
 /**
-  * @brief  Return the last host transfer size
+  * @brief  Return the last host transfer size.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval last transfer size in byte
   */
 uint32_t HAL_HCD_HC_GetXferCount(HCD_HandleTypeDef *hhcd, uint8_t chnum)
+{
   return hhcd->hc[chnum].xfer_count;
+}
 /**
-  * @brief  Return the Host Channel state
+  * @brief  Return the Host Channel state.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval Host channel state
-  *          This parameter can be one of the these values:
+  *          This parameter can be one of these values:
   *            HC_IDLE/
   *            HC_XFRC/
   *            HC_HALTED/
   *            HC_NYET/
   *            HC_NAK/
   *            HC_STALL/
   *            HC_XACTERR/
   *            HC_BBLERR/
-  *            HC_DATATGLERR/
+  *            HC_DATATGLERR
   */
 HCD_HCStateTypeDef  HAL_HCD_HC_GetState(HCD_HandleTypeDef *hhcd, uint8_t chnum)
+{
   return hhcd->hc[chnum].state;
+}
 /**
-  * @brief  Return the current Host frame number
+  * @brief  Return the current Host frame number.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval Current Host frame number
   */
 uint32_t HAL_HCD_GetCurrentFrame(HCD_HandleTypeDef *hhcd)
+{
   return (USB_GetCurrentFrame(hhcd->Instance));
+}
 /**
-  * @brief  Return the Host enumeration speed
+  * @brief  Return the Host enumeration speed.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval Enumeration speed
   */
 uint32_t HAL_HCD_GetCurrentSpeed(HCD_HandleTypeDef *hhcd)
+{
   return (USB_GetHostSpeed(hhcd->Instance));
+}
 /**
   * @}
   */
 /**
   * @}
   */
 /** @addtogroup HCD_Private_Functions
   * @{
   */
 /**
-  * @brief  This function handles Host Channel IN interrupt requests.
+  * @brief  Handle Host Channel IN interrupt requests.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval none
   */
-static void HCD_HC_IN_IRQHandler (HCD_HandleTypeDef *hhcd, uint8_t chnum)
+static void HCD_HC_IN_IRQHandler(HCD_HandleTypeDef *hhcd, uint8_t chnum)
+{
   USB_OTG_GlobalTypeDef *USBx = hhcd->Instance;
+  uint32_t USBx_BASE = (uint32_t)USBx;
+  uint32_t ch_num = (uint32_t)chnum;
-  uint32_t tmpreg = 0U;
+  uint32_t tmpreg;
-  if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_AHBERR)
+  if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_AHBERR) == USB_OTG_HCINT_AHBERR)
+  {
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_AHBERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_AHBERR);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
+  }
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_BBERR) == USB_OTG_HCINT_BBERR)
+  {
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_BBERR);
+    hhcd->hc[ch_num].state = HC_BBLERR;
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
   }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_ACK)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_ACK) == USB_OTG_HCINT_ACK)
+  {
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_ACK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_ACK);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_STALL)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_STALL) == USB_OTG_HCINT_STALL)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    hhcd->hc[chnum].state = HC_STALL;
+    hhcd->hc[ch_num].state = HC_STALL;
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_STALL);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_STALL);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_DTERR)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_DTERR) == USB_OTG_HCINT_DTERR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
-    hhcd->hc[chnum].state = HC_DATATGLERR;
+    hhcd->hc[ch_num].state = HC_DATATGLERR;
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_DTERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_DTERR);
+  }
+  else
-  if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_FRMOR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    /* ... */
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_FRMOR);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_XFRC)
+  if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_FRMOR) == USB_OTG_HCINT_FRMOR)
+  {
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_FRMOR);
+  }
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_XFRC) == USB_OTG_HCINT_XFRC)
+  {
-    hhcd->hc[chnum].state = HC_XFRC;
+    hhcd->hc[ch_num].state = HC_XFRC;
-    hhcd->hc[chnum].ErrCnt = 0U;
+    hhcd->hc[ch_num].ErrCnt = 0U;
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_XFRC);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_XFRC);
+    if ((hhcd->hc[ch_num].ep_type == EP_TYPE_CTRL) ||
+        (hhcd->hc[ch_num].ep_type == EP_TYPE_BULK))
+    {
+      __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
+      (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
+      __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
+    }
-    if ((hhcd->hc[chnum].ep_type == EP_TYPE_CTRL)||
+    else if (hhcd->hc[ch_num].ep_type == EP_TYPE_INTR)
+    {
+      USBx_HC(ch_num)->HCCHAR |= USB_OTG_HCCHAR_ODDFRM;
+      hhcd->hc[ch_num].urb_state = URB_DONE;
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+      hhcd->HC_NotifyURBChangeCallback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+#else
+      HAL_HCD_HC_NotifyURBChange_Callback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+    }
-        (hhcd->hc[chnum].ep_type == EP_TYPE_BULK))
+    else if (hhcd->hc[ch_num].ep_type == EP_TYPE_ISOC)
+    {
-      __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+      hhcd->hc[ch_num].urb_state = URB_DONE;
-      USB_HC_Halt(hhcd->Instance, chnum);
+      hhcd->hc[ch_num].toggle_in ^= 1U;
-      __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+      hhcd->HC_NotifyURBChangeCallback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+#else
+      HAL_HCD_HC_NotifyURBChange_Callback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+    }
-    else if(hhcd->hc[chnum].ep_type == EP_TYPE_INTR)
+    else
+    {
-      USBx_HC(chnum)->HCCHAR |= USB_OTG_HCCHAR_ODDFRM;
-      hhcd->hc[chnum].urb_state = URB_DONE;
+      /* ... */
-      HAL_HCD_HC_NotifyURBChange_Callback(hhcd, chnum, hhcd->hc[chnum].urb_state);
+    }
-    hhcd->hc[chnum].toggle_in ^= 1U;
+    hhcd->hc[ch_num].toggle_in ^= 1U;
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_CHH)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_CHH) == USB_OTG_HCINT_CHH)
+  {
-    __HAL_HCD_MASK_HALT_HC_INT(chnum);
+    __HAL_HCD_MASK_HALT_HC_INT(ch_num);
-    if(hhcd->hc[chnum].state == HC_XFRC)
+    if (hhcd->hc[ch_num].state == HC_XFRC)
+    {
-      hhcd->hc[chnum].urb_state  = URB_DONE;
+      hhcd->hc[ch_num].urb_state  = URB_DONE;
+    }
-    else if (hhcd->hc[chnum].state == HC_STALL)
+    else if (hhcd->hc[ch_num].state == HC_STALL)
+    {
-      hhcd->hc[chnum].urb_state  = URB_STALL;
+      hhcd->hc[ch_num].urb_state  = URB_STALL;
+    }
-    else if((hhcd->hc[chnum].state == HC_XACTERR) ||
+    else if ((hhcd->hc[ch_num].state == HC_XACTERR) ||
-            (hhcd->hc[chnum].state == HC_DATATGLERR))
+             (hhcd->hc[ch_num].state == HC_DATATGLERR))
+    {
+      hhcd->hc[ch_num].ErrCnt++;
-      if(hhcd->hc[chnum].ErrCnt++ > 3U)
+      if (hhcd->hc[ch_num].ErrCnt > 3U)
+      {
-        hhcd->hc[chnum].ErrCnt = 0U;
+        hhcd->hc[ch_num].ErrCnt = 0U;
-        hhcd->hc[chnum].urb_state = URB_ERROR;
+        hhcd->hc[ch_num].urb_state = URB_ERROR;
+      }
       else
+      {
-        hhcd->hc[chnum].urb_state = URB_NOTREADY;
+        hhcd->hc[ch_num].urb_state = URB_NOTREADY;
+      }
+      /* re-activate the channel  */
+      tmpreg = USBx_HC(ch_num)->HCCHAR;
+      tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
+      tmpreg |= USB_OTG_HCCHAR_CHENA;
+      USBx_HC(ch_num)->HCCHAR = tmpreg;
+    }
+    else if (hhcd->hc[ch_num].state == HC_NAK)
+    {
+      hhcd->hc[ch_num].urb_state  = URB_NOTREADY;
       /* re-activate the channel  */
-      tmpreg = USBx_HC(chnum)->HCCHAR;
+      tmpreg = USBx_HC(ch_num)->HCCHAR;
       tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
       tmpreg |= USB_OTG_HCCHAR_CHENA;
-      USBx_HC(chnum)->HCCHAR = tmpreg;
+      USBx_HC(ch_num)->HCCHAR = tmpreg;
+    }
+    else if (hhcd->hc[ch_num].state == HC_BBLERR)
+    {
+      hhcd->hc[ch_num].ErrCnt++;
+      hhcd->hc[ch_num].urb_state = URB_ERROR;
+    }
+    else
+    {
+      /* ... */
+    }
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_CHH);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_CHH);
-    HAL_HCD_HC_NotifyURBChange_Callback(hhcd, chnum, hhcd->hc[chnum].urb_state);
+    HAL_HCD_HC_NotifyURBChange_Callback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_TXERR)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_TXERR) == USB_OTG_HCINT_TXERR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-     hhcd->hc[chnum].ErrCnt++;
+    hhcd->hc[ch_num].ErrCnt++;
-     hhcd->hc[chnum].state = HC_XACTERR;
+    hhcd->hc[ch_num].state = HC_XACTERR;
-     USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-     __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_TXERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_TXERR);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_NAK)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_NAK) == USB_OTG_HCINT_NAK)
+  {
-    if(hhcd->hc[chnum].ep_type == EP_TYPE_INTR)
+    if (hhcd->hc[ch_num].ep_type == EP_TYPE_INTR)
+    {
+      hhcd->hc[ch_num].ErrCnt = 0U;
-      __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+      __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-      USB_HC_Halt(hhcd->Instance, chnum);
+      (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
+    }
-    else if  ((hhcd->hc[chnum].ep_type == EP_TYPE_CTRL)||
+    else if ((hhcd->hc[ch_num].ep_type == EP_TYPE_CTRL) ||
-              (hhcd->hc[chnum].ep_type == EP_TYPE_BULK))
+             (hhcd->hc[ch_num].ep_type == EP_TYPE_BULK))
+    {
-      /* re-activate the channel  */
+      hhcd->hc[ch_num].ErrCnt = 0U;
-      tmpreg = USBx_HC(chnum)->HCCHAR;
+      hhcd->hc[ch_num].state = HC_NAK;
-      tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
+      __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-      tmpreg |= USB_OTG_HCCHAR_CHENA;
+      (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
+    }
+    else
+    {
-      USBx_HC(chnum)->HCCHAR = tmpreg;
+      /* ... */
+    }
-    hhcd->hc[chnum].state = HC_NAK;
-     __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
+  }
+  else
+  {
+    /* ... */
+  }
+}
 /**
-  * @brief  This function handles Host Channel OUT interrupt requests.
+  * @brief  Handle Host Channel OUT interrupt requests.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
-  * @param  chnum: Channel number.
+  * @param  chnum Channel number.
   *         This parameter can be a value from 1 to 15
   * @retval none
   */
-static void HCD_HC_OUT_IRQHandler (HCD_HandleTypeDef *hhcd, uint8_t chnum)
+static void HCD_HC_OUT_IRQHandler(HCD_HandleTypeDef *hhcd, uint8_t chnum)
+{
   USB_OTG_GlobalTypeDef *USBx = hhcd->Instance;
+  uint32_t USBx_BASE = (uint32_t)USBx;
+  uint32_t ch_num = (uint32_t)chnum;
-  uint32_t tmpreg = 0U;
+  uint32_t tmpreg;
-  if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_AHBERR)
+  if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_AHBERR) == USB_OTG_HCINT_AHBERR)
+  {
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_AHBERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_AHBERR);
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_ACK)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_ACK) == USB_OTG_HCINT_ACK)
+  {
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_ACK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_ACK);
-    if( hhcd->hc[chnum].do_ping == 1U)
+    if (hhcd->hc[ch_num].do_ping == 1U)
+    {
+      hhcd->hc[ch_num].do_ping = 0U;
-      hhcd->hc[chnum].state = HC_NYET;
+      hhcd->hc[ch_num].urb_state  = URB_NOTREADY;
-      __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+      __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-      USB_HC_Halt(hhcd->Instance, chnum);
+      (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-      hhcd->hc[chnum].urb_state  = URB_NOTREADY;
+    }
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_NYET)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_NYET) == USB_OTG_HCINT_NYET)
+  {
-    hhcd->hc[chnum].state = HC_NYET;
+    hhcd->hc[ch_num].state = HC_NYET;
+    hhcd->hc[ch_num].do_ping = 1U;
-    hhcd->hc[chnum].ErrCnt= 0U;
+    hhcd->hc[ch_num].ErrCnt = 0U;
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NYET);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NYET);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_FRMOR)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_FRMOR) == USB_OTG_HCINT_FRMOR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_FRMOR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_FRMOR);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_XFRC)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_XFRC) == USB_OTG_HCINT_XFRC)
+  {
-    hhcd->hc[chnum].ErrCnt = 0U;
+    hhcd->hc[ch_num].ErrCnt = 0U;
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_XFRC);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_XFRC);
-    hhcd->hc[chnum].state = HC_XFRC;
+    hhcd->hc[ch_num].state = HC_XFRC;
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_STALL)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_STALL) == USB_OTG_HCINT_STALL)
+  {
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_STALL);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_STALL);
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    hhcd->hc[chnum].state = HC_STALL;
+    hhcd->hc[ch_num].state = HC_STALL;
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_NAK)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_NAK) == USB_OTG_HCINT_NAK)
+  {
-    hhcd->hc[chnum].ErrCnt = 0U;
+    hhcd->hc[ch_num].ErrCnt = 0U;
+    hhcd->hc[ch_num].state = HC_NAK;
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    hhcd->hc[chnum].state = HC_NAK;
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_TXERR)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_TXERR) == USB_OTG_HCINT_TXERR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    hhcd->hc[chnum].state = HC_XACTERR;
+    hhcd->hc[ch_num].state = HC_XACTERR;
-     __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_TXERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_TXERR);
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_DTERR)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_DTERR) == USB_OTG_HCINT_DTERR)
+  {
-    __HAL_HCD_UNMASK_HALT_HC_INT(chnum);
+    __HAL_HCD_UNMASK_HALT_HC_INT(ch_num);
-    USB_HC_Halt(hhcd->Instance, chnum);
+    (void)USB_HC_Halt(hhcd->Instance, (uint8_t)ch_num);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_NAK);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_NAK);
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_DTERR);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_DTERR);
-    hhcd->hc[chnum].state = HC_DATATGLERR;
+    hhcd->hc[ch_num].state = HC_DATATGLERR;
+  }
-  else if ((USBx_HC(chnum)->HCINT) &  USB_OTG_HCINT_CHH)
+  else if ((USBx_HC(ch_num)->HCINT & USB_OTG_HCINT_CHH) == USB_OTG_HCINT_CHH)
+  {
-    __HAL_HCD_MASK_HALT_HC_INT(chnum);
+    __HAL_HCD_MASK_HALT_HC_INT(ch_num);
-    if(hhcd->hc[chnum].state == HC_XFRC)
+    if (hhcd->hc[ch_num].state == HC_XFRC)
+    {
-      hhcd->hc[chnum].urb_state  = URB_DONE;
+      hhcd->hc[ch_num].urb_state  = URB_DONE;
-      if (hhcd->hc[chnum].ep_type == EP_TYPE_BULK)
+      if ((hhcd->hc[ch_num].ep_type == EP_TYPE_BULK) ||
+          (hhcd->hc[ch_num].ep_type == EP_TYPE_INTR))
+      {
-        hhcd->hc[chnum].toggle_out ^= 1U;
+        hhcd->hc[ch_num].toggle_out ^= 1U;
+      }
+    }
-    else if (hhcd->hc[chnum].state == HC_NAK)
+    else if (hhcd->hc[ch_num].state == HC_NAK)
+    {
-      hhcd->hc[chnum].urb_state  = URB_NOTREADY;
+      hhcd->hc[ch_num].urb_state = URB_NOTREADY;
+    }
-    else if (hhcd->hc[chnum].state == HC_NYET)
+    else if (hhcd->hc[ch_num].state == HC_NYET)
+    {
-      hhcd->hc[chnum].urb_state  = URB_NOTREADY;
+      hhcd->hc[ch_num].urb_state  = URB_NOTREADY;
-      hhcd->hc[chnum].do_ping = 0U;
+    }
-    else if (hhcd->hc[chnum].state == HC_STALL)
+    else if (hhcd->hc[ch_num].state == HC_STALL)
+    {
-      hhcd->hc[chnum].urb_state  = URB_STALL;
+      hhcd->hc[ch_num].urb_state  = URB_STALL;
+    }
-    else if((hhcd->hc[chnum].state == HC_XACTERR) ||
+    else if ((hhcd->hc[ch_num].state == HC_XACTERR) ||
-            (hhcd->hc[chnum].state == HC_DATATGLERR))
+             (hhcd->hc[ch_num].state == HC_DATATGLERR))
+    {
+      hhcd->hc[ch_num].ErrCnt++;
-      if(hhcd->hc[chnum].ErrCnt++ > 3U)
+      if (hhcd->hc[ch_num].ErrCnt > 3U)
+      {
-        hhcd->hc[chnum].ErrCnt = 0U;
+        hhcd->hc[ch_num].ErrCnt = 0U;
-        hhcd->hc[chnum].urb_state = URB_ERROR;
+        hhcd->hc[ch_num].urb_state = URB_ERROR;
+      }
       else
+      {
-        hhcd->hc[chnum].urb_state = URB_NOTREADY;
+        hhcd->hc[ch_num].urb_state = URB_NOTREADY;
+      }
       /* re-activate the channel  */
-      tmpreg = USBx_HC(chnum)->HCCHAR;
+      tmpreg = USBx_HC(ch_num)->HCCHAR;
       tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
       tmpreg |= USB_OTG_HCCHAR_CHENA;
-      USBx_HC(chnum)->HCCHAR = tmpreg;
+      USBx_HC(ch_num)->HCCHAR = tmpreg;
+    }
+    else
+    {
+      /* ... */
+    }
-    __HAL_HCD_CLEAR_HC_INT(chnum, USB_OTG_HCINT_CHH);
+    __HAL_HCD_CLEAR_HC_INT(ch_num, USB_OTG_HCINT_CHH);
-    HAL_HCD_HC_NotifyURBChange_Callback(hhcd, chnum, hhcd->hc[chnum].urb_state);
+    HAL_HCD_HC_NotifyURBChange_Callback(hhcd, (uint8_t)ch_num, hhcd->hc[ch_num].urb_state);
+  }
+  else
+  {
+    /* ... */
+  }
+}
 /**
-  * @brief  This function handles Rx Queue Level interrupt requests.
+  * @brief  Handle Rx Queue Level interrupt requests.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval none
   */
-static void HCD_RXQLVL_IRQHandler  (HCD_HandleTypeDef *hhcd)
+static void HCD_RXQLVL_IRQHandler(HCD_HandleTypeDef *hhcd)
+{
   USB_OTG_GlobalTypeDef *USBx = hhcd->Instance;
-  uint8_t                       channelnum =0U;
+  uint32_t USBx_BASE = (uint32_t)USBx;
-  uint32_t                      pktsts;
+  uint32_t pktsts;
-  uint32_t                      pktcnt;
+  uint32_t pktcnt;
-  uint32_t                      temp = 0U;
+  uint32_t temp;
-  uint32_t tmpreg = 0U;
+  uint32_t tmpreg;
+  uint32_t ch_num;
   temp = hhcd->Instance->GRXSTSP;
-  channelnum = temp &  USB_OTG_GRXSTSP_EPNUM;
+  ch_num = temp & USB_OTG_GRXSTSP_EPNUM;
-  pktsts = (temp &  USB_OTG_GRXSTSP_PKTSTS) >> 17U;
+  pktsts = (temp & USB_OTG_GRXSTSP_PKTSTS) >> 17;
-  pktcnt = (temp &  USB_OTG_GRXSTSP_BCNT) >> 4U;
+  pktcnt = (temp & USB_OTG_GRXSTSP_BCNT) >> 4;
   switch (pktsts)
+  {
-  case GRXSTS_PKTSTS_IN:
+    case GRXSTS_PKTSTS_IN:
-    /* Read the data into the host buffer. */
+      /* Read the data into the host buffer. */
-    if ((pktcnt > 0U) && (hhcd->hc[channelnum].xfer_buff != (void  *)0U))
+      if ((pktcnt > 0U) && (hhcd->hc[ch_num].xfer_buff != (void *)0))
-    {
-      USB_ReadPacket(hhcd->Instance, hhcd->hc[channelnum].xfer_buff, pktcnt);
-      /*manage multiple Xfer */
-      hhcd->hc[channelnum].xfer_buff += pktcnt;
-      hhcd->hc[channelnum].xfer_count  += pktcnt;
-      if((USBx_HC(channelnum)->HCTSIZ & USB_OTG_HCTSIZ_PKTCNT) > 0U)
+      {
+        (void)USB_ReadPacket(hhcd->Instance, hhcd->hc[ch_num].xfer_buff, (uint16_t)pktcnt);
+        /*manage multiple Xfer */
+        hhcd->hc[ch_num].xfer_buff += pktcnt;
+        hhcd->hc[ch_num].xfer_count  += pktcnt;
+        if ((USBx_HC(ch_num)->HCTSIZ & USB_OTG_HCTSIZ_PKTCNT) > 0U)
+        {
-        /* re-activate the channel when more packets are expected */
+          /* re-activate the channel when more packets are expected */
-        tmpreg = USBx_HC(channelnum)->HCCHAR;
+          tmpreg = USBx_HC(ch_num)->HCCHAR;
-        tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
+          tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
-        tmpreg |= USB_OTG_HCCHAR_CHENA;
+          tmpreg |= USB_OTG_HCCHAR_CHENA;
-        USBx_HC(channelnum)->HCCHAR = tmpreg;
+          USBx_HC(ch_num)->HCCHAR = tmpreg;
-        hhcd->hc[channelnum].toggle_in ^= 1U;
+          hhcd->hc[ch_num].toggle_in ^= 1U;
+        }
+      }
-    }
-    break;
+      break;
-  case GRXSTS_PKTSTS_DATA_TOGGLE_ERR:
+    case GRXSTS_PKTSTS_DATA_TOGGLE_ERR:
-    break;
+      break;
-  case GRXSTS_PKTSTS_IN_XFER_COMP:
+    case GRXSTS_PKTSTS_IN_XFER_COMP:
-  case GRXSTS_PKTSTS_CH_HALTED:
+    case GRXSTS_PKTSTS_CH_HALTED:
-  default:
+    default:
-    break;
+      break;
+  }
+}
 /**
-  * @brief  This function handles Host Port interrupt requests.
+  * @brief  Handle Host Port interrupt requests.
-  * @param  hhcd: HCD handle
+  * @param  hhcd HCD handle
   * @retval None
   */
-static void HCD_Port_IRQHandler (HCD_HandleTypeDef *hhcd)
+static void HCD_Port_IRQHandler(HCD_HandleTypeDef *hhcd)
+{
   USB_OTG_GlobalTypeDef *USBx = hhcd->Instance;
+  uint32_t USBx_BASE = (uint32_t)USBx;
-  __IO uint32_t hprt0 = 0, hprt0_dup = 0U;
+  __IO uint32_t hprt0, hprt0_dup;
   /* Handle Host Port Interrupts */
   hprt0 = USBx_HPRT0;
   hprt0_dup = USBx_HPRT0;
-  hprt0_dup &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |\
+  hprt0_dup &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET | \
-                 USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG );
+                 USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG);
-  /* Check whether Port Connect Detected */
+  /* Check whether Port Connect detected */
-  if((hprt0 & USB_OTG_HPRT_PCDET) == USB_OTG_HPRT_PCDET)
+  if ((hprt0 & USB_OTG_HPRT_PCDET) == USB_OTG_HPRT_PCDET)
+  {
-    if((hprt0 & USB_OTG_HPRT_PCSTS) == USB_OTG_HPRT_PCSTS)
+    if ((hprt0 & USB_OTG_HPRT_PCSTS) == USB_OTG_HPRT_PCSTS)
+    {
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
-      USB_MASK_INTERRUPT(hhcd->Instance, USB_OTG_GINTSTS_DISCINT);
+      hhcd->ConnectCallback(hhcd);
+#else
       HAL_HCD_Connect_Callback(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+    }
     hprt0_dup  |= USB_OTG_HPRT_PCDET;
+  }
   /* Check whether Port Enable Changed */
-  if((hprt0 & USB_OTG_HPRT_PENCHNG) == USB_OTG_HPRT_PENCHNG)
+  if ((hprt0 & USB_OTG_HPRT_PENCHNG) == USB_OTG_HPRT_PENCHNG)
+  {
     hprt0_dup |= USB_OTG_HPRT_PENCHNG;
-    if((hprt0 & USB_OTG_HPRT_PENA) == USB_OTG_HPRT_PENA)
+    if ((hprt0 & USB_OTG_HPRT_PENA) == USB_OTG_HPRT_PENA)
+    {
-      if ((hprt0 & USB_OTG_HPRT_PSPD) == (HPRT0_PRTSPD_LOW_SPEED << 17U))
+      if (hhcd->Init.phy_itface  == USB_OTG_EMBEDDED_PHY)
+      {
+        if ((hprt0 & USB_OTG_HPRT_PSPD) == (HPRT0_PRTSPD_LOW_SPEED << 17))
+        {
-        USB_InitFSLSPClkSel(hhcd->Instance ,HCFG_6_MHZ );
+          (void)USB_InitFSLSPClkSel(hhcd->Instance, HCFG_6_MHZ);
+        }
+        else
+        {
+          (void)USB_InitFSLSPClkSel(hhcd->Instance, HCFG_48_MHZ);
+        }
+      }
       else
+      {
-        USB_InitFSLSPClkSel(hhcd->Instance ,HCFG_48_MHZ );
+        if (hhcd->Init.speed == HCD_SPEED_FULL)
+        {
+          USBx_HOST->HFIR = 60000U;
+        }
+      }
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
+      hhcd->PortEnabledCallback(hhcd);
+#else
-      HAL_HCD_Connect_Callback(hhcd);
+      HAL_HCD_PortEnabled_Callback(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+    }
     else
+    {
-      /* Cleanup HPRT */
-      USBx_HPRT0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |\
+#if (USE_HAL_HCD_REGISTER_CALLBACKS == 1U)
-        USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG );
+      hhcd->PortDisabledCallback(hhcd);
+#else
-      USB_UNMASK_INTERRUPT(hhcd->Instance, USB_OTG_GINTSTS_DISCINT);
+      HAL_HCD_PortDisabled_Callback(hhcd);
+#endif /* USE_HAL_HCD_REGISTER_CALLBACKS */
+    }
+  }
-  /* Check For an over current */
+  /* Check for an overcurrent */
-  if((hprt0 & USB_OTG_HPRT_POCCHNG) == USB_OTG_HPRT_POCCHNG)
+  if ((hprt0 & USB_OTG_HPRT_POCCHNG) == USB_OTG_HPRT_POCCHNG)
+  {
     hprt0_dup |= USB_OTG_HPRT_POCCHNG;
+  }
   /* Clear Port Interrupts */
   USBx_HPRT0 = hprt0_dup;
+}
 /**
 /**
   * @}
   */
-#endif /* STM32F105xC || STM32F107xC */
+#endif /* defined (USB_OTG_FS) */
 #endif /* HAL_HCD_MODULE_ENABLED */
 /**
   * @}
   */
+/**
+  * @}
+  */
 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

Subversion Repositories LedShow

(root)/trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_hcd.c – Rev 2 → 9