/**

******************************************************************************

* @file stm32f4xx_hal_sd.c

* @author MCD Application Team

* @version V1.1.0

* @date 19-June-2014

* @brief SD card HAL module driver.

* This file provides firmware functions to manage the following

* functionalities of the Secure Digital (SD) peripheral:

* + Initialization and de-initialization functions

* + IO operation functions

* + Peripheral Control functions

* + Peripheral State functions

*

@verbatim

==============================================================================

##### How to use this driver #####

==============================================================================

[..]

This driver implements a high level communication layer for read and write from/to

this memory. The needed STM32 hardware resources (SDIO and GPIO) are performed by

the user in HAL_SD_MspInit() function (MSP layer).

Basically, the MSP layer configuration should be the same as we provide in the

examples.

You can easily tailor this configuration according to hardware resources.

[..]

This driver is a generic layered driver for SDIO memories which uses the HAL

SDIO driver functions to interface with SD and uSD cards devices.

It is used as follows:

(#)Initialize the SDIO low level resources by implement the HAL_SD_MspInit() API:

(##) Enable the SDIO interface clock using __SDIO_CLK_ENABLE();

(##) SDIO pins configuration for SD card

(+++) Enable the clock for the SDIO GPIOs using the functions __GPIOx_CLK_ENABLE();

(+++) Configure these SDIO pins as alternate function pull-up using HAL_GPIO_Init()

and according to your pin assignment;

(##) DMA Configuration if you need to use DMA process (HAL_SD_ReadBlocks_DMA()

and HAL_SD_WriteBlocks_DMA() APIs).

(+++) Enable the DMAx interface clock using __DMAx_CLK_ENABLE();

(+++) Configure the DMA using the function HAL_DMA_Init() with predeclared and filled.

(##) NVIC configuration if you need to use interrupt process when using DMA transfer.

(+++) Configure the SDIO and DMA interrupt priorities using functions

HAL_NVIC_SetPriority(); DMA priority is superior to SDIO's priority

(+++) Enable the NVIC DMA and SDIO IRQs using function HAL_NVIC_EnableIRQ()

(+++) SDIO interrupts are managed using the macros __HAL_SD_SDIO_ENABLE_IT()

and __HAL_SD_SDIO_DISABLE_IT() inside the communication process.

(+++) SDIO interrupts pending bits are managed using the macros __HAL_SD_SDIO_GET_IT()

and __HAL_SD_SDIO_CLEAR_IT()

(#) At this stage, you can perform SD read/write/erase operations after SD card initialization

*** SD Card Initialization and configuration ***

================================================

[..]

To initialize the SD Card, use the HAL_SD_Init() function. It Initializes

the SD Card and put it into StandBy State (Ready for data transfer).

This function provide the following operations:

(#) Apply the SD Card initialization process at 400KHz and check the SD Card

type (Standard Capacity or High Capacity). You can change or adapt this

frequency by adjusting the "ClockDiv" field.

The SD Card frequency (SDIO_CK) is computed as follows:

SDIO_CK = SDIOCLK / (ClockDiv + 2)

In initialization mode and according to the SD Card standard,

make sure that the SDIO_CK frequency doesn't exceed 400KHz.

(#) Get the SD CID and CSD data. All these information are managed by the SDCardInfo

structure. This structure provide also ready computed SD Card capacity

and Block size.

-@- These information are stored in SD handle structure in case of future use.

(#) Configure the SD Card Data transfer frequency. By Default, the card transfer

frequency is set to 24MHz. You can change or adapt this frequency by adjusting

the "ClockDiv" field.

In transfer mode and according to the SD Card standard, make sure that the

SDIO_CK frequency doesn't exceed 25MHz and 50MHz in High-speed mode switch.

To be able to use a frequency higher than 24MHz, you should use the SDIO

peripheral in bypass mode. Refer to the corresponding reference manual

for more details.

(#) Select the corresponding SD Card according to the address read with the step 2.

(#) Configure the SD Card in wide bus mode: 4-bits data.

*** SD Card Read operation ***

==============================

[..]

(+) You can read from SD card in polling mode by using function HAL_SD_ReadBlocks().

This function support only 512-byte block length (the block size should be

chosen as 512 byte).

You can choose either one block read operation or multiple block read operation

by adjusting the "NumberOfBlocks" parameter.

(+) You can read from SD card in DMA mode by using function HAL_SD_ReadBlocks_DMA().

This function support only 512-byte block length (the block size should be

chosen as 512 byte).

You can choose either one block read operation or multiple block read operation

by adjusting the "NumberOfBlocks" parameter.

After this, you have to call the function HAL_SD_CheckReadOperation(), to insure

that the read transfer is done correctly in both DMA and SD sides.

*** SD Card Write operation ***

===============================

[..]

(+) You can write to SD card in polling mode by using function HAL_SD_WriteBlocks().

This function support only 512-byte block length (the block size should be

chosen as 512 byte).

You can choose either one block read operation or multiple block read operation

by adjusting the "NumberOfBlocks" parameter.

(+) You can write to SD card in DMA mode by using function HAL_SD_WriteBlocks_DMA().

This function support only 512-byte block length (the block size should be

chosen as 512 byte).

You can choose either one block read operation or multiple block read operation

by adjusting the "NumberOfBlocks" parameter.

After this, you have to call the function HAL_SD_CheckWriteOperation(), to insure

that the write transfer is done correctly in both DMA and SD sides.

*** SD card status ***

======================

[..]

(+) At any time, you can check the SD Card status and get the SD card state

by using the HAL_SD_GetStatus() function. This function checks first if the

SD card is still connected and then get the internal SD Card transfer state.

(+) You can also get the SD card SD Status register by using the HAL_SD_SendSDStatus()

function.

*** SD HAL driver macros list ***

==================================

[..]

Below the list of most used macros in SD HAL driver.

(+) __HAL_SD_SDIO_ENABLE : Enable the SD device

(+) __HAL_SD_SDIO_DISABLE : Disable the SD device

(+) __HAL_SD_SDIO_DMA_ENABLE: Enable the SDIO DMA transfer

(+) __HAL_SD_SDIO_DMA_DISABLE: Disable the SDIO DMA transfer

(+) __HAL_SD_SDIO_ENABLE_IT: Enable the SD device interrupt

(+) __HAL_SD_SDIO_DISABLE_IT: Disable the SD device interrupt

(+) __HAL_SD_SDIO_GET_FLAG:Check whether the specified SD flag is set or not

(+) __HAL_SD_SDIO_CLEAR_FLAG: Clear the SD's pending flags

(@) You can refer to the SD HAL driver header file for more useful macros

@endverbatim

******************************************************************************

* @attention

*

* <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>

*

* 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.

*

******************************************************************************

*/

/* Includes ------------------------------------------------------------------*/

#include "stm32f4xx_hal.h"

/** @addtogroup STM32F4xx_HAL_Driver

* @{

*/

/** @defgroup SD

* @brief SD HAL module driver

* @{

*/

#ifdef HAL_SD_MODULE_ENABLED

/* Private typedef -----------------------------------------------------------*/

/* Private define ------------------------------------------------------------*/

/** @defgroup SD_Private_Define

* @{

*/

/**

* @brief SDIO Static flags, TimeOut, FIFO Address

*/

#define SDIO_STATIC_FLAGS ((uint32_t)(SDIO_FLAG_CCRCFAIL | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_CTIMEOUT |\

SDIO_FLAG_DTIMEOUT | SDIO_FLAG_TXUNDERR | SDIO_FLAG_RXOVERR |\

SDIO_FLAG_CMDREND | SDIO_FLAG_CMDSENT | SDIO_FLAG_DATAEND |\

SDIO_FLAG_DBCKEND))

#define SDIO_CMD0TIMEOUT ((uint32_t)0x00010000)

/**

* @brief Mask for errors Card Status R1 (OCR Register)

*/

#define SD_OCR_ADDR_OUT_OF_RANGE ((uint32_t)0x80000000)

#define SD_OCR_ADDR_MISALIGNED ((uint32_t)0x40000000)

#define SD_OCR_BLOCK_LEN_ERR ((uint32_t)0x20000000)

#define SD_OCR_ERASE_SEQ_ERR ((uint32_t)0x10000000)

#define SD_OCR_BAD_ERASE_PARAM ((uint32_t)0x08000000)

#define SD_OCR_WRITE_PROT_VIOLATION ((uint32_t)0x04000000)

#define SD_OCR_LOCK_UNLOCK_FAILED ((uint32_t)0x01000000)

#define SD_OCR_COM_CRC_FAILED ((uint32_t)0x00800000)

#define SD_OCR_ILLEGAL_CMD ((uint32_t)0x00400000)

#define SD_OCR_CARD_ECC_FAILED ((uint32_t)0x00200000)

#define SD_OCR_CC_ERROR ((uint32_t)0x00100000)

#define SD_OCR_GENERAL_UNKNOWN_ERROR ((uint32_t)0x00080000)

#define SD_OCR_STREAM_READ_UNDERRUN ((uint32_t)0x00040000)

#define SD_OCR_STREAM_WRITE_OVERRUN ((uint32_t)0x00020000)

#define SD_OCR_CID_CSD_OVERWRIETE ((uint32_t)0x00010000)

#define SD_OCR_WP_ERASE_SKIP ((uint32_t)0x00008000)

#define SD_OCR_CARD_ECC_DISABLED ((uint32_t)0x00004000)

#define SD_OCR_ERASE_RESET ((uint32_t)0x00002000)

#define SD_OCR_AKE_SEQ_ERROR ((uint32_t)0x00000008)

#define SD_OCR_ERRORBITS ((uint32_t)0xFDFFE008)

/**

* @brief Masks for R6 Response

*/

#define SD_R6_GENERAL_UNKNOWN_ERROR ((uint32_t)0x00002000)

#define SD_R6_ILLEGAL_CMD ((uint32_t)0x00004000)

#define SD_R6_COM_CRC_FAILED ((uint32_t)0x00008000)

#define SD_VOLTAGE_WINDOW_SD ((uint32_t)0x80100000)

#define SD_HIGH_CAPACITY ((uint32_t)0x40000000)

#define SD_STD_CAPACITY ((uint32_t)0x00000000)

#define SD_CHECK_PATTERN ((uint32_t)0x000001AA)

#define SD_MAX_VOLT_TRIAL ((uint32_t)0x0000FFFF)

#define SD_ALLZERO ((uint32_t)0x00000000)

#define SD_WIDE_BUS_SUPPORT ((uint32_t)0x00040000)

#define SD_SINGLE_BUS_SUPPORT ((uint32_t)0x00010000)

#define SD_CARD_LOCKED ((uint32_t)0x02000000)

#define SD_DATATIMEOUT ((uint32_t)0xFFFFFFFF)

#define SD_0TO7BITS ((uint32_t)0x000000FF)

#define SD_8TO15BITS ((uint32_t)0x0000FF00)

#define SD_16TO23BITS ((uint32_t)0x00FF0000)

#define SD_24TO31BITS ((uint32_t)0xFF000000)

#define SD_MAX_DATA_LENGTH ((uint32_t)0x01FFFFFF)

#define SD_HALFFIFO ((uint32_t)0x00000008)

#define SD_HALFFIFOBYTES ((uint32_t)0x00000020)

/**

* @brief Command Class Supported

*/

#define SD_CCCC_LOCK_UNLOCK ((uint32_t)0x00000080)

#define SD_CCCC_WRITE_PROT ((uint32_t)0x00000040)

#define SD_CCCC_ERASE ((uint32_t)0x00000020)

/**

* @brief Following commands are SD Card Specific commands.

* SDIO_APP_CMD should be sent before sending these commands.

*/

#define SD_SDIO_SEND_IF_COND ((uint32_t)SD_CMD_HS_SEND_EXT_CSD)

/**

* @}

*/

