| /** |
| ****************************************************************************** |
| * @file stm32l0xx_hal_pcd_ex.c |
| * @author MCD Application Team |
| * @brief Extended PCD HAL module driver. |
| * This file provides firmware functions to manage the following |
| * functionalities of the USB Peripheral Controller: |
| * + Configururation of the PMA for EP |
| * |
| ****************************************************************************** |
| * @attention |
| * |
| * <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2> |
| * |
| * 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. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| * 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 |
| * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
| * 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. |
| * |
| ****************************************************************************** |
| */ |
| |
| #if !defined(STM32L011xx) && !defined(STM32L021xx) && !defined (STM32L031xx) && !defined (STM32L041xx) && !defined (STM32L051xx) && !defined (STM32L061xx) && !defined (STM32L071xx) && !defined (STM32L081xx) |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32l0xx_hal.h" |
| #ifdef HAL_PCD_MODULE_ENABLED |
| /** @addtogroup STM32L0xx_HAL_Driver |
| * @{ |
| */ |
| |
| /** @addtogroup PCDEx |
| * @brief PCDEx HAL module driver |
| * @{ |
| */ |
| |
| |
| |
| /* Private typedef -----------------------------------------------------------*/ |
| /* Private define ------------------------------------------------------------*/ |
| /* Private macro -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private function prototypes -----------------------------------------------*/ |
| /* Private functions ---------------------------------------------------------*/ |
| |
| |
| /** @addtogroup PCDEx_Exported_Functions PCDEx Exported Functions |
| * @{ |
| */ |
| |
| /** @addtogroup PCDEx__Exported_Functions_Group1 |
| * @brief Initialization and Configuration functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Peripheral extended features functions ##### |
| =============================================================================== |
| @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 : 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 & 0x7FU]; |
| } |
| 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 te PMA*/ |
| ep->pmaadress = (uint16_t)pmaadress; |
| } |
| else /*USB_DBL_BUF*/ |
| { |
| /*Double Buffer Endpoint*/ |
| ep->doublebuffer = 1U; |
| /*Configure the PMA*/ |
| ep->pmaaddr0 = pmaadress & 0xFFFFU; |
| ep->pmaaddr1 = (pmaadress & 0xFFFF0000U) >> 16U; |
| } |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Activate BatteryCharging feature. |
| * @param hpcd: PCD handle |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCDEx_ActivateBCD(PCD_HandleTypeDef *hpcd) |
| { |
| USB_TypeDef *USBx = hpcd->Instance; |
| hpcd->battery_charging_active = ENABLE; |
| |
| USBx->BCDR |= (USB_BCDR_BCDEN); |
| /* Enable DCD : Data Contact Detect */ |
| USBx->BCDR |= (USB_BCDR_DCDEN); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Deactivate BatteryCharging feature. |
| * @param hpcd: PCD handle |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCDEx_DeActivateBCD(PCD_HandleTypeDef *hpcd) |
| { |
| USB_TypeDef *USBx = hpcd->Instance; |
| hpcd->battery_charging_active = DISABLE; |
| |
| USBx->BCDR &= ~(USB_BCDR_BCDEN); |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Handle BatteryCharging Process. |
| * @param hpcd: PCD handle |
| * @retval HAL status |
| */ |
| void HAL_PCDEx_BCD_VBUSDetect(PCD_HandleTypeDef *hpcd) |
| { |
| USB_TypeDef *USBx = hpcd->Instance; |
| uint32_t tickstart = HAL_GetTick(); |
| |
| /* Wait Detect flag or a timeout is happen*/ |
| while ((USBx->BCDR & USB_BCDR_DCDET) == 0) |
| { |
| /* Check for the Timeout */ |
| if((HAL_GetTick() - tickstart ) > 1000) |
| { |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_ERROR); |
| return; |
| } |
| } |
| |
| HAL_Delay(300); |
| |
| /* Data Pin Contact ? Check Detect flag */ |
| if (USBx->BCDR & USB_BCDR_DCDET) |
| { |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CONTACT_DETECTION); |
| } |
| /* Primary detection: checks if connected to Standard Downstream Port |
| (without charging capability) */ |
| USBx->BCDR &= ~(USB_BCDR_DCDEN); |
| USBx->BCDR |= (USB_BCDR_PDEN); |
| HAL_Delay(300); |
| |
| /* If Charger detect ? */ |
| if (USBx->BCDR & USB_BCDR_PDET) |
| { |
| /* Start secondary detection to check connection to Charging Downstream |
| Port or Dedicated Charging Port */ |
| USBx->BCDR &= ~(USB_BCDR_PDEN); |
| USBx->BCDR |= (USB_BCDR_SDEN); |
| HAL_Delay(300); |
| |
| /* If CDP ? */ |
| if (USBx->BCDR & USB_BCDR_SDET) |
| { |
| /* Dedicated Downstream Port DCP */ |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DEDICATED_CHARGING_PORT); |
| } |
| else |
| { |
| /* Charging Downstream Port CDP */ |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CHARGING_DOWNSTREAM_PORT); |
| } |
| } |
| else |
| { |
| /* Standard Downstream Port */ |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_STD_DOWNSTREAM_PORT); |
| } |
| /* Battery Charging capability discovery finished |
| Start Enumeration*/ |
| HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DISCOVERY_COMPLETED); |
| } |
| |
| /** |
| * @brief Activate LPM feature. |
| * @param hpcd: PCD handle |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCDEx_ActivateLPM(PCD_HandleTypeDef *hpcd) |
| { |
| |
| USB_TypeDef *USBx = hpcd->Instance; |
| hpcd->lpm_active = ENABLE; |
| hpcd->LPM_State = LPM_L0; |
| |
| USBx->LPMCSR |= (USB_LPMCSR_LMPEN); |
| USBx->LPMCSR |= (USB_LPMCSR_LPMACK); |
| |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Deactivate LPM feature. |
| * @param hpcd: PCD handle |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCDEx_DeActivateLPM(PCD_HandleTypeDef *hpcd) |
| { |
| USB_TypeDef *USBx = hpcd->Instance; |
| |
| hpcd->lpm_active = DISABLE; |
| |
| USBx->LPMCSR &= ~ (USB_LPMCSR_LMPEN); |
| USBx->LPMCSR &= ~ (USB_LPMCSR_LPMACK); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @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 /* HAL_PCD_MODULE_ENABLED */ |
| #endif /* #if !defined(STM32L011xx) && !defined(STM32L021xx) && !defined (STM32L031xx) && !defined (STM32L041xx) && !defined (STM32L051xx) && !defined (STM32L061xx) && !defined (STM32L071xx) && !defined (STM32L081xx) */ |
| /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |