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_ll_sdmmc.c@579:53297373a894, 2015-07-01 (annotated)

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
573:ad23fe03a082
Child:
610:813dcc80987e
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081



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



Initial version of drivers for SAMR21

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_ll_sdmmc.c
mbed_official 573:ad23fe03a082 4 * @author MCD Application Team
mbed_official 573:ad23fe03a082 5 * @version V1.0.0
mbed_official 573:ad23fe03a082 6 * @date 12-May-2015
mbed_official 573:ad23fe03a082 7 * @brief SDMMC Low Layer HAL module driver.
mbed_official 573:ad23fe03a082 8 *
mbed_official 573:ad23fe03a082 9 * This file provides firmware functions to manage the following
mbed_official 573:ad23fe03a082 10 * functionalities of the SDMMC peripheral:
mbed_official 573:ad23fe03a082 11 * + Initialization/de-initialization functions
mbed_official 573:ad23fe03a082 12 * + I/O operation functions
mbed_official 573:ad23fe03a082 13 * + Peripheral Control functions
mbed_official 573:ad23fe03a082 14 * + Peripheral State functions
mbed_official 573:ad23fe03a082 15 *
mbed_official 573:ad23fe03a082 16 @verbatim
mbed_official 573:ad23fe03a082 17 ==============================================================================
mbed_official 573:ad23fe03a082 18 ##### SDMMC peripheral features #####
mbed_official 573:ad23fe03a082 19 ==============================================================================
mbed_official 573:ad23fe03a082 20 [..] The SD/SDMMC MMC card host interface (SDMMC) provides an interface between the APB2
mbed_official 573:ad23fe03a082 21 peripheral bus and MultiMedia cards (MMCs), SD memory cards, SDMMC cards and CE-ATA
mbed_official 573:ad23fe03a082 22 devices.
mbed_official 573:ad23fe03a082 23
mbed_official 573:ad23fe03a082 24 [..] The SDMMC features include the following:
mbed_official 573:ad23fe03a082 25 (+) Full compliance with MultiMedia Card System Specification Version 4.2. Card support
mbed_official 573:ad23fe03a082 26 for three different databus modes: 1-bit (default), 4-bit and 8-bit
mbed_official 573:ad23fe03a082 27 (+) Full compatibility with previous versions of MultiMedia Cards (forward compatibility)
mbed_official 573:ad23fe03a082 28 (+) Full compliance with SD Memory Card Specifications Version 2.0
mbed_official 573:ad23fe03a082 29 (+) Full compliance with SD I/O Card Specification Version 2.0: card support for two
mbed_official 573:ad23fe03a082 30 different data bus modes: 1-bit (default) and 4-bit
mbed_official 573:ad23fe03a082 31 (+) Full support of the CE-ATA features (full compliance with CE-ATA digital protocol
mbed_official 573:ad23fe03a082 32 Rev1.1)
mbed_official 573:ad23fe03a082 33 (+) Data transfer up to 48 MHz for the 8 bit mode
mbed_official 573:ad23fe03a082 34 (+) Data and command output enable signals to control external bidirectional drivers.
mbed_official 573:ad23fe03a082 35
mbed_official 573:ad23fe03a082 36
mbed_official 573:ad23fe03a082 37 ##### How to use this driver #####
mbed_official 573:ad23fe03a082 38 ==============================================================================
mbed_official 573:ad23fe03a082 39 [..]
mbed_official 573:ad23fe03a082 40 This driver is a considered as a driver of service for external devices drivers
mbed_official 573:ad23fe03a082 41 that interfaces with the SDMMC peripheral.
mbed_official 573:ad23fe03a082 42 According to the device used (SD card/ MMC card / SDMMC card ...), a set of APIs
mbed_official 573:ad23fe03a082 43 is used in the device's driver to perform SDMMC operations and functionalities.
mbed_official 573:ad23fe03a082 44
mbed_official 573:ad23fe03a082 45 This driver is almost transparent for the final user, it is only used to implement other
mbed_official 573:ad23fe03a082 46 functionalities of the external device.
mbed_official 573:ad23fe03a082 47
mbed_official 573:ad23fe03a082 48 [..]
mbed_official 573:ad23fe03a082 49 (+) The SDMMC clock (SDMMCCLK = 48 MHz) is coming from a specific output of PLL
mbed_official 573:ad23fe03a082 50 (PLL48CLK). Before start working with SDMMC peripheral make sure that the
mbed_official 573:ad23fe03a082 51 PLL is well configured.
mbed_official 573:ad23fe03a082 52 The SDMMC peripheral uses two clock signals:
mbed_official 573:ad23fe03a082 53 (++) SDMMC adapter clock (SDMMCCLK = 48 MHz)
mbed_official 573:ad23fe03a082 54 (++) APB2 bus clock (PCLK2)
mbed_official 573:ad23fe03a082 55
mbed_official 573:ad23fe03a082 56 -@@- PCLK2 and SDMMC_CK clock frequencies must respect the following condition:
mbed_official 573:ad23fe03a082 57 Frequency(PCLK2) >= (3 / 8 x Frequency(SDMMC_CK))
mbed_official 573:ad23fe03a082 58
mbed_official 573:ad23fe03a082 59 (+) Enable/Disable peripheral clock using RCC peripheral macros related to SDMMC
mbed_official 573:ad23fe03a082 60 peripheral.
mbed_official 573:ad23fe03a082 61
mbed_official 573:ad23fe03a082 62 (+) Enable the Power ON State using the SDMMC_PowerState_ON(SDMMCx)
mbed_official 573:ad23fe03a082 63 function and disable it using the function SDMMC_PowerState_OFF(SDMMCx).
mbed_official 573:ad23fe03a082 64
mbed_official 573:ad23fe03a082 65 (+) Enable/Disable the clock using the __SDMMC_ENABLE()/__SDMMC_DISABLE() macros.
mbed_official 573:ad23fe03a082 66
mbed_official 573:ad23fe03a082 67 (+) Enable/Disable the peripheral interrupts using the macros __SDMMC_ENABLE_IT(hSDMMC, IT)
mbed_official 573:ad23fe03a082 68 and __SDMMC_DISABLE_IT(hSDMMC, IT) if you need to use interrupt mode.
mbed_official 573:ad23fe03a082 69
mbed_official 573:ad23fe03a082 70 (+) When using the DMA mode
mbed_official 573:ad23fe03a082 71 (++) Configure the DMA in the MSP layer of the external device
mbed_official 573:ad23fe03a082 72 (++) Active the needed channel Request
mbed_official 573:ad23fe03a082 73 (++) Enable the DMA using __SDMMC_DMA_ENABLE() macro or Disable it using the macro
mbed_official 573:ad23fe03a082 74 __SDMMC_DMA_DISABLE().
mbed_official 573:ad23fe03a082 75
mbed_official 573:ad23fe03a082 76 (+) To control the CPSM (Command Path State Machine) and send
mbed_official 573:ad23fe03a082 77 commands to the card use the SDMMC_SendCommand(SDMMCx),
mbed_official 573:ad23fe03a082 78 SDMMC_GetCommandResponse() and SDMMC_GetResponse() functions. First, user has
mbed_official 573:ad23fe03a082 79 to fill the command structure (pointer to SDMMC_CmdInitTypeDef) according
mbed_official 573:ad23fe03a082 80 to the selected command to be sent.
mbed_official 573:ad23fe03a082 81 The parameters that should be filled are:
mbed_official 573:ad23fe03a082 82 (++) Command Argument
mbed_official 573:ad23fe03a082 83 (++) Command Index
mbed_official 573:ad23fe03a082 84 (++) Command Response type
mbed_official 573:ad23fe03a082 85 (++) Command Wait
mbed_official 573:ad23fe03a082 86 (++) CPSM Status (Enable or Disable).
mbed_official 573:ad23fe03a082 87
mbed_official 573:ad23fe03a082 88 -@@- To check if the command is well received, read the SDMMC_CMDRESP
mbed_official 573:ad23fe03a082 89 register using the SDMMC_GetCommandResponse().
mbed_official 573:ad23fe03a082 90 The SDMMC responses registers (SDMMC_RESP1 to SDMMC_RESP2), use the
mbed_official 573:ad23fe03a082 91 SDMMC_GetResponse() function.
mbed_official 573:ad23fe03a082 92
mbed_official 573:ad23fe03a082 93 (+) To control the DPSM (Data Path State Machine) and send/receive
mbed_official 573:ad23fe03a082 94 data to/from the card use the SDMMC_DataConfig(), SDMMC_GetDataCounter(),
mbed_official 573:ad23fe03a082 95 SDMMC_ReadFIFO(), DIO_WriteFIFO() and SDMMC_GetFIFOCount() functions.
mbed_official 573:ad23fe03a082 96
mbed_official 573:ad23fe03a082 97 *** Read Operations ***
mbed_official 573:ad23fe03a082 98 =======================
mbed_official 573:ad23fe03a082 99 [..]
mbed_official 573:ad23fe03a082 100 (#) First, user has to fill the data structure (pointer to
mbed_official 573:ad23fe03a082 101 SDMMC_DataInitTypeDef) according to the selected data type to be received.
mbed_official 573:ad23fe03a082 102 The parameters that should be filled are:
mbed_official 573:ad23fe03a082 103 (++) Data TimeOut
mbed_official 573:ad23fe03a082 104 (++) Data Length
mbed_official 573:ad23fe03a082 105 (++) Data Block size
mbed_official 573:ad23fe03a082 106 (++) Data Transfer direction: should be from card (To SDMMC)
mbed_official 573:ad23fe03a082 107 (++) Data Transfer mode
mbed_official 573:ad23fe03a082 108 (++) DPSM Status (Enable or Disable)
mbed_official 573:ad23fe03a082 109
mbed_official 573:ad23fe03a082 110 (#) Configure the SDMMC resources to receive the data from the card
mbed_official 573:ad23fe03a082 111 according to selected transfer mode (Refer to Step 8, 9 and 10).
mbed_official 573:ad23fe03a082 112
mbed_official 573:ad23fe03a082 113 (#) Send the selected Read command (refer to step 11).
mbed_official 573:ad23fe03a082 114
mbed_official 573:ad23fe03a082 115 (#) Use the SDMMC flags/interrupts to check the transfer status.
mbed_official 573:ad23fe03a082 116
mbed_official 573:ad23fe03a082 117 *** Write Operations ***
mbed_official 573:ad23fe03a082 118 ========================
mbed_official 573:ad23fe03a082 119 [..]
mbed_official 573:ad23fe03a082 120 (#) First, user has to fill the data structure (pointer to
mbed_official 573:ad23fe03a082 121 SDMMC_DataInitTypeDef) according to the selected data type to be received.
mbed_official 573:ad23fe03a082 122 The parameters that should be filled are:
mbed_official 573:ad23fe03a082 123 (++) Data TimeOut
mbed_official 573:ad23fe03a082 124 (++) Data Length
mbed_official 573:ad23fe03a082 125 (++) Data Block size
mbed_official 573:ad23fe03a082 126 (++) Data Transfer direction: should be to card (To CARD)
mbed_official 573:ad23fe03a082 127 (++) Data Transfer mode
mbed_official 573:ad23fe03a082 128 (++) DPSM Status (Enable or Disable)
mbed_official 573:ad23fe03a082 129
mbed_official 573:ad23fe03a082 130 (#) Configure the SDMMC resources to send the data to the card according to
mbed_official 573:ad23fe03a082 131 selected transfer mode.
mbed_official 573:ad23fe03a082 132
mbed_official 573:ad23fe03a082 133 (#) Send the selected Write command.
mbed_official 573:ad23fe03a082 134
mbed_official 573:ad23fe03a082 135 (#) Use the SDMMC flags/interrupts to check the transfer status.
mbed_official 573:ad23fe03a082 136
mbed_official 573:ad23fe03a082 137 @endverbatim
mbed_official 573:ad23fe03a082 138 ******************************************************************************
mbed_official 573:ad23fe03a082 139 * @attention
mbed_official 573:ad23fe03a082 140 *
mbed_official 573:ad23fe03a082 141 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 573:ad23fe03a082 142 *
mbed_official 573:ad23fe03a082 143 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 573:ad23fe03a082 144 * are permitted provided that the following conditions are met:
mbed_official 573:ad23fe03a082 145 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 573:ad23fe03a082 146 * this list of conditions and the following disclaimer.
mbed_official 573:ad23fe03a082 147 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 573:ad23fe03a082 148 * this list of conditions and the following disclaimer in the documentation
mbed_official 573:ad23fe03a082 149 * and/or other materials provided with the distribution.
mbed_official 573:ad23fe03a082 150 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 573:ad23fe03a082 151 * may be used to endorse or promote products derived from this software
mbed_official 573:ad23fe03a082 152 * without specific prior written permission.
mbed_official 573:ad23fe03a082 153 *
mbed_official 573:ad23fe03a082 154 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 573:ad23fe03a082 155 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 573:ad23fe03a082 156 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 573:ad23fe03a082 157 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 573:ad23fe03a082 158 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 573:ad23fe03a082 159 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 573:ad23fe03a082 160 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 573:ad23fe03a082 161 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 573:ad23fe03a082 162 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 573:ad23fe03a082 163 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 573:ad23fe03a082 164 *
mbed_official 573:ad23fe03a082 165 ******************************************************************************
mbed_official 573:ad23fe03a082 166 */
mbed_official 573:ad23fe03a082 167
mbed_official 573:ad23fe03a082 168 /* Includes ------------------------------------------------------------------*/
mbed_official 573:ad23fe03a082 169 #include "stm32f7xx_hal.h"
mbed_official 573:ad23fe03a082 170
mbed_official 573:ad23fe03a082 171 /** @addtogroup STM32F7xx_HAL_Driver
mbed_official 573:ad23fe03a082 172 * @{
mbed_official 573:ad23fe03a082 173 */
mbed_official 573:ad23fe03a082 174
mbed_official 573:ad23fe03a082 175 /** @defgroup SDMMC_LL SDMMC Low Layer
mbed_official 573:ad23fe03a082 176 * @brief Low layer module for SD
mbed_official 573:ad23fe03a082 177 * @{
mbed_official 573:ad23fe03a082 178 */
mbed_official 573:ad23fe03a082 179
mbed_official 573:ad23fe03a082 180 #if defined (HAL_SD_MODULE_ENABLED) || defined(HAL_MMC_MODULE_ENABLED)
mbed_official 573:ad23fe03a082 181
mbed_official 573:ad23fe03a082 182 /* Private typedef -----------------------------------------------------------*/
mbed_official 573:ad23fe03a082 183 /* Private define ------------------------------------------------------------*/
mbed_official 573:ad23fe03a082 184 /* Private macro -------------------------------------------------------------*/
mbed_official 573:ad23fe03a082 185 /* Private variables ---------------------------------------------------------*/
mbed_official 573:ad23fe03a082 186 /* Private function prototypes -----------------------------------------------*/
mbed_official 573:ad23fe03a082 187 /* Exported functions --------------------------------------------------------*/
mbed_official 573:ad23fe03a082 188
mbed_official 573:ad23fe03a082 189 /** @defgroup SDMMC_LL_Exported_Functions SDMMC Low Layer Exported Functions
mbed_official 573:ad23fe03a082 190 * @{
mbed_official 573:ad23fe03a082 191 */
mbed_official 573:ad23fe03a082 192
mbed_official 573:ad23fe03a082 193 /** @defgroup HAL_SDMMC_LL_Group1 Initialization de-initialization functions
mbed_official 573:ad23fe03a082 194 * @brief Initialization and Configuration functions
mbed_official 573:ad23fe03a082 195 *
mbed_official 573:ad23fe03a082 196 @verbatim
mbed_official 573:ad23fe03a082 197 ===============================================================================
mbed_official 573:ad23fe03a082 198 ##### Initialization/de-initialization functions #####
mbed_official 573:ad23fe03a082 199 ===============================================================================
mbed_official 573:ad23fe03a082 200 [..] This section provides functions allowing to:
mbed_official 573:ad23fe03a082 201
mbed_official 573:ad23fe03a082 202 @endverbatim
mbed_official 573:ad23fe03a082 203 * @{
mbed_official 573:ad23fe03a082 204 */
mbed_official 573:ad23fe03a082 205
mbed_official 573:ad23fe03a082 206 /**
mbed_official 573:ad23fe03a082 207 * @brief Initializes the SDMMC according to the specified
mbed_official 573:ad23fe03a082 208 * parameters in the SDMMC_InitTypeDef and create the associated handle.
mbed_official 573:ad23fe03a082 209 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 210 * @param Init: SDMMC initialization structure
mbed_official 573:ad23fe03a082 211 * @retval HAL status
mbed_official 573:ad23fe03a082 212 */
mbed_official 573:ad23fe03a082 213 HAL_StatusTypeDef SDMMC_Init(SDMMC_TypeDef *SDMMCx, SDMMC_InitTypeDef Init)
mbed_official 573:ad23fe03a082 214 {
mbed_official 573:ad23fe03a082 215 uint32_t tmpreg = 0;
mbed_official 573:ad23fe03a082 216
mbed_official 573:ad23fe03a082 217 /* Check the parameters */
mbed_official 573:ad23fe03a082 218 assert_param(IS_SDMMC_ALL_INSTANCE(SDMMCx));
mbed_official 573:ad23fe03a082 219 assert_param(IS_SDMMC_CLOCK_EDGE(Init.ClockEdge));
mbed_official 573:ad23fe03a082 220 assert_param(IS_SDMMC_CLOCK_BYPASS(Init.ClockBypass));
mbed_official 573:ad23fe03a082 221 assert_param(IS_SDMMC_CLOCK_POWER_SAVE(Init.ClockPowerSave));
mbed_official 573:ad23fe03a082 222 assert_param(IS_SDMMC_BUS_WIDE(Init.BusWide));
mbed_official 573:ad23fe03a082 223 assert_param(IS_SDMMC_HARDWARE_FLOW_CONTROL(Init.HardwareFlowControl));
mbed_official 573:ad23fe03a082 224 assert_param(IS_SDMMC_CLKDIV(Init.ClockDiv));
mbed_official 573:ad23fe03a082 225
mbed_official 573:ad23fe03a082 226 /* Set SDMMC configuration parameters */
mbed_official 573:ad23fe03a082 227 tmpreg |= (Init.ClockEdge |\
mbed_official 573:ad23fe03a082 228 Init.ClockBypass |\
mbed_official 573:ad23fe03a082 229 Init.ClockPowerSave |\
mbed_official 573:ad23fe03a082 230 Init.BusWide |\
mbed_official 573:ad23fe03a082 231 Init.HardwareFlowControl |\
mbed_official 573:ad23fe03a082 232 Init.ClockDiv
mbed_official 573:ad23fe03a082 233 );
mbed_official 573:ad23fe03a082 234
mbed_official 573:ad23fe03a082 235 /* Write to SDMMC CLKCR */
mbed_official 573:ad23fe03a082 236 MODIFY_REG(SDMMCx->CLKCR, CLKCR_CLEAR_MASK, tmpreg);
mbed_official 573:ad23fe03a082 237
mbed_official 573:ad23fe03a082 238 return HAL_OK;
mbed_official 573:ad23fe03a082 239 }
mbed_official 573:ad23fe03a082 240
mbed_official 573:ad23fe03a082 241
mbed_official 573:ad23fe03a082 242
mbed_official 573:ad23fe03a082 243 /**
mbed_official 573:ad23fe03a082 244 * @}
mbed_official 573:ad23fe03a082 245 */
mbed_official 573:ad23fe03a082 246
mbed_official 573:ad23fe03a082 247 /** @defgroup HAL_SDMMC_LL_Group2 IO operation functions
mbed_official 573:ad23fe03a082 248 * @brief Data transfers functions
mbed_official 573:ad23fe03a082 249 *
mbed_official 573:ad23fe03a082 250 @verbatim
mbed_official 573:ad23fe03a082 251 ===============================================================================
mbed_official 573:ad23fe03a082 252 ##### I/O operation functions #####
mbed_official 573:ad23fe03a082 253 ===============================================================================
mbed_official 573:ad23fe03a082 254 [..]
mbed_official 573:ad23fe03a082 255 This subsection provides a set of functions allowing to manage the SDMMC data
mbed_official 573:ad23fe03a082 256 transfers.
mbed_official 573:ad23fe03a082 257
mbed_official 573:ad23fe03a082 258 @endverbatim
mbed_official 573:ad23fe03a082 259 * @{
mbed_official 573:ad23fe03a082 260 */
mbed_official 573:ad23fe03a082 261
mbed_official 573:ad23fe03a082 262 /**
mbed_official 573:ad23fe03a082 263 * @brief Read data (word) from Rx FIFO in blocking mode (polling)
mbed_official 573:ad23fe03a082 264 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 265 * @retval HAL status
mbed_official 573:ad23fe03a082 266 */
mbed_official 573:ad23fe03a082 267 uint32_t SDMMC_ReadFIFO(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 268 {
mbed_official 573:ad23fe03a082 269 /* Read data from Rx FIFO */
mbed_official 573:ad23fe03a082 270 return (SDMMCx->FIFO);
mbed_official 573:ad23fe03a082 271 }
mbed_official 573:ad23fe03a082 272
mbed_official 573:ad23fe03a082 273 /**
mbed_official 573:ad23fe03a082 274 * @brief Write data (word) to Tx FIFO in blocking mode (polling)
mbed_official 573:ad23fe03a082 275 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 276 * @param pWriteData: pointer to data to write
mbed_official 573:ad23fe03a082 277 * @retval HAL status
mbed_official 573:ad23fe03a082 278 */
mbed_official 573:ad23fe03a082 279 HAL_StatusTypeDef SDMMC_WriteFIFO(SDMMC_TypeDef *SDMMCx, uint32_t *pWriteData)
mbed_official 573:ad23fe03a082 280 {
mbed_official 573:ad23fe03a082 281 /* Write data to FIFO */
mbed_official 573:ad23fe03a082 282 SDMMCx->FIFO = *pWriteData;
mbed_official 573:ad23fe03a082 283
mbed_official 573:ad23fe03a082 284 return HAL_OK;
mbed_official 573:ad23fe03a082 285 }
mbed_official 573:ad23fe03a082 286
mbed_official 573:ad23fe03a082 287 /**
mbed_official 573:ad23fe03a082 288 * @}
mbed_official 573:ad23fe03a082 289 */
mbed_official 573:ad23fe03a082 290
mbed_official 573:ad23fe03a082 291 /** @defgroup HAL_SDMMC_LL_Group3 Peripheral Control functions
mbed_official 573:ad23fe03a082 292 * @brief management functions
mbed_official 573:ad23fe03a082 293 *
mbed_official 573:ad23fe03a082 294 @verbatim
mbed_official 573:ad23fe03a082 295 ===============================================================================
mbed_official 573:ad23fe03a082 296 ##### Peripheral Control functions #####
mbed_official 573:ad23fe03a082 297 ===============================================================================
mbed_official 573:ad23fe03a082 298 [..]
mbed_official 573:ad23fe03a082 299 This subsection provides a set of functions allowing to control the SDMMC data
mbed_official 573:ad23fe03a082 300 transfers.
mbed_official 573:ad23fe03a082 301
mbed_official 573:ad23fe03a082 302 @endverbatim
mbed_official 573:ad23fe03a082 303 * @{
mbed_official 573:ad23fe03a082 304 */
mbed_official 573:ad23fe03a082 305
mbed_official 573:ad23fe03a082 306 /**
mbed_official 573:ad23fe03a082 307 * @brief Set SDMMC Power state to ON.
mbed_official 573:ad23fe03a082 308 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 309 * @retval HAL status
mbed_official 573:ad23fe03a082 310 */
mbed_official 573:ad23fe03a082 311 HAL_StatusTypeDef SDMMC_PowerState_ON(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 312 {
mbed_official 573:ad23fe03a082 313 /* Set power state to ON */
mbed_official 573:ad23fe03a082 314 SDMMCx->POWER = SDMMC_POWER_PWRCTRL;
mbed_official 573:ad23fe03a082 315
mbed_official 573:ad23fe03a082 316 return HAL_OK;
mbed_official 573:ad23fe03a082 317 }
mbed_official 573:ad23fe03a082 318
mbed_official 573:ad23fe03a082 319 /**
mbed_official 573:ad23fe03a082 320 * @brief Set SDMMC Power state to OFF.
mbed_official 573:ad23fe03a082 321 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 322 * @retval HAL status
mbed_official 573:ad23fe03a082 323 */
mbed_official 573:ad23fe03a082 324 HAL_StatusTypeDef SDMMC_PowerState_OFF(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 325 {
mbed_official 573:ad23fe03a082 326 /* Set power state to OFF */
mbed_official 573:ad23fe03a082 327 SDMMCx->POWER = (uint32_t)0x00000000;
mbed_official 573:ad23fe03a082 328
mbed_official 573:ad23fe03a082 329 return HAL_OK;
mbed_official 573:ad23fe03a082 330 }
mbed_official 573:ad23fe03a082 331
mbed_official 573:ad23fe03a082 332 /**
mbed_official 573:ad23fe03a082 333 * @brief Get SDMMC Power state.
mbed_official 573:ad23fe03a082 334 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 335 * @retval Power status of the controller. The returned value can be one of the
mbed_official 573:ad23fe03a082 336 * following values:
mbed_official 573:ad23fe03a082 337 * - 0x00: Power OFF
mbed_official 573:ad23fe03a082 338 * - 0x02: Power UP
mbed_official 573:ad23fe03a082 339 * - 0x03: Power ON
mbed_official 573:ad23fe03a082 340 */
mbed_official 573:ad23fe03a082 341 uint32_t SDMMC_GetPowerState(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 342 {
mbed_official 573:ad23fe03a082 343 return (SDMMCx->POWER & SDMMC_POWER_PWRCTRL);
mbed_official 573:ad23fe03a082 344 }
mbed_official 573:ad23fe03a082 345
mbed_official 573:ad23fe03a082 346 /**
mbed_official 573:ad23fe03a082 347 * @brief Configure the SDMMC command path according to the specified parameters in
mbed_official 573:ad23fe03a082 348 * SDMMC_CmdInitTypeDef structure and send the command
mbed_official 573:ad23fe03a082 349 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 350 * @param Command: pointer to a SDMMC_CmdInitTypeDef structure that contains
mbed_official 573:ad23fe03a082 351 * the configuration information for the SDMMC command
mbed_official 573:ad23fe03a082 352 * @retval HAL status
mbed_official 573:ad23fe03a082 353 */
mbed_official 573:ad23fe03a082 354 HAL_StatusTypeDef SDMMC_SendCommand(SDMMC_TypeDef *SDMMCx, SDMMC_CmdInitTypeDef *Command)
mbed_official 573:ad23fe03a082 355 {
mbed_official 573:ad23fe03a082 356 uint32_t tmpreg = 0;
mbed_official 573:ad23fe03a082 357
mbed_official 573:ad23fe03a082 358 /* Check the parameters */
mbed_official 573:ad23fe03a082 359 assert_param(IS_SDMMC_CMD_INDEX(Command->CmdIndex));
mbed_official 573:ad23fe03a082 360 assert_param(IS_SDMMC_RESPONSE(Command->Response));
mbed_official 573:ad23fe03a082 361 assert_param(IS_SDMMC_WAIT(Command->WaitForInterrupt));
mbed_official 573:ad23fe03a082 362 assert_param(IS_SDMMC_CPSM(Command->CPSM));
mbed_official 573:ad23fe03a082 363
mbed_official 573:ad23fe03a082 364 /* Set the SDMMC Argument value */
mbed_official 573:ad23fe03a082 365 SDMMCx->ARG = Command->Argument;
mbed_official 573:ad23fe03a082 366
mbed_official 573:ad23fe03a082 367 /* Set SDMMC command parameters */
mbed_official 573:ad23fe03a082 368 tmpreg |= (uint32_t)(Command->CmdIndex |\
mbed_official 573:ad23fe03a082 369 Command->Response |\
mbed_official 573:ad23fe03a082 370 Command->WaitForInterrupt |\
mbed_official 573:ad23fe03a082 371 Command->CPSM);
mbed_official 573:ad23fe03a082 372
mbed_official 573:ad23fe03a082 373 /* Write to SDMMC CMD register */
mbed_official 573:ad23fe03a082 374 MODIFY_REG(SDMMCx->CMD, CMD_CLEAR_MASK, tmpreg);
mbed_official 573:ad23fe03a082 375
mbed_official 573:ad23fe03a082 376 return HAL_OK;
mbed_official 573:ad23fe03a082 377 }
mbed_official 573:ad23fe03a082 378
mbed_official 573:ad23fe03a082 379 /**
mbed_official 573:ad23fe03a082 380 * @brief Return the command index of last command for which response received
mbed_official 573:ad23fe03a082 381 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 382 * @retval Command index of the last command response received
mbed_official 573:ad23fe03a082 383 */
mbed_official 573:ad23fe03a082 384 uint8_t SDMMC_GetCommandResponse(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 385 {
mbed_official 573:ad23fe03a082 386 return (uint8_t)(SDMMCx->RESPCMD);
mbed_official 573:ad23fe03a082 387 }
mbed_official 573:ad23fe03a082 388
mbed_official 573:ad23fe03a082 389
mbed_official 573:ad23fe03a082 390 /**
mbed_official 573:ad23fe03a082 391 * @brief Return the response received from the card for the last command
mbed_official 573:ad23fe03a082 392 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 393 * @param Response: Specifies the SDMMC response register.
mbed_official 573:ad23fe03a082 394 * This parameter can be one of the following values:
mbed_official 573:ad23fe03a082 395 * @arg SDMMC_RESP1: Response Register 1
mbed_official 573:ad23fe03a082 396 * @arg SDMMC_RESP2: Response Register 2
mbed_official 573:ad23fe03a082 397 * @arg SDMMC_RESP3: Response Register 3
mbed_official 573:ad23fe03a082 398 * @arg SDMMC_RESP4: Response Register 4
mbed_official 573:ad23fe03a082 399 * @retval The Corresponding response register value
mbed_official 573:ad23fe03a082 400 */
mbed_official 573:ad23fe03a082 401 uint32_t SDMMC_GetResponse(SDMMC_TypeDef *SDMMCx, uint32_t Response)
mbed_official 573:ad23fe03a082 402 {
mbed_official 573:ad23fe03a082 403 __IO uint32_t tmp = 0;
mbed_official 573:ad23fe03a082 404
mbed_official 573:ad23fe03a082 405 /* Check the parameters */
mbed_official 573:ad23fe03a082 406 assert_param(IS_SDMMC_RESP(Response));
mbed_official 573:ad23fe03a082 407
mbed_official 573:ad23fe03a082 408 /* Get the response */
mbed_official 573:ad23fe03a082 409 tmp = (uint32_t)&(SDMMCx->RESP1) + Response;
mbed_official 573:ad23fe03a082 410
mbed_official 573:ad23fe03a082 411 return (*(__IO uint32_t *) tmp);
mbed_official 573:ad23fe03a082 412 }
mbed_official 573:ad23fe03a082 413
mbed_official 573:ad23fe03a082 414 /**
mbed_official 573:ad23fe03a082 415 * @brief Configure the SDMMC data path according to the specified
mbed_official 573:ad23fe03a082 416 * parameters in the SDMMC_DataInitTypeDef.
mbed_official 573:ad23fe03a082 417 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 418 * @param Data : pointer to a SDMMC_DataInitTypeDef structure
mbed_official 573:ad23fe03a082 419 * that contains the configuration information for the SDMMC data.
mbed_official 573:ad23fe03a082 420 * @retval HAL status
mbed_official 573:ad23fe03a082 421 */
mbed_official 573:ad23fe03a082 422 HAL_StatusTypeDef SDMMC_DataConfig(SDMMC_TypeDef *SDMMCx, SDMMC_DataInitTypeDef* Data)
mbed_official 573:ad23fe03a082 423 {
mbed_official 573:ad23fe03a082 424 uint32_t tmpreg = 0;
mbed_official 573:ad23fe03a082 425
mbed_official 573:ad23fe03a082 426 /* Check the parameters */
mbed_official 573:ad23fe03a082 427 assert_param(IS_SDMMC_DATA_LENGTH(Data->DataLength));
mbed_official 573:ad23fe03a082 428 assert_param(IS_SDMMC_BLOCK_SIZE(Data->DataBlockSize));
mbed_official 573:ad23fe03a082 429 assert_param(IS_SDMMC_TRANSFER_DIR(Data->TransferDir));
mbed_official 573:ad23fe03a082 430 assert_param(IS_SDMMC_TRANSFER_MODE(Data->TransferMode));
mbed_official 573:ad23fe03a082 431 assert_param(IS_SDMMC_DPSM(Data->DPSM));
mbed_official 573:ad23fe03a082 432
mbed_official 573:ad23fe03a082 433 /* Set the SDMMC Data TimeOut value */
mbed_official 573:ad23fe03a082 434 SDMMCx->DTIMER = Data->DataTimeOut;
mbed_official 573:ad23fe03a082 435
mbed_official 573:ad23fe03a082 436 /* Set the SDMMC DataLength value */
mbed_official 573:ad23fe03a082 437 SDMMCx->DLEN = Data->DataLength;
mbed_official 573:ad23fe03a082 438
mbed_official 573:ad23fe03a082 439 /* Set the SDMMC data configuration parameters */
mbed_official 573:ad23fe03a082 440 tmpreg |= (uint32_t)(Data->DataBlockSize |\
mbed_official 573:ad23fe03a082 441 Data->TransferDir |\
mbed_official 573:ad23fe03a082 442 Data->TransferMode |\
mbed_official 573:ad23fe03a082 443 Data->DPSM);
mbed_official 573:ad23fe03a082 444
mbed_official 573:ad23fe03a082 445 /* Write to SDMMC DCTRL */
mbed_official 573:ad23fe03a082 446 MODIFY_REG(SDMMCx->DCTRL, DCTRL_CLEAR_MASK, tmpreg);
mbed_official 573:ad23fe03a082 447
mbed_official 573:ad23fe03a082 448 return HAL_OK;
mbed_official 573:ad23fe03a082 449
mbed_official 573:ad23fe03a082 450 }
mbed_official 573:ad23fe03a082 451
mbed_official 573:ad23fe03a082 452 /**
mbed_official 573:ad23fe03a082 453 * @brief Returns number of remaining data bytes to be transferred.
mbed_official 573:ad23fe03a082 454 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 455 * @retval Number of remaining data bytes to be transferred
mbed_official 573:ad23fe03a082 456 */
mbed_official 573:ad23fe03a082 457 uint32_t SDMMC_GetDataCounter(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 458 {
mbed_official 573:ad23fe03a082 459 return (SDMMCx->DCOUNT);
mbed_official 573:ad23fe03a082 460 }
mbed_official 573:ad23fe03a082 461
mbed_official 573:ad23fe03a082 462 /**
mbed_official 573:ad23fe03a082 463 * @brief Get the FIFO data
mbed_official 573:ad23fe03a082 464 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 465 * @retval Data received
mbed_official 573:ad23fe03a082 466 */
mbed_official 573:ad23fe03a082 467 uint32_t SDMMC_GetFIFOCount(SDMMC_TypeDef *SDMMCx)
mbed_official 573:ad23fe03a082 468 {
mbed_official 573:ad23fe03a082 469 return (SDMMCx->FIFO);
mbed_official 573:ad23fe03a082 470 }
mbed_official 573:ad23fe03a082 471
mbed_official 573:ad23fe03a082 472
mbed_official 573:ad23fe03a082 473 /**
mbed_official 573:ad23fe03a082 474 * @brief Sets one of the two options of inserting read wait interval.
mbed_official 573:ad23fe03a082 475 * @param SDMMCx: Pointer to SDMMC register base
mbed_official 573:ad23fe03a082 476 * @param SDMMC_ReadWaitMode: SDMMC Read Wait operation mode.
mbed_official 573:ad23fe03a082 477 * This parameter can be:
mbed_official 573:ad23fe03a082 478 * @arg SDMMC_READ_WAIT_MODE_CLK: Read Wait control by stopping SDMMCCLK
mbed_official 573:ad23fe03a082 479 * @arg SDMMC_READ_WAIT_MODE_DATA2: Read Wait control using SDMMC_DATA2
mbed_official 573:ad23fe03a082 480 * @retval None
mbed_official 573:ad23fe03a082 481 */
mbed_official 573:ad23fe03a082 482 HAL_StatusTypeDef SDMMC_SetSDMMCReadWaitMode(SDMMC_TypeDef *SDMMCx, uint32_t SDMMC_ReadWaitMode)
mbed_official 573:ad23fe03a082 483 {
mbed_official 573:ad23fe03a082 484 /* Check the parameters */
mbed_official 573:ad23fe03a082 485 assert_param(IS_SDMMC_READWAIT_MODE(SDMMC_ReadWaitMode));
mbed_official 573:ad23fe03a082 486
mbed_official 573:ad23fe03a082 487 /* Set SDMMC read wait mode */
mbed_official 573:ad23fe03a082 488 SDMMCx->DCTRL |= SDMMC_ReadWaitMode;
mbed_official 573:ad23fe03a082 489
mbed_official 573:ad23fe03a082 490 return HAL_OK;
mbed_official 573:ad23fe03a082 491 }
mbed_official 573:ad23fe03a082 492
mbed_official 573:ad23fe03a082 493 /**
mbed_official 573:ad23fe03a082 494 * @}
mbed_official 573:ad23fe03a082 495 */
mbed_official 573:ad23fe03a082 496
mbed_official 573:ad23fe03a082 497 /**
mbed_official 573:ad23fe03a082 498 * @}
mbed_official 573:ad23fe03a082 499 */
mbed_official 573:ad23fe03a082 500
mbed_official 573:ad23fe03a082 501 #endif /* (HAL_SD_MODULE_ENABLED) || (HAL_MMC_MODULE_ENABLED) */
mbed_official 573:ad23fe03a082 502 /**
mbed_official 573:ad23fe03a082 503 * @}
mbed_official 573:ad23fe03a082 504 */
mbed_official 573:ad23fe03a082 505
mbed_official 573:ad23fe03a082 506 /**
mbed_official 573:ad23fe03a082 507 * @}
mbed_official 573:ad23fe03a082 508 */
mbed_official 573:ad23fe03a082 509
mbed_official 573:ad23fe03a082 510 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/