/* Private macro -------------------------------------------------------------*/

/* Private variables ---------------------------------------------------------*/

/* Private function prototypes -----------------------------------------------*/

/* Private functions ---------------------------------------------------------*/

/** @defgroup SD_Private_Functions SD Private Functions

* @{

*/

static HAL_SD_ErrorTypedef SD_Initialize_Cards(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_Select_Deselect(SD_HandleTypeDef *hsd, uint64_t addr);

static HAL_SD_ErrorTypedef SD_PowerON(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_PowerOFF(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_SendStatus(SD_HandleTypeDef *hsd, uint32_t *pCardStatus);

static HAL_SD_CardStateTypedef SD_GetState(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_IsCardProgramming(SD_HandleTypeDef *hsd, uint8_t *pStatus);

static HAL_SD_ErrorTypedef SD_CmdError(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_CmdResp1Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD);

static HAL_SD_ErrorTypedef SD_CmdResp7Error(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_CmdResp3Error(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_CmdResp2Error(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_CmdResp6Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD, uint16_t *pRCA);

static HAL_SD_ErrorTypedef SD_WideBus_Enable(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_WideBus_Disable(SD_HandleTypeDef *hsd);

static HAL_SD_ErrorTypedef SD_FindSCR(SD_HandleTypeDef *hsd, uint32_t *pSCR);

static void SD_DMA_RxCplt(DMA_HandleTypeDef *hdma);

static void SD_DMA_RxError(DMA_HandleTypeDef *hdma);

static void SD_DMA_TxCplt(DMA_HandleTypeDef *hdma);

static void SD_DMA_TxError(DMA_HandleTypeDef *hdma);

/**

* @}

*/

/** @defgroup SD_Private_Functions

* @{

*/

/** @defgroup SD_Group1 Initialization and de-initialization functions

* @brief Initialization and Configuration functions

*

@verbatim

==============================================================================

##### Initialization and de-initialization functions #####

==============================================================================

[..]

This section provides functions allowing to initialize/de-initialize the SD

card device to be ready for use.

@endverbatim

* @{

*/

/**

* @brief Initializes the SD card according to the specified parameters in the

SD_HandleTypeDef and create the associated handle.

* @param hsd: SD handle

* @param SDCardInfo: HAL_SD_CardInfoTypedef structure for SD card information

* @retval HAL SD error state

*/

HAL_SD_ErrorTypedef HAL_SD_Init(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypedef *SDCardInfo)

{

__IO HAL_SD_ErrorTypedef errorstate = SD_OK;

SD_InitTypeDef tmpinit;

/* Initialize the low level hardware (MSP) */

HAL_SD_MspInit(hsd);

/* Default SDIO peripheral configuration for SD card initialization */

tmpinit.ClockEdge = SDIO_CLOCK_EDGE_RISING;

tmpinit.ClockBypass = SDIO_CLOCK_BYPASS_DISABLE;

tmpinit.ClockPowerSave = SDIO_CLOCK_POWER_SAVE_DISABLE;

tmpinit.BusWide = SDIO_BUS_WIDE_1B;

tmpinit.HardwareFlowControl = SDIO_HARDWARE_FLOW_CONTROL_DISABLE;

tmpinit.ClockDiv = SDIO_INIT_CLK_DIV;

/* Initialize SDIO peripheral interface with default configuration */

SDIO_Init(hsd->Instance, tmpinit);

/* Identify card operating voltage */

errorstate = SD_PowerON(hsd);

if(errorstate != SD_OK)

{

return errorstate;

}

/* Initialize the present SDIO card(s) and put them in idle state */

errorstate = SD_Initialize_Cards(hsd);

if (errorstate != SD_OK)

{

return errorstate;

}

/* Read CSD/CID MSD registers */

errorstate = HAL_SD_Get_CardInfo(hsd, SDCardInfo);

if (errorstate == SD_OK)

{

/* Select the Card */

errorstate = SD_Select_Deselect(hsd, (uint32_t)(((uint32_t)SDCardInfo->RCA) << 16));

}

/* Configure SDIO peripheral interface */

SDIO_Init(hsd->Instance, hsd->Init);

return errorstate;

}

/**

* @brief De-Initializes the SD card.

* @param hsd: SD handle

* @retval HAL status

*/

HAL_StatusTypeDef HAL_SD_DeInit(SD_HandleTypeDef *hsd)

{

/* Set SD power state to off */

SD_PowerOFF(hsd);

/* De-Initialize the MSP layer */

HAL_SD_MspDeInit(hsd);

return HAL_OK;

}

/**

* @brief Initializes the SD MSP.

* @param hsd: SD handle

* @retval None

*/

__weak void HAL_SD_MspInit(SD_HandleTypeDef *hsd)

{

/* NOTE : This function Should not be modified, when the callback is needed,

the HAL_SD_MspInit could be implemented in the user file

*/

}

/**

* @brief De-Initialize SD MSP.

* @param hsd: SD handle

* @retval None

*/

__weak void HAL_SD_MspDeInit(SD_HandleTypeDef *hsd)

{

/* NOTE : This function Should not be modified, when the callback is needed,

the HAL_SD_MspDeInit could be implemented in the user file

*/

}

/**

* @}

*/

/** @defgroup SD_Group2 IO operation functions

* @brief Data transfer functions

*

@verbatim

==============================================================================

##### IO operation functions #####

==============================================================================

[..]

This subsection provides a set of functions allowing to manage the data

transfer from/to SD card.

@endverbatim

* @{

*/

/**

* @brief Reads block(s) from a specified address in a card. The Data transfer

* is managed by polling mode.

* @param hsd: SD handle

* @param pReadBuffer: pointer to the buffer that will contain the received data

* @param BlockNumber: Block number from where data is to be read (byte address = BlockNumber * BlockSize)

* @param BlockSize: SD card Data block size

* This parameter should be 512

* @param NumberOfBlocks: Number of SD blocks to read

* @retval SD Card error state

*/

HAL_SD_ErrorTypedef HAL_SD_ReadBlocks_BlockNumber(SD_HandleTypeDef *hsd, uint32_t *pReadBuffer, uint32_t BlockNumber, uint32_t BlockSize, uint32_t NumberOfBlocks)

{

SDIO_CmdInitTypeDef sdio_cmdinitstructure;

SDIO_DataInitTypeDef sdio_datainitstructure;

HAL_SD_ErrorTypedef errorstate = SD_OK;

uint32_t count = 0, *tempbuff = (uint32_t *)pReadBuffer;

/* Initialize data control register */

hsd->Instance->DCTRL = 0;

uint32_t ReadAddr;

if (hsd->CardType == HIGH_CAPACITY_SD_CARD)

{

BlockSize = 512;

ReadAddr = BlockNumber;

}

else

{

// should not overflow for standard-capacity cards

ReadAddr = BlockNumber * BlockSize;

}

/* Set Block Size for Card */

sdio_cmdinitstructure.Argument = (uint32_t) BlockSize;

sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;

sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;

sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;

sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Check for error conditions */

errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);

if (errorstate != SD_OK)

{

return errorstate;

}

/* Configure the SD DPSM (Data Path State Machine) */

sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;

sdio_datainitstructure.DataLength = NumberOfBlocks * BlockSize;

sdio_datainitstructure.DataBlockSize = (uint32_t)(9 << 4);

sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;

sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;

sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;

SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);

if(NumberOfBlocks > 1)

{

/* Send CMD18 READ_MULT_BLOCK with argument data address */

sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_MULT_BLOCK;

}

else

{

/* Send CMD17 READ_SINGLE_BLOCK */

sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_SINGLE_BLOCK;

}

sdio_cmdinitstructure.Argument = ReadAddr;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Read block(s) in polling mode */

if(NumberOfBlocks > 1)

{

/* Check for error conditions */

errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_MULT_BLOCK);

if (errorstate != SD_OK)

{

return errorstate;

}

/* Poll on SDIO flags */

while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DATAEND | SDIO_FLAG_STBITERR))

{

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))

{

/* Read data from SDIO Rx FIFO */

for (count = 0; count < 8; count++)

{

*(tempbuff + count) = SDIO_ReadFIFO(hsd->Instance);

}

tempbuff += 8;

}

}

}

else

{

/* Check for error conditions */

errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_SINGLE_BLOCK);

if (errorstate != SD_OK)

{

return errorstate;

}

/* In case of single block transfer, no need of stop transfer at all */

while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))

{

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))

{

/* Read data from SDIO Rx FIFO */

for (count = 0; count < 8; count++)

{

*(tempbuff + count) = SDIO_ReadFIFO(hsd->Instance);

}

tempbuff += 8;

}

}

}

/* Send stop transmission command in case of multiblock read */

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1))

{

if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) ||\

(hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\

(hsd->CardType == HIGH_CAPACITY_SD_CARD))

{

/* Send stop transmission command */

errorstate = HAL_SD_StopTransfer(hsd);

}

}

/* Get error state */

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);

errorstate = SD_DATA_TIMEOUT;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);

errorstate = SD_DATA_CRC_FAIL;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);

errorstate = SD_RX_OVERRUN;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);

errorstate = SD_START_BIT_ERR;

return errorstate;

}

else

{

/* No error flag set */

}

count = SD_DATATIMEOUT;

/* Empty FIFO if there is still any data */

while ((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXDAVL)) && (count > 0))

{

*tempbuff = SDIO_ReadFIFO(hsd->Instance);

tempbuff++;

count--;

}

/* Clear all the static flags */

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);

return errorstate;

}

/**

* @brief Allows to write block(s) to a specified address in a card. The Data

* transfer is managed by polling mode.

* @param hsd: SD handle

* @param pWriteBuffer: pointer to the buffer that will contain the data to transmit

* @param BlockNumber: Block number to where data is to be written (byte address = BlockNumber * BlockSize)

* @param BlockSize: SD card Data block size

* This parameter should be 512.

* @param NumberOfBlocks: Number of SD blocks to write

* @retval SD Card error state

*/

