Hal Drivers for L4
Dependents: BSP OneHopeOnePrayer FINAL_AUDIO_RECORD AudioDemo
Fork of STM32L4xx_HAL_Driver by
stm32l4xx_ll_sdmmc.c File Reference
SDMMC Low Layer HAL module driver. This file provides firmware functions to manage the following functionalities of the SDMMC peripheral: + Initialization/de-initialization functions + I/O operation functions + Peripheral Control functions + Peripheral State functions. More...
Go to the source code of this file.
Functions | |
HAL_StatusTypeDef | SDMMC_Init (SDMMC_TypeDef *SDMMCx, SDMMC_InitTypeDef Init) |
Initializes the SDMMC according to the specified parameters in the SDMMC_InitTypeDef and initialize the associated handle. | |
uint32_t | SDMMC_ReadFIFO (SDMMC_TypeDef *SDMMCx) |
Read data (word) from Rx FIFO in blocking mode (polling) | |
HAL_StatusTypeDef | SDMMC_WriteFIFO (SDMMC_TypeDef *SDMMCx, uint32_t *pWriteData) |
Write data (word) to Tx FIFO in blocking mode (polling) | |
HAL_StatusTypeDef | SDMMC_PowerState_ON (SDMMC_TypeDef *SDMMCx) |
Set SDMMC Power state to ON. | |
HAL_StatusTypeDef | SDMMC_PowerState_OFF (SDMMC_TypeDef *SDMMCx) |
Set SDMMC Power state to OFF. | |
uint32_t | SDMMC_GetPowerState (SDMMC_TypeDef *SDMMCx) |
Get SDMMC Power state. | |
HAL_StatusTypeDef | SDMMC_SendCommand (SDMMC_TypeDef *SDMMCx, SDMMC_CmdInitTypeDef *Command) |
Configure the SDMMC command path according to the specified parameters in SDMMC_CmdInitTypeDef structure and send the command. | |
uint8_t | SDMMC_GetCommandResponse (SDMMC_TypeDef *SDMMCx) |
Return the command index of last command for which response received. | |
uint32_t | SDMMC_GetResponse (SDMMC_TypeDef *SDMMCx, uint32_t Response) |
Return the response received from the card for the last command. | |
HAL_StatusTypeDef | SDMMC_DataConfig (SDMMC_TypeDef *SDMMCx, SDMMC_DataInitTypeDef *Data) |
Configure the SDMMC data path according to the specified parameters in the SDMMC_DataInitTypeDef. | |
uint32_t | SDMMC_GetDataCounter (SDMMC_TypeDef *SDMMCx) |
Returns number of remaining data bytes to be transferred. | |
uint32_t | SDMMC_GetFIFOCount (SDMMC_TypeDef *SDMMCx) |
Get the FIFO data. | |
HAL_StatusTypeDef | SDMMC_SetSDMMCReadWaitMode (SDMMC_TypeDef *SDMMCx, uint32_t SDMMC_ReadWaitMode) |
Sets one of the two options of inserting read wait interval. |
Detailed Description
SDMMC Low Layer HAL module driver. This file provides firmware functions to manage the following functionalities of the SDMMC peripheral: + Initialization/de-initialization functions + I/O operation functions + Peripheral Control functions + Peripheral State functions.
- Version:
- V1.1.0
- Date:
- 16-September-2015
============================================================================== ##### SDMMC peripheral features ##### ============================================================================== [..] The SD/SDMMC MMC card host interface (SDMMC) provides an interface between the APB2 peripheral bus and MultiMedia cards (MMCs), SD memory cards, SDMMC cards and CE-ATA devices. [..] The SDMMC features include the following: (+) Full compliance with MultiMedia Card System Specification Version 4.2. Card support for three different data bus modes: 1-bit (default), 4-bit and 8-bit (+) Full compatibility with previous versions of MultiMedia Cards (forward compatibility) (+) Full compliance with SD Memory Card Specifications Version 2.0 (+) Full compliance with SD I/O Card Specification Version 2.0: card support for two different data bus modes: 1-bit (default) and 4-bit (+) Full support of the CE-ATA features (full compliance with CE-ATA digital protocol Rev1.1) (+) Data transfer up to 48 MHz for the 8 bit mode (+) Data and command output enable signals to control external bidirectional drivers. ##### How to use this driver ##### ============================================================================== [..] This driver is a considered as a driver of service for external devices drivers that interfaces with the SDMMC peripheral. According to the device used (SD card/ MMC card / SDMMC card ...), a set of APIs is used in the device's driver to perform SDMMC operations and functionalities. This driver is almost transparent for the final user, it is only used to implement other functionalities of the external device. [..] (+) The SDMMC clock (SDMMCCLK = 48 MHz) is coming from a specific output (MSI, PLLUSB1CLK, PLLUSB2CLK). Before start working with SDMMC peripheral make sure that the PLL is well configured. The SDMMC peripheral uses two clock signals: (++) SDMMC adapter clock (SDMMCCLK = 48 MHz) (++) APB2 bus clock (PCLK2) -@@- PCLK2 and SDMMC_CK clock frequencies must respect the following condition: Frequency(PCLK2) >= (3 / 8 x Frequency(SDMMC_CK)) (+) Enable/Disable peripheral clock using RCC peripheral macros related to SDMMC peripheral. (+) Enable the Power ON State using the SDMMC_PowerState_ON(SDMMCx) function and disable it using the function SDMMC_PowerState_OFF(SDMMCx). (+) Enable/Disable the clock using the __SDMMC_ENABLE()/__SDMMC_DISABLE() macros. (+) Enable/Disable the peripheral interrupts using the macros __SDMMC_ENABLE_IT(hSDMMC, IT) and __SDMMC_DISABLE_IT(hSDMMC, IT) if you need to use interrupt mode. (+) When using the DMA mode (++) Configure the DMA in the MSP layer of the external device (++) Active the needed channel Request (++) Enable the DMA using __SDMMC_DMA_ENABLE() macro or Disable it using the macro __SDMMC_DMA_DISABLE(). (+) To control the CPSM (Command Path State Machine) and send commands to the card use the SDMMC_SendCommand(SDMMCx), SDMMC_GetCommandResponse() and SDMMC_GetResponse() functions. First, user has to fill the command structure (pointer to SDMMC_CmdInitTypeDef) according to the selected command to be sent. The parameters that should be filled are: (++) Command Argument (++) Command Index (++) Command Response type (++) Command Wait (++) CPSM Status (Enable or Disable). -@@- To check if the command is well received, read the SDMMC_CMDRESP register using the SDMMC_GetCommandResponse(). The SDMMC responses registers (SDMMC_RESP1 to SDMMC_RESP2), use the SDMMC_GetResponse() function. (+) To control the DPSM (Data Path State Machine) and send/receive data to/from the card use the SDMMC_DataConfig(), SDMMC_GetDataCounter(), SDMMC_ReadFIFO(), SDMMC_WriteFIFO() and SDMMC_GetFIFOCount() functions. *** Read Operations *** ======================= [..] (#) First, user has to fill the data structure (pointer to SDMMC_DataInitTypeDef) according to the selected data type to be received. The parameters that should be filled are: (++) Data TimeOut (++) Data Length (++) Data Block size (++) Data Transfer direction: should be from card (To SDMMC) (++) Data Transfer mode (++) DPSM Status (Enable or Disable) (#) Configure the SDMMC resources to receive the data from the card according to selected transfer mode (Refer to Step 8, 9 and 10). (#) Send the selected Read command (refer to step 11). (#) Use the SDMMC flags/interrupts to check the transfer status. *** Write Operations *** ======================== [..] (#) First, user has to fill the data structure (pointer to SDMMC_DataInitTypeDef) according to the selected data type to be received. The parameters that should be filled are: (++) Data TimeOut (++) Data Length (++) Data Block size (++) Data Transfer direction: should be to card (To CARD) (++) Data Transfer mode (++) DPSM Status (Enable or Disable) (#) Configure the SDMMC resources to send the data to the card according to selected transfer mode. (#) Send the selected Write command. (#) Use the SDMMC flags/interrupts to check the transfer status.
- Attention:
© COPYRIGHT(c) 2015 STMicroelectronics
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Definition in file stm32l4xx_ll_sdmmc.c.
Generated on Tue Jul 12 2022 11:35:20 by 1.7.2