mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_pcd_ex.c@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Parent:
573:ad23fe03a082 
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

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