HAL_SD_ErrorTypedef HAL_SD_WriteBlocks_BlockNumber(SD_HandleTypeDef *hsd, uint32_t *pWriteBuffer, uint32_t BlockNumber, uint32_t BlockSize, uint32_t NumberOfBlocks)

{

SDIO_CmdInitTypeDef sdio_cmdinitstructure;

SDIO_DataInitTypeDef sdio_datainitstructure;

HAL_SD_ErrorTypedef errorstate = SD_OK;

uint32_t totalnumberofbytes = 0, bytestransferred = 0, count = 0, restwords = 0;

uint32_t *tempbuff = (uint32_t *)pWriteBuffer;

uint8_t cardstate = 0;

/* Initialize data control register */

hsd->Instance->DCTRL = 0;

uint32_t WriteAddr;

if (hsd->CardType == HIGH_CAPACITY_SD_CARD)

{

BlockSize = 512;

WriteAddr = BlockNumber;

}

else

{

// should not overflow for standard-capacity cards

WriteAddr = BlockNumber * BlockSize;

}

/* Set Block Size for Card */

sdio_cmdinitstructure.Argument = (uint32_t)BlockSize;

sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;

sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;

sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;

sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Check for error conditions */

errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);

if (errorstate != SD_OK)

{

return errorstate;

}

if(NumberOfBlocks > 1)

{

/* Send CMD25 WRITE_MULT_BLOCK with argument data address */

sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_MULT_BLOCK;

}

else

{

/* Send CMD24 WRITE_SINGLE_BLOCK */

sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_SINGLE_BLOCK;

}

sdio_cmdinitstructure.Argument = WriteAddr;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Check for error conditions */

if(NumberOfBlocks > 1)

{

errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_MULT_BLOCK);

}

else

{

errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_SINGLE_BLOCK);

}

if (errorstate != SD_OK)

{

return errorstate;

}

/* Set total number of bytes to write */

