/** | |
****************************************************************************** | |
* @file stm32l4xx_hal_pcd.c | |
* @author MCD Application Team | |
* @brief PCD 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 ##### | |
============================================================================== | |
[..] | |
The PCD HAL driver can be used as follows: | |
(#) Declare a PCD_HandleTypeDef handle structure, for example: | |
PCD_HandleTypeDef hpcd; | |
(#) Fill parameters of Init structure in HCD handle | |
(#) Call HAL_PCD_Init() API to initialize the PCD peripheral (Core, Device core, ...) | |
(#) Initialize the PCD low level resources through the HAL_PCD_MspInit() API: | |
(##) Enable the PCD/USB Low Level interface clock using | |
(+++) __HAL_RCC_USB_CLK_ENABLE(); For USB Device only FS peripheral | |
(##) Initialize the related GPIO clocks | |
(##) Configure PCD pin-out | |
(##) Configure PCD NVIC interrupt | |
(#)Associate the Upper USB device stack to the HAL PCD Driver: | |
(##) hpcd.pData = pdev; | |
(#)Enable PCD transmission and reception: | |
(##) HAL_PCD_Start(); | |
@endverbatim | |
****************************************************************************** | |
* @attention | |
* | |
* <h2><center>© Copyright (c) 2017 STMicroelectronics. | |
* All rights reserved.</center></h2> | |
* | |
* This software component is licensed by ST under BSD 3-Clause license, | |
* the "License"; You may not use this file except in compliance with the | |
* License. You may obtain a copy of the License at: | |
* opensource.org/licenses/BSD-3-Clause | |
* | |
****************************************************************************** | |
*/ | |
/* Includes ------------------------------------------------------------------*/ | |
#include "stm32l4xx_hal.h" | |
/** @addtogroup STM32L4xx_HAL_Driver | |
* @{ | |
*/ | |
/** @defgroup PCD PCD | |
* @brief PCD HAL module driver | |
* @{ | |
*/ | |
#ifdef HAL_PCD_MODULE_ENABLED | |
#if defined (USB) || defined (USB_OTG_FS) | |
/* Private types -------------------------------------------------------------*/ | |
/* Private variables ---------------------------------------------------------*/ | |
/* Private constants ---------------------------------------------------------*/ | |
/* Private macros ------------------------------------------------------------*/ | |
/** @defgroup PCD_Private_Macros PCD Private Macros | |
* @{ | |
*/ | |
#define PCD_MIN(a, b) (((a) < (b)) ? (a) : (b)) | |
#define PCD_MAX(a, b) (((a) > (b)) ? (a) : (b)) | |
/** | |
* @} | |
*/ | |
/* Private functions prototypes ----------------------------------------------*/ | |
/** @defgroup PCD_Private_Functions PCD Private Functions | |
* @{ | |
*/ | |
#if defined (USB_OTG_FS) | |
static HAL_StatusTypeDef PCD_WriteEmptyTxFifo(PCD_HandleTypeDef *hpcd, uint32_t epnum); | |
static HAL_StatusTypeDef PCD_EP_OutXfrComplete_int(PCD_HandleTypeDef *hpcd, uint32_t epnum); | |
static HAL_StatusTypeDef PCD_EP_OutSetupPacket_int(PCD_HandleTypeDef *hpcd, uint32_t epnum); | |
#endif /* defined (USB_OTG_FS) */ | |
#if defined (USB) | |
static HAL_StatusTypeDef PCD_EP_ISR_Handler(PCD_HandleTypeDef *hpcd); | |
#endif /* defined (USB) */ | |
/** | |
* @} | |
*/ | |
/* Exported functions --------------------------------------------------------*/ | |
/** @defgroup PCD_Exported_Functions PCD Exported Functions | |
* @{ | |
*/ | |
/** @defgroup PCD_Exported_Functions_Group1 Initialization and de-initialization functions | |
* @brief Initialization and Configuration functions | |
* | |
@verbatim | |
=============================================================================== | |
##### Initialization and de-initialization functions ##### | |
=============================================================================== | |
[..] This section provides functions allowing to: | |
@endverbatim | |
* @{ | |
*/ | |
/** | |
* @brief Initializes the PCD according to the specified | |
* parameters in the PCD_InitTypeDef and initialize the associated handle. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_Init(PCD_HandleTypeDef *hpcd) | |
{ | |
#if defined (USB_OTG_FS) | |
USB_OTG_GlobalTypeDef *USBx; | |
#endif /* defined (USB_OTG_FS) */ | |
uint8_t i; | |
/* Check the PCD handle allocation */ | |
if (hpcd == NULL) | |
{ | |
return HAL_ERROR; | |
} | |
/* Check the parameters */ | |
assert_param(IS_PCD_ALL_INSTANCE(hpcd->Instance)); | |
#if defined (USB_OTG_FS) | |
USBx = hpcd->Instance; | |
#endif /* defined (USB_OTG_FS) */ | |
if (hpcd->State == HAL_PCD_STATE_RESET) | |
{ | |
/* Allocate lock resource and initialize it */ | |
hpcd->Lock = HAL_UNLOCKED; | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SOFCallback = HAL_PCD_SOFCallback; | |
hpcd->SetupStageCallback = HAL_PCD_SetupStageCallback; | |
hpcd->ResetCallback = HAL_PCD_ResetCallback; | |
hpcd->SuspendCallback = HAL_PCD_SuspendCallback; | |
hpcd->ResumeCallback = HAL_PCD_ResumeCallback; | |
hpcd->ConnectCallback = HAL_PCD_ConnectCallback; | |
hpcd->DisconnectCallback = HAL_PCD_DisconnectCallback; | |
hpcd->DataOutStageCallback = HAL_PCD_DataOutStageCallback; | |
hpcd->DataInStageCallback = HAL_PCD_DataInStageCallback; | |
hpcd->ISOOUTIncompleteCallback = HAL_PCD_ISOOUTIncompleteCallback; | |
hpcd->ISOINIncompleteCallback = HAL_PCD_ISOINIncompleteCallback; | |
hpcd->LPMCallback = HAL_PCDEx_LPM_Callback; | |
hpcd->BCDCallback = HAL_PCDEx_BCD_Callback; | |
if (hpcd->MspInitCallback == NULL) | |
{ | |
hpcd->MspInitCallback = HAL_PCD_MspInit; | |
} | |
/* Init the low level hardware */ | |
hpcd->MspInitCallback(hpcd); | |
#else | |
/* Init the low level hardware : GPIO, CLOCK, NVIC... */ | |
HAL_PCD_MspInit(hpcd); | |
#endif /* (USE_HAL_PCD_REGISTER_CALLBACKS) */ | |
} | |
hpcd->State = HAL_PCD_STATE_BUSY; | |
#if defined (USB_OTG_FS) | |
/* Disable DMA mode for FS instance */ | |
if ((USBx->CID & (0x1U << 8)) == 0U) | |
{ | |
hpcd->Init.dma_enable = 0U; | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
/* Disable the Interrupts */ | |
__HAL_PCD_DISABLE(hpcd); | |
/*Init the Core (common init.) */ | |
if (USB_CoreInit(hpcd->Instance, hpcd->Init) != HAL_OK) | |
{ | |
hpcd->State = HAL_PCD_STATE_ERROR; | |
return HAL_ERROR; | |
} | |
/* Force Device Mode*/ | |
(void)USB_SetCurrentMode(hpcd->Instance, USB_DEVICE_MODE); | |
/* Init endpoints structures */ | |
for (i = 0U; i < hpcd->Init.dev_endpoints; i++) | |
{ | |
/* Init ep structure */ | |
hpcd->IN_ep[i].is_in = 1U; | |
hpcd->IN_ep[i].num = i; | |
hpcd->IN_ep[i].tx_fifo_num = i; | |
/* Control until ep is activated */ | |
hpcd->IN_ep[i].type = EP_TYPE_CTRL; | |
hpcd->IN_ep[i].maxpacket = 0U; | |
hpcd->IN_ep[i].xfer_buff = 0U; | |
hpcd->IN_ep[i].xfer_len = 0U; | |
} | |
for (i = 0U; i < hpcd->Init.dev_endpoints; i++) | |
{ | |
hpcd->OUT_ep[i].is_in = 0U; | |
hpcd->OUT_ep[i].num = i; | |
/* Control until ep is activated */ | |
hpcd->OUT_ep[i].type = EP_TYPE_CTRL; | |
hpcd->OUT_ep[i].maxpacket = 0U; | |
hpcd->OUT_ep[i].xfer_buff = 0U; | |
hpcd->OUT_ep[i].xfer_len = 0U; | |
} | |
/* Init Device */ | |
if (USB_DevInit(hpcd->Instance, hpcd->Init) != HAL_OK) | |
{ | |
hpcd->State = HAL_PCD_STATE_ERROR; | |
return HAL_ERROR; | |
} | |
hpcd->USB_Address = 0U; | |
hpcd->State = HAL_PCD_STATE_READY; | |
/* Activate LPM */ | |
if (hpcd->Init.lpm_enable == 1U) | |
{ | |
(void)HAL_PCDEx_ActivateLPM(hpcd); | |
} | |
(void)USB_DevDisconnect(hpcd->Instance); | |
return HAL_OK; | |
} | |
/** | |
* @brief DeInitializes the PCD peripheral. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_DeInit(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Check the PCD handle allocation */ | |
if (hpcd == NULL) | |
{ | |
return HAL_ERROR; | |
} | |
hpcd->State = HAL_PCD_STATE_BUSY; | |
/* Stop Device */ | |
(void)HAL_PCD_Stop(hpcd); | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
if (hpcd->MspDeInitCallback == NULL) | |
{ | |
hpcd->MspDeInitCallback = HAL_PCD_MspDeInit; /* Legacy weak MspDeInit */ | |
} | |
/* DeInit the low level hardware */ | |
hpcd->MspDeInitCallback(hpcd); | |
#else | |
/* DeInit the low level hardware: CLOCK, NVIC.*/ | |
HAL_PCD_MspDeInit(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
hpcd->State = HAL_PCD_STATE_RESET; | |
return HAL_OK; | |
} | |
/** | |
* @brief Initializes the PCD MSP. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_MspInit(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_MspInit could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief DeInitializes PCD MSP. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_MspDeInit(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_MspDeInit could be implemented in the user file | |
*/ | |
} | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
/** | |
* @brief Register a User USB PCD Callback | |
* To be used instead of the weak predefined callback | |
* @param hpcd USB PCD handle | |
* @param CallbackID ID of the callback to be registered | |
* This parameter can be one of the following values: | |
* @arg @ref HAL_PCD_SOF_CB_ID USB PCD SOF callback ID | |
* @arg @ref HAL_PCD_SETUPSTAGE_CB_ID USB PCD Setup callback ID | |
* @arg @ref HAL_PCD_RESET_CB_ID USB PCD Reset callback ID | |
* @arg @ref HAL_PCD_SUSPEND_CB_ID USB PCD Suspend callback ID | |
* @arg @ref HAL_PCD_RESUME_CB_ID USB PCD Resume callback ID | |
* @arg @ref HAL_PCD_CONNECT_CB_ID USB PCD Connect callback ID | |
* @arg @ref HAL_PCD_DISCONNECT_CB_ID OTG PCD Disconnect callback ID | |
* @arg @ref HAL_PCD_MSPINIT_CB_ID MspDeInit callback ID | |
* @arg @ref HAL_PCD_MSPDEINIT_CB_ID MspDeInit callback ID | |
* @param pCallback pointer to the Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterCallback(PCD_HandleTypeDef *hpcd, HAL_PCD_CallbackIDTypeDef CallbackID, pPCD_CallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
switch (CallbackID) | |
{ | |
case HAL_PCD_SOF_CB_ID : | |
hpcd->SOFCallback = pCallback; | |
break; | |
case HAL_PCD_SETUPSTAGE_CB_ID : | |
hpcd->SetupStageCallback = pCallback; | |
break; | |
case HAL_PCD_RESET_CB_ID : | |
hpcd->ResetCallback = pCallback; | |
break; | |
case HAL_PCD_SUSPEND_CB_ID : | |
hpcd->SuspendCallback = pCallback; | |
break; | |
case HAL_PCD_RESUME_CB_ID : | |
hpcd->ResumeCallback = pCallback; | |
break; | |
case HAL_PCD_CONNECT_CB_ID : | |
hpcd->ConnectCallback = pCallback; | |
break; | |
case HAL_PCD_DISCONNECT_CB_ID : | |
hpcd->DisconnectCallback = pCallback; | |
break; | |
case HAL_PCD_MSPINIT_CB_ID : | |
hpcd->MspInitCallback = pCallback; | |
break; | |
case HAL_PCD_MSPDEINIT_CB_ID : | |
hpcd->MspDeInitCallback = pCallback; | |
break; | |
default : | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
break; | |
} | |
} | |
else if (hpcd->State == HAL_PCD_STATE_RESET) | |
{ | |
switch (CallbackID) | |
{ | |
case HAL_PCD_MSPINIT_CB_ID : | |
hpcd->MspInitCallback = pCallback; | |
break; | |
case HAL_PCD_MSPDEINIT_CB_ID : | |
hpcd->MspDeInitCallback = pCallback; | |
break; | |
default : | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
break; | |
} | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Unregister an USB PCD Callback | |
* USB PCD callabck is redirected to the weak predefined callback | |
* @param hpcd USB PCD handle | |
* @param CallbackID ID of the callback to be unregistered | |
* This parameter can be one of the following values: | |
* @arg @ref HAL_PCD_SOF_CB_ID USB PCD SOF callback ID | |
* @arg @ref HAL_PCD_SETUPSTAGE_CB_ID USB PCD Setup callback ID | |
* @arg @ref HAL_PCD_RESET_CB_ID USB PCD Reset callback ID | |
* @arg @ref HAL_PCD_SUSPEND_CB_ID USB PCD Suspend callback ID | |
* @arg @ref HAL_PCD_RESUME_CB_ID USB PCD Resume callback ID | |
* @arg @ref HAL_PCD_CONNECT_CB_ID USB PCD Connect callback ID | |
* @arg @ref HAL_PCD_DISCONNECT_CB_ID OTG PCD Disconnect callback ID | |
* @arg @ref HAL_PCD_MSPINIT_CB_ID MspDeInit callback ID | |
* @arg @ref HAL_PCD_MSPDEINIT_CB_ID MspDeInit callback ID | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterCallback(PCD_HandleTypeDef *hpcd, HAL_PCD_CallbackIDTypeDef CallbackID) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
/* Setup Legacy weak Callbacks */ | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
switch (CallbackID) | |
{ | |
case HAL_PCD_SOF_CB_ID : | |
hpcd->SOFCallback = HAL_PCD_SOFCallback; | |
break; | |
case HAL_PCD_SETUPSTAGE_CB_ID : | |
hpcd->SetupStageCallback = HAL_PCD_SetupStageCallback; | |
break; | |
case HAL_PCD_RESET_CB_ID : | |
hpcd->ResetCallback = HAL_PCD_ResetCallback; | |
break; | |
case HAL_PCD_SUSPEND_CB_ID : | |
hpcd->SuspendCallback = HAL_PCD_SuspendCallback; | |
break; | |
case HAL_PCD_RESUME_CB_ID : | |
hpcd->ResumeCallback = HAL_PCD_ResumeCallback; | |
break; | |
case HAL_PCD_CONNECT_CB_ID : | |
hpcd->ConnectCallback = HAL_PCD_ConnectCallback; | |
break; | |
case HAL_PCD_DISCONNECT_CB_ID : | |
hpcd->DisconnectCallback = HAL_PCD_DisconnectCallback; | |
break; | |
case HAL_PCD_MSPINIT_CB_ID : | |
hpcd->MspInitCallback = HAL_PCD_MspInit; | |
break; | |
case HAL_PCD_MSPDEINIT_CB_ID : | |
hpcd->MspDeInitCallback = HAL_PCD_MspDeInit; | |
break; | |
default : | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
break; | |
} | |
} | |
else if (hpcd->State == HAL_PCD_STATE_RESET) | |
{ | |
switch (CallbackID) | |
{ | |
case HAL_PCD_MSPINIT_CB_ID : | |
hpcd->MspInitCallback = HAL_PCD_MspInit; | |
break; | |
case HAL_PCD_MSPDEINIT_CB_ID : | |
hpcd->MspDeInitCallback = HAL_PCD_MspDeInit; | |
break; | |
default : | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
break; | |
} | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD Data OUT Stage Callback | |
* To be used instead of the weak HAL_PCD_DataOutStageCallback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD Data OUT Stage Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterDataOutStageCallback(PCD_HandleTypeDef *hpcd, pPCD_DataOutStageCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->DataOutStageCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD Data OUT Stage Callback | |
* USB PCD Data OUT Stage Callback is redirected to the weak HAL_PCD_DataOutStageCallback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterDataOutStageCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->DataOutStageCallback = HAL_PCD_DataOutStageCallback; /* Legacy weak DataOutStageCallback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD Data IN Stage Callback | |
* To be used instead of the weak HAL_PCD_DataInStageCallback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD Data IN Stage Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterDataInStageCallback(PCD_HandleTypeDef *hpcd, pPCD_DataInStageCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->DataInStageCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD Data IN Stage Callback | |
* USB PCD Data OUT Stage Callback is redirected to the weak HAL_PCD_DataInStageCallback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterDataInStageCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->DataInStageCallback = HAL_PCD_DataInStageCallback; /* Legacy weak DataInStageCallback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD Iso OUT incomplete Callback | |
* To be used instead of the weak HAL_PCD_ISOOUTIncompleteCallback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD Iso OUT incomplete Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterIsoOutIncpltCallback(PCD_HandleTypeDef *hpcd, pPCD_IsoOutIncpltCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->ISOOUTIncompleteCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD Iso OUT incomplete Callback | |
* USB PCD Iso OUT incomplete Callback is redirected to the weak HAL_PCD_ISOOUTIncompleteCallback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterIsoOutIncpltCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->ISOOUTIncompleteCallback = HAL_PCD_ISOOUTIncompleteCallback; /* Legacy weak ISOOUTIncompleteCallback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD Iso IN incomplete Callback | |
* To be used instead of the weak HAL_PCD_ISOINIncompleteCallback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD Iso IN incomplete Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterIsoInIncpltCallback(PCD_HandleTypeDef *hpcd, pPCD_IsoInIncpltCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->ISOINIncompleteCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD Iso IN incomplete Callback | |
* USB PCD Iso IN incomplete Callback is redirected to the weak HAL_PCD_ISOINIncompleteCallback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterIsoInIncpltCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->ISOINIncompleteCallback = HAL_PCD_ISOINIncompleteCallback; /* Legacy weak ISOINIncompleteCallback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD BCD Callback | |
* To be used instead of the weak HAL_PCDEx_BCD_Callback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD BCD Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterBcdCallback(PCD_HandleTypeDef *hpcd, pPCD_BcdCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->BCDCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD BCD Callback | |
* USB BCD Callback is redirected to the weak HAL_PCDEx_BCD_Callback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterBcdCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->BCDCallback = HAL_PCDEx_BCD_Callback; /* Legacy weak HAL_PCDEx_BCD_Callback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief Register USB PCD LPM Callback | |
* To be used instead of the weak HAL_PCDEx_LPM_Callback() predefined callback | |
* @param hpcd PCD handle | |
* @param pCallback pointer to the USB PCD LPM Callback function | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_RegisterLpmCallback(PCD_HandleTypeDef *hpcd, pPCD_LpmCallbackTypeDef pCallback) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
if (pCallback == NULL) | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
return HAL_ERROR; | |
} | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->LPMCallback = pCallback; | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
/** | |
* @brief UnRegister the USB PCD LPM Callback | |
* USB LPM Callback is redirected to the weak HAL_PCDEx_LPM_Callback() predefined callback | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_UnRegisterLpmCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
HAL_StatusTypeDef status = HAL_OK; | |
/* Process locked */ | |
__HAL_LOCK(hpcd); | |
if (hpcd->State == HAL_PCD_STATE_READY) | |
{ | |
hpcd->LPMCallback = HAL_PCDEx_LPM_Callback; /* Legacy weak HAL_PCDEx_LPM_Callback */ | |
} | |
else | |
{ | |
/* Update the error code */ | |
hpcd->ErrorCode |= HAL_PCD_ERROR_INVALID_CALLBACK; | |
/* Return error status */ | |
status = HAL_ERROR; | |
} | |
/* Release Lock */ | |
__HAL_UNLOCK(hpcd); | |
return status; | |
} | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
/** | |
* @} | |
*/ | |
/** @defgroup PCD_Exported_Functions_Group2 Input and Output operation functions | |
* @brief Data transfers functions | |
* | |
@verbatim | |
=============================================================================== | |
##### IO operation functions ##### | |
=============================================================================== | |
[..] | |
This subsection provides a set of functions allowing to manage the PCD data | |
transfers. | |
@endverbatim | |
* @{ | |
*/ | |
/** | |
* @brief Start the USB device | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_Start(PCD_HandleTypeDef *hpcd) | |
{ | |
#if defined (USB_OTG_FS) | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
#endif /* defined (USB_OTG_FS) */ | |
__HAL_LOCK(hpcd); | |
#if defined (USB_OTG_FS) | |
if (hpcd->Init.battery_charging_enable == 1U) | |
{ | |
/* Enable USB Transceiver */ | |
USBx->GCCFG |= USB_OTG_GCCFG_PWRDWN; | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
(void)USB_DevConnect(hpcd->Instance); | |
__HAL_PCD_ENABLE(hpcd); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Stop the USB device. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_Stop(PCD_HandleTypeDef *hpcd) | |
{ | |
__HAL_LOCK(hpcd); | |
__HAL_PCD_DISABLE(hpcd); | |
if (USB_StopDevice(hpcd->Instance) != HAL_OK) | |
{ | |
__HAL_UNLOCK(hpcd); | |
return HAL_ERROR; | |
} | |
(void)USB_DevDisconnect(hpcd->Instance); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
#if defined (USB_OTG_FS) | |
/** | |
* @brief Handles PCD interrupt request. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
void HAL_PCD_IRQHandler(PCD_HandleTypeDef *hpcd) | |
{ | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
uint32_t USBx_BASE = (uint32_t)USBx; | |
uint32_t i, ep_intr, epint, epnum = 0U; | |
uint32_t fifoemptymsk, temp; | |
USB_OTG_EPTypeDef *ep; | |
/* ensure that we are in device mode */ | |
if (USB_GetMode(hpcd->Instance) == USB_OTG_MODE_DEVICE) | |
{ | |
/* avoid spurious interrupt */ | |
if (__HAL_PCD_IS_INVALID_INTERRUPT(hpcd)) | |
{ | |
return; | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_MMIS)) | |
{ | |
/* incorrect mode, acknowledge the interrupt */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_MMIS); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_OEPINT)) | |
{ | |
epnum = 0U; | |
/* Read in the device interrupt bits */ | |
ep_intr = USB_ReadDevAllOutEpInterrupt(hpcd->Instance); | |
while (ep_intr != 0U) | |
{ | |
if ((ep_intr & 0x1U) != 0U) | |
{ | |
epint = USB_ReadDevOutEPInterrupt(hpcd->Instance, (uint8_t)epnum); | |
if ((epint & USB_OTG_DOEPINT_XFRC) == USB_OTG_DOEPINT_XFRC) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_XFRC); | |
(void)PCD_EP_OutXfrComplete_int(hpcd, epnum); | |
} | |
if ((epint & USB_OTG_DOEPINT_STUP) == USB_OTG_DOEPINT_STUP) | |
{ | |
/* Class B setup phase done for previous decoded setup */ | |
(void)PCD_EP_OutSetupPacket_int(hpcd, epnum); | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_STUP); | |
} | |
if ((epint & USB_OTG_DOEPINT_OTEPDIS) == USB_OTG_DOEPINT_OTEPDIS) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_OTEPDIS); | |
} | |
/* Clear Status Phase Received interrupt */ | |
if ((epint & USB_OTG_DOEPINT_OTEPSPR) == USB_OTG_DOEPINT_OTEPSPR) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_OTEPSPR); | |
} | |
/* Clear OUT NAK interrupt */ | |
if ((epint & USB_OTG_DOEPINT_NAK) == USB_OTG_DOEPINT_NAK) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_NAK); | |
} | |
} | |
epnum++; | |
ep_intr >>= 1U; | |
} | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_IEPINT)) | |
{ | |
/* Read in the device interrupt bits */ | |
ep_intr = USB_ReadDevAllInEpInterrupt(hpcd->Instance); | |
epnum = 0U; | |
while (ep_intr != 0U) | |
{ | |
if ((ep_intr & 0x1U) != 0U) /* In ITR */ | |
{ | |
epint = USB_ReadDevInEPInterrupt(hpcd->Instance, (uint8_t)epnum); | |
if ((epint & USB_OTG_DIEPINT_XFRC) == USB_OTG_DIEPINT_XFRC) | |
{ | |
fifoemptymsk = (uint32_t)(0x1UL << (epnum & EP_ADDR_MSK)); | |
USBx_DEVICE->DIEPEMPMSK &= ~fifoemptymsk; | |
CLEAR_IN_EP_INTR(epnum, USB_OTG_DIEPINT_XFRC); | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataInStageCallback(hpcd, (uint8_t)epnum); | |
#else | |
HAL_PCD_DataInStageCallback(hpcd, (uint8_t)epnum); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
if ((epint & USB_OTG_DIEPINT_TOC) == USB_OTG_DIEPINT_TOC) | |
{ | |
CLEAR_IN_EP_INTR(epnum, USB_OTG_DIEPINT_TOC); | |
} | |
if ((epint & USB_OTG_DIEPINT_ITTXFE) == USB_OTG_DIEPINT_ITTXFE) | |
{ | |
CLEAR_IN_EP_INTR(epnum, USB_OTG_DIEPINT_ITTXFE); | |
} | |
if ((epint & USB_OTG_DIEPINT_INEPNE) == USB_OTG_DIEPINT_INEPNE) | |
{ | |
CLEAR_IN_EP_INTR(epnum, USB_OTG_DIEPINT_INEPNE); | |
} | |
if ((epint & USB_OTG_DIEPINT_EPDISD) == USB_OTG_DIEPINT_EPDISD) | |
{ | |
CLEAR_IN_EP_INTR(epnum, USB_OTG_DIEPINT_EPDISD); | |
} | |
if ((epint & USB_OTG_DIEPINT_TXFE) == USB_OTG_DIEPINT_TXFE) | |
{ | |
(void)PCD_WriteEmptyTxFifo(hpcd, epnum); | |
} | |
} | |
epnum++; | |
ep_intr >>= 1U; | |
} | |
} | |
/* Handle Resume Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_WKUINT)) | |
{ | |
/* Clear the Remote Wake-up Signaling */ | |
USBx_DEVICE->DCTL &= ~USB_OTG_DCTL_RWUSIG; | |
if (hpcd->LPM_State == LPM_L1) | |
{ | |
hpcd->LPM_State = LPM_L0; | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->LPMCallback(hpcd, PCD_LPM_L0_ACTIVE); | |
#else | |
HAL_PCDEx_LPM_Callback(hpcd, PCD_LPM_L0_ACTIVE); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ResumeCallback(hpcd); | |
#else | |
HAL_PCD_ResumeCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_WKUINT); | |
} | |
/* Handle Suspend Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_USBSUSP)) | |
{ | |
if ((USBx_DEVICE->DSTS & USB_OTG_DSTS_SUSPSTS) == USB_OTG_DSTS_SUSPSTS) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SuspendCallback(hpcd); | |
#else | |
HAL_PCD_SuspendCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_USBSUSP); | |
} | |
/* Handle LPM Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_LPMINT)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_LPMINT); | |
if (hpcd->LPM_State == LPM_L0) | |
{ | |
hpcd->LPM_State = LPM_L1; | |
hpcd->BESL = (hpcd->Instance->GLPMCFG & USB_OTG_GLPMCFG_BESL) >> 2U; | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->LPMCallback(hpcd, PCD_LPM_L1_ACTIVE); | |
#else | |
HAL_PCDEx_LPM_Callback(hpcd, PCD_LPM_L1_ACTIVE); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SuspendCallback(hpcd); | |
#else | |
HAL_PCD_SuspendCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
} | |
/* Handle Reset Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_USBRST)) | |
{ | |
USBx_DEVICE->DCTL &= ~USB_OTG_DCTL_RWUSIG; | |
(void)USB_FlushTxFifo(hpcd->Instance, 0x10U); | |
for (i = 0U; i < hpcd->Init.dev_endpoints; i++) | |
{ | |
USBx_INEP(i)->DIEPINT = 0xFB7FU; | |
USBx_INEP(i)->DIEPCTL &= ~USB_OTG_DIEPCTL_STALL; | |
USBx_OUTEP(i)->DOEPINT = 0xFB7FU; | |
USBx_OUTEP(i)->DOEPCTL &= ~USB_OTG_DOEPCTL_STALL; | |
} | |
USBx_DEVICE->DAINTMSK |= 0x10001U; | |
if (hpcd->Init.use_dedicated_ep1 != 0U) | |
{ | |
USBx_DEVICE->DOUTEP1MSK |= USB_OTG_DOEPMSK_STUPM | | |
USB_OTG_DOEPMSK_XFRCM | | |
USB_OTG_DOEPMSK_EPDM; | |
USBx_DEVICE->DINEP1MSK |= USB_OTG_DIEPMSK_TOM | | |
USB_OTG_DIEPMSK_XFRCM | | |
USB_OTG_DIEPMSK_EPDM; | |
} | |
else | |
{ | |
USBx_DEVICE->DOEPMSK |= USB_OTG_DOEPMSK_STUPM | | |
USB_OTG_DOEPMSK_XFRCM | | |
USB_OTG_DOEPMSK_EPDM | | |
USB_OTG_DOEPMSK_OTEPSPRM | | |
USB_OTG_DOEPMSK_NAKM; | |
USBx_DEVICE->DIEPMSK |= USB_OTG_DIEPMSK_TOM | | |
USB_OTG_DIEPMSK_XFRCM | | |
USB_OTG_DIEPMSK_EPDM; | |
} | |
/* Set Default Address to 0 */ | |
USBx_DEVICE->DCFG &= ~USB_OTG_DCFG_DAD; | |
/* setup EP0 to receive SETUP packets */ | |
(void)USB_EP0_OutStart(hpcd->Instance, (uint8_t *)hpcd->Setup); | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_USBRST); | |
} | |
/* Handle Enumeration done Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_ENUMDNE)) | |
{ | |
(void)USB_ActivateSetup(hpcd->Instance); | |
hpcd->Init.speed = USB_GetDevSpeed(hpcd->Instance); | |
/* Set USB Turnaround time */ | |
(void)USB_SetTurnaroundTime(hpcd->Instance, | |
HAL_RCC_GetHCLKFreq(), | |
(uint8_t)hpcd->Init.speed); | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ResetCallback(hpcd); | |
#else | |
HAL_PCD_ResetCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_ENUMDNE); | |
} | |
/* Handle RxQLevel Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_RXFLVL)) | |
{ | |
USB_MASK_INTERRUPT(hpcd->Instance, USB_OTG_GINTSTS_RXFLVL); | |
temp = USBx->GRXSTSP; | |
ep = &hpcd->OUT_ep[temp & USB_OTG_GRXSTSP_EPNUM]; | |
if (((temp & USB_OTG_GRXSTSP_PKTSTS) >> 17) == STS_DATA_UPDT) | |
{ | |
if ((temp & USB_OTG_GRXSTSP_BCNT) != 0U) | |
{ | |
(void)USB_ReadPacket(USBx, ep->xfer_buff, | |
(uint16_t)((temp & USB_OTG_GRXSTSP_BCNT) >> 4)); | |
ep->xfer_buff += (temp & USB_OTG_GRXSTSP_BCNT) >> 4; | |
ep->xfer_count += (temp & USB_OTG_GRXSTSP_BCNT) >> 4; | |
} | |
} | |
else if (((temp & USB_OTG_GRXSTSP_PKTSTS) >> 17) == STS_SETUP_UPDT) | |
{ | |
(void)USB_ReadPacket(USBx, (uint8_t *)hpcd->Setup, 8U); | |
ep->xfer_count += (temp & USB_OTG_GRXSTSP_BCNT) >> 4; | |
} | |
else | |
{ | |
/* ... */ | |
} | |
USB_UNMASK_INTERRUPT(hpcd->Instance, USB_OTG_GINTSTS_RXFLVL); | |
} | |
/* Handle SOF Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_SOF)) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SOFCallback(hpcd); | |
#else | |
HAL_PCD_SOFCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_SOF); | |
} | |
/* Handle Incomplete ISO IN Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_IISOIXFR)) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ISOINIncompleteCallback(hpcd, (uint8_t)epnum); | |
#else | |
HAL_PCD_ISOINIncompleteCallback(hpcd, (uint8_t)epnum); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_IISOIXFR); | |
} | |
/* Handle Incomplete ISO OUT Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_PXFR_INCOMPISOOUT)) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ISOOUTIncompleteCallback(hpcd, (uint8_t)epnum); | |
#else | |
HAL_PCD_ISOOUTIncompleteCallback(hpcd, (uint8_t)epnum); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_PXFR_INCOMPISOOUT); | |
} | |
/* Handle Connection event Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_SRQINT)) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ConnectCallback(hpcd); | |
#else | |
HAL_PCD_ConnectCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_OTG_GINTSTS_SRQINT); | |
} | |
/* Handle Disconnection event Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_OTG_GINTSTS_OTGINT)) | |
{ | |
temp = hpcd->Instance->GOTGINT; | |
if ((temp & USB_OTG_GOTGINT_SEDET) == USB_OTG_GOTGINT_SEDET) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DisconnectCallback(hpcd); | |
#else | |
HAL_PCD_DisconnectCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
hpcd->Instance->GOTGINT |= temp; | |
} | |
} | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
#if defined (USB) | |
/** | |
* @brief This function handles PCD interrupt request. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
void HAL_PCD_IRQHandler(PCD_HandleTypeDef *hpcd) | |
{ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_CTR)) | |
{ | |
/* servicing of the endpoint correct transfer interrupt */ | |
/* clear of the CTR flag into the sub */ | |
(void)PCD_EP_ISR_Handler(hpcd); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_RESET)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_RESET); | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ResetCallback(hpcd); | |
#else | |
HAL_PCD_ResetCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
(void)HAL_PCD_SetAddress(hpcd, 0U); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_PMAOVR)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_PMAOVR); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_ERR)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_ERR); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_WKUP)) | |
{ | |
hpcd->Instance->CNTR &= (uint16_t) ~(USB_CNTR_LPMODE); | |
hpcd->Instance->CNTR &= (uint16_t) ~(USB_CNTR_FSUSP); | |
if (hpcd->LPM_State == LPM_L1) | |
{ | |
hpcd->LPM_State = LPM_L0; | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->LPMCallback(hpcd, PCD_LPM_L0_ACTIVE); | |
#else | |
HAL_PCDEx_LPM_Callback(hpcd, PCD_LPM_L0_ACTIVE); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->ResumeCallback(hpcd); | |
#else | |
HAL_PCD_ResumeCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_WKUP); | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_SUSP)) | |
{ | |
/* Force low-power mode in the macrocell */ | |
hpcd->Instance->CNTR |= USB_CNTR_FSUSP; | |
/* clear of the ISTR bit must be done after setting of CNTR_FSUSP */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_SUSP); | |
hpcd->Instance->CNTR |= USB_CNTR_LPMODE; | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_WKUP) == 0U) | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SuspendCallback(hpcd); | |
#else | |
HAL_PCD_SuspendCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
} | |
/* Handle LPM Interrupt */ | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_L1REQ)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_L1REQ); | |
if (hpcd->LPM_State == LPM_L0) | |
{ | |
/* Force suspend and low-power mode before going to L1 state*/ | |
hpcd->Instance->CNTR |= USB_CNTR_LPMODE; | |
hpcd->Instance->CNTR |= USB_CNTR_FSUSP; | |
hpcd->LPM_State = LPM_L1; | |
hpcd->BESL = ((uint32_t)hpcd->Instance->LPMCSR & USB_LPMCSR_BESL) >> 2; | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->LPMCallback(hpcd, PCD_LPM_L1_ACTIVE); | |
#else | |
HAL_PCDEx_LPM_Callback(hpcd, PCD_LPM_L1_ACTIVE); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SuspendCallback(hpcd); | |
#else | |
HAL_PCD_SuspendCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_SOF)) | |
{ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_SOF); | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SOFCallback(hpcd); | |
#else | |
HAL_PCD_SOFCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
if (__HAL_PCD_GET_FLAG(hpcd, USB_ISTR_ESOF)) | |
{ | |
/* clear ESOF flag in ISTR */ | |
__HAL_PCD_CLEAR_FLAG(hpcd, USB_ISTR_ESOF); | |
} | |
} | |
#endif /* defined (USB) */ | |
/** | |
* @brief Data OUT stage callback. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval None | |
*/ | |
__weak void HAL_PCD_DataOutStageCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
UNUSED(epnum); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_DataOutStageCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Data IN stage callback | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval None | |
*/ | |
__weak void HAL_PCD_DataInStageCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
UNUSED(epnum); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_DataInStageCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Setup stage callback | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_SetupStageCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_SetupStageCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief USB Start Of Frame callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_SOFCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_SOFCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief USB Reset callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_ResetCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_ResetCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Suspend event callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_SuspendCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_SuspendCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Resume event callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_ResumeCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_ResumeCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Incomplete ISO OUT callback. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval None | |
*/ | |
__weak void HAL_PCD_ISOOUTIncompleteCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
UNUSED(epnum); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_ISOOUTIncompleteCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Incomplete ISO IN callback. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval None | |
*/ | |
__weak void HAL_PCD_ISOINIncompleteCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
UNUSED(epnum); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_ISOINIncompleteCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Connection event callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_ConnectCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_ConnectCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @brief Disconnection event callback. | |
* @param hpcd PCD handle | |
* @retval None | |
*/ | |
__weak void HAL_PCD_DisconnectCallback(PCD_HandleTypeDef *hpcd) | |
{ | |
/* Prevent unused argument(s) compilation warning */ | |
UNUSED(hpcd); | |
/* NOTE : This function should not be modified, when the callback is needed, | |
the HAL_PCD_DisconnectCallback could be implemented in the user file | |
*/ | |
} | |
/** | |
* @} | |
*/ | |
/** @defgroup PCD_Exported_Functions_Group3 Peripheral Control functions | |
* @brief management functions | |
* | |
@verbatim | |
=============================================================================== | |
##### Peripheral Control functions ##### | |
=============================================================================== | |
[..] | |
This subsection provides a set of functions allowing to control the PCD data | |
transfers. | |
@endverbatim | |
* @{ | |
*/ | |
/** | |
* @brief Connect the USB device | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_DevConnect(PCD_HandleTypeDef *hpcd) | |
{ | |
#if defined (USB_OTG_FS) | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
#endif /* defined (USB_OTG_FS) */ | |
__HAL_LOCK(hpcd); | |
#if defined (USB_OTG_FS) | |
if (hpcd->Init.battery_charging_enable == 1U) | |
{ | |
/* Enable USB Transceiver */ | |
USBx->GCCFG |= USB_OTG_GCCFG_PWRDWN; | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
(void)USB_DevConnect(hpcd->Instance); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Disconnect the USB device. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_DevDisconnect(PCD_HandleTypeDef *hpcd) | |
{ | |
#if defined (USB_OTG_FS) | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
#endif /* defined (USB_OTG_FS) */ | |
__HAL_LOCK(hpcd); | |
(void)USB_DevDisconnect(hpcd->Instance); | |
#if defined (USB_OTG_FS) | |
if (hpcd->Init.battery_charging_enable == 1U) | |
{ | |
/* Disable USB Transceiver */ | |
USBx->GCCFG &= ~(USB_OTG_GCCFG_PWRDWN); | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Set the USB Device address. | |
* @param hpcd PCD handle | |
* @param address new device address | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_SetAddress(PCD_HandleTypeDef *hpcd, uint8_t address) | |
{ | |
__HAL_LOCK(hpcd); | |
hpcd->USB_Address = address; | |
(void)USB_SetDevAddress(hpcd->Instance, address); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Open and configure an endpoint. | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @param ep_mps endpoint max packet size | |
* @param ep_type endpoint type | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_Open(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint16_t ep_mps, uint8_t ep_type) | |
{ | |
HAL_StatusTypeDef ret = HAL_OK; | |
PCD_EPTypeDef *ep; | |
if ((ep_addr & 0x80U) == 0x80U) | |
{ | |
ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 1U; | |
} | |
else | |
{ | |
ep = &hpcd->OUT_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 0U; | |
} | |
ep->num = ep_addr & EP_ADDR_MSK; | |
ep->maxpacket = ep_mps; | |
ep->type = ep_type; | |
if (ep->is_in != 0U) | |
{ | |
/* Assign a Tx FIFO */ | |
ep->tx_fifo_num = ep->num; | |
} | |
/* Set initial data PID. */ | |
if (ep_type == EP_TYPE_BULK) | |
{ | |
ep->data_pid_start = 0U; | |
} | |
__HAL_LOCK(hpcd); | |
(void)USB_ActivateEndpoint(hpcd->Instance, ep); | |
__HAL_UNLOCK(hpcd); | |
return ret; | |
} | |
/** | |
* @brief Deactivate an endpoint. | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_Close(PCD_HandleTypeDef *hpcd, uint8_t ep_addr) | |
{ | |
PCD_EPTypeDef *ep; | |
if ((ep_addr & 0x80U) == 0x80U) | |
{ | |
ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 1U; | |
} | |
else | |
{ | |
ep = &hpcd->OUT_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 0U; | |
} | |
ep->num = ep_addr & EP_ADDR_MSK; | |
__HAL_LOCK(hpcd); | |
(void)USB_DeactivateEndpoint(hpcd->Instance, ep); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Receive an amount of data. | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @param pBuf pointer to the reception buffer | |
* @param len amount of data to be received | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_Receive(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint8_t *pBuf, uint32_t len) | |
{ | |
PCD_EPTypeDef *ep; | |
ep = &hpcd->OUT_ep[ep_addr & EP_ADDR_MSK]; | |
/*setup and start the Xfer */ | |
ep->xfer_buff = pBuf; | |
ep->xfer_len = len; | |
ep->xfer_count = 0U; | |
ep->is_in = 0U; | |
ep->num = ep_addr & EP_ADDR_MSK; | |
if ((ep_addr & EP_ADDR_MSK) == 0U) | |
{ | |
(void)USB_EP0StartXfer(hpcd->Instance, ep); | |
} | |
else | |
{ | |
(void)USB_EPStartXfer(hpcd->Instance, ep); | |
} | |
return HAL_OK; | |
} | |
/** | |
* @brief Get Received Data Size | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @retval Data Size | |
*/ | |
uint32_t HAL_PCD_EP_GetRxCount(PCD_HandleTypeDef *hpcd, uint8_t ep_addr) | |
{ | |
return hpcd->OUT_ep[ep_addr & EP_ADDR_MSK].xfer_count; | |
} | |
/** | |
* @brief Send an amount of data | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @param pBuf pointer to the transmission buffer | |
* @param len amount of data to be sent | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_Transmit(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint8_t *pBuf, uint32_t len) | |
{ | |
PCD_EPTypeDef *ep; | |
ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; | |
/*setup and start the Xfer */ | |
ep->xfer_buff = pBuf; | |
ep->xfer_len = len; | |
ep->xfer_count = 0U; | |
ep->is_in = 1U; | |
ep->num = ep_addr & EP_ADDR_MSK; | |
if ((ep_addr & EP_ADDR_MSK) == 0U) | |
{ | |
(void)USB_EP0StartXfer(hpcd->Instance, ep); | |
} | |
else | |
{ | |
(void)USB_EPStartXfer(hpcd->Instance, ep); | |
} | |
return HAL_OK; | |
} | |
/** | |
* @brief Set a STALL condition over an endpoint | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_SetStall(PCD_HandleTypeDef *hpcd, uint8_t ep_addr) | |
{ | |
PCD_EPTypeDef *ep; | |
if (((uint32_t)ep_addr & EP_ADDR_MSK) > hpcd->Init.dev_endpoints) | |
{ | |
return HAL_ERROR; | |
} | |
if ((0x80U & ep_addr) == 0x80U) | |
{ | |
ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 1U; | |
} | |
else | |
{ | |
ep = &hpcd->OUT_ep[ep_addr]; | |
ep->is_in = 0U; | |
} | |
ep->is_stall = 1U; | |
ep->num = ep_addr & EP_ADDR_MSK; | |
__HAL_LOCK(hpcd); | |
(void)USB_EPSetStall(hpcd->Instance, ep); | |
if ((ep_addr & EP_ADDR_MSK) == 0U) | |
{ | |
(void)USB_EP0_OutStart(hpcd->Instance, (uint8_t *)hpcd->Setup); | |
} | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Clear a STALL condition over in an endpoint | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_ClrStall(PCD_HandleTypeDef *hpcd, uint8_t ep_addr) | |
{ | |
PCD_EPTypeDef *ep; | |
if (((uint32_t)ep_addr & 0x0FU) > hpcd->Init.dev_endpoints) | |
{ | |
return HAL_ERROR; | |
} | |
if ((0x80U & ep_addr) == 0x80U) | |
{ | |
ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 1U; | |
} | |
else | |
{ | |
ep = &hpcd->OUT_ep[ep_addr & EP_ADDR_MSK]; | |
ep->is_in = 0U; | |
} | |
ep->is_stall = 0U; | |
ep->num = ep_addr & EP_ADDR_MSK; | |
__HAL_LOCK(hpcd); | |
(void)USB_EPClearStall(hpcd->Instance, ep); | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Flush an endpoint | |
* @param hpcd PCD handle | |
* @param ep_addr endpoint address | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_EP_Flush(PCD_HandleTypeDef *hpcd, uint8_t ep_addr) | |
{ | |
__HAL_LOCK(hpcd); | |
if ((ep_addr & 0x80U) == 0x80U) | |
{ | |
(void)USB_FlushTxFifo(hpcd->Instance, (uint32_t)ep_addr & EP_ADDR_MSK); | |
} | |
else | |
{ | |
(void)USB_FlushRxFifo(hpcd->Instance); | |
} | |
__HAL_UNLOCK(hpcd); | |
return HAL_OK; | |
} | |
/** | |
* @brief Activate remote wakeup signalling | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_ActivateRemoteWakeup(PCD_HandleTypeDef *hpcd) | |
{ | |
return (USB_ActivateRemoteWakeup(hpcd->Instance)); | |
} | |
/** | |
* @brief De-activate remote wakeup signalling. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
HAL_StatusTypeDef HAL_PCD_DeActivateRemoteWakeup(PCD_HandleTypeDef *hpcd) | |
{ | |
return (USB_DeActivateRemoteWakeup(hpcd->Instance)); | |
} | |
/** | |
* @} | |
*/ | |
/** @defgroup PCD_Exported_Functions_Group4 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 PCD handle state. | |
* @param hpcd PCD handle | |
* @retval HAL state | |
*/ | |
PCD_StateTypeDef HAL_PCD_GetState(PCD_HandleTypeDef *hpcd) | |
{ | |
return hpcd->State; | |
} | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
/* Private functions ---------------------------------------------------------*/ | |
/** @addtogroup PCD_Private_Functions | |
* @{ | |
*/ | |
#if defined (USB_OTG_FS) | |
/** | |
* @brief Check FIFO for the next packet to be loaded. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval HAL status | |
*/ | |
static HAL_StatusTypeDef PCD_WriteEmptyTxFifo(PCD_HandleTypeDef *hpcd, uint32_t epnum) | |
{ | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
uint32_t USBx_BASE = (uint32_t)USBx; | |
USB_OTG_EPTypeDef *ep; | |
uint32_t len; | |
uint32_t len32b; | |
uint32_t fifoemptymsk; | |
ep = &hpcd->IN_ep[epnum]; | |
if (ep->xfer_count > ep->xfer_len) | |
{ | |
return HAL_ERROR; | |
} | |
len = ep->xfer_len - ep->xfer_count; | |
if (len > ep->maxpacket) | |
{ | |
len = ep->maxpacket; | |
} | |
len32b = (len + 3U) / 4U; | |
while (((USBx_INEP(epnum)->DTXFSTS & USB_OTG_DTXFSTS_INEPTFSAV) >= len32b) && | |
(ep->xfer_count < ep->xfer_len) && (ep->xfer_len != 0U)) | |
{ | |
/* Write the FIFO */ | |
len = ep->xfer_len - ep->xfer_count; | |
if (len > ep->maxpacket) | |
{ | |
len = ep->maxpacket; | |
} | |
len32b = (len + 3U) / 4U; | |
(void)USB_WritePacket(USBx, ep->xfer_buff, (uint8_t)epnum, (uint16_t)len); | |
ep->xfer_buff += len; | |
ep->xfer_count += len; | |
} | |
if (ep->xfer_len <= ep->xfer_count) | |
{ | |
fifoemptymsk = (uint32_t)(0x1UL << (epnum & EP_ADDR_MSK)); | |
USBx_DEVICE->DIEPEMPMSK &= ~fifoemptymsk; | |
} | |
return HAL_OK; | |
} | |
/** | |
* @brief process EP OUT transfer complete interrupt. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval HAL status | |
*/ | |
static HAL_StatusTypeDef PCD_EP_OutXfrComplete_int(PCD_HandleTypeDef *hpcd, uint32_t epnum) | |
{ | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
uint32_t USBx_BASE = (uint32_t)USBx; | |
uint32_t gSNPSiD = *(__IO uint32_t *)(&USBx->CID + 0x1U); | |
uint32_t DoepintReg = USBx_OUTEP(epnum)->DOEPINT; | |
if (gSNPSiD == USB_OTG_CORE_ID_310A) | |
{ | |
/* StupPktRcvd = 1 this is a setup packet */ | |
if ((DoepintReg & USB_OTG_DOEPINT_STPKTRX) == USB_OTG_DOEPINT_STPKTRX) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_STPKTRX); | |
} | |
else | |
{ | |
if ((DoepintReg & USB_OTG_DOEPINT_OTEPSPR) == USB_OTG_DOEPINT_OTEPSPR) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_OTEPSPR); | |
} | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataOutStageCallback(hpcd, (uint8_t)epnum); | |
#else | |
HAL_PCD_DataOutStageCallback(hpcd, (uint8_t)epnum); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
} | |
else | |
{ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataOutStageCallback(hpcd, (uint8_t)epnum); | |
#else | |
HAL_PCD_DataOutStageCallback(hpcd, (uint8_t)epnum); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
return HAL_OK; | |
} | |
/** | |
* @brief process EP OUT setup packet received interrupt. | |
* @param hpcd PCD handle | |
* @param epnum endpoint number | |
* @retval HAL status | |
*/ | |
static HAL_StatusTypeDef PCD_EP_OutSetupPacket_int(PCD_HandleTypeDef *hpcd, uint32_t epnum) | |
{ | |
USB_OTG_GlobalTypeDef *USBx = hpcd->Instance; | |
uint32_t USBx_BASE = (uint32_t)USBx; | |
uint32_t gSNPSiD = *(__IO uint32_t *)(&USBx->CID + 0x1U); | |
uint32_t DoepintReg = USBx_OUTEP(epnum)->DOEPINT; | |
if ((gSNPSiD == USB_OTG_CORE_ID_310A) && | |
((DoepintReg & USB_OTG_DOEPINT_STPKTRX) == USB_OTG_DOEPINT_STPKTRX)) | |
{ | |
CLEAR_OUT_EP_INTR(epnum, USB_OTG_DOEPINT_STPKTRX); | |
} | |
/* Inform the upper layer that a setup packet is available */ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SetupStageCallback(hpcd); | |
#else | |
HAL_PCD_SetupStageCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
return HAL_OK; | |
} | |
#endif /* defined (USB_OTG_FS) */ | |
#if defined (USB) | |
/** | |
* @brief This function handles PCD Endpoint interrupt request. | |
* @param hpcd PCD handle | |
* @retval HAL status | |
*/ | |
static HAL_StatusTypeDef PCD_EP_ISR_Handler(PCD_HandleTypeDef *hpcd) | |
{ | |
PCD_EPTypeDef *ep; | |
uint16_t count; | |
uint16_t wIstr; | |
uint16_t wEPVal; | |
uint8_t epindex; | |
/* stay in loop while pending interrupts */ | |
while ((hpcd->Instance->ISTR & USB_ISTR_CTR) != 0U) | |
{ | |
wIstr = hpcd->Instance->ISTR; | |
/* extract highest priority endpoint number */ | |
epindex = (uint8_t)(wIstr & USB_ISTR_EP_ID); | |
if (epindex == 0U) | |
{ | |
/* Decode and service control endpoint interrupt */ | |
/* DIR bit = origin of the interrupt */ | |
if ((wIstr & USB_ISTR_DIR) == 0U) | |
{ | |
/* DIR = 0 */ | |
/* DIR = 0 => IN int */ | |
/* DIR = 0 implies that (EP_CTR_TX = 1) always */ | |
PCD_CLEAR_TX_EP_CTR(hpcd->Instance, PCD_ENDP0); | |
ep = &hpcd->IN_ep[0]; | |
ep->xfer_count = PCD_GET_EP_TX_CNT(hpcd->Instance, ep->num); | |
ep->xfer_buff += ep->xfer_count; | |
/* TX COMPLETE */ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataInStageCallback(hpcd, 0U); | |
#else | |
HAL_PCD_DataInStageCallback(hpcd, 0U); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
if ((hpcd->USB_Address > 0U) && (ep->xfer_len == 0U)) | |
{ | |
hpcd->Instance->DADDR = ((uint16_t)hpcd->USB_Address | USB_DADDR_EF); | |
hpcd->USB_Address = 0U; | |
} | |
} | |
else | |
{ | |
/* DIR = 1 */ | |
/* DIR = 1 & CTR_RX => SETUP or OUT int */ | |
/* DIR = 1 & (CTR_TX | CTR_RX) => 2 int pending */ | |
ep = &hpcd->OUT_ep[0]; | |
wEPVal = PCD_GET_ENDPOINT(hpcd->Instance, PCD_ENDP0); | |
if ((wEPVal & USB_EP_SETUP) != 0U) | |
{ | |
/* Get SETUP Packet*/ | |
ep->xfer_count = PCD_GET_EP_RX_CNT(hpcd->Instance, ep->num); | |
USB_ReadPMA(hpcd->Instance, (uint8_t *)hpcd->Setup, | |
ep->pmaadress, (uint16_t)ep->xfer_count); | |
/* SETUP bit kept frozen while CTR_RX = 1*/ | |
PCD_CLEAR_RX_EP_CTR(hpcd->Instance, PCD_ENDP0); | |
/* Process SETUP Packet*/ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->SetupStageCallback(hpcd); | |
#else | |
HAL_PCD_SetupStageCallback(hpcd); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else if ((wEPVal & USB_EP_CTR_RX) != 0U) | |
{ | |
PCD_CLEAR_RX_EP_CTR(hpcd->Instance, PCD_ENDP0); | |
/* Get Control Data OUT Packet*/ | |
ep->xfer_count = PCD_GET_EP_RX_CNT(hpcd->Instance, ep->num); | |
if ((ep->xfer_count != 0U) && (ep->xfer_buff != 0U)) | |
{ | |
USB_ReadPMA(hpcd->Instance, ep->xfer_buff, | |
ep->pmaadress, (uint16_t)ep->xfer_count); | |
ep->xfer_buff += ep->xfer_count; | |
/* Process Control Data OUT Packet*/ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataOutStageCallback(hpcd, 0U); | |
#else | |
HAL_PCD_DataOutStageCallback(hpcd, 0U); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
PCD_SET_EP_RX_CNT(hpcd->Instance, PCD_ENDP0, ep->maxpacket); | |
PCD_SET_EP_RX_STATUS(hpcd->Instance, PCD_ENDP0, USB_EP_RX_VALID); | |
} | |
} | |
} | |
else | |
{ | |
/* Decode and service non control endpoints interrupt */ | |
/* process related endpoint register */ | |
wEPVal = PCD_GET_ENDPOINT(hpcd->Instance, epindex); | |
if ((wEPVal & USB_EP_CTR_RX) != 0U) | |
{ | |
/* clear int flag */ | |
PCD_CLEAR_RX_EP_CTR(hpcd->Instance, epindex); | |
ep = &hpcd->OUT_ep[epindex]; | |
/* OUT double Buffering*/ | |
if (ep->doublebuffer == 0U) | |
{ | |
count = (uint16_t)PCD_GET_EP_RX_CNT(hpcd->Instance, ep->num); | |
if (count != 0U) | |
{ | |
USB_ReadPMA(hpcd->Instance, ep->xfer_buff, ep->pmaadress, count); | |
} | |
} | |
else | |
{ | |
if ((PCD_GET_ENDPOINT(hpcd->Instance, ep->num) & USB_EP_DTOG_RX) != 0U) | |
{ | |
/*read from endpoint BUF0Addr buffer*/ | |
count = (uint16_t)PCD_GET_EP_DBUF0_CNT(hpcd->Instance, ep->num); | |
if (count != 0U) | |
{ | |
USB_ReadPMA(hpcd->Instance, ep->xfer_buff, ep->pmaaddr0, count); | |
} | |
} | |
else | |
{ | |
/*read from endpoint BUF1Addr buffer*/ | |
count = (uint16_t)PCD_GET_EP_DBUF1_CNT(hpcd->Instance, ep->num); | |
if (count != 0U) | |
{ | |
USB_ReadPMA(hpcd->Instance, ep->xfer_buff, ep->pmaaddr1, count); | |
} | |
} | |
/* free EP OUT Buffer */ | |
PCD_FreeUserBuffer(hpcd->Instance, ep->num, 0U); | |
} | |
/*multi-packet on the NON control OUT endpoint*/ | |
ep->xfer_count += count; | |
ep->xfer_buff += count; | |
if ((ep->xfer_len == 0U) || (count < ep->maxpacket)) | |
{ | |
/* RX COMPLETE */ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataOutStageCallback(hpcd, ep->num); | |
#else | |
HAL_PCD_DataOutStageCallback(hpcd, ep->num); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else | |
{ | |
(void)HAL_PCD_EP_Receive(hpcd, ep->num, ep->xfer_buff, ep->xfer_len); | |
} | |
} /* if((wEPVal & EP_CTR_RX) */ | |
if ((wEPVal & USB_EP_CTR_TX) != 0U) | |
{ | |
ep = &hpcd->IN_ep[epindex]; | |
/* clear int flag */ | |
PCD_CLEAR_TX_EP_CTR(hpcd->Instance, epindex); | |
/*multi-packet on the NON control IN endpoint*/ | |
ep->xfer_count = PCD_GET_EP_TX_CNT(hpcd->Instance, ep->num); | |
ep->xfer_buff += ep->xfer_count; | |
/* Zero Length Packet? */ | |
if (ep->xfer_len == 0U) | |
{ | |
/* TX COMPLETE */ | |
#if (USE_HAL_PCD_REGISTER_CALLBACKS == 1U) | |
hpcd->DataInStageCallback(hpcd, ep->num); | |
#else | |
HAL_PCD_DataInStageCallback(hpcd, ep->num); | |
#endif /* USE_HAL_PCD_REGISTER_CALLBACKS */ | |
} | |
else | |
{ | |
(void)HAL_PCD_EP_Transmit(hpcd, ep->num, ep->xfer_buff, ep->xfer_len); | |
} | |
} | |
} | |
} | |
return HAL_OK; | |
} | |
#endif /* defined (USB) */ | |
/** | |
* @} | |
*/ | |
#endif /* defined (USB) || defined (USB_OTG_FS) */ | |
#endif /* HAL_PCD_MODULE_ENABLED */ | |
/** | |
* @} | |
*/ | |
/** | |
* @} | |
*/ | |
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |