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_STM32F3/stm32f3xx_hal_pcd_ex.c@632:7687fb9c4f91, 2015-09-28 (annotated)

Committer:
mbed_official
Date:
Mon Sep 28 14:00:11 2015 +0100
Revision:
632:7687fb9c4f91
Parent:
385:be64abf45658
Child:
634:ac7d6880524d
Synchronized with git revision f7ce4ed029cc611121464252ff28d5e8beb895b0



Full URL: https://github.com/mbedmicro/mbed/commit/f7ce4ed029cc611121464252ff28d5e8beb895b0/



NUCLEO_F303K8 - add support of the STM32F303K8

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 237:f3da66175598 1 /**
mbed_official 237:f3da66175598 2 ******************************************************************************
mbed_official 237:f3da66175598 3 * @file stm32f3xx_hal_pcd_ex.c
mbed_official 237:f3da66175598 4 * @author MCD Application Team
mbed_official 632:7687fb9c4f91 5 * @version V1.1.1
mbed_official 632:7687fb9c4f91 6 * @date 19-June-2015
mbed_official 237:f3da66175598 7 * @brief Extended PCD HAL module driver.
mbed_official 237:f3da66175598 8 * This file provides firmware functions to manage the following
mbed_official 237:f3da66175598 9 * functionalities of the USB Peripheral Controller:
mbed_official 375:3d36234a1087 10 * + Configuration of the PMA for EP
mbed_official 237:f3da66175598 11 *
mbed_official 237:f3da66175598 12 ******************************************************************************
mbed_official 237:f3da66175598 13 * @attention
mbed_official 237:f3da66175598 14 *
mbed_official 632:7687fb9c4f91 15 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 237:f3da66175598 16 *
mbed_official 237:f3da66175598 17 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 237:f3da66175598 18 * are permitted provided that the following conditions are met:
mbed_official 237:f3da66175598 19 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 237:f3da66175598 20 * this list of conditions and the following disclaimer.
mbed_official 237:f3da66175598 21 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 237:f3da66175598 22 * this list of conditions and the following disclaimer in the documentation
mbed_official 237:f3da66175598 23 * and/or other materials provided with the distribution.
mbed_official 237:f3da66175598 24 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 237:f3da66175598 25 * may be used to endorse or promote products derived from this software
mbed_official 237:f3da66175598 26 * without specific prior written permission.
mbed_official 237:f3da66175598 27 *
mbed_official 237:f3da66175598 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 237:f3da66175598 29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 237:f3da66175598 30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 237:f3da66175598 31 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 237:f3da66175598 32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 237:f3da66175598 33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 237:f3da66175598 34 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 237:f3da66175598 35 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 237:f3da66175598 36 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 237:f3da66175598 37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 237:f3da66175598 38 *
mbed_official 237:f3da66175598 39 ******************************************************************************
mbed_official 237:f3da66175598 40 */
mbed_official 237:f3da66175598 41
mbed_official 237:f3da66175598 42 /* Includes ------------------------------------------------------------------*/
mbed_official 237:f3da66175598 43 #include "stm32f3xx_hal.h"
mbed_official 237:f3da66175598 44
mbed_official 237:f3da66175598 45 /** @addtogroup STM32F3xx_HAL_Driver
mbed_official 237:f3da66175598 46 * @{
mbed_official 237:f3da66175598 47 */
mbed_official 237:f3da66175598 48
mbed_official 375:3d36234a1087 49 /** @defgroup PCDEx PCD Extended HAL module driver
mbed_official 375:3d36234a1087 50 * @brief PCDEx PCDEx Extended HAL module driver
mbed_official 237:f3da66175598 51 * @{
mbed_official 237:f3da66175598 52 */
mbed_official 237:f3da66175598 53
mbed_official 237:f3da66175598 54 #ifdef HAL_PCD_MODULE_ENABLED
mbed_official 237:f3da66175598 55
mbed_official 375:3d36234a1087 56 #if defined(STM32F302xE) || defined(STM32F303xE) || \
mbed_official 375:3d36234a1087 57 defined(STM32F302xC) || defined(STM32F303xC) || \
mbed_official 375:3d36234a1087 58 defined(STM32F302x8) || \
mbed_official 375:3d36234a1087 59 defined(STM32F373xC)
mbed_official 237:f3da66175598 60
mbed_official 237:f3da66175598 61 /* Private typedef -----------------------------------------------------------*/
mbed_official 237:f3da66175598 62 /* Private define ------------------------------------------------------------*/
mbed_official 237:f3da66175598 63 /* Private macro -------------------------------------------------------------*/
mbed_official 237:f3da66175598 64 /* Private variables ---------------------------------------------------------*/
mbed_official 237:f3da66175598 65 /* Private function prototypes -----------------------------------------------*/
mbed_official 375:3d36234a1087 66 /* Exported functions ---------------------------------------------------------*/
mbed_official 237:f3da66175598 67
mbed_official 375:3d36234a1087 68 /** @defgroup PCDEx_Exported_Functions PCD Extended Exported Functions
mbed_official 237:f3da66175598 69 * @{
mbed_official 237:f3da66175598 70 */
mbed_official 237:f3da66175598 71
mbed_official 375:3d36234a1087 72 /** @defgroup PCDEx_Exported_Functions_Group1 Extended Initialization and de-initialization functions
mbed_official 237:f3da66175598 73 * @brief Initialization and Configuration functions
mbed_official 237:f3da66175598 74 *
mbed_official 237:f3da66175598 75 @verbatim
mbed_official 237:f3da66175598 76 ===============================================================================
mbed_official 237:f3da66175598 77 ##### Peripheral extended features methods #####
mbed_official 237:f3da66175598 78 ===============================================================================
mbed_official 237:f3da66175598 79 @endverbatim
mbed_official 237:f3da66175598 80 * @{
mbed_official 237:f3da66175598 81 */
mbed_official 237:f3da66175598 82
mbed_official 237:f3da66175598 83 /**
mbed_official 237:f3da66175598 84 * @brief Configure PMA for EP
mbed_official 375:3d36234a1087 85 * @param hpcd: PCD handle
mbed_official 237:f3da66175598 86 * @param ep_addr: endpoint address
mbed_official 237:f3da66175598 87 * @param ep_kind: endpoint Kind
mbed_official 237:f3da66175598 88 * @arg USB_SNG_BUF: Single Buffer used
mbed_official 237:f3da66175598 89 * @arg USB_DBL_BUF: Double Buffer used
mbed_official 237:f3da66175598 90 * @param pmaadress: EP address in The PMA: In case of single buffer endpoint
mbed_official 237:f3da66175598 91 * this parameter is 16-bit value providing the address
mbed_official 237:f3da66175598 92 * in PMA allocated to endpoint.
mbed_official 237:f3da66175598 93 * In case of double buffer endpoint this parameter
mbed_official 237:f3da66175598 94 * is a 32-bit value providing the endpoint buffer 0 address
mbed_official 237:f3da66175598 95 * in the LSB part of 32-bit value and endpoint buffer 1 address
mbed_official 237:f3da66175598 96 * in the MSB part of 32-bit value.
mbed_official 237:f3da66175598 97 * @retval : status
mbed_official 237:f3da66175598 98 */
mbed_official 237:f3da66175598 99
mbed_official 237:f3da66175598 100 HAL_StatusTypeDef HAL_PCDEx_PMAConfig(PCD_HandleTypeDef *hpcd,
mbed_official 237:f3da66175598 101 uint16_t ep_addr,
mbed_official 237:f3da66175598 102 uint16_t ep_kind,
mbed_official 237:f3da66175598 103 uint32_t pmaadress)
mbed_official 237:f3da66175598 104
mbed_official 237:f3da66175598 105 {
mbed_official 237:f3da66175598 106 PCD_EPTypeDef *ep;
mbed_official 237:f3da66175598 107
mbed_official 237:f3da66175598 108 /* initialize ep structure*/
mbed_official 237:f3da66175598 109 if ((0x80 & ep_addr) == 0x80)
mbed_official 237:f3da66175598 110 {
mbed_official 237:f3da66175598 111 ep = &hpcd->IN_ep[ep_addr & 0x7F];
mbed_official 237:f3da66175598 112 }
mbed_official 237:f3da66175598 113 else
mbed_official 237:f3da66175598 114 {
mbed_official 237:f3da66175598 115 ep = &hpcd->OUT_ep[ep_addr];
mbed_official 237:f3da66175598 116 }
mbed_official 237:f3da66175598 117
mbed_official 237:f3da66175598 118 /* Here we check if the endpoint is single or double Buffer*/
mbed_official 237:f3da66175598 119 if (ep_kind == PCD_SNG_BUF)
mbed_official 237:f3da66175598 120 {
mbed_official 237:f3da66175598 121 /*Single Buffer*/
mbed_official 237:f3da66175598 122 ep->doublebuffer = 0;
mbed_official 237:f3da66175598 123 /*Configure te PMA*/
mbed_official 237:f3da66175598 124 ep->pmaadress = (uint16_t)pmaadress;
mbed_official 237:f3da66175598 125 }
mbed_official 237:f3da66175598 126 else /*USB_DBL_BUF*/
mbed_official 237:f3da66175598 127 {
mbed_official 237:f3da66175598 128 /*Double Buffer Endpoint*/
mbed_official 237:f3da66175598 129 ep->doublebuffer = 1;
mbed_official 237:f3da66175598 130 /*Configure the PMA*/
mbed_official 237:f3da66175598 131 ep->pmaaddr0 = pmaadress & 0xFFFF;
mbed_official 237:f3da66175598 132 ep->pmaaddr1 = (pmaadress & 0xFFFF0000) >> 16;
mbed_official 237:f3da66175598 133 }
mbed_official 237:f3da66175598 134
mbed_official 237:f3da66175598 135 return HAL_OK;
mbed_official 237:f3da66175598 136 }
mbed_official 375:3d36234a1087 137 /**
mbed_official 375:3d36234a1087 138 * @}
mbed_official 375:3d36234a1087 139 */
mbed_official 237:f3da66175598 140
mbed_official 375:3d36234a1087 141 /**
mbed_official 375:3d36234a1087 142 * @}
mbed_official 375:3d36234a1087 143 */
mbed_official 375:3d36234a1087 144
mbed_official 375:3d36234a1087 145 /** @defgroup PCDEx_Private_Functions PCD Extended Private Functions
mbed_official 375:3d36234a1087 146 * @{
mbed_official 375:3d36234a1087 147 */
mbed_official 375:3d36234a1087 148 #if defined(STM32F303xC) || \
mbed_official 375:3d36234a1087 149 defined(STM32F303x8) || defined(STM32F334x8) || \
mbed_official 375:3d36234a1087 150 defined(STM32F301x8) || \
mbed_official 375:3d36234a1087 151 defined(STM32F373xC) || defined(STM32F378xx)
mbed_official 237:f3da66175598 152
mbed_official 237:f3da66175598 153
mbed_official 237:f3da66175598 154 /**
mbed_official 237:f3da66175598 155 * @brief Copy a buffer from user memory area to packet memory area (PMA)
mbed_official 237:f3da66175598 156 * @param USBx: USB peripheral instance register address.
mbed_official 237:f3da66175598 157 * @param pbUsrBuf: pointer to user memory area.
mbed_official 237:f3da66175598 158 * @param wPMABufAddr: address into PMA.
mbed_official 237:f3da66175598 159 * @param wNBytes: no. of bytes to be copied.
mbed_official 237:f3da66175598 160 * @retval None
mbed_official 237:f3da66175598 161 */
mbed_official 237:f3da66175598 162 void PCD_WritePMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)
mbed_official 237:f3da66175598 163 {
mbed_official 237:f3da66175598 164 uint32_t n = (wNBytes + 1) >> 1; /* n = (wNBytes + 1) / 2 */
mbed_official 237:f3da66175598 165 uint32_t i, temp1, temp2;
mbed_official 237:f3da66175598 166 uint16_t *pdwVal;
mbed_official 237:f3da66175598 167 pdwVal = (uint16_t *)(wPMABufAddr * 2 + (uint32_t)USBx + 0x400);
mbed_official 237:f3da66175598 168 for (i = n; i != 0; i--)
mbed_official 237:f3da66175598 169 {
mbed_official 237:f3da66175598 170 temp1 = (uint16_t) * pbUsrBuf;
mbed_official 237:f3da66175598 171 pbUsrBuf++;
mbed_official 237:f3da66175598 172 temp2 = temp1 | (uint16_t) * pbUsrBuf << 8;
mbed_official 237:f3da66175598 173 *pdwVal++ = temp2;
mbed_official 237:f3da66175598 174 pdwVal++;
mbed_official 237:f3da66175598 175 pbUsrBuf++;
mbed_official 237:f3da66175598 176 }
mbed_official 237:f3da66175598 177 }
mbed_official 237:f3da66175598 178
mbed_official 237:f3da66175598 179 /**
mbed_official 237:f3da66175598 180 * @brief Copy a buffer from user memory area to packet memory area (PMA)
mbed_official 237:f3da66175598 181 * @param USBx: USB peripheral instance register address.
mbed_official 375:3d36234a1087 182 * @param pbUsrBuf: pointer to user memory area.
mbed_official 237:f3da66175598 183 * @param wPMABufAddr: address into PMA.
mbed_official 237:f3da66175598 184 * @param wNBytes: no. of bytes to be copied.
mbed_official 237:f3da66175598 185 * @retval None
mbed_official 237:f3da66175598 186 */
mbed_official 237:f3da66175598 187 void PCD_ReadPMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)
mbed_official 237:f3da66175598 188 {
mbed_official 237:f3da66175598 189 uint32_t n = (wNBytes + 1) >> 1;/* /2*/
mbed_official 237:f3da66175598 190 uint32_t i;
mbed_official 237:f3da66175598 191 uint32_t *pdwVal;
mbed_official 237:f3da66175598 192 pdwVal = (uint32_t *)(wPMABufAddr * 2 + (uint32_t)USBx + 0x400);
mbed_official 237:f3da66175598 193 for (i = n; i != 0; i--)
mbed_official 237:f3da66175598 194 {
mbed_official 237:f3da66175598 195 *(uint16_t*)pbUsrBuf++ = *pdwVal++;
mbed_official 237:f3da66175598 196 pbUsrBuf++;
mbed_official 237:f3da66175598 197 }
mbed_official 237:f3da66175598 198 }
mbed_official 375:3d36234a1087 199 #endif /* STM32F303xC || */
mbed_official 375:3d36234a1087 200 /* STM32F303x8 || STM32F334x8 || */
mbed_official 375:3d36234a1087 201 /* STM32F301x8 || */
mbed_official 375:3d36234a1087 202 /* STM32F373xC || STM32F378xx */
mbed_official 237:f3da66175598 203
mbed_official 375:3d36234a1087 204 #if defined(STM32F302xE) || defined(STM32F303xE) || \
mbed_official 375:3d36234a1087 205 defined(STM32F302xC) || \
mbed_official 375:3d36234a1087 206 defined(STM32F302x8)
mbed_official 237:f3da66175598 207 /**
mbed_official 237:f3da66175598 208 * @brief Copy a buffer from user memory area to packet memory area (PMA)
mbed_official 237:f3da66175598 209 * @param USBx: USB peripheral instance register address.
mbed_official 237:f3da66175598 210 * @param pbUsrBuf: pointer to user memory area.
mbed_official 237:f3da66175598 211 * @param wPMABufAddr: address into PMA.
mbed_official 237:f3da66175598 212 * @param wNBytes: no. of bytes to be copied.
mbed_official 237:f3da66175598 213 * @retval None
mbed_official 237:f3da66175598 214 */
mbed_official 237:f3da66175598 215 void PCD_WritePMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)
mbed_official 237:f3da66175598 216 {
mbed_official 237:f3da66175598 217 uint32_t n = (wNBytes + 1) >> 1;
mbed_official 237:f3da66175598 218 uint32_t i;
mbed_official 237:f3da66175598 219 uint16_t temp1, temp2;
mbed_official 237:f3da66175598 220 uint16_t *pdwVal;
mbed_official 237:f3da66175598 221 pdwVal = (uint16_t *)(wPMABufAddr + (uint32_t)USBx + 0x400);
mbed_official 237:f3da66175598 222
mbed_official 237:f3da66175598 223 for (i = n; i != 0; i--)
mbed_official 237:f3da66175598 224 {
mbed_official 237:f3da66175598 225 temp1 = (uint16_t) * pbUsrBuf;
mbed_official 237:f3da66175598 226 pbUsrBuf++;
mbed_official 237:f3da66175598 227 temp2 = temp1 | (uint16_t) * pbUsrBuf << 8;
mbed_official 237:f3da66175598 228 *pdwVal++ = temp2;
mbed_official 237:f3da66175598 229 pbUsrBuf++;
mbed_official 237:f3da66175598 230 }
mbed_official 237:f3da66175598 231 }
mbed_official 237:f3da66175598 232
mbed_official 237:f3da66175598 233 /**
mbed_official 237:f3da66175598 234 * @brief Copy a buffer from user memory area to packet memory area (PMA)
mbed_official 237:f3da66175598 235 * @param USBx: USB peripheral instance register address.
mbed_official 375:3d36234a1087 236 * @param pbUsrBuf: pointer to user memory area.
mbed_official 237:f3da66175598 237 * @param wPMABufAddr: address into PMA.
mbed_official 237:f3da66175598 238 * @param wNBytes: no. of bytes to be copied.
mbed_official 237:f3da66175598 239 * @retval None
mbed_official 237:f3da66175598 240 */
mbed_official 237:f3da66175598 241 void PCD_ReadPMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf, uint16_t wPMABufAddr, uint16_t wNBytes)
mbed_official 237:f3da66175598 242 {
mbed_official 237:f3da66175598 243 uint32_t n = (wNBytes + 1) >> 1;
mbed_official 237:f3da66175598 244 uint32_t i;
mbed_official 237:f3da66175598 245 uint16_t *pdwVal;
mbed_official 237:f3da66175598 246 pdwVal = (uint16_t *)(wPMABufAddr + (uint32_t)USBx + 0x400);
mbed_official 237:f3da66175598 247 for (i = n; i != 0; i--)
mbed_official 237:f3da66175598 248 {
mbed_official 237:f3da66175598 249 *(uint16_t*)pbUsrBuf++ = *pdwVal++;
mbed_official 237:f3da66175598 250 pbUsrBuf++;
mbed_official 237:f3da66175598 251 }
mbed_official 237:f3da66175598 252 }
mbed_official 375:3d36234a1087 253 #endif /* STM32F302xE || STM32F303xE || */
mbed_official 375:3d36234a1087 254 /* STM32F302xC || */
mbed_official 375:3d36234a1087 255 /* STM32F302x8 */
mbed_official 375:3d36234a1087 256
mbed_official 375:3d36234a1087 257 /**
mbed_official 375:3d36234a1087 258 * @}
mbed_official 375:3d36234a1087 259 */
mbed_official 237:f3da66175598 260
mbed_official 375:3d36234a1087 261 /** @addtogroup PCDEx_Exported_Functions PCD Extended Exported Functions
mbed_official 375:3d36234a1087 262 * @{
mbed_official 375:3d36234a1087 263 */
mbed_official 375:3d36234a1087 264
mbed_official 375:3d36234a1087 265 /** @addtogroup PCDEx_Exported_Functions_Group1 Extended Initialization and de-initialization functions
mbed_official 375:3d36234a1087 266 * @{
mbed_official 375:3d36234a1087 267 */
mbed_official 237:f3da66175598 268 /**
mbed_official 237:f3da66175598 269 * @brief Software Device Connection
mbed_official 237:f3da66175598 270 * @param hpcd: PCD handle
mbed_official 237:f3da66175598 271 * @param state: Device state
mbed_official 237:f3da66175598 272 * @retval None
mbed_official 237:f3da66175598 273 */
mbed_official 237:f3da66175598 274 __weak void HAL_PCDEx_SetConnectionState(PCD_HandleTypeDef *hpcd, uint8_t state)
mbed_official 237:f3da66175598 275 {
mbed_official 237:f3da66175598 276 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 237:f3da66175598 277 the HAL_PCDEx_SetConnectionState could be implenetd in the user file
mbed_official 237:f3da66175598 278 */
mbed_official 237:f3da66175598 279 }
mbed_official 375:3d36234a1087 280 /**
mbed_official 375:3d36234a1087 281 * @}
mbed_official 375:3d36234a1087 282 */
mbed_official 237:f3da66175598 283
mbed_official 237:f3da66175598 284 /**
mbed_official 237:f3da66175598 285 * @}
mbed_official 237:f3da66175598 286 */
mbed_official 375:3d36234a1087 287 #endif /* STM32F302xE || STM32F303xE || */
mbed_official 375:3d36234a1087 288 /* STM32F302xC || STM32F303xC || */
mbed_official 375:3d36234a1087 289 /* STM32F302x8 || */
mbed_official 375:3d36234a1087 290 /* STM32F373xC */
mbed_official 237:f3da66175598 291
mbed_official 237:f3da66175598 292 #endif /* HAL_PCD_MODULE_ENABLED */
mbed_official 237:f3da66175598 293 /**
mbed_official 237:f3da66175598 294 * @}
mbed_official 237:f3da66175598 295 */
mbed_official 237:f3da66175598 296
mbed_official 237:f3da66175598 297 /**
mbed_official 237:f3da66175598 298 * @}
mbed_official 237:f3da66175598 299 */
mbed_official 237:f3da66175598 300
mbed_official 237:f3da66175598 301 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/