totalnumberofbytes = NumberOfBlocks * BlockSize;

/* Configure the SD DPSM (Data Path State Machine) */

sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;

sdio_datainitstructure.DataLength = NumberOfBlocks * BlockSize;

sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;

sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;

sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;

sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;

SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);

/* Write block(s) in polling mode */

if(NumberOfBlocks > 1)

{

while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DATAEND | SDIO_FLAG_STBITERR))

{

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXFIFOHE))

{

if ((totalnumberofbytes - bytestransferred) < 32)

{

restwords = ((totalnumberofbytes - bytestransferred) % 4 == 0) ? ((totalnumberofbytes - bytestransferred) / 4) : (( totalnumberofbytes - bytestransferred) / 4 + 1);

/* Write data to SDIO Tx FIFO */

for (count = 0; count < restwords; count++)

{

SDIO_WriteFIFO(hsd->Instance, tempbuff);

tempbuff++;

bytestransferred += 4;

}

}

else

{

/* Write data to SDIO Tx FIFO */

for (count = 0; count < 8; count++)

{

SDIO_WriteFIFO(hsd->Instance, (tempbuff + count));

}

tempbuff += 8;

bytestransferred += 32;

}

}

}

}

else

{

/* In case of single data block transfer no need of stop command at all */

while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))

{

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXFIFOHE))

{

if ((totalnumberofbytes - bytestransferred) < 32)

{

restwords = ((totalnumberofbytes - bytestransferred) % 4 == 0) ? ((totalnumberofbytes - bytestransferred) / 4) : (( totalnumberofbytes - bytestransferred) / 4 + 1);

/* Write data to SDIO Tx FIFO */

for (count = 0; count < restwords; count++)

{

SDIO_WriteFIFO(hsd->Instance, tempbuff);

tempbuff++;

bytestransferred += 4;

}

}

else

{

/* Write data to SDIO Tx FIFO */

for (count = 0; count < 8; count++)

{

SDIO_WriteFIFO(hsd->Instance, (tempbuff + count));

}

tempbuff += 8;

bytestransferred += 32;

}

}

}

}

/* Send stop transmission command in case of multiblock write */

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1))

{

if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\

(hsd->CardType == HIGH_CAPACITY_SD_CARD))

{

/* Send stop transmission command */

errorstate = HAL_SD_StopTransfer(hsd);

}

}

/* Get error state */

if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);

errorstate = SD_DATA_TIMEOUT;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);

errorstate = SD_DATA_CRC_FAIL;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_TXUNDERR);

errorstate = SD_TX_UNDERRUN;

return errorstate;

}

else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))

{

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);

errorstate = SD_START_BIT_ERR;

return errorstate;

}

else

{

/* No error flag set */

}

/* Clear all the static flags */

__HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);

/* Wait till the card is in programming state */

errorstate = SD_IsCardProgramming(hsd, &cardstate);

while ((errorstate == SD_OK) && ((cardstate == SD_CARD_PROGRAMMING) || (cardstate == SD_CARD_RECEIVING)))

{

errorstate = SD_IsCardProgramming(hsd, &cardstate);

}

return errorstate;

}

/**

* @brief Reads block(s) from a specified address in a card. The Data transfer

* is managed by DMA mode.

* @note This API should be followed by the function HAL_SD_CheckReadOperation()

* to check the completion of the read process

* @param hsd: SD handle

* @param pReadBuffer: Pointer to the buffer that will contain the received data

* @param BlockNumber: Block number from where data is to be read (byte address = BlockNumber * BlockSize)

* @param BlockSize: SD card Data block size

* This paramater should be 512.

* @param NumberOfBlocks: Number of blocks to read.

* @retval SD Card error state

*/

HAL_SD_ErrorTypedef HAL_SD_ReadBlocks_BlockNumber_DMA(SD_HandleTypeDef *hsd, uint32_t *pReadBuffer, uint32_t BlockNumber, uint32_t BlockSize, uint32_t NumberOfBlocks)

