| /** |
| ****************************************************************************** |
| * @file stm32f3xx_hal_pcd_ex.c |
| * @author MCD Application Team |
| * @brief PCD Extended HAL module driver. |
| * This file provides firmware functions to manage the following |
| * functionalities of the USB Peripheral Controller: |
| * + Extended features functions |
| * |
| ****************************************************************************** |
| * @attention |
| * |
| * Copyright (c) 2016 STMicroelectronics. |
| * All rights reserved. |
| * |
| * This software is licensed under terms that can be found in the LICENSE file |
| * in the root directory of this software component. |
| * If no LICENSE file comes with this software, it is provided AS-IS. |
| * |
| ****************************************************************************** |
| */ |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32f3xx_hal.h" |
| |
| /** @addtogroup STM32F3xx_HAL_Driver |
| * @{ |
| */ |
| |
| /** @defgroup PCDEx PCDEx |
| * @brief PCD Extended HAL module driver |
| * @{ |
| */ |
| |
| #ifdef HAL_PCD_MODULE_ENABLED |
| |
| #if defined (USB) |
| /* Private types -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private constants ---------------------------------------------------------*/ |
| /* Private macros ------------------------------------------------------------*/ |
| /* Private functions ---------------------------------------------------------*/ |
| /* Exported functions --------------------------------------------------------*/ |
| |
| /** @defgroup PCDEx_Exported_Functions PCDEx Exported Functions |
| * @{ |
| */ |
| |
| /** @defgroup PCDEx_Exported_Functions_Group1 Peripheral Control functions |
| * @brief PCDEx control functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Extended features functions ##### |
| =============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Update FIFO configuration |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Configure PMA for EP |
| * @param hpcd Device instance |
| * @param ep_addr endpoint address |
| * @param ep_kind endpoint Kind |
| * USB_SNG_BUF: Single Buffer used |
| * USB_DBL_BUF: Double Buffer used |
| * @param pmaadress: EP address in The PMA: In case of single buffer endpoint |
| * this parameter is 16-bit value providing the address |
| * in PMA allocated to endpoint. |
| * In case of double buffer endpoint this parameter |
| * is a 32-bit value providing the endpoint buffer 0 address |
| * in the LSB part of 32-bit value and endpoint buffer 1 address |
| * in the MSB part of 32-bit value. |
| * @retval HAL status |
| */ |
| |
| HAL_StatusTypeDef HAL_PCDEx_PMAConfig(PCD_HandleTypeDef *hpcd, uint16_t ep_addr, |
| uint16_t ep_kind, uint32_t pmaadress) |
| { |
| PCD_EPTypeDef *ep; |
| |
| /* initialize ep structure*/ |
| if ((0x80U & ep_addr) == 0x80U) |
| { |
| ep = &hpcd->IN_ep[ep_addr & EP_ADDR_MSK]; |
| } |
| else |
| { |
| ep = &hpcd->OUT_ep[ep_addr]; |
| } |
| |
| /* Here we check if the endpoint is single or double Buffer*/ |
| if (ep_kind == PCD_SNG_BUF) |
| { |
| /* Single Buffer */ |
| ep->doublebuffer = 0U; |
| /* Configure the PMA */ |
| ep->pmaadress = (uint16_t)pmaadress; |
| } |
| else /* USB_DBL_BUF */ |
| { |
| /* Double Buffer Endpoint */ |
| ep->doublebuffer = 1U; |
| /* Configure the PMA */ |
| ep->pmaaddr0 = (uint16_t)(pmaadress & 0xFFFFU); |
| ep->pmaaddr1 = (uint16_t)((pmaadress & 0xFFFF0000U) >> 16); |
| } |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Software Device Connection, |
| * this function is not required by USB OTG FS peripheral, it is used |
| * only by USB Device FS peripheral. |
| * @param hpcd PCD handle |
| * @param state connection state (0 : disconnected / 1: connected) |
| * @retval None |
| */ |
| __weak void HAL_PCDEx_SetConnectionState(PCD_HandleTypeDef *hpcd, uint8_t state) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpcd); |
| UNUSED(state); |
| /* NOTE : This function Should not be modified, when the callback is needed, |
| the HAL_PCDEx_SetConnectionState could be implemented in the user file |
| */ |
| } |
| |
| |
| /** |
| * @brief Send LPM message to user layer callback. |
| * @param hpcd PCD handle |
| * @param msg LPM message |
| * @retval HAL status |
| */ |
| __weak void HAL_PCDEx_LPM_Callback(PCD_HandleTypeDef *hpcd, PCD_LPM_MsgTypeDef msg) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpcd); |
| UNUSED(msg); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_PCDEx_LPM_Callback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief Send BatteryCharging message to user layer callback. |
| * @param hpcd PCD handle |
| * @param msg LPM message |
| * @retval HAL status |
| */ |
| __weak void HAL_PCDEx_BCD_Callback(PCD_HandleTypeDef *hpcd, PCD_BCD_MsgTypeDef msg) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpcd); |
| UNUSED(msg); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_PCDEx_BCD_Callback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| #endif /* defined (USB) */ |
| #endif /* HAL_PCD_MODULE_ENABLED */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |