siva surendar / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32L4/device/stm32l4xx_hal_pcd_ex.c@150:da61ba4e9755, 2016-11-25 (annotated)

Committer:
sivasuren
Date:
Fri Nov 25 07:57:40 2016 +0000
Revision:
150:da61ba4e9755
Parent:
149:156823d33999 
surendar changes

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32l4xx_hal_pcd_ex.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.5.1
<> 144:ef7eb2e8f9f7 6 * @date 31-May-2016
<> 144:ef7eb2e8f9f7 7 * @brief PCD Extended HAL module driver.
<> 144:ef7eb2e8f9f7 8 * This file provides firmware functions to manage the following
<> 144:ef7eb2e8f9f7 9 * functionalities of the USB Peripheral Controller:
<> 144:ef7eb2e8f9f7 10 * + Extended features functions
<> 144:ef7eb2e8f9f7 11 *
<> 144:ef7eb2e8f9f7 12 ******************************************************************************
<> 144:ef7eb2e8f9f7 13 * @attention
<> 144:ef7eb2e8f9f7 14 *
<> 144:ef7eb2e8f9f7 15 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 16 *
<> 144:ef7eb2e8f9f7 17 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 18 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 19 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 20 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 21 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 22 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 23 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 24 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 25 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 26 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 27 *
<> 144:ef7eb2e8f9f7 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 31 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 34 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 35 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 36 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 38 *
<> 144:ef7eb2e8f9f7 39 ******************************************************************************
<> 144:ef7eb2e8f9f7 40 */
<> 144:ef7eb2e8f9f7 41
<> 144:ef7eb2e8f9f7 42 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 43 #include "stm32l4xx_hal.h"
<> 144:ef7eb2e8f9f7 44
<> 144:ef7eb2e8f9f7 45 /** @addtogroup STM32L4xx_HAL_Driver
<> 144:ef7eb2e8f9f7 46 * @{
<> 144:ef7eb2e8f9f7 47 */
<> 144:ef7eb2e8f9f7 48 #ifdef HAL_PCD_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 49
<> 144:ef7eb2e8f9f7 50 #if defined(STM32L475xx) || defined(STM32L476xx) || \
<> 144:ef7eb2e8f9f7 51 defined(STM32L485xx) || defined(STM32L486xx) || \
<> 144:ef7eb2e8f9f7 52 defined(STM32L432xx) || defined(STM32L433xx) || \
<> 144:ef7eb2e8f9f7 53 defined(STM32L442xx) || defined(STM32L443xx)
<> 144:ef7eb2e8f9f7 54
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /** @defgroup PCDEx PCDEx
<> 144:ef7eb2e8f9f7 57 * @brief PCD Extended HAL module driver
<> 144:ef7eb2e8f9f7 58 * @{
<> 144:ef7eb2e8f9f7 59 */
<> 144:ef7eb2e8f9f7 60
<> 144:ef7eb2e8f9f7 61 /* Private types -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 62 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 63 /* Private constants ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 64 /* Private macros ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 65 /* Private functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 66 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 67
<> 144:ef7eb2e8f9f7 68 /** @defgroup PCDEx_Exported_Functions PCDEx Exported Functions
<> 144:ef7eb2e8f9f7 69 * @{
<> 144:ef7eb2e8f9f7 70 */
<> 144:ef7eb2e8f9f7 71
<> 144:ef7eb2e8f9f7 72 /** @defgroup PCDEx_Exported_Functions_Group1 Peripheral Control functions
<> 144:ef7eb2e8f9f7 73 * @brief PCDEx control functions
<> 144:ef7eb2e8f9f7 74 *
<> 144:ef7eb2e8f9f7 75 @verbatim
<> 144:ef7eb2e8f9f7 76 ===============================================================================
<> 144:ef7eb2e8f9f7 77 ##### Extended features functions #####
<> 144:ef7eb2e8f9f7 78 ===============================================================================
<> 144:ef7eb2e8f9f7 79 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 80 (+) Update FIFO configuration
<> 144:ef7eb2e8f9f7 81
<> 144:ef7eb2e8f9f7 82 @endverbatim
<> 144:ef7eb2e8f9f7 83 * @{
<> 144:ef7eb2e8f9f7 84 */
<> 144:ef7eb2e8f9f7 85 #if defined (USB_OTG_FS)
<> 144:ef7eb2e8f9f7 86 /**
<> 144:ef7eb2e8f9f7 87 * @brief Set Tx FIFO
<> 144:ef7eb2e8f9f7 88 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 89 * @param fifo: The number of Tx fifo
<> 144:ef7eb2e8f9f7 90 * @param size: Fifo size
<> 144:ef7eb2e8f9f7 91 * @retval HAL status
<> 144:ef7eb2e8f9f7 92 */
<> 144:ef7eb2e8f9f7 93 HAL_StatusTypeDef HAL_PCDEx_SetTxFiFo(PCD_HandleTypeDef *hpcd, uint8_t fifo, uint16_t size)
<> 144:ef7eb2e8f9f7 94 {
<> 144:ef7eb2e8f9f7 95 uint8_t index = 0;
<> 144:ef7eb2e8f9f7 96 uint32_t Tx_Offset = 0;
<> 144:ef7eb2e8f9f7 97
<> 144:ef7eb2e8f9f7 98 /* TXn min size = 16 words. (n : Transmit FIFO index)
<> 144:ef7eb2e8f9f7 99 When a TxFIFO is not used, the Configuration should be as follows:
<> 144:ef7eb2e8f9f7 100 case 1 : n > m and Txn is not used (n,m : Transmit FIFO indexes)
<> 144:ef7eb2e8f9f7 101 --> Txm can use the space allocated for Txn.
<> 144:ef7eb2e8f9f7 102 case2 : n < m and Txn is not used (n,m : Transmit FIFO indexes)
<> 144:ef7eb2e8f9f7 103 --> Txn should be configured with the minimum space of 16 words
<> 144:ef7eb2e8f9f7 104 The FIFO is used optimally when used TxFIFOs are allocated in the top
<> 144:ef7eb2e8f9f7 105 of the FIFO.Ex: use EP1 and EP2 as IN instead of EP1 and EP3 as IN ones.
<> 144:ef7eb2e8f9f7 106 When DMA is used 3n * FIFO locations should be reserved for internal DMA registers */
<> 144:ef7eb2e8f9f7 107
<> 144:ef7eb2e8f9f7 108 Tx_Offset = hpcd->Instance->GRXFSIZ;
<> 144:ef7eb2e8f9f7 109
<> 144:ef7eb2e8f9f7 110 if(fifo == 0)
<> 144:ef7eb2e8f9f7 111 {
<> 144:ef7eb2e8f9f7 112 hpcd->Instance->DIEPTXF0_HNPTXFSIZ = (size << 16) | Tx_Offset;
<> 144:ef7eb2e8f9f7 113 }
<> 144:ef7eb2e8f9f7 114 else
<> 144:ef7eb2e8f9f7 115 {
<> 144:ef7eb2e8f9f7 116 Tx_Offset += (hpcd->Instance->DIEPTXF0_HNPTXFSIZ) >> 16;
<> 144:ef7eb2e8f9f7 117 for (index = 0; index < (fifo - 1); index++)
<> 144:ef7eb2e8f9f7 118 {
<> 144:ef7eb2e8f9f7 119 Tx_Offset += (hpcd->Instance->DIEPTXF[index] >> 16);
<> 144:ef7eb2e8f9f7 120 }
<> 144:ef7eb2e8f9f7 121
<> 144:ef7eb2e8f9f7 122 /* Multiply Tx_Size by 2 to get higher performance */
<> 144:ef7eb2e8f9f7 123 hpcd->Instance->DIEPTXF[fifo - 1] = (size << 16) | Tx_Offset;
<> 144:ef7eb2e8f9f7 124 }
<> 144:ef7eb2e8f9f7 125
<> 144:ef7eb2e8f9f7 126 return HAL_OK;
<> 144:ef7eb2e8f9f7 127 }
<> 144:ef7eb2e8f9f7 128
<> 144:ef7eb2e8f9f7 129 /**
<> 144:ef7eb2e8f9f7 130 * @brief Set Rx FIFO
<> 144:ef7eb2e8f9f7 131 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 132 * @param size: Size of Rx fifo
<> 144:ef7eb2e8f9f7 133 * @retval HAL status
<> 144:ef7eb2e8f9f7 134 */
<> 144:ef7eb2e8f9f7 135 HAL_StatusTypeDef HAL_PCDEx_SetRxFiFo(PCD_HandleTypeDef *hpcd, uint16_t size)
<> 144:ef7eb2e8f9f7 136 {
<> 144:ef7eb2e8f9f7 137 hpcd->Instance->GRXFSIZ = size;
<> 144:ef7eb2e8f9f7 138
<> 144:ef7eb2e8f9f7 139 return HAL_OK;
<> 144:ef7eb2e8f9f7 140 }
<> 144:ef7eb2e8f9f7 141
<> 144:ef7eb2e8f9f7 142 /**
<> 144:ef7eb2e8f9f7 143 * @brief Activate LPM feature.
<> 144:ef7eb2e8f9f7 144 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 145 * @retval HAL status
<> 144:ef7eb2e8f9f7 146 */
<> 144:ef7eb2e8f9f7 147 HAL_StatusTypeDef HAL_PCDEx_ActivateLPM(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 148 {
<> 144:ef7eb2e8f9f7 149 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 150
<> 144:ef7eb2e8f9f7 151 hpcd->lpm_active = ENABLE;
<> 144:ef7eb2e8f9f7 152 hpcd->LPM_State = LPM_L0;
<> 144:ef7eb2e8f9f7 153 USBx->GINTMSK |= USB_OTG_GINTMSK_LPMINTM;
<> 144:ef7eb2e8f9f7 154 USBx->GLPMCFG |= (USB_OTG_GLPMCFG_LPMEN | USB_OTG_GLPMCFG_LPMACK | USB_OTG_GLPMCFG_ENBESL);
<> 144:ef7eb2e8f9f7 155
<> 144:ef7eb2e8f9f7 156 return HAL_OK;
<> 144:ef7eb2e8f9f7 157 }
<> 144:ef7eb2e8f9f7 158
<> 144:ef7eb2e8f9f7 159 /**
<> 144:ef7eb2e8f9f7 160 * @brief Deactivate LPM feature.
<> 144:ef7eb2e8f9f7 161 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 162 * @retval HAL status
<> 144:ef7eb2e8f9f7 163 */
<> 144:ef7eb2e8f9f7 164 HAL_StatusTypeDef HAL_PCDEx_DeActivateLPM(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 165 {
<> 144:ef7eb2e8f9f7 166 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 167
<> 144:ef7eb2e8f9f7 168 hpcd->lpm_active = DISABLE;
<> 144:ef7eb2e8f9f7 169 USBx->GINTMSK &= ~USB_OTG_GINTMSK_LPMINTM;
<> 144:ef7eb2e8f9f7 170 USBx->GLPMCFG &= ~(USB_OTG_GLPMCFG_LPMEN | USB_OTG_GLPMCFG_LPMACK | USB_OTG_GLPMCFG_ENBESL);
<> 144:ef7eb2e8f9f7 171
<> 144:ef7eb2e8f9f7 172 return HAL_OK;
<> 144:ef7eb2e8f9f7 173 }
<> 144:ef7eb2e8f9f7 174
<> 144:ef7eb2e8f9f7 175 /**
<> 144:ef7eb2e8f9f7 176 * @brief Handle BatteryCharging Process.
<> 144:ef7eb2e8f9f7 177 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 178 * @retval HAL status
<> 144:ef7eb2e8f9f7 179 */
<> 144:ef7eb2e8f9f7 180 void HAL_PCDEx_BCD_VBUSDetect(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 181 {
<> 144:ef7eb2e8f9f7 182 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 183 uint32_t tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 184
<> 144:ef7eb2e8f9f7 185 /* Start BCD When device is connected */
<> 144:ef7eb2e8f9f7 186 if (USBx_DEVICE->DCTL & USB_OTG_DCTL_SDIS)
<> 144:ef7eb2e8f9f7 187 {
<> 144:ef7eb2e8f9f7 188 /* Enable DCD : Data Contact Detect */
<> 144:ef7eb2e8f9f7 189 USBx->GCCFG |= USB_OTG_GCCFG_DCDEN;
<> 144:ef7eb2e8f9f7 190
<> 144:ef7eb2e8f9f7 191 /* Wait Detect flag or a timeout is happen*/
<> 144:ef7eb2e8f9f7 192 while ((USBx->GCCFG & USB_OTG_GCCFG_DCDET) == 0)
<> 144:ef7eb2e8f9f7 193 {
<> 144:ef7eb2e8f9f7 194 /* Check for the Timeout */
<> 144:ef7eb2e8f9f7 195 if((HAL_GetTick() - tickstart ) > 1000)
<> 144:ef7eb2e8f9f7 196 {
<> 144:ef7eb2e8f9f7 197 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_ERROR);
<> 144:ef7eb2e8f9f7 198 return;
<> 144:ef7eb2e8f9f7 199 }
<> 144:ef7eb2e8f9f7 200 }
<> 144:ef7eb2e8f9f7 201
<> 144:ef7eb2e8f9f7 202 /* Right response got */
<> 144:ef7eb2e8f9f7 203 HAL_Delay(100);
<> 144:ef7eb2e8f9f7 204
<> 144:ef7eb2e8f9f7 205 /* Check Detect flag*/
<> 144:ef7eb2e8f9f7 206 if (USBx->GCCFG & USB_OTG_GCCFG_DCDET)
<> 144:ef7eb2e8f9f7 207 {
<> 144:ef7eb2e8f9f7 208 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CONTACT_DETECTION);
<> 144:ef7eb2e8f9f7 209 }
<> 144:ef7eb2e8f9f7 210
<> 144:ef7eb2e8f9f7 211 /*Primary detection: checks if connected to Standard Downstream Port
<> 144:ef7eb2e8f9f7 212 (without charging capability) */
<> 144:ef7eb2e8f9f7 213 USBx->GCCFG &=~ USB_OTG_GCCFG_DCDEN;
<> 144:ef7eb2e8f9f7 214 USBx->GCCFG |= USB_OTG_GCCFG_PDEN;
<> 144:ef7eb2e8f9f7 215 HAL_Delay(100);
<> 144:ef7eb2e8f9f7 216
<> 144:ef7eb2e8f9f7 217 if (!(USBx->GCCFG & USB_OTG_GCCFG_PDET))
<> 144:ef7eb2e8f9f7 218 {
<> 144:ef7eb2e8f9f7 219 /* Case of Standard Downstream Port */
<> 144:ef7eb2e8f9f7 220 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_STD_DOWNSTREAM_PORT);
<> 144:ef7eb2e8f9f7 221 }
<> 144:ef7eb2e8f9f7 222 else
<> 144:ef7eb2e8f9f7 223 {
<> 144:ef7eb2e8f9f7 224 /* start secondary detection to check connection to Charging Downstream
<> 144:ef7eb2e8f9f7 225 Port or Dedicated Charging Port */
<> 144:ef7eb2e8f9f7 226 USBx->GCCFG &=~ USB_OTG_GCCFG_PDEN;
<> 144:ef7eb2e8f9f7 227 USBx->GCCFG |= USB_OTG_GCCFG_SDEN;
<> 144:ef7eb2e8f9f7 228 HAL_Delay(100);
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230 if ((USBx->GCCFG) & USB_OTG_GCCFG_SDET)
<> 144:ef7eb2e8f9f7 231 {
<> 144:ef7eb2e8f9f7 232 /* case Dedicated Charging Port */
<> 144:ef7eb2e8f9f7 233 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DEDICATED_CHARGING_PORT);
<> 144:ef7eb2e8f9f7 234 }
<> 144:ef7eb2e8f9f7 235 else
<> 144:ef7eb2e8f9f7 236 {
<> 144:ef7eb2e8f9f7 237 /* case Charging Downstream Port */
<> 144:ef7eb2e8f9f7 238 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CHARGING_DOWNSTREAM_PORT);
<> 144:ef7eb2e8f9f7 239 }
<> 144:ef7eb2e8f9f7 240 }
<> 144:ef7eb2e8f9f7 241 /* Battery Charging capability discovery finished */
<> 144:ef7eb2e8f9f7 242 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DISCOVERY_COMPLETED);
<> 144:ef7eb2e8f9f7 243 }
<> 144:ef7eb2e8f9f7 244 }
<> 144:ef7eb2e8f9f7 245
<> 144:ef7eb2e8f9f7 246 /**
<> 144:ef7eb2e8f9f7 247 * @brief Activate BatteryCharging feature.
<> 144:ef7eb2e8f9f7 248 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 249 * @retval HAL status
<> 144:ef7eb2e8f9f7 250 */
<> 144:ef7eb2e8f9f7 251 HAL_StatusTypeDef HAL_PCDEx_ActivateBCD(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 252 {
<> 144:ef7eb2e8f9f7 253 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 254
<> 144:ef7eb2e8f9f7 255 hpcd->battery_charging_active = ENABLE;
<> 144:ef7eb2e8f9f7 256 USBx->GCCFG |= (USB_OTG_GCCFG_BCDEN);
<> 144:ef7eb2e8f9f7 257
<> 144:ef7eb2e8f9f7 258 return HAL_OK;
<> 144:ef7eb2e8f9f7 259 }
<> 144:ef7eb2e8f9f7 260
<> 144:ef7eb2e8f9f7 261 /**
<> 144:ef7eb2e8f9f7 262 * @brief Deactivate BatteryCharging feature.
<> 144:ef7eb2e8f9f7 263 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 264 * @retval HAL status
<> 144:ef7eb2e8f9f7 265 */
<> 144:ef7eb2e8f9f7 266 HAL_StatusTypeDef HAL_PCDEx_DeActivateBCD(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 267 {
<> 144:ef7eb2e8f9f7 268 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 269 hpcd->battery_charging_active = DISABLE;
<> 144:ef7eb2e8f9f7 270 USBx->GCCFG &= ~(USB_OTG_GCCFG_BCDEN);
<> 144:ef7eb2e8f9f7 271 return HAL_OK;
<> 144:ef7eb2e8f9f7 272 }
<> 144:ef7eb2e8f9f7 273 #endif /* USB_OTG_FS */
<> 144:ef7eb2e8f9f7 274
<> 144:ef7eb2e8f9f7 275 #if defined (USB)
<> 144:ef7eb2e8f9f7 276 /**
<> 144:ef7eb2e8f9f7 277 * @brief Configure PMA for EP
<> 144:ef7eb2e8f9f7 278 * @param hpcd : Device instance
<> 144:ef7eb2e8f9f7 279 * @param ep_addr: endpoint address
<> 144:ef7eb2e8f9f7 280 * @param ep_kind: endpoint Kind
<> 144:ef7eb2e8f9f7 281 * USB_SNG_BUF: Single Buffer used
<> 144:ef7eb2e8f9f7 282 * USB_DBL_BUF: Double Buffer used
<> 144:ef7eb2e8f9f7 283 * @param pmaadress: EP address in The PMA: In case of single buffer endpoint
<> 144:ef7eb2e8f9f7 284 * this parameter is 16-bit value providing the address
<> 144:ef7eb2e8f9f7 285 * in PMA allocated to endpoint.
<> 144:ef7eb2e8f9f7 286 * In case of double buffer endpoint this parameter
<> 144:ef7eb2e8f9f7 287 * is a 32-bit value providing the endpoint buffer 0 address
<> 144:ef7eb2e8f9f7 288 * in the LSB part of 32-bit value and endpoint buffer 1 address
<> 144:ef7eb2e8f9f7 289 * in the MSB part of 32-bit value.
<> 144:ef7eb2e8f9f7 290 * @retval HAL status
<> 144:ef7eb2e8f9f7 291 */
<> 144:ef7eb2e8f9f7 292
<> 144:ef7eb2e8f9f7 293 HAL_StatusTypeDef HAL_PCDEx_PMAConfig(PCD_HandleTypeDef *hpcd,
<> 144:ef7eb2e8f9f7 294 uint16_t ep_addr,
<> 144:ef7eb2e8f9f7 295 uint16_t ep_kind,
<> 144:ef7eb2e8f9f7 296 uint32_t pmaadress)
<> 144:ef7eb2e8f9f7 297
<> 144:ef7eb2e8f9f7 298 {
<> 144:ef7eb2e8f9f7 299 PCD_EPTypeDef *ep = NULL;
<> 144:ef7eb2e8f9f7 300
<> 144:ef7eb2e8f9f7 301 /* initialize ep structure*/
<> 144:ef7eb2e8f9f7 302 if ((0x80 & ep_addr) == 0x80)
<> 144:ef7eb2e8f9f7 303 {
<> 144:ef7eb2e8f9f7 304 ep = &hpcd->IN_ep[ep_addr & 0x7F];
<> 144:ef7eb2e8f9f7 305 }
<> 144:ef7eb2e8f9f7 306 else
<> 144:ef7eb2e8f9f7 307 {
<> 144:ef7eb2e8f9f7 308 ep = &hpcd->OUT_ep[ep_addr];
<> 144:ef7eb2e8f9f7 309 }
<> 144:ef7eb2e8f9f7 310
<> 144:ef7eb2e8f9f7 311 /* Here we check if the endpoint is single or double Buffer*/
<> 144:ef7eb2e8f9f7 312 if (ep_kind == PCD_SNG_BUF)
<> 144:ef7eb2e8f9f7 313 {
<> 144:ef7eb2e8f9f7 314 /*Single Buffer*/
<> 144:ef7eb2e8f9f7 315 ep->doublebuffer = 0;
<> 144:ef7eb2e8f9f7 316 /*Configure te PMA*/
<> 144:ef7eb2e8f9f7 317 ep->pmaadress = (uint16_t)pmaadress;
<> 144:ef7eb2e8f9f7 318 }
<> 144:ef7eb2e8f9f7 319 else /*USB_DBL_BUF*/
<> 144:ef7eb2e8f9f7 320 {
<> 144:ef7eb2e8f9f7 321 /*Double Buffer Endpoint*/
<> 144:ef7eb2e8f9f7 322 ep->doublebuffer = 1;
<> 144:ef7eb2e8f9f7 323 /*Configure the PMA*/
<> 144:ef7eb2e8f9f7 324 ep->pmaaddr0 = pmaadress & 0xFFFF;
<> 144:ef7eb2e8f9f7 325 ep->pmaaddr1 = (pmaadress & 0xFFFF0000) >> 16;
<> 144:ef7eb2e8f9f7 326 }
<> 144:ef7eb2e8f9f7 327
<> 144:ef7eb2e8f9f7 328 return HAL_OK;
<> 144:ef7eb2e8f9f7 329 }
<> 144:ef7eb2e8f9f7 330
<> 144:ef7eb2e8f9f7 331 /**
<> 144:ef7eb2e8f9f7 332 * @brief Activate BatteryCharging feature.
<> 144:ef7eb2e8f9f7 333 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 334 * @retval HAL status
<> 144:ef7eb2e8f9f7 335 */
<> 144:ef7eb2e8f9f7 336 HAL_StatusTypeDef HAL_PCDEx_ActivateBCD(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 337 {
<> 144:ef7eb2e8f9f7 338 USB_TypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 339 hpcd->battery_charging_active = ENABLE;
<> 144:ef7eb2e8f9f7 340
<> 144:ef7eb2e8f9f7 341 USBx->BCDR |= (USB_BCDR_BCDEN);
<> 144:ef7eb2e8f9f7 342 /* Enable DCD : Data Contact Detect */
<> 144:ef7eb2e8f9f7 343 USBx->BCDR |= (USB_BCDR_DCDEN);
<> 144:ef7eb2e8f9f7 344
<> 144:ef7eb2e8f9f7 345 return HAL_OK;
<> 144:ef7eb2e8f9f7 346 }
<> 144:ef7eb2e8f9f7 347
<> 144:ef7eb2e8f9f7 348 /**
<> 144:ef7eb2e8f9f7 349 * @brief Deactivate BatteryCharging feature.
<> 144:ef7eb2e8f9f7 350 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 351 * @retval HAL status
<> 144:ef7eb2e8f9f7 352 */
<> 144:ef7eb2e8f9f7 353 HAL_StatusTypeDef HAL_PCDEx_DeActivateBCD(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 354 {
<> 144:ef7eb2e8f9f7 355 USB_TypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 356 hpcd->battery_charging_active = DISABLE;
<> 144:ef7eb2e8f9f7 357
<> 144:ef7eb2e8f9f7 358 USBx->BCDR &= ~(USB_BCDR_BCDEN);
<> 144:ef7eb2e8f9f7 359 return HAL_OK;
<> 144:ef7eb2e8f9f7 360 }
<> 144:ef7eb2e8f9f7 361
<> 144:ef7eb2e8f9f7 362 /**
<> 144:ef7eb2e8f9f7 363 * @brief Handle BatteryCharging Process.
<> 144:ef7eb2e8f9f7 364 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 365 * @retval HAL status
<> 144:ef7eb2e8f9f7 366 */
<> 144:ef7eb2e8f9f7 367 void HAL_PCDEx_BCD_VBUSDetect(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 368 {
<> 144:ef7eb2e8f9f7 369 USB_TypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 370 uint32_t tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 371
<> 144:ef7eb2e8f9f7 372 /* Wait Detect flag or a timeout is happen*/
<> 144:ef7eb2e8f9f7 373 while ((USBx->BCDR & USB_BCDR_DCDET) == 0)
<> 144:ef7eb2e8f9f7 374 {
<> 144:ef7eb2e8f9f7 375 /* Check for the Timeout */
<> 144:ef7eb2e8f9f7 376 if((HAL_GetTick() - tickstart ) > 1000)
<> 144:ef7eb2e8f9f7 377 {
<> 144:ef7eb2e8f9f7 378 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_ERROR);
<> 144:ef7eb2e8f9f7 379 return;
<> 144:ef7eb2e8f9f7 380 }
<> 144:ef7eb2e8f9f7 381 }
<> 144:ef7eb2e8f9f7 382
<> 144:ef7eb2e8f9f7 383 HAL_Delay(300);
<> 144:ef7eb2e8f9f7 384
<> 144:ef7eb2e8f9f7 385 /* Data Pin Contact ? Check Detect flag */
<> 144:ef7eb2e8f9f7 386 if (USBx->BCDR & USB_BCDR_DCDET)
<> 144:ef7eb2e8f9f7 387 {
<> 144:ef7eb2e8f9f7 388 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CONTACT_DETECTION);
<> 144:ef7eb2e8f9f7 389 }
<> 144:ef7eb2e8f9f7 390 /* Primary detection: checks if connected to Standard Downstream Port
<> 144:ef7eb2e8f9f7 391 (without charging capability) */
<> 144:ef7eb2e8f9f7 392 USBx->BCDR &= ~(USB_BCDR_DCDEN);
<> 144:ef7eb2e8f9f7 393 USBx->BCDR |= (USB_BCDR_PDEN);
<> 144:ef7eb2e8f9f7 394 HAL_Delay(300);
<> 144:ef7eb2e8f9f7 395
<> 144:ef7eb2e8f9f7 396 /* If Charger detect ? */
<> 144:ef7eb2e8f9f7 397 if (USBx->BCDR & USB_BCDR_PDET)
<> 144:ef7eb2e8f9f7 398 {
<> 144:ef7eb2e8f9f7 399 /* Start secondary detection to check connection to Charging Downstream
<> 144:ef7eb2e8f9f7 400 Port or Dedicated Charging Port */
<> 144:ef7eb2e8f9f7 401 USBx->BCDR &= ~(USB_BCDR_PDEN);
<> 144:ef7eb2e8f9f7 402 USBx->BCDR |= (USB_BCDR_SDEN);
<> 144:ef7eb2e8f9f7 403 HAL_Delay(300);
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 /* If CDP ? */
<> 144:ef7eb2e8f9f7 406 if (USBx->BCDR & USB_BCDR_SDET)
<> 144:ef7eb2e8f9f7 407 {
<> 144:ef7eb2e8f9f7 408 /* Dedicated Downstream Port DCP */
<> 144:ef7eb2e8f9f7 409 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DEDICATED_CHARGING_PORT);
<> 144:ef7eb2e8f9f7 410 }
<> 144:ef7eb2e8f9f7 411 else
<> 144:ef7eb2e8f9f7 412 {
<> 144:ef7eb2e8f9f7 413 /* Charging Downstream Port CDP */
<> 144:ef7eb2e8f9f7 414 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_CHARGING_DOWNSTREAM_PORT);
<> 144:ef7eb2e8f9f7 415
<> 144:ef7eb2e8f9f7 416 /* Battery Charging capability discovery finished
<> 144:ef7eb2e8f9f7 417 Start Enumeration*/
<> 144:ef7eb2e8f9f7 418 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_DISCOVERY_COMPLETED);
<> 144:ef7eb2e8f9f7 419 }
<> 144:ef7eb2e8f9f7 420 }
<> 144:ef7eb2e8f9f7 421 else /* NO */
<> 144:ef7eb2e8f9f7 422 {
<> 144:ef7eb2e8f9f7 423 /* Standard Downstream Port */
<> 144:ef7eb2e8f9f7 424 HAL_PCDEx_BCD_Callback(hpcd, PCD_BCD_STD_DOWNSTREAM_PORT);
<> 144:ef7eb2e8f9f7 425 }
<> 144:ef7eb2e8f9f7 426 }
<> 144:ef7eb2e8f9f7 427
<> 144:ef7eb2e8f9f7 428 /**
<> 144:ef7eb2e8f9f7 429 * @brief Activate LPM feature.
<> 144:ef7eb2e8f9f7 430 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 431 * @retval HAL status
<> 144:ef7eb2e8f9f7 432 */
<> 144:ef7eb2e8f9f7 433 HAL_StatusTypeDef HAL_PCDEx_ActivateLPM(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 434 {
<> 144:ef7eb2e8f9f7 435
<> 144:ef7eb2e8f9f7 436 USB_TypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 437 hpcd->lpm_active = ENABLE;
<> 144:ef7eb2e8f9f7 438 hpcd->LPM_State = LPM_L0;
<> 144:ef7eb2e8f9f7 439
<> 144:ef7eb2e8f9f7 440 USBx->LPMCSR |= (USB_LPMCSR_LMPEN);
<> 144:ef7eb2e8f9f7 441 USBx->LPMCSR |= (USB_LPMCSR_LPMACK);
<> 144:ef7eb2e8f9f7 442
<> 144:ef7eb2e8f9f7 443
<> 144:ef7eb2e8f9f7 444 return HAL_OK;
<> 144:ef7eb2e8f9f7 445 }
<> 144:ef7eb2e8f9f7 446
<> 144:ef7eb2e8f9f7 447 /**
<> 144:ef7eb2e8f9f7 448 * @brief Deactivate LPM feature.
<> 144:ef7eb2e8f9f7 449 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 450 * @retval HAL status
<> 144:ef7eb2e8f9f7 451 */
<> 144:ef7eb2e8f9f7 452 HAL_StatusTypeDef HAL_PCDEx_DeActivateLPM(PCD_HandleTypeDef *hpcd)
<> 144:ef7eb2e8f9f7 453 {
<> 144:ef7eb2e8f9f7 454 USB_TypeDef *USBx = hpcd->Instance;
<> 144:ef7eb2e8f9f7 455
<> 144:ef7eb2e8f9f7 456 hpcd->lpm_active = DISABLE;
<> 144:ef7eb2e8f9f7 457
<> 144:ef7eb2e8f9f7 458 USBx->LPMCSR &= ~ (USB_LPMCSR_LMPEN);
<> 144:ef7eb2e8f9f7 459 USBx->LPMCSR &= ~ (USB_LPMCSR_LPMACK);
<> 144:ef7eb2e8f9f7 460
<> 144:ef7eb2e8f9f7 461 return HAL_OK;
<> 144:ef7eb2e8f9f7 462 }
<> 144:ef7eb2e8f9f7 463
<> 144:ef7eb2e8f9f7 464 #endif /* USB_FS */
<> 144:ef7eb2e8f9f7 465
<> 144:ef7eb2e8f9f7 466 /**
<> 144:ef7eb2e8f9f7 467 * @brief Send LPM message to user layer callback.
<> 144:ef7eb2e8f9f7 468 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 469 * @param msg: LPM message
<> 144:ef7eb2e8f9f7 470 * @retval HAL status
<> 144:ef7eb2e8f9f7 471 */
<> 144:ef7eb2e8f9f7 472 __weak void HAL_PCDEx_LPM_Callback(PCD_HandleTypeDef *hpcd, PCD_LPM_MsgTypeDef msg)
<> 144:ef7eb2e8f9f7 473 {
<> 144:ef7eb2e8f9f7 474 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 475 UNUSED(hpcd);
<> 144:ef7eb2e8f9f7 476 UNUSED(msg);
<> 144:ef7eb2e8f9f7 477
<> 144:ef7eb2e8f9f7 478 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 479 the HAL_PCDEx_LPM_Callback could be implemented in the user file
<> 144:ef7eb2e8f9f7 480 */
<> 144:ef7eb2e8f9f7 481 }
<> 144:ef7eb2e8f9f7 482
<> 144:ef7eb2e8f9f7 483 /**
<> 144:ef7eb2e8f9f7 484 * @brief Send BatteryCharging message to user layer callback.
<> 144:ef7eb2e8f9f7 485 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 486 * @param msg: LPM message
<> 144:ef7eb2e8f9f7 487 * @retval HAL status
<> 144:ef7eb2e8f9f7 488 */
<> 144:ef7eb2e8f9f7 489 __weak void HAL_PCDEx_BCD_Callback(PCD_HandleTypeDef *hpcd, PCD_BCD_MsgTypeDef msg)
<> 144:ef7eb2e8f9f7 490 {
<> 144:ef7eb2e8f9f7 491 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 492 UNUSED(hpcd);
<> 144:ef7eb2e8f9f7 493 UNUSED(msg);
<> 144:ef7eb2e8f9f7 494
<> 144:ef7eb2e8f9f7 495 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 496 the HAL_PCDEx_BCD_Callback could be implemented in the user file
<> 144:ef7eb2e8f9f7 497 */
<> 144:ef7eb2e8f9f7 498 }
<> 144:ef7eb2e8f9f7 499
<> 144:ef7eb2e8f9f7 500 /**
<> 144:ef7eb2e8f9f7 501 * @}
<> 144:ef7eb2e8f9f7 502 */
<> 144:ef7eb2e8f9f7 503
<> 144:ef7eb2e8f9f7 504 /**
<> 144:ef7eb2e8f9f7 505 * @}
<> 144:ef7eb2e8f9f7 506 */
<> 144:ef7eb2e8f9f7 507 /**
<> 144:ef7eb2e8f9f7 508 * @}
<> 144:ef7eb2e8f9f7 509 */
<> 144:ef7eb2e8f9f7 510
<> 144:ef7eb2e8f9f7 511 /**
<> 144:ef7eb2e8f9f7 512 * @}
<> 144:ef7eb2e8f9f7 513 */
<> 144:ef7eb2e8f9f7 514
<> 144:ef7eb2e8f9f7 515 #endif /* STM32L475xx || STM32L476xx || */
<> 144:ef7eb2e8f9f7 516 /* STM32L485xx || STM32L486xx || */
<> 144:ef7eb2e8f9f7 517 /* STM32L432xx || STM32L433xx || */
<> 144:ef7eb2e8f9f7 518 /* STM32L442xx || STM32L443xx */
<> 144:ef7eb2e8f9f7 519
<> 144:ef7eb2e8f9f7 520 #endif /* HAL_PCD_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 521
<> 144:ef7eb2e8f9f7 522 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/