{

SDIO_CmdInitTypeDef sdio_cmdinitstructure;

SDIO_DataInitTypeDef sdio_datainitstructure;

HAL_SD_ErrorTypedef errorstate = SD_OK;

/* Initialize data control register */

hsd->Instance->DCTRL = 0;

/* Initialize handle flags */

hsd->SdTransferCplt = 0;

hsd->DmaTransferCplt = 0;

hsd->SdTransferErr = SD_OK;

/* Initialize SD Read operation */

if(NumberOfBlocks > 1)

{

hsd->SdOperation = SD_READ_MULTIPLE_BLOCK;

}

else

{

hsd->SdOperation = SD_READ_SINGLE_BLOCK;

}

/* Enable transfer interrupts */

__HAL_SD_SDIO_ENABLE_IT(hsd, (SDIO_IT_DCRCFAIL |\

SDIO_IT_DTIMEOUT |\

SDIO_IT_DATAEND |\

SDIO_IT_RXOVERR |\

SDIO_IT_STBITERR));

/* Enable SDIO DMA transfer */

__HAL_SD_SDIO_DMA_ENABLE();

/* Configure DMA user callbacks */

hsd->hdmarx->XferCpltCallback = SD_DMA_RxCplt;

hsd->hdmarx->XferErrorCallback = SD_DMA_RxError;

/* Enable the DMA Stream */

HAL_DMA_Start_IT(hsd->hdmarx, (uint32_t)&hsd->Instance->FIFO, (uint32_t)pReadBuffer, (uint32_t)(BlockSize * NumberOfBlocks));

uint32_t ReadAddr;

if (hsd->CardType == HIGH_CAPACITY_SD_CARD)

{

BlockSize = 512;

ReadAddr = BlockNumber;

}

else

{

// should not overflow for standard-capacity cards

ReadAddr = BlockNumber * BlockSize;

}

/* Set Block Size for Card */

sdio_cmdinitstructure.Argument = (uint32_t)BlockSize;

sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;

sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;

sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;

sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Check for error conditions */

errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);

if (errorstate != SD_OK)

{

return errorstate;

}

/* Configure the SD DPSM (Data Path State Machine) */

sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;

sdio_datainitstructure.DataLength = BlockSize * NumberOfBlocks;

sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;

sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;

sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;

sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;

SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);

/* Check number of blocks command */

if(NumberOfBlocks > 1)

{

/* Send CMD18 READ_MULT_BLOCK with argument data address */

sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_MULT_BLOCK;

}

else

{

/* Send CMD17 READ_SINGLE_BLOCK */

sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_SINGLE_BLOCK;

}

sdio_cmdinitstructure.Argument = ReadAddr;

SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);

/* Check for error conditions */

if(NumberOfBlocks > 1)

{

errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_MULT_BLOCK);

}

else

{

errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_SINGLE_BLOCK);

}

/* Update the SD transfer error in SD handle */

hsd->SdTransferErr = errorstate;

return errorstate;

}

/**

* @brief Writes block(s) to a specified address in a card. The Data transfer

* is managed by DMA mode.

* @note This API should be followed by the function HAL_SD_CheckWriteOperation()

* to check the completion of the write process (by SD current status polling).

* @param hsd: SD handle

* @param pWriteBuffer: pointer to the buffer that will contain the data to transmit

* @param BlockNumber: Block number to where data is to be written (byte address = BlockNumber * BlockSize)

* @param BlockSize: the SD card Data block size

* This parameter should be 512.

* @param NumberOfBlocks: Number of blocks to write

* @retval SD Card error state

*/

HAL_SD_ErrorTypedef HAL_SD_WriteBlocks_BlockNumber_DMA(SD_HandleTypeDef *hsd, uint32_t *pWriteBuffer, uint32_t BlockNumber, uint32_t BlockSize, uint32_t NumberOfBlocks)

{

SDIO_CmdInitTypeDef sdio_cmdinitstructure;

SDIO_DataInitTypeDef sdio_datainitstructure;

HAL_SD_ErrorTypedef errorstate = SD_OK;