marcus chiou / mbed-src

mbed library sources

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F4/stm32f4xx_hal_pcd_ex.c@613:bc40b8d2aec4, 2015-08-20 (annotated)

Committer:
mbed_official
Date:
Thu Aug 20 10:45:13 2015 +0100
Revision:
613:bc40b8d2aec4
Parent:
532:fe11edbda85c 
Synchronized with git revision 92ca8c7b60a283b6bb60eb65b183dac1599f0ade



Full URL: https://github.com/mbedmicro/mbed/commit/92ca8c7b60a283b6bb60eb65b183dac1599f0ade/



Nordic: update application start address in GCC linker script

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 330:c80ac197fa6a 1 /**
mbed_official 330:c80ac197fa6a 2 ******************************************************************************
mbed_official 330:c80ac197fa6a 3 * @file stm32f4xx_hal_pcd_ex.c
mbed_official 330:c80ac197fa6a 4 * @author MCD Application Team
mbed_official 613:bc40b8d2aec4 5 * @version V1.3.2
mbed_official 613:bc40b8d2aec4 6 * @date 26-June-2015
mbed_official 330:c80ac197fa6a 7 * @brief PCD HAL module driver.
mbed_official 330:c80ac197fa6a 8 * This file provides firmware functions to manage the following
mbed_official 330:c80ac197fa6a 9 * functionalities of the USB Peripheral Controller:
mbed_official 330:c80ac197fa6a 10 * + Extended features functions
mbed_official 330:c80ac197fa6a 11 *
mbed_official 330:c80ac197fa6a 12 ******************************************************************************
mbed_official 330:c80ac197fa6a 13 * @attention
mbed_official 330:c80ac197fa6a 14 *
mbed_official 532:fe11edbda85c 15 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 330:c80ac197fa6a 16 *
mbed_official 330:c80ac197fa6a 17 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 330:c80ac197fa6a 18 * are permitted provided that the following conditions are met:
mbed_official 330:c80ac197fa6a 19 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 330:c80ac197fa6a 20 * this list of conditions and the following disclaimer.
mbed_official 330:c80ac197fa6a 21 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 330:c80ac197fa6a 22 * this list of conditions and the following disclaimer in the documentation
mbed_official 330:c80ac197fa6a 23 * and/or other materials provided with the distribution.
mbed_official 330:c80ac197fa6a 24 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 330:c80ac197fa6a 25 * may be used to endorse or promote products derived from this software
mbed_official 330:c80ac197fa6a 26 * without specific prior written permission.
mbed_official 330:c80ac197fa6a 27 *
mbed_official 330:c80ac197fa6a 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 330:c80ac197fa6a 29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 330:c80ac197fa6a 30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 330:c80ac197fa6a 31 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 330:c80ac197fa6a 32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 330:c80ac197fa6a 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 330:c80ac197fa6a 34 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 330:c80ac197fa6a 35 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 330:c80ac197fa6a 36 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 330:c80ac197fa6a 37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 330:c80ac197fa6a 38 *
mbed_official 330:c80ac197fa6a 39 ******************************************************************************
mbed_official 330:c80ac197fa6a 40 */
mbed_official 330:c80ac197fa6a 41
mbed_official 330:c80ac197fa6a 42 /* Includes ------------------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 43 #include "stm32f4xx_hal.h"
mbed_official 330:c80ac197fa6a 44
mbed_official 330:c80ac197fa6a 45 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 330:c80ac197fa6a 46 * @{
mbed_official 330:c80ac197fa6a 47 */
mbed_official 330:c80ac197fa6a 48
mbed_official 532:fe11edbda85c 49 /** @defgroup PCDEx PCDEx
mbed_official 330:c80ac197fa6a 50 * @brief PCD Extended HAL module driver
mbed_official 330:c80ac197fa6a 51 * @{
mbed_official 330:c80ac197fa6a 52 */
mbed_official 532:fe11edbda85c 53 #ifdef HAL_PCD_MODULE_ENABLED
mbed_official 532:fe11edbda85c 54
mbed_official 532:fe11edbda85c 55 /* Private types -------------------------------------------------------------*/
mbed_official 532:fe11edbda85c 56 /* Private variables ---------------------------------------------------------*/
mbed_official 532:fe11edbda85c 57 /* Private constants ---------------------------------------------------------*/
mbed_official 532:fe11edbda85c 58 /* Private macros ------------------------------------------------------------*/
mbed_official 532:fe11edbda85c 59 /* Private functions ---------------------------------------------------------*/
mbed_official 532:fe11edbda85c 60 /* Exported functions --------------------------------------------------------*/
mbed_official 532:fe11edbda85c 61
mbed_official 613:bc40b8d2aec4 62 /** @defgroup PCDEx_Exported_Functions PCD Extended Exported Functions
mbed_official 532:fe11edbda85c 63 * @{
mbed_official 532:fe11edbda85c 64 */
mbed_official 330:c80ac197fa6a 65
mbed_official 532:fe11edbda85c 66 /** @defgroup PCDEx_Exported_Functions_Group1 Peripheral Control functions
mbed_official 532:fe11edbda85c 67 * @brief PCDEx control functions
mbed_official 532:fe11edbda85c 68 *
mbed_official 532:fe11edbda85c 69 @verbatim
mbed_official 330:c80ac197fa6a 70 ===============================================================================
mbed_official 330:c80ac197fa6a 71 ##### Extended features functions #####
mbed_official 330:c80ac197fa6a 72 ===============================================================================
mbed_official 330:c80ac197fa6a 73 [..] This section provides functions allowing to:
mbed_official 330:c80ac197fa6a 74 (+) Update FIFO configuration
mbed_official 330:c80ac197fa6a 75
mbed_official 330:c80ac197fa6a 76 @endverbatim
mbed_official 330:c80ac197fa6a 77 * @{
mbed_official 330:c80ac197fa6a 78 */
mbed_official 330:c80ac197fa6a 79
mbed_official 330:c80ac197fa6a 80 /**
mbed_official 532:fe11edbda85c 81 * @brief Set Tx FIFO
mbed_official 330:c80ac197fa6a 82 * @param hpcd: PCD handle
mbed_official 532:fe11edbda85c 83 * @param fifo: The number of Tx fifo
mbed_official 532:fe11edbda85c 84 * @param size: Fifo size
mbed_official 330:c80ac197fa6a 85 * @retval HAL status
mbed_official 330:c80ac197fa6a 86 */
mbed_official 330:c80ac197fa6a 87 HAL_StatusTypeDef HAL_PCDEx_SetTxFiFo(PCD_HandleTypeDef *hpcd, uint8_t fifo, uint16_t size)
mbed_official 330:c80ac197fa6a 88 {
mbed_official 330:c80ac197fa6a 89 uint8_t i = 0;
mbed_official 330:c80ac197fa6a 90 uint32_t Tx_Offset = 0;
mbed_official 330:c80ac197fa6a 91
mbed_official 330:c80ac197fa6a 92 /* TXn min size = 16 words. (n : Transmit FIFO index)
mbed_official 330:c80ac197fa6a 93 When a TxFIFO is not used, the Configuration should be as follows:
mbed_official 330:c80ac197fa6a 94 case 1 : n > m and Txn is not used (n,m : Transmit FIFO indexes)
mbed_official 330:c80ac197fa6a 95 --> Txm can use the space allocated for Txn.
mbed_official 330:c80ac197fa6a 96 case2 : n < m and Txn is not used (n,m : Transmit FIFO indexes)
mbed_official 330:c80ac197fa6a 97 --> Txn should be configured with the minimum space of 16 words
mbed_official 330:c80ac197fa6a 98 The FIFO is used optimally when used TxFIFOs are allocated in the top
mbed_official 330:c80ac197fa6a 99 of the FIFO.Ex: use EP1 and EP2 as IN instead of EP1 and EP3 as IN ones.
mbed_official 330:c80ac197fa6a 100 When DMA is used 3n * FIFO locations should be reserved for internal DMA registers */
mbed_official 330:c80ac197fa6a 101
mbed_official 330:c80ac197fa6a 102 Tx_Offset = hpcd->Instance->GRXFSIZ;
mbed_official 330:c80ac197fa6a 103
mbed_official 330:c80ac197fa6a 104 if(fifo == 0)
mbed_official 330:c80ac197fa6a 105 {
mbed_official 613:bc40b8d2aec4 106 hpcd->Instance->DIEPTXF0_HNPTXFSIZ = (uint32_t)(((uint32_t)size << 16) | Tx_Offset);
mbed_official 330:c80ac197fa6a 107 }
mbed_official 330:c80ac197fa6a 108 else
mbed_official 330:c80ac197fa6a 109 {
mbed_official 330:c80ac197fa6a 110 Tx_Offset += (hpcd->Instance->DIEPTXF0_HNPTXFSIZ) >> 16;
mbed_official 330:c80ac197fa6a 111 for (i = 0; i < (fifo - 1); i++)
mbed_official 330:c80ac197fa6a 112 {
mbed_official 330:c80ac197fa6a 113 Tx_Offset += (hpcd->Instance->DIEPTXF[i] >> 16);
mbed_official 330:c80ac197fa6a 114 }
mbed_official 330:c80ac197fa6a 115
mbed_official 330:c80ac197fa6a 116 /* Multiply Tx_Size by 2 to get higher performance */
mbed_official 613:bc40b8d2aec4 117 hpcd->Instance->DIEPTXF[fifo - 1] = (uint32_t)(((uint32_t)size << 16) | Tx_Offset);
mbed_official 330:c80ac197fa6a 118 }
mbed_official 330:c80ac197fa6a 119
mbed_official 330:c80ac197fa6a 120 return HAL_OK;
mbed_official 330:c80ac197fa6a 121 }
mbed_official 330:c80ac197fa6a 122
mbed_official 330:c80ac197fa6a 123 /**
mbed_official 532:fe11edbda85c 124 * @brief Set Rx FIFO
mbed_official 330:c80ac197fa6a 125 * @param hpcd: PCD handle
mbed_official 532:fe11edbda85c 126 * @param size: Size of Rx fifo
mbed_official 330:c80ac197fa6a 127 * @retval HAL status
mbed_official 330:c80ac197fa6a 128 */
mbed_official 330:c80ac197fa6a 129 HAL_StatusTypeDef HAL_PCDEx_SetRxFiFo(PCD_HandleTypeDef *hpcd, uint16_t size)
mbed_official 330:c80ac197fa6a 130 {
mbed_official 330:c80ac197fa6a 131 hpcd->Instance->GRXFSIZ = size;
mbed_official 330:c80ac197fa6a 132
mbed_official 330:c80ac197fa6a 133 return HAL_OK;
mbed_official 330:c80ac197fa6a 134 }
mbed_official 330:c80ac197fa6a 135
mbed_official 532:fe11edbda85c 136 #if defined(STM32F446xx)
mbed_official 532:fe11edbda85c 137 /**
mbed_official 613:bc40b8d2aec4 138 * @brief Activate LPM feature
mbed_official 532:fe11edbda85c 139 * @param hpcd: PCD handle
mbed_official 532:fe11edbda85c 140 * @retval HAL status
mbed_official 532:fe11edbda85c 141 */
mbed_official 532:fe11edbda85c 142 HAL_StatusTypeDef HAL_PCDEx_ActivateLPM(PCD_HandleTypeDef *hpcd)
mbed_official 532:fe11edbda85c 143 {
mbed_official 532:fe11edbda85c 144 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
mbed_official 532:fe11edbda85c 145
mbed_official 532:fe11edbda85c 146 hpcd->lpm_active = ENABLE;
mbed_official 532:fe11edbda85c 147 hpcd->LPM_State = LPM_L0;
mbed_official 532:fe11edbda85c 148 USBx->GINTMSK |= USB_OTG_GINTMSK_LPMINTM;
mbed_official 532:fe11edbda85c 149 USBx->GLPMCFG |= (USB_OTG_GLPMCFG_LPMEN | USB_OTG_GLPMCFG_LPMACK | USB_OTG_GLPMCFG_ENBESL);
mbed_official 532:fe11edbda85c 150
mbed_official 532:fe11edbda85c 151 return HAL_OK;
mbed_official 532:fe11edbda85c 152 }
mbed_official 532:fe11edbda85c 153
mbed_official 532:fe11edbda85c 154 /**
mbed_official 613:bc40b8d2aec4 155 * @brief Deactivate LPM feature.
mbed_official 532:fe11edbda85c 156 * @param hpcd: PCD handle
mbed_official 532:fe11edbda85c 157 * @retval HAL status
mbed_official 532:fe11edbda85c 158 */
mbed_official 532:fe11edbda85c 159 HAL_StatusTypeDef HAL_PCDEx_DeActivateLPM(PCD_HandleTypeDef *hpcd)
mbed_official 532:fe11edbda85c 160 {
mbed_official 532:fe11edbda85c 161 USB_OTG_GlobalTypeDef *USBx = hpcd->Instance;
mbed_official 532:fe11edbda85c 162
mbed_official 532:fe11edbda85c 163 hpcd->lpm_active = DISABLE;
mbed_official 532:fe11edbda85c 164 USBx->GINTMSK &= ~USB_OTG_GINTMSK_LPMINTM;
mbed_official 532:fe11edbda85c 165 USBx->GLPMCFG &= ~(USB_OTG_GLPMCFG_LPMEN | USB_OTG_GLPMCFG_LPMACK | USB_OTG_GLPMCFG_ENBESL);
mbed_official 532:fe11edbda85c 166
mbed_official 532:fe11edbda85c 167 return HAL_OK;
mbed_official 532:fe11edbda85c 168 }
mbed_official 532:fe11edbda85c 169
mbed_official 532:fe11edbda85c 170 /**
mbed_official 613:bc40b8d2aec4 171 * @brief Send LPM message to user layer callback.
mbed_official 532:fe11edbda85c 172 * @param hpcd: PCD handle
mbed_official 532:fe11edbda85c 173 * @param msg: LPM message
mbed_official 532:fe11edbda85c 174 * @retval HAL status
mbed_official 532:fe11edbda85c 175 */
mbed_official 532:fe11edbda85c 176 __weak void HAL_PCDEx_LPM_Callback(PCD_HandleTypeDef *hpcd, PCD_LPM_MsgTypeDef msg)
mbed_official 532:fe11edbda85c 177 {
mbed_official 532:fe11edbda85c 178 }
mbed_official 532:fe11edbda85c 179 #endif /* STM32F446xx */
mbed_official 532:fe11edbda85c 180
mbed_official 330:c80ac197fa6a 181 /**
mbed_official 330:c80ac197fa6a 182 * @}
mbed_official 330:c80ac197fa6a 183 */
mbed_official 330:c80ac197fa6a 184
mbed_official 330:c80ac197fa6a 185 /**
mbed_official 330:c80ac197fa6a 186 * @}
mbed_official 330:c80ac197fa6a 187 */
mbed_official 330:c80ac197fa6a 188
mbed_official 330:c80ac197fa6a 189 #endif /* HAL_PCD_MODULE_ENABLED */
mbed_official 330:c80ac197fa6a 190 /**
mbed_official 330:c80ac197fa6a 191 * @}
mbed_official 330:c80ac197fa6a 192 */
mbed_official 330:c80ac197fa6a 193
mbed_official 330:c80ac197fa6a 194 /**
mbed_official 330:c80ac197fa6a 195 * @}
mbed_official 330:c80ac197fa6a 196 */
mbed_official 330:c80ac197fa6a 197
mbed_official 330:c80ac197fa6a 198 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/