/** ****************************************************************************** * @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 * *

© 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. * * 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****/