mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32F2/device/stm32f2xx_hal_pcd_ex.c@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
167:e84263d55307 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f2xx_hal_pcd_ex.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
AnnaBridge 167:e84263d55307 5 * @version V1.2.1
AnnaBridge 167:e84263d55307 6 * @date 14-April-2017
<> 144:ef7eb2e8f9f7 7 * @brief PCD 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 *
AnnaBridge 167:e84263d55307 15 * <h2><center>&copy; COPYRIGHT(c) 2017 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 "stm32f2xx_hal.h"
<> 144:ef7eb2e8f9f7 44
<> 144:ef7eb2e8f9f7 45 /** @addtogroup STM32F2xx_HAL_Driver
<> 144:ef7eb2e8f9f7 46 * @{
<> 144:ef7eb2e8f9f7 47 */
<> 144:ef7eb2e8f9f7 48
<> 144:ef7eb2e8f9f7 49 /** @defgroup PCDEx PCDEx
<> 144:ef7eb2e8f9f7 50 * @brief PCD Extended HAL module driver
<> 144:ef7eb2e8f9f7 51 * @{
<> 144:ef7eb2e8f9f7 52 */
<> 144:ef7eb2e8f9f7 53 #ifdef HAL_PCD_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 54
<> 144:ef7eb2e8f9f7 55 /* Private types -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 56 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 57 /* Private constants ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 58 /* Private macros ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 59 /* Private functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 60 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 61
<> 144:ef7eb2e8f9f7 62 /** @defgroup PCDEx_Exported_Functions PCD Extended Exported Functions
<> 144:ef7eb2e8f9f7 63 * @{
<> 144:ef7eb2e8f9f7 64 */
<> 144:ef7eb2e8f9f7 65
<> 144:ef7eb2e8f9f7 66 /** @defgroup PCDEx_Exported_Functions_Group1 Peripheral Control functions
<> 144:ef7eb2e8f9f7 67 * @brief PCDEx control functions
<> 144:ef7eb2e8f9f7 68 *
<> 144:ef7eb2e8f9f7 69 @verbatim
<> 144:ef7eb2e8f9f7 70 ===============================================================================
<> 144:ef7eb2e8f9f7 71 ##### Extended features functions #####
<> 144:ef7eb2e8f9f7 72 ===============================================================================
<> 144:ef7eb2e8f9f7 73 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 74 (+) Update FIFO configuration
<> 144:ef7eb2e8f9f7 75
<> 144:ef7eb2e8f9f7 76 @endverbatim
<> 144:ef7eb2e8f9f7 77 * @{
<> 144:ef7eb2e8f9f7 78 */
<> 144:ef7eb2e8f9f7 79
<> 144:ef7eb2e8f9f7 80 /**
<> 144:ef7eb2e8f9f7 81 * @brief Set Tx FIFO
<> 144:ef7eb2e8f9f7 82 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 83 * @param fifo: The number of Tx fifo
<> 144:ef7eb2e8f9f7 84 * @param size: Fifo size
<> 144:ef7eb2e8f9f7 85 * @retval HAL status
<> 144:ef7eb2e8f9f7 86 */
<> 144:ef7eb2e8f9f7 87 HAL_StatusTypeDef HAL_PCDEx_SetTxFiFo(PCD_HandleTypeDef *hpcd, uint8_t fifo, uint16_t size)
<> 144:ef7eb2e8f9f7 88 {
AnnaBridge 167:e84263d55307 89 uint8_t i = 0;
<> 144:ef7eb2e8f9f7 90 uint32_t Tx_Offset = 0U;
<> 144:ef7eb2e8f9f7 91
<> 144:ef7eb2e8f9f7 92 /* TXn min size = 16 words. (n : Transmit FIFO index)
<> 144:ef7eb2e8f9f7 93 When a TxFIFO is not used, the Configuration should be as follows:
<> 144:ef7eb2e8f9f7 94 case 1 : n > m and Txn is not used (n,m : Transmit FIFO indexes)
<> 144:ef7eb2e8f9f7 95 --> Txm can use the space allocated for Txn.
<> 144:ef7eb2e8f9f7 96 case2 : n < m and Txn is not used (n,m : Transmit FIFO indexes)
<> 144:ef7eb2e8f9f7 97 --> Txn should be configured with the minimum space of 16 words
<> 144:ef7eb2e8f9f7 98 The FIFO is used optimally when used TxFIFOs are allocated in the top
<> 144:ef7eb2e8f9f7 99 of the FIFO.Ex: use EP1 and EP2 as IN instead of EP1 and EP3 as IN ones.
<> 144:ef7eb2e8f9f7 100 When DMA is used 3n * FIFO locations should be reserved for internal DMA registers */
<> 144:ef7eb2e8f9f7 101
<> 144:ef7eb2e8f9f7 102 Tx_Offset = hpcd->Instance->GRXFSIZ;
<> 144:ef7eb2e8f9f7 103
AnnaBridge 167:e84263d55307 104 if(fifo == 0)
<> 144:ef7eb2e8f9f7 105 {
<> 144:ef7eb2e8f9f7 106 hpcd->Instance->DIEPTXF0_HNPTXFSIZ = (uint32_t)(((uint32_t)size << 16U) | Tx_Offset);
<> 144:ef7eb2e8f9f7 107 }
<> 144:ef7eb2e8f9f7 108 else
<> 144:ef7eb2e8f9f7 109 {
<> 144:ef7eb2e8f9f7 110 Tx_Offset += (hpcd->Instance->DIEPTXF0_HNPTXFSIZ) >> 16U;
AnnaBridge 167:e84263d55307 111 for (i = 0; i < (fifo - 1); i++)
<> 144:ef7eb2e8f9f7 112 {
<> 144:ef7eb2e8f9f7 113 Tx_Offset += (hpcd->Instance->DIEPTXF[i] >> 16U);
<> 144:ef7eb2e8f9f7 114 }
<> 144:ef7eb2e8f9f7 115
<> 144:ef7eb2e8f9f7 116 /* Multiply Tx_Size by 2 to get higher performance */
AnnaBridge 167:e84263d55307 117 hpcd->Instance->DIEPTXF[fifo - 1] = (uint32_t)(((uint32_t)size << 16U) | Tx_Offset);
<> 144:ef7eb2e8f9f7 118 }
<> 144:ef7eb2e8f9f7 119
<> 144:ef7eb2e8f9f7 120 return HAL_OK;
<> 144:ef7eb2e8f9f7 121 }
<> 144:ef7eb2e8f9f7 122
<> 144:ef7eb2e8f9f7 123 /**
<> 144:ef7eb2e8f9f7 124 * @brief Set Rx FIFO
<> 144:ef7eb2e8f9f7 125 * @param hpcd: PCD handle
<> 144:ef7eb2e8f9f7 126 * @param size: Size of Rx fifo
<> 144:ef7eb2e8f9f7 127 * @retval HAL status
<> 144:ef7eb2e8f9f7 128 */
<> 144:ef7eb2e8f9f7 129 HAL_StatusTypeDef HAL_PCDEx_SetRxFiFo(PCD_HandleTypeDef *hpcd, uint16_t size)
<> 144:ef7eb2e8f9f7 130 {
<> 144:ef7eb2e8f9f7 131 hpcd->Instance->GRXFSIZ = size;
<> 144:ef7eb2e8f9f7 132
<> 144:ef7eb2e8f9f7 133 return HAL_OK;
<> 144:ef7eb2e8f9f7 134 }
<> 144:ef7eb2e8f9f7 135
<> 144:ef7eb2e8f9f7 136 /**
<> 144:ef7eb2e8f9f7 137 * @}
<> 144:ef7eb2e8f9f7 138 */
<> 144:ef7eb2e8f9f7 139
<> 144:ef7eb2e8f9f7 140 /**
<> 144:ef7eb2e8f9f7 141 * @}
<> 144:ef7eb2e8f9f7 142 */
<> 144:ef7eb2e8f9f7 143
<> 144:ef7eb2e8f9f7 144 #endif /* HAL_PCD_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 145 /**
<> 144:ef7eb2e8f9f7 146 * @}
<> 144:ef7eb2e8f9f7 147 */
<> 144:ef7eb2e8f9f7 148
<> 144:ef7eb2e8f9f7 149 /**
<> 144:ef7eb2e8f9f7 150 * @}
<> 144:ef7eb2e8f9f7 151 */
<> 144:ef7eb2e8f9f7 152
<> 144:ef7eb2e8f9f7 153 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/