GameOpener / mbed-src

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-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_pcd_ex.c@330:c80ac197fa6a, 2014-09-23 (annotated)

Committer:
mbed_official
Date:
Tue Sep 23 10:30:11 2014 +0100
Revision:
330:c80ac197fa6a
Synchronized with git revision 56e9fd597864aab1c8fd92ef1c565e88a04d0a37



Full URL: https://github.com/mbedmicro/mbed/commit/56e9fd597864aab1c8fd92ef1c565e88a04d0a37/



[NUCLEO_F302R8] Migration to STM32Cube driver.

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 330:c80ac197fa6a 5 * @version V1.1.0
mbed_official 330:c80ac197fa6a 6 * @date 19-June-2014
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 330:c80ac197fa6a 15 * <h2><center>&copy; COPYRIGHT(c) 2014 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 330:c80ac197fa6a 49 /** @defgroup PCDEx
mbed_official 330:c80ac197fa6a 50 * @brief PCD Extended HAL module driver
mbed_official 330:c80ac197fa6a 51 * @{
mbed_official 330:c80ac197fa6a 52 */
mbed_official 330:c80ac197fa6a 53
mbed_official 330:c80ac197fa6a 54 #ifdef HAL_PCD_MODULE_ENABLED
mbed_official 330:c80ac197fa6a 55
mbed_official 330:c80ac197fa6a 56 /* Private typedef -----------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 57 /* Private define ------------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 58 /* Private macro -------------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 59 /* Private variables ---------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 60 /* Private function prototypes -----------------------------------------------*/
mbed_official 330:c80ac197fa6a 61 /* Private functions ---------------------------------------------------------*/
mbed_official 330:c80ac197fa6a 62
mbed_official 330:c80ac197fa6a 63 /** @defgroup PCDEx_Private_Functions
mbed_official 330:c80ac197fa6a 64 * @{
mbed_official 330:c80ac197fa6a 65 */
mbed_official 330:c80ac197fa6a 66
mbed_official 330:c80ac197fa6a 67
mbed_official 330:c80ac197fa6a 68 /** @defgroup PCDEx_Group1 Extended features functions
mbed_official 330:c80ac197fa6a 69 * @brief Extended features functions
mbed_official 330:c80ac197fa6a 70 *
mbed_official 330:c80ac197fa6a 71 @verbatim
mbed_official 330:c80ac197fa6a 72 ===============================================================================
mbed_official 330:c80ac197fa6a 73 ##### Extended features functions #####
mbed_official 330:c80ac197fa6a 74 ===============================================================================
mbed_official 330:c80ac197fa6a 75 [..] This section provides functions allowing to:
mbed_official 330:c80ac197fa6a 76 (+) Update FIFO configuration
mbed_official 330:c80ac197fa6a 77
mbed_official 330:c80ac197fa6a 78 @endverbatim
mbed_official 330:c80ac197fa6a 79 * @{
mbed_official 330:c80ac197fa6a 80 */
mbed_official 330:c80ac197fa6a 81
mbed_official 330:c80ac197fa6a 82 /**
mbed_official 330:c80ac197fa6a 83 * @brief Update FIFO configuration
mbed_official 330:c80ac197fa6a 84 * @param hpcd: PCD handle
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 330:c80ac197fa6a 106 hpcd->Instance->DIEPTXF0_HNPTXFSIZ = (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 330:c80ac197fa6a 117 hpcd->Instance->DIEPTXF[fifo - 1] = (size << 16) | Tx_Offset;
mbed_official 330:c80ac197fa6a 118
mbed_official 330:c80ac197fa6a 119 }
mbed_official 330:c80ac197fa6a 120
mbed_official 330:c80ac197fa6a 121 return HAL_OK;
mbed_official 330:c80ac197fa6a 122 }
mbed_official 330:c80ac197fa6a 123
mbed_official 330:c80ac197fa6a 124 /**
mbed_official 330:c80ac197fa6a 125 * @brief Update FIFO configuration
mbed_official 330:c80ac197fa6a 126 * @param hpcd: PCD handle
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
mbed_official 330:c80ac197fa6a 132 hpcd->Instance->GRXFSIZ = size;
mbed_official 330:c80ac197fa6a 133
mbed_official 330:c80ac197fa6a 134 return HAL_OK;
mbed_official 330:c80ac197fa6a 135 }
mbed_official 330:c80ac197fa6a 136
mbed_official 330:c80ac197fa6a 137 /**
mbed_official 330:c80ac197fa6a 138 * @}
mbed_official 330:c80ac197fa6a 139 */
mbed_official 330:c80ac197fa6a 140
mbed_official 330:c80ac197fa6a 141 /**
mbed_official 330:c80ac197fa6a 142 * @}
mbed_official 330:c80ac197fa6a 143 */
mbed_official 330:c80ac197fa6a 144
mbed_official 330:c80ac197fa6a 145 #endif /* HAL_PCD_MODULE_ENABLED */
mbed_official 330:c80ac197fa6a 146 /**
mbed_official 330:c80ac197fa6a 147 * @}
mbed_official 330:c80ac197fa6a 148 */
mbed_official 330:c80ac197fa6a 149
mbed_official 330:c80ac197fa6a 150 /**
mbed_official 330:c80ac197fa6a 151 * @}
mbed_official 330:c80ac197fa6a 152 */
mbed_official 330:c80ac197fa6a 153
mbed_official 330:c80ac197fa6a 154 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/