WebSVN – testOled – Blame – /trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_mmc.c

Rev	Author	Line No.	Line
2	mjames	1	/**
		2	******************************************************************************
		3	* @file stm32f1xx_hal_mmc.c
		4	* @author MCD Application Team
		5	* @brief MMC card HAL module driver.
		6	* This file provides firmware functions to manage the following
		7	* functionalities of the Secure Digital (MMC) peripheral:
		8	* + Initialization and de-initialization functions
		9	* + IO operation functions
		10	* + Peripheral Control functions
		11	* + MMC card Control functions
		12	*
		13	@verbatim
		14	==============================================================================
		15	##### How to use this driver #####
		16	==============================================================================
		17	[..]
		18	This driver implements a high level communication layer for read and write from/to
		19	this memory. The needed STM32 hardware resources (SDMMC and GPIO) are performed by
		20	the user in HAL_MMC_MspInit() function (MSP layer).
		21	Basically, the MSP layer configuration should be the same as we provide in the
		22	examples.
		23	You can easily tailor this configuration according to hardware resources.
		24
		25	[..]
		26	This driver is a generic layered driver for SDMMC memories which uses the HAL
		27	SDMMC driver functions to interface with MMC and eMMC cards devices.
		28	It is used as follows:
		29
		30	(#)Initialize the SDMMC low level resources by implement the HAL_MMC_MspInit() API:
		31	(##) Enable the SDMMC interface clock using __HAL_RCC_SDMMC_CLK_ENABLE();
		32	(##) SDMMC pins configuration for MMC card
		33	(+++) Enable the clock for the SDMMC GPIOs using the functions __HAL_RCC_GPIOx_CLK_ENABLE();
		34	(+++) Configure these SDMMC pins as alternate function pull-up using HAL_GPIO_Init()
		35	and according to your pin assignment;
		36	(##) DMA Configuration if you need to use DMA process (HAL_MMC_ReadBlocks_DMA()
		37	and HAL_MMC_WriteBlocks_DMA() APIs).
		38	(+++) Enable the DMAx interface clock using __HAL_RCC_DMAx_CLK_ENABLE();
		39	(+++) Configure the DMA using the function HAL_DMA_Init() with predeclared and filled.
		40	(##) NVIC configuration if you need to use interrupt process when using DMA transfer.
		41	(+++) Configure the SDMMC and DMA interrupt priorities using function HAL_NVIC_SetPriority();
		42	DMA priority is superior to SDMMC's priority
		43	(+++) Enable the NVIC DMA and SDMMC IRQs using function HAL_NVIC_EnableIRQ()
		44	(+++) SDMMC interrupts are managed using the macros __HAL_MMC_ENABLE_IT()
		45	and __HAL_MMC_DISABLE_IT() inside the communication process.
		46	(+++) SDMMC interrupts pending bits are managed using the macros __HAL_MMC_GET_IT()
		47	and __HAL_MMC_CLEAR_IT()
		48	(##) NVIC configuration if you need to use interrupt process (HAL_MMC_ReadBlocks_IT()
		49	and HAL_MMC_WriteBlocks_IT() APIs).
		50	(+++) Configure the SDMMC interrupt priorities using function HAL_NVIC_SetPriority();
		51	(+++) Enable the NVIC SDMMC IRQs using function HAL_NVIC_EnableIRQ()
		52	(+++) SDMMC interrupts are managed using the macros __HAL_MMC_ENABLE_IT()
		53	and __HAL_MMC_DISABLE_IT() inside the communication process.
		54	(+++) SDMMC interrupts pending bits are managed using the macros __HAL_MMC_GET_IT()
		55	and __HAL_MMC_CLEAR_IT()
		56	(#) At this stage, you can perform MMC read/write/erase operations after MMC card initialization
		57
		58
		59	* MMC Card Initialization and configuration *
		60	================================================
		61	[..]
		62	To initialize the MMC Card, use the HAL_MMC_Init() function. It Initializes
		63	SDMMC Peripheral (STM32 side) and the MMC Card, and put it into StandBy State (Ready for data transfer).
		64	This function provide the following operations:
		65
		66	(#) Initialize the SDMMC peripheral interface with defaullt configuration.
		67	The initialization process is done at 400KHz. You can change or adapt
		68	this frequency by adjusting the "ClockDiv" field.
		69	The MMC Card frequency (SDMMC_CK) is computed as follows:
		70
		71	SDMMC_CK = SDMMCCLK / (ClockDiv + 2)
		72
		73	In initialization mode and according to the MMC Card standard,
		74	make sure that the SDMMC_CK frequency doesn't exceed 400KHz.
		75
		76	This phase of initialization is done through SDMMC_Init() and
		77	SDMMC_PowerState_ON() SDMMC low level APIs.
		78
		79	(#) Initialize the MMC card. The API used is HAL_MMC_InitCard().
		80	This phase allows the card initialization and identification
		81	and check the MMC Card type (Standard Capacity or High Capacity)
		82	The initialization flow is compatible with MMC standard.
		83
		84	This API (HAL_MMC_InitCard()) could be used also to reinitialize the card in case
		85	of plug-off plug-in.
		86
		87	(#) Configure the MMC Card Data transfer frequency. By Default, the card transfer
		88	frequency is set to 24MHz. You can change or adapt this frequency by adjusting
		89	the "ClockDiv" field.
		90	In transfer mode and according to the MMC Card standard, make sure that the
		91	SDMMC_CK frequency doesn't exceed 25MHz and 50MHz in High-speed mode switch.
		92	To be able to use a frequency higher than 24MHz, you should use the SDMMC
		93	peripheral in bypass mode. Refer to the corresponding reference manual
		94	for more details.
		95
		96	(#) Select the corresponding MMC Card according to the address read with the step 2.
		97
		98	(#) Configure the MMC Card in wide bus mode: 4-bits data.
		99
		100	* MMC Card Read operation *
		101	==============================
		102	[..]
		103	(+) You can read from MMC card in polling mode by using function HAL_MMC_ReadBlocks().
		104	This function support only 512-bytes block length (the block size should be
		105	chosen as 512 bytes).
		106	You can choose either one block read operation or multiple block read operation
		107	by adjusting the "NumberOfBlocks" parameter.
		108	After this, you have to ensure that the transfer is done correctly. The check is done
		109	through HAL_MMC_GetCardState() function for MMC card state.
		110
		111	(+) You can read from MMC card in DMA mode by using function HAL_MMC_ReadBlocks_DMA().
		112	This function support only 512-bytes block length (the block size should be
		113	chosen as 512 bytes).
		114	You can choose either one block read operation or multiple block read operation
		115	by adjusting the "NumberOfBlocks" parameter.
		116	After this, you have to ensure that the transfer is done correctly. The check is done
		117	through HAL_MMC_GetCardState() function for MMC card state.
		118	You could also check the DMA transfer process through the MMC Rx interrupt event.
		119
		120	(+) You can read from MMC card in Interrupt mode by using function HAL_MMC_ReadBlocks_IT().
		121	This function allows the read of 512 bytes blocks.
		122	You can choose either one block read operation or multiple block read operation
		123	by adjusting the "NumberOfBlocks" parameter.
		124	After this, you have to ensure that the transfer is done correctly. The check is done
		125	through HAL_MMC_GetCardState() function for MMC card state.
		126	You could also check the IT transfer process through the MMC Rx interrupt event.
		127
		128	* MMC Card Write operation *
		129	===============================
		130	[..]
		131	(+) You can write to MMC card in polling mode by using function HAL_MMC_WriteBlocks().
		132	This function support only 512-bytes block length (the block size should be
		133	chosen as 512 bytes).
		134	You can choose either one block read operation or multiple block read operation
		135	by adjusting the "NumberOfBlocks" parameter.
		136	After this, you have to ensure that the transfer is done correctly. The check is done
		137	through HAL_MMC_GetCardState() function for MMC card state.
		138
		139	(+) You can write to MMC card in DMA mode by using function HAL_MMC_WriteBlocks_DMA().
		140	This function support only 512-bytes block length (the block size should be
		141	chosen as 512 byte).
		142	You can choose either one block read operation or multiple block read operation
		143	by adjusting the "NumberOfBlocks" parameter.
		144	After this, you have to ensure that the transfer is done correctly. The check is done
		145	through HAL_MMC_GetCardState() function for MMC card state.
		146	You could also check the DMA transfer process through the MMC Tx interrupt event.
		147
		148	(+) You can write to MMC card in Interrupt mode by using function HAL_MMC_WriteBlocks_IT().
		149	This function allows the read of 512 bytes blocks.
		150	You can choose either one block read operation or multiple block read operation
		151	by adjusting the "NumberOfBlocks" parameter.
		152	After this, you have to ensure that the transfer is done correctly. The check is done
		153	through HAL_MMC_GetCardState() function for MMC card state.
		154	You could also check the IT transfer process through the MMC Tx interrupt event.
		155
		156	* MMC card information *
		157	===========================
		158	[..]
		159	(+) To get MMC card information, you can use the function HAL_MMC_GetCardInfo().
		160	It returns useful information about the MMC card such as block size, card type,
		161	block number ...
		162
		163	* MMC card CSD register *
		164	============================
		165	[..]
		166	(+) The HAL_MMC_GetCardCSD() API allows to get the parameters of the CSD register.
		167	Some of the CSD parameters are useful for card initialization and identification.
		168
		169	* MMC card CID register *
		170	============================
		171	[..]
		172	(+) The HAL_MMC_GetCardCID() API allows to get the parameters of the CID register.
		173	Some of the CID parameters are useful for card initialization and identification.
		174
		175	* MMC HAL driver macros list *
		176	==================================
		177	[..]
		178	Below the list of most used macros in MMC HAL driver.
		179
		180	(+) __HAL_MMC_ENABLE : Enable the MMC device
		181	(+) __HAL_MMC_DISABLE : Disable the MMC device
		182	(+) __HAL_MMC_DMA_ENABLE: Enable the SDMMC DMA transfer
		183	(+) __HAL_MMC_DMA_DISABLE: Disable the SDMMC DMA transfer
		184	(+) __HAL_MMC_ENABLE_IT: Enable the MMC device interrupt
		185	(+) __HAL_MMC_DISABLE_IT: Disable the MMC device interrupt
		186	(+) __HAL_MMC_GET_FLAG:Check whether the specified MMC flag is set or not
		187	(+) __HAL_MMC_CLEAR_FLAG: Clear the MMC's pending flags
		188
		189	[..]
		190	(@) You can refer to the MMC HAL driver header file for more useful macros
		191
		192	* Callback registration *
		193	=============================================
		194	[..]
		195	The compilation define USE_HAL_MMC_REGISTER_CALLBACKS when set to 1
		196	allows the user to configure dynamically the driver callbacks.
		197
		198	Use Functions @ref HAL_MMC_RegisterCallback() to register a user callback,
		199	it allows to register following callbacks:
		200	(+) TxCpltCallback : callback when a transmission transfer is completed.
		201	(+) RxCpltCallback : callback when a reception transfer is completed.
		202	(+) ErrorCallback : callback when error occurs.
		203	(+) AbortCpltCallback : callback when abort is completed.
		204	(+) MspInitCallback : MMC MspInit.
		205	(+) MspDeInitCallback : MMC MspDeInit.
		206	This function takes as parameters the HAL peripheral handle, the Callback ID
		207	and a pointer to the user callback function.
		208
		209	Use function @ref HAL_MMC_UnRegisterCallback() to reset a callback to the default
		210	weak (surcharged) function. It allows to reset following callbacks:
		211	(+) TxCpltCallback : callback when a transmission transfer is completed.
		212	(+) RxCpltCallback : callback when a reception transfer is completed.
		213	(+) ErrorCallback : callback when error occurs.
		214	(+) AbortCpltCallback : callback when abort is completed.
		215	(+) MspInitCallback : MMC MspInit.
		216	(+) MspDeInitCallback : MMC MspDeInit.
		217	This function) takes as parameters the HAL peripheral handle and the Callback ID.
		218
		219	By default, after the @ref HAL_MMC_Init and if the state is HAL_MMC_STATE_RESET
		220	all callbacks are reset to the corresponding legacy weak (surcharged) functions.
		221	Exception done for MspInit and MspDeInit callbacks that are respectively
		222	reset to the legacy weak (surcharged) functions in the @ref HAL_MMC_Init
		223	and @ref HAL_MMC_DeInit only when these callbacks are null (not registered beforehand).
		224	If not, MspInit or MspDeInit are not null, the @ref HAL_MMC_Init and @ref HAL_MMC_DeInit
		225	keep and use the user MspInit/MspDeInit callbacks (registered beforehand)
		226
		227	Callbacks can be registered/unregistered in READY state only.
		228	Exception done for MspInit/MspDeInit callbacks that can be registered/unregistered
		229	in READY or RESET state, thus registered (user) MspInit/DeInit callbacks can be used
		230	during the Init/DeInit.
		231	In that case first register the MspInit/MspDeInit user callbacks
		232	using @ref HAL_MMC_RegisterCallback before calling @ref HAL_MMC_DeInit
		233	or @ref HAL_MMC_Init function.
		234
		235	When The compilation define USE_HAL_MMC_REGISTER_CALLBACKS is set to 0 or
		236	not defined, the callback registering feature is not available
		237	and weak (surcharged) callbacks are used.
		238
		239	@endverbatim
		240	******************************************************************************
		241	* @attention
		242	*
		243	* <h2><center>© Copyright (c) 2018 STMicroelectronics.
		244	* All rights reserved.</center></h2>
		245	*
		246	* This software component is licensed by ST under BSD 3-Clause license,
		247	* the "License"; You may not use this file except in compliance with the
		248	* License. You may obtain a copy of the License at:
		249	* opensource.org/licenses/BSD-3-Clause
		250	*
		251	******************************************************************************
		252	*/
		253
		254	/* Includes ------------------------------------------------------------------*/
		255	#include "stm32f1xx_hal.h"
		256
		257	/** @addtogroup STM32F1xx_HAL_Driver
		258	* @{
		259	*/
		260
		261	/** @defgroup MMC MMC
		262	* @brief MMC HAL module driver
		263	* @{
		264	*/
		265
		266	#ifdef HAL_MMC_MODULE_ENABLED
		267
		268	#if defined(SDIO)
		269
		270	/* Private typedef -----------------------------------------------------------*/
		271	/* Private define ------------------------------------------------------------*/
		272	/** @addtogroup MMC_Private_Defines
		273	* @{
		274	*/
		275
		276	/**
		277	* @}
		278	*/
		279
		280	/* Private macro -------------------------------------------------------------*/
		281	/* Private variables ---------------------------------------------------------*/
		282	/* Private function prototypes -----------------------------------------------*/
		283	/* Private functions ---------------------------------------------------------*/
		284	/** @defgroup MMC_Private_Functions MMC Private Functions
		285	* @{
		286	*/
		287	static uint32_t MMC_InitCard(MMC_HandleTypeDef *hmmc);
		288	static uint32_t MMC_PowerON(MMC_HandleTypeDef *hmmc);
		289	static uint32_t MMC_SendStatus(MMC_HandleTypeDef hmmc, uint32_t pCardStatus);
		290	static uint32_t MMC_ReadExtCSD(MMC_HandleTypeDef hmmc, uint32_t pFieldData, uint16_t FieldIndex, uint32_t Timeout);
		291	static void MMC_PowerOFF(MMC_HandleTypeDef *hmmc);
		292	static void MMC_Write_IT(MMC_HandleTypeDef *hmmc);
		293	static void MMC_Read_IT(MMC_HandleTypeDef *hmmc);
		294	static void MMC_DMATransmitCplt(DMA_HandleTypeDef *hdma);
		295	static void MMC_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
		296	static void MMC_DMAError(DMA_HandleTypeDef *hdma);
		297	static void MMC_DMATxAbort(DMA_HandleTypeDef *hdma);
		298	static void MMC_DMARxAbort(DMA_HandleTypeDef *hdma);
		299	/**
		300	* @}
		301	*/
		302	/* Exported functions --------------------------------------------------------*/
		303	/** @addtogroup MMC_Exported_Functions
		304	* @{
		305	*/
		306
		307	/** @addtogroup MMC_Exported_Functions_Group1
		308	* @brief Initialization and de-initialization functions
		309	*
		310	@verbatim
		311	==============================================================================
		312	##### Initialization and de-initialization functions #####
		313	==============================================================================
		314	[..]
		315	This section provides functions allowing to initialize/de-initialize the MMC
		316	card device to be ready for use.
		317
		318	@endverbatim
		319	* @{
		320	*/
		321
		322	/**
		323	* @brief Initializes the MMC according to the specified parameters in the
		324	MMC_HandleTypeDef and create the associated handle.
		325	* @param hmmc: Pointer to the MMC handle
		326	* @retval HAL status
		327	*/
		328	HAL_StatusTypeDef HAL_MMC_Init(MMC_HandleTypeDef *hmmc)
		329	{
		330	/* Check the MMC handle allocation */
		331	if(hmmc == NULL)
		332	{
		333	return HAL_ERROR;
		334	}
		335
		336	/* Check the parameters */
		337	assert_param(IS_SDIO_ALL_INSTANCE(hmmc->Instance));
		338	assert_param(IS_SDIO_CLOCK_EDGE(hmmc->Init.ClockEdge));
		339	assert_param(IS_SDIO_CLOCK_BYPASS(hmmc->Init.ClockBypass));
		340	assert_param(IS_SDIO_CLOCK_POWER_SAVE(hmmc->Init.ClockPowerSave));
		341	assert_param(IS_SDIO_BUS_WIDE(hmmc->Init.BusWide));
		342	assert_param(IS_SDIO_HARDWARE_FLOW_CONTROL(hmmc->Init.HardwareFlowControl));
		343	assert_param(IS_SDIO_CLKDIV(hmmc->Init.ClockDiv));
		344
		345	if(hmmc->State == HAL_MMC_STATE_RESET)
		346	{
		347	/* Allocate lock resource and initialize it */
		348	hmmc->Lock = HAL_UNLOCKED;
		349	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		350	/* Reset Callback pointers in HAL_MMC_STATE_RESET only */
		351	hmmc->TxCpltCallback = HAL_MMC_TxCpltCallback;
		352	hmmc->RxCpltCallback = HAL_MMC_RxCpltCallback;
		353	hmmc->ErrorCallback = HAL_MMC_ErrorCallback;
		354	hmmc->AbortCpltCallback = HAL_MMC_AbortCallback;
		355
		356	if(hmmc->MspInitCallback == NULL)
		357	{
		358	hmmc->MspInitCallback = HAL_MMC_MspInit;
		359	}
		360
		361	/* Init the low level hardware */
		362	hmmc->MspInitCallback(hmmc);
		363	#else
		364	/* Init the low level hardware : GPIO, CLOCK, CORTEX...etc */
		365	HAL_MMC_MspInit(hmmc);
		366	#endif
		367	}
		368
		369	hmmc->State = HAL_MMC_STATE_BUSY;
		370
		371	/* Initialize the Card parameters */
		372	if(HAL_MMC_InitCard(hmmc) == HAL_ERROR)
		373	{
		374	return HAL_ERROR;
		375	}
		376
		377	/* Initialize the error code */
		378	hmmc->ErrorCode = HAL_DMA_ERROR_NONE;
		379
		380	/* Initialize the MMC operation */
		381	hmmc->Context = MMC_CONTEXT_NONE;
		382
		383	/* Initialize the MMC state */
		384	hmmc->State = HAL_MMC_STATE_READY;
		385
		386	return HAL_OK;
		387	}
		388
		389	/**
		390	* @brief Initializes the MMC Card.
		391	* @param hmmc: Pointer to MMC handle
		392	* @note This function initializes the MMC card. It could be used when a card
		393	re-initialization is needed.
		394	* @retval HAL status
		395	*/
		396	HAL_StatusTypeDef HAL_MMC_InitCard(MMC_HandleTypeDef *hmmc)
		397	{
		398	uint32_t errorstate;
		399	MMC_InitTypeDef Init;
		400	HAL_StatusTypeDef status;
		401
		402	/* Default SDIO peripheral configuration for MMC card initialization */
		403	Init.ClockEdge = SDIO_CLOCK_EDGE_RISING;
		404	Init.ClockBypass = SDIO_CLOCK_BYPASS_DISABLE;
		405	Init.ClockPowerSave = SDIO_CLOCK_POWER_SAVE_DISABLE;
		406	Init.BusWide = SDIO_BUS_WIDE_1B;
		407	Init.HardwareFlowControl = SDIO_HARDWARE_FLOW_CONTROL_DISABLE;
		408	Init.ClockDiv = SDIO_INIT_CLK_DIV;
		409
		410	/* Initialize SDIO peripheral interface with default configuration */
		411	status = SDIO_Init(hmmc->Instance, Init);
		412	if(status == HAL_ERROR)
		413	{
		414	return HAL_ERROR;
		415	}
		416
		417	/* Disable SDIO Clock */
		418	__HAL_MMC_DISABLE(hmmc);
		419
		420	/* Set Power State to ON */
		421	status = SDIO_PowerState_ON(hmmc->Instance);
		422	if(status == HAL_ERROR)
		423	{
		424	return HAL_ERROR;
		425	}
		426
		427	/* Enable MMC Clock */
		428	__HAL_MMC_ENABLE(hmmc);
		429
		430	/* Identify card operating voltage */
		431	errorstate = MMC_PowerON(hmmc);
		432	if(errorstate != HAL_MMC_ERROR_NONE)
		433	{
		434	hmmc->State = HAL_MMC_STATE_READY;
		435	hmmc->ErrorCode \|= errorstate;
		436	return HAL_ERROR;
		437	}
		438
		439	/* Card initialization */
		440	errorstate = MMC_InitCard(hmmc);
		441	if(errorstate != HAL_MMC_ERROR_NONE)
		442	{
		443	hmmc->State = HAL_MMC_STATE_READY;
		444	hmmc->ErrorCode \|= errorstate;
		445	return HAL_ERROR;
		446	}
		447
		448	/* Set Block Size for Card */
		449	errorstate = SDMMC_CmdBlockLength(hmmc->Instance, MMC_BLOCKSIZE);
		450	if(errorstate != HAL_MMC_ERROR_NONE)
		451	{
		452	/* Clear all the static flags */
		453	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		454	hmmc->ErrorCode \|= errorstate;
		455	hmmc->State = HAL_MMC_STATE_READY;
		456	return HAL_ERROR;
		457	}
		458
		459	return HAL_OK;
		460	}
		461
		462	/**
		463	* @brief De-Initializes the MMC card.
		464	* @param hmmc: Pointer to MMC handle
		465	* @retval HAL status
		466	*/
		467	HAL_StatusTypeDef HAL_MMC_DeInit(MMC_HandleTypeDef *hmmc)
		468	{
		469	/* Check the MMC handle allocation */
		470	if(hmmc == NULL)
		471	{
		472	return HAL_ERROR;
		473	}
		474
		475	/* Check the parameters */
		476	assert_param(IS_SDIO_ALL_INSTANCE(hmmc->Instance));
		477
		478	hmmc->State = HAL_MMC_STATE_BUSY;
		479
		480	/* Set MMC power state to off */
		481	MMC_PowerOFF(hmmc);
		482
		483	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		484	if(hmmc->MspDeInitCallback == NULL)
		485	{
		486	hmmc->MspDeInitCallback = HAL_MMC_MspDeInit;
		487	}
		488
		489	/* DeInit the low level hardware */
		490	hmmc->MspDeInitCallback(hmmc);
		491	#else
		492	/* De-Initialize the MSP layer */
		493	HAL_MMC_MspDeInit(hmmc);
		494	#endif
		495
		496	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		497	hmmc->State = HAL_MMC_STATE_RESET;
		498
		499	return HAL_OK;
		500	}
		501
		502
		503	/**
		504	* @brief Initializes the MMC MSP.
		505	* @param hmmc: Pointer to MMC handle
		506	* @retval None
		507	*/
		508	__weak void HAL_MMC_MspInit(MMC_HandleTypeDef *hmmc)
		509	{
		510	/* Prevent unused argument(s) compilation warning */
		511	UNUSED(hmmc);
		512
		513	/* NOTE : This function Should not be modified, when the callback is needed,
		514	the HAL_MMC_MspInit could be implemented in the user file
		515	*/
		516	}
		517
		518	/**
		519	* @brief De-Initialize MMC MSP.
		520	* @param hmmc: Pointer to MMC handle
		521	* @retval None
		522	*/
		523	__weak void HAL_MMC_MspDeInit(MMC_HandleTypeDef *hmmc)
		524	{
		525	/* Prevent unused argument(s) compilation warning */
		526	UNUSED(hmmc);
		527
		528	/* NOTE : This function Should not be modified, when the callback is needed,
		529	the HAL_MMC_MspDeInit could be implemented in the user file
		530	*/
		531	}
		532
		533	/**
		534	* @}
		535	*/
		536
		537	/** @addtogroup MMC_Exported_Functions_Group2
		538	* @brief Data transfer functions
		539	*
		540	@verbatim
		541	==============================================================================
		542	##### IO operation functions #####
		543	==============================================================================
		544	[..]
		545	This subsection provides a set of functions allowing to manage the data
		546	transfer from/to MMC card.
		547
		548	@endverbatim
		549	* @{
		550	*/
		551
		552	/**
		553	* @brief Reads block(s) from a specified address in a card. The Data transfer
		554	* is managed by polling mode.
		555	* @note This API should be followed by a check on the card state through
		556	* HAL_MMC_GetCardState().
		557	* @param hmmc: Pointer to MMC handle
		558	* @param pData: pointer to the buffer that will contain the received data
		559	* @param BlockAdd: Block Address from where data is to be read
		560	* @param NumberOfBlocks: Number of MMC blocks to read
		561	* @param Timeout: Specify timeout value
		562	* @retval HAL status
		563	*/
		564	HAL_StatusTypeDef HAL_MMC_ReadBlocks(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout)
		565	{
		566	SDIO_DataInitTypeDef config;
		567	uint32_t errorstate;
		568	uint32_t tickstart = HAL_GetTick();
		569	uint32_t count, data, dataremaining;
		570	uint32_t add = BlockAdd;
		571	uint8_t *tempbuff = pData;
		572
		573	if(NULL == pData)
		574	{
		575	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		576	return HAL_ERROR;
		577	}
		578
		579	if(hmmc->State == HAL_MMC_STATE_READY)
		580	{
		581	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		582
		583	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		584	{
		585	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		586	return HAL_ERROR;
		587	}
		588
		589	hmmc->State = HAL_MMC_STATE_BUSY;
		590
		591	/* Initialize data control register */
		592	hmmc->Instance->DCTRL = 0U;
		593
		594	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		595	{
		596	add *= 512U;
		597	}
		598
		599	/* Configure the MMC DPSM (Data Path State Machine) */
		600	config.DataTimeOut = SDMMC_DATATIMEOUT;
		601	config.DataLength = NumberOfBlocks * MMC_BLOCKSIZE;
		602	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		603	config.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
		604	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		605	config.DPSM = SDIO_DPSM_ENABLE;
		606	(void)SDIO_ConfigData(hmmc->Instance, &config);
		607
		608	/* Read block(s) in polling mode */
		609	if(NumberOfBlocks > 1U)
		610	{
		611	hmmc->Context = MMC_CONTEXT_READ_MULTIPLE_BLOCK;
		612
		613	/* Read Multi Block command */
		614	errorstate = SDMMC_CmdReadMultiBlock(hmmc->Instance, add);
		615	}
		616	else
		617	{
		618	hmmc->Context = MMC_CONTEXT_READ_SINGLE_BLOCK;
		619
		620	/* Read Single Block command */
		621	errorstate = SDMMC_CmdReadSingleBlock(hmmc->Instance, add);
		622	}
		623	if(errorstate != HAL_MMC_ERROR_NONE)
		624	{
		625	/* Clear all the static flags */
		626	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		627	hmmc->ErrorCode \|= errorstate;
		628	hmmc->State = HAL_MMC_STATE_READY;
		629	return HAL_ERROR;
		630	}
		631
		632	/* Poll on SDIO flags */
		633	dataremaining = config.DataLength;
		634	while(!__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXOVERR \| SDIO_FLAG_DCRCFAIL \| SDIO_FLAG_DTIMEOUT \| SDIO_FLAG_DATAEND \| SDIO_FLAG_STBITERR))
		635	{
		636	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXFIFOHF) && (dataremaining > 0U))
		637	{
		638	/* Read data from SDIO Rx FIFO */
		639	for(count = 0U; count < 8U; count++)
		640	{
		641	data = SDIO_ReadFIFO(hmmc->Instance);
		642	*tempbuff = (uint8_t)(data & 0xFFU);
		643	tempbuff++;
		644	dataremaining--;
		645	*tempbuff = (uint8_t)((data >> 8U) & 0xFFU);
		646	tempbuff++;
		647	dataremaining--;
		648	*tempbuff = (uint8_t)((data >> 16U) & 0xFFU);
		649	tempbuff++;
		650	dataremaining--;
		651	*tempbuff = (uint8_t)((data >> 24U) & 0xFFU);
		652	tempbuff++;
		653	dataremaining--;
		654	}
		655	}
		656
		657	if(((HAL_GetTick()-tickstart) >= Timeout) \|\| (Timeout == 0U))
		658	{
		659	/* Clear all the static flags */
		660	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		661	hmmc->ErrorCode \|= HAL_MMC_ERROR_TIMEOUT;
		662	hmmc->State= HAL_MMC_STATE_READY;
		663	return HAL_TIMEOUT;
		664	}
		665	}
		666
		667	/* Send stop transmission command in case of multiblock read */
		668	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1U))
		669	{
		670	/* Send stop transmission command */
		671	errorstate = SDMMC_CmdStopTransfer(hmmc->Instance);
		672	if(errorstate != HAL_MMC_ERROR_NONE)
		673	{
		674	/* Clear all the static flags */
		675	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		676	hmmc->ErrorCode \|= errorstate;
		677	hmmc->State = HAL_MMC_STATE_READY;
		678	return HAL_ERROR;
		679	}
		680	}
		681
		682	/* Get error state */
		683	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DTIMEOUT))
		684	{
		685	/* Clear all the static flags */
		686	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		687	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_TIMEOUT;
		688	hmmc->State = HAL_MMC_STATE_READY;
		689	return HAL_ERROR;
		690	}
		691	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DCRCFAIL))
		692	{
		693	/* Clear all the static flags */
		694	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		695	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_CRC_FAIL;
		696	hmmc->State = HAL_MMC_STATE_READY;
		697	return HAL_ERROR;
		698	}
		699	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXOVERR))
		700	{
		701	/* Clear all the static flags */
		702	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		703	hmmc->ErrorCode \|= HAL_MMC_ERROR_RX_OVERRUN;
		704	hmmc->State = HAL_MMC_STATE_READY;
		705	return HAL_ERROR;
		706	}
		707	else
		708	{
		709	/* Nothing to do */
		710	}
		711
		712	/* Empty FIFO if there is still any data */
		713	while ((__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXDAVL)) && (dataremaining > 0U))
		714	{
		715	data = SDIO_ReadFIFO(hmmc->Instance);
		716	*tempbuff = (uint8_t)(data & 0xFFU);
		717	tempbuff++;
		718	dataremaining--;
		719	*tempbuff = (uint8_t)((data >> 8U) & 0xFFU);
		720	tempbuff++;
		721	dataremaining--;
		722	*tempbuff = (uint8_t)((data >> 16U) & 0xFFU);
		723	tempbuff++;
		724	dataremaining--;
		725	*tempbuff = (uint8_t)((data >> 24U) & 0xFFU);
		726	tempbuff++;
		727	dataremaining--;
		728
		729	if(((HAL_GetTick()-tickstart) >= Timeout) \|\| (Timeout == 0U))
		730	{
		731	/* Clear all the static flags */
		732	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		733	hmmc->ErrorCode \|= HAL_MMC_ERROR_TIMEOUT;
		734	hmmc->State= HAL_MMC_STATE_READY;
		735	return HAL_ERROR;
		736	}
		737	}
		738
		739	/* Clear all the static flags */
		740	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		741
		742	hmmc->State = HAL_MMC_STATE_READY;
		743
		744	return HAL_OK;
		745	}
		746	else
		747	{
		748	hmmc->ErrorCode \|= HAL_MMC_ERROR_BUSY;
		749	return HAL_ERROR;
		750	}
		751	}
		752
		753	/**
		754	* @brief Allows to write block(s) to a specified address in a card. The Data
		755	* transfer is managed by polling mode.
		756	* @note This API should be followed by a check on the card state through
		757	* HAL_MMC_GetCardState().
		758	* @param hmmc: Pointer to MMC handle
		759	* @param pData: pointer to the buffer that will contain the data to transmit
		760	* @param BlockAdd: Block Address where data will be written
		761	* @param NumberOfBlocks: Number of MMC blocks to write
		762	* @param Timeout: Specify timeout value
		763	* @retval HAL status
		764	*/
		765	HAL_StatusTypeDef HAL_MMC_WriteBlocks(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout)
		766	{
		767	SDIO_DataInitTypeDef config;
		768	uint32_t errorstate;
		769	uint32_t tickstart = HAL_GetTick();
		770	uint32_t count, data, dataremaining;
		771	uint32_t add = BlockAdd;
		772	uint8_t *tempbuff = pData;
		773
		774	if(NULL == pData)
		775	{
		776	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		777	return HAL_ERROR;
		778	}
		779
		780	if(hmmc->State == HAL_MMC_STATE_READY)
		781	{
		782	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		783
		784	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		785	{
		786	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		787	return HAL_ERROR;
		788	}
		789
		790	hmmc->State = HAL_MMC_STATE_BUSY;
		791
		792	/* Initialize data control register */
		793	hmmc->Instance->DCTRL = 0U;
		794
		795	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		796	{
		797	add *= 512U;
		798	}
		799
		800	/* Write Blocks in Polling mode */
		801	if(NumberOfBlocks > 1U)
		802	{
		803	hmmc->Context = MMC_CONTEXT_WRITE_MULTIPLE_BLOCK;
		804
		805	/* Write Multi Block command */
		806	errorstate = SDMMC_CmdWriteMultiBlock(hmmc->Instance, add);
		807	}
		808	else
		809	{
		810	hmmc->Context = MMC_CONTEXT_WRITE_SINGLE_BLOCK;
		811
		812	/* Write Single Block command */
		813	errorstate = SDMMC_CmdWriteSingleBlock(hmmc->Instance, add);
		814	}
		815	if(errorstate != HAL_MMC_ERROR_NONE)
		816	{
		817	/* Clear all the static flags */
		818	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		819	hmmc->ErrorCode \|= errorstate;
		820	hmmc->State = HAL_MMC_STATE_READY;
		821	return HAL_ERROR;
		822	}
		823
		824	/* Configure the MMC DPSM (Data Path State Machine) */
		825	config.DataTimeOut = SDMMC_DATATIMEOUT;
		826	config.DataLength = NumberOfBlocks * MMC_BLOCKSIZE;
		827	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		828	config.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;
		829	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		830	config.DPSM = SDIO_DPSM_ENABLE;
		831	(void)SDIO_ConfigData(hmmc->Instance, &config);
		832
		833	/* Write block(s) in polling mode */
		834	dataremaining = config.DataLength;
		835	while(!__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_TXUNDERR \| SDIO_FLAG_DCRCFAIL \| SDIO_FLAG_DTIMEOUT \| SDIO_FLAG_DATAEND \| SDIO_FLAG_STBITERR))
		836	{
		837	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_TXFIFOHE) && (dataremaining > 0U))
		838	{
		839	/* Write data to SDIO Tx FIFO */
		840	for(count = 0U; count < 8U; count++)
		841	{
		842	data = (uint32_t)(*tempbuff);
		843	tempbuff++;
		844	dataremaining--;
		845	data \|= ((uint32_t)(*tempbuff) << 8U);
		846	tempbuff++;
		847	dataremaining--;
		848	data \|= ((uint32_t)(*tempbuff) << 16U);
		849	tempbuff++;
		850	dataremaining--;
		851	data \|= ((uint32_t)(*tempbuff) << 24U);
		852	tempbuff++;
		853	dataremaining--;
		854	(void)SDIO_WriteFIFO(hmmc->Instance, &data);
		855	}
		856	}
		857
		858	if(((HAL_GetTick()-tickstart) >= Timeout) \|\| (Timeout == 0U))
		859	{
		860	/* Clear all the static flags */
		861	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		862	hmmc->ErrorCode \|= errorstate;
		863	hmmc->State = HAL_MMC_STATE_READY;
		864	return HAL_TIMEOUT;
		865	}
		866	}
		867
		868	/* Send stop transmission command in case of multiblock write */
		869	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1U))
		870	{
		871	/* Send stop transmission command */
		872	errorstate = SDMMC_CmdStopTransfer(hmmc->Instance);
		873	if(errorstate != HAL_MMC_ERROR_NONE)
		874	{
		875	/* Clear all the static flags */
		876	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		877	hmmc->ErrorCode \|= errorstate;
		878	hmmc->State = HAL_MMC_STATE_READY;
		879	return HAL_ERROR;
		880	}
		881	}
		882
		883	/* Get error state */
		884	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DTIMEOUT))
		885	{
		886	/* Clear all the static flags */
		887	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		888	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_TIMEOUT;
		889	hmmc->State = HAL_MMC_STATE_READY;
		890	return HAL_ERROR;
		891	}
		892	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DCRCFAIL))
		893	{
		894	/* Clear all the static flags */
		895	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		896	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_CRC_FAIL;
		897	hmmc->State = HAL_MMC_STATE_READY;
		898	return HAL_ERROR;
		899	}
		900	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_TXUNDERR))
		901	{
		902	/* Clear all the static flags */
		903	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		904	hmmc->ErrorCode \|= HAL_MMC_ERROR_TX_UNDERRUN;
		905	hmmc->State = HAL_MMC_STATE_READY;
		906	return HAL_ERROR;
		907	}
		908	else
		909	{
		910	/* Nothing to do */
		911	}
		912
		913	/* Clear all the static flags */
		914	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		915
		916	hmmc->State = HAL_MMC_STATE_READY;
		917
		918	return HAL_OK;
		919	}
		920	else
		921	{
		922	hmmc->ErrorCode \|= HAL_MMC_ERROR_BUSY;
		923	return HAL_ERROR;
		924	}
		925	}
		926
		927	/**
		928	* @brief Reads block(s) from a specified address in a card. The Data transfer
		929	* is managed in interrupt mode.
		930	* @note This API should be followed by a check on the card state through
		931	* HAL_MMC_GetCardState().
		932	* @note You could also check the IT transfer process through the MMC Rx
		933	* interrupt event.
		934	* @param hmmc: Pointer to MMC handle
		935	* @param pData: Pointer to the buffer that will contain the received data
		936	* @param BlockAdd: Block Address from where data is to be read
		937	* @param NumberOfBlocks: Number of blocks to read.
		938	* @retval HAL status
		939	*/
		940	HAL_StatusTypeDef HAL_MMC_ReadBlocks_IT(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks)
		941	{
		942	SDIO_DataInitTypeDef config;
		943	uint32_t errorstate;
		944	uint32_t add = BlockAdd;
		945
		946	if(NULL == pData)
		947	{
		948	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		949	return HAL_ERROR;
		950	}
		951
		952	if(hmmc->State == HAL_MMC_STATE_READY)
		953	{
		954	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		955
		956	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		957	{
		958	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		959	return HAL_ERROR;
		960	}
		961
		962	hmmc->State = HAL_MMC_STATE_BUSY;
		963
		964	/* Initialize data control register */
		965	hmmc->Instance->DCTRL = 0U;
		966
		967	hmmc->pRxBuffPtr = pData;
		968	hmmc->RxXferSize = MMC_BLOCKSIZE * NumberOfBlocks;
		969
		970	__HAL_MMC_ENABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_RXOVERR \| SDIO_IT_DATAEND \| SDIO_FLAG_RXFIFOHF));
		971
		972	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		973	{
		974	add *= 512U;
		975	}
		976
		977	/* Configure the MMC DPSM (Data Path State Machine) */
		978	config.DataTimeOut = SDMMC_DATATIMEOUT;
		979	config.DataLength = MMC_BLOCKSIZE * NumberOfBlocks;
		980	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		981	config.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
		982	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		983	config.DPSM = SDIO_DPSM_ENABLE;
		984	(void)SDIO_ConfigData(hmmc->Instance, &config);
		985
		986	/* Read Blocks in IT mode */
		987	if(NumberOfBlocks > 1U)
		988	{
		989	hmmc->Context = (MMC_CONTEXT_READ_MULTIPLE_BLOCK \| MMC_CONTEXT_IT);
		990
		991	/* Read Multi Block command */
		992	errorstate = SDMMC_CmdReadMultiBlock(hmmc->Instance, add);
		993	}
		994	else
		995	{
		996	hmmc->Context = (MMC_CONTEXT_READ_SINGLE_BLOCK \| MMC_CONTEXT_IT);
		997
		998	/* Read Single Block command */
		999	errorstate = SDMMC_CmdReadSingleBlock(hmmc->Instance, add);
		1000	}
		1001
		1002	if(errorstate != HAL_MMC_ERROR_NONE)
		1003	{
		1004	/* Clear all the static flags */
		1005	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1006	hmmc->ErrorCode \|= errorstate;
		1007	hmmc->State = HAL_MMC_STATE_READY;
		1008	return HAL_ERROR;
		1009	}
		1010
		1011	return HAL_OK;
		1012	}
		1013	else
		1014	{
		1015	return HAL_BUSY;
		1016	}
		1017	}
		1018
		1019	/**
		1020	* @brief Writes block(s) to a specified address in a card. The Data transfer
		1021	* is managed in interrupt mode.
		1022	* @note This API should be followed by a check on the card state through
		1023	* HAL_MMC_GetCardState().
		1024	* @note You could also check the IT transfer process through the MMC Tx
		1025	* interrupt event.
		1026	* @param hmmc: Pointer to MMC handle
		1027	* @param pData: Pointer to the buffer that will contain the data to transmit
		1028	* @param BlockAdd: Block Address where data will be written
		1029	* @param NumberOfBlocks: Number of blocks to write
		1030	* @retval HAL status
		1031	*/
		1032	HAL_StatusTypeDef HAL_MMC_WriteBlocks_IT(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks)
		1033	{
		1034	SDIO_DataInitTypeDef config;
		1035	uint32_t errorstate;
		1036	uint32_t add = BlockAdd;
		1037
		1038	if(NULL == pData)
		1039	{
		1040	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		1041	return HAL_ERROR;
		1042	}
		1043
		1044	if(hmmc->State == HAL_MMC_STATE_READY)
		1045	{
		1046	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		1047
		1048	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		1049	{
		1050	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		1051	return HAL_ERROR;
		1052	}
		1053
		1054	hmmc->State = HAL_MMC_STATE_BUSY;
		1055
		1056	/* Initialize data control register */
		1057	hmmc->Instance->DCTRL = 0U;
		1058
		1059	hmmc->pTxBuffPtr = pData;
		1060	hmmc->TxXferSize = MMC_BLOCKSIZE * NumberOfBlocks;
		1061
		1062	/* Enable transfer interrupts */
		1063	__HAL_MMC_ENABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_TXUNDERR \| SDIO_IT_DATAEND \| SDIO_FLAG_TXFIFOHE));
		1064
		1065	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		1066	{
		1067	add *= 512U;
		1068	}
		1069
		1070	/* Write Blocks in Polling mode */
		1071	if(NumberOfBlocks > 1U)
		1072	{
		1073	hmmc->Context = (MMC_CONTEXT_WRITE_MULTIPLE_BLOCK\| MMC_CONTEXT_IT);
		1074
		1075	/* Write Multi Block command */
		1076	errorstate = SDMMC_CmdWriteMultiBlock(hmmc->Instance, add);
		1077	}
		1078	else
		1079	{
		1080	hmmc->Context = (MMC_CONTEXT_WRITE_SINGLE_BLOCK \| MMC_CONTEXT_IT);
		1081
		1082	/* Write Single Block command */
		1083	errorstate = SDMMC_CmdWriteSingleBlock(hmmc->Instance, add);
		1084	}
		1085	if(errorstate != HAL_MMC_ERROR_NONE)
		1086	{
		1087	/* Clear all the static flags */
		1088	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1089	hmmc->ErrorCode \|= errorstate;
		1090	hmmc->State = HAL_MMC_STATE_READY;
		1091	return HAL_ERROR;
		1092	}
		1093
		1094	/* Configure the MMC DPSM (Data Path State Machine) */
		1095	config.DataTimeOut = SDMMC_DATATIMEOUT;
		1096	config.DataLength = MMC_BLOCKSIZE * NumberOfBlocks;
		1097	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		1098	config.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;
		1099	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		1100	config.DPSM = SDIO_DPSM_ENABLE;
		1101	(void)SDIO_ConfigData(hmmc->Instance, &config);
		1102
		1103	return HAL_OK;
		1104	}
		1105	else
		1106	{
		1107	return HAL_BUSY;
		1108	}
		1109	}
		1110
		1111	/**
		1112	* @brief Reads block(s) from a specified address in a card. The Data transfer
		1113	* is managed by DMA mode.
		1114	* @note This API should be followed by a check on the card state through
		1115	* HAL_MMC_GetCardState().
		1116	* @note You could also check the DMA transfer process through the MMC Rx
		1117	* interrupt event.
		1118	* @param hmmc: Pointer MMC handle
		1119	* @param pData: Pointer to the buffer that will contain the received data
		1120	* @param BlockAdd: Block Address from where data is to be read
		1121	* @param NumberOfBlocks: Number of blocks to read.
		1122	* @retval HAL status
		1123	*/
		1124	HAL_StatusTypeDef HAL_MMC_ReadBlocks_DMA(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks)
		1125	{
		1126	SDIO_DataInitTypeDef config;
		1127	uint32_t errorstate;
		1128	uint32_t add = BlockAdd;
		1129
		1130	if(NULL == pData)
		1131	{
		1132	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		1133	return HAL_ERROR;
		1134	}
		1135
		1136	if(hmmc->State == HAL_MMC_STATE_READY)
		1137	{
		1138	hmmc->ErrorCode = HAL_DMA_ERROR_NONE;
		1139
		1140	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		1141	{
		1142	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		1143	return HAL_ERROR;
		1144	}
		1145
		1146	hmmc->State = HAL_MMC_STATE_BUSY;
		1147
		1148	/* Initialize data control register */
		1149	hmmc->Instance->DCTRL = 0U;
		1150
		1151	__HAL_MMC_ENABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_RXOVERR \| SDIO_IT_DATAEND));
		1152
		1153	/* Set the DMA transfer complete callback */
		1154	hmmc->hdmarx->XferCpltCallback = MMC_DMAReceiveCplt;
		1155
		1156	/* Set the DMA error callback */
		1157	hmmc->hdmarx->XferErrorCallback = MMC_DMAError;
		1158
		1159	/* Set the DMA Abort callback */
		1160	hmmc->hdmarx->XferAbortCallback = NULL;
		1161
		1162	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		1163	{
		1164	add *= 512U;
		1165	}
		1166
		1167	/* Force DMA Direction */
		1168	hmmc->hdmarx->Init.Direction = DMA_PERIPH_TO_MEMORY;
		1169	MODIFY_REG(hmmc->hdmarx->Instance->CCR, DMA_CCR_DIR, hmmc->hdmarx->Init.Direction);
		1170
		1171	/* Enable the DMA Channel */
		1172	if(HAL_DMA_Start_IT(hmmc->hdmarx, (uint32_t)&hmmc->Instance->FIFO, (uint32_t)pData, (uint32_t)(MMC_BLOCKSIZE * NumberOfBlocks)/4) != HAL_OK)
		1173	{
		1174	__HAL_MMC_DISABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_RXOVERR \| SDIO_IT_DATAEND));
		1175	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1176	hmmc->ErrorCode = HAL_MMC_ERROR_DMA;
		1177	hmmc->State = HAL_MMC_STATE_READY;
		1178	return HAL_ERROR;
		1179	}
		1180	else
		1181	{
		1182	/* Enable MMC DMA transfer */
		1183	__HAL_MMC_DMA_ENABLE(hmmc);
		1184
		1185	/* Configure the MMC DPSM (Data Path State Machine) */
		1186	config.DataTimeOut = SDMMC_DATATIMEOUT;
		1187	config.DataLength = MMC_BLOCKSIZE * NumberOfBlocks;
		1188	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		1189	config.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
		1190	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		1191	config.DPSM = SDIO_DPSM_ENABLE;
		1192	(void)SDIO_ConfigData(hmmc->Instance, &config);
		1193
		1194	/* Read Blocks in DMA mode */
		1195	if(NumberOfBlocks > 1U)
		1196	{
		1197	hmmc->Context = (MMC_CONTEXT_READ_MULTIPLE_BLOCK \| MMC_CONTEXT_DMA);
		1198
		1199	/* Read Multi Block command */
		1200	errorstate = SDMMC_CmdReadMultiBlock(hmmc->Instance, add);
		1201	}
		1202	else
		1203	{
		1204	hmmc->Context = (MMC_CONTEXT_READ_SINGLE_BLOCK \| MMC_CONTEXT_DMA);
		1205
		1206	/* Read Single Block command */
		1207	errorstate = SDMMC_CmdReadSingleBlock(hmmc->Instance, add);
		1208	}
		1209	if(errorstate != HAL_MMC_ERROR_NONE)
		1210	{
		1211	/* Clear all the static flags */
		1212	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1213	__HAL_MMC_DISABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_RXOVERR \| SDIO_IT_DATAEND));
		1214	hmmc->ErrorCode = errorstate;
		1215	hmmc->State = HAL_MMC_STATE_READY;
		1216	return HAL_ERROR;
		1217	}
		1218
		1219	return HAL_OK;
		1220	}
		1221	}
		1222	else
		1223	{
		1224	return HAL_BUSY;
		1225	}
		1226	}
		1227
		1228	/**
		1229	* @brief Writes block(s) to a specified address in a card. The Data transfer
		1230	* is managed by DMA mode.
		1231	* @note This API should be followed by a check on the card state through
		1232	* HAL_MMC_GetCardState().
		1233	* @note You could also check the DMA transfer process through the MMC Tx
		1234	* interrupt event.
		1235	* @param hmmc: Pointer to MMC handle
		1236	* @param pData: Pointer to the buffer that will contain the data to transmit
		1237	* @param BlockAdd: Block Address where data will be written
		1238	* @param NumberOfBlocks: Number of blocks to write
		1239	* @retval HAL status
		1240	*/
		1241	HAL_StatusTypeDef HAL_MMC_WriteBlocks_DMA(MMC_HandleTypeDef hmmc, uint8_t pData, uint32_t BlockAdd, uint32_t NumberOfBlocks)
		1242	{
		1243	SDIO_DataInitTypeDef config;
		1244	uint32_t errorstate;
		1245	uint32_t add = BlockAdd;
		1246
		1247	if(NULL == pData)
		1248	{
		1249	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		1250	return HAL_ERROR;
		1251	}
		1252
		1253	if(hmmc->State == HAL_MMC_STATE_READY)
		1254	{
		1255	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		1256
		1257	if((BlockAdd + NumberOfBlocks) > (hmmc->MmcCard.LogBlockNbr))
		1258	{
		1259	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		1260	return HAL_ERROR;
		1261	}
		1262
		1263	hmmc->State = HAL_MMC_STATE_BUSY;
		1264
		1265	/* Initialize data control register */
		1266	hmmc->Instance->DCTRL = 0U;
		1267
		1268	/* Enable MMC Error interrupts */
		1269	__HAL_MMC_ENABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_TXUNDERR));
		1270
		1271	/* Set the DMA transfer complete callback */
		1272	hmmc->hdmatx->XferCpltCallback = MMC_DMATransmitCplt;
		1273
		1274	/* Set the DMA error callback */
		1275	hmmc->hdmatx->XferErrorCallback = MMC_DMAError;
		1276
		1277	/* Set the DMA Abort callback */
		1278	hmmc->hdmatx->XferAbortCallback = NULL;
		1279
		1280	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		1281	{
		1282	add *= 512U;
		1283	}
		1284
		1285
		1286	/* Write Blocks in Polling mode */
		1287	if(NumberOfBlocks > 1U)
		1288	{
		1289	hmmc->Context = (MMC_CONTEXT_WRITE_MULTIPLE_BLOCK \| MMC_CONTEXT_DMA);
		1290
		1291	/* Write Multi Block command */
		1292	errorstate = SDMMC_CmdWriteMultiBlock(hmmc->Instance, add);
		1293	}
		1294	else
		1295	{
		1296	hmmc->Context = (MMC_CONTEXT_WRITE_SINGLE_BLOCK \| MMC_CONTEXT_DMA);
		1297
		1298	/* Write Single Block command */
		1299	errorstate = SDMMC_CmdWriteSingleBlock(hmmc->Instance, add);
		1300	}
		1301	if(errorstate != HAL_MMC_ERROR_NONE)
		1302	{
		1303	/* Clear all the static flags */
		1304	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1305	__HAL_MMC_DISABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_TXUNDERR \| SDIO_IT_DATAEND));
		1306	hmmc->ErrorCode \|= errorstate;
		1307	hmmc->State = HAL_MMC_STATE_READY;
		1308	return HAL_ERROR;
		1309	}
		1310
		1311	/* Enable SDIO DMA transfer */
		1312	__HAL_MMC_DMA_ENABLE(hmmc);
		1313
		1314	/* Force DMA Direction */
		1315	hmmc->hdmatx->Init.Direction = DMA_MEMORY_TO_PERIPH;
		1316	MODIFY_REG(hmmc->hdmatx->Instance->CCR, DMA_CCR_DIR, hmmc->hdmatx->Init.Direction);
		1317
		1318	/* Enable the DMA Channel */
		1319	if(HAL_DMA_Start_IT(hmmc->hdmatx, (uint32_t)pData, (uint32_t)&hmmc->Instance->FIFO, (uint32_t)(MMC_BLOCKSIZE * NumberOfBlocks)/4) != HAL_OK)
		1320	{
		1321	__HAL_MMC_DISABLE_IT(hmmc, (SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT \| SDIO_IT_TXUNDERR \| SDIO_IT_DATAEND));
		1322	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1323	hmmc->ErrorCode \|= HAL_MMC_ERROR_DMA;
		1324	hmmc->State = HAL_MMC_STATE_READY;
		1325	return HAL_ERROR;
		1326	}
		1327	else
		1328	{
		1329	/* Configure the MMC DPSM (Data Path State Machine) */
		1330	config.DataTimeOut = SDMMC_DATATIMEOUT;
		1331	config.DataLength = MMC_BLOCKSIZE * NumberOfBlocks;
		1332	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		1333	config.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;
		1334	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		1335	config.DPSM = SDIO_DPSM_ENABLE;
		1336	(void)SDIO_ConfigData(hmmc->Instance, &config);
		1337
		1338	return HAL_OK;
		1339	}
		1340	}
		1341	else
		1342	{
		1343	return HAL_BUSY;
		1344	}
		1345	}
		1346
		1347	/**
		1348	* @brief Erases the specified memory area of the given MMC card.
		1349	* @note This API should be followed by a check on the card state through
		1350	* HAL_MMC_GetCardState().
		1351	* @param hmmc: Pointer to MMC handle
		1352	* @param BlockStartAdd: Start Block address
		1353	* @param BlockEndAdd: End Block address
		1354	* @retval HAL status
		1355	*/
		1356	HAL_StatusTypeDef HAL_MMC_Erase(MMC_HandleTypeDef *hmmc, uint32_t BlockStartAdd, uint32_t BlockEndAdd)
		1357	{
		1358	uint32_t errorstate;
		1359	uint32_t start_add = BlockStartAdd;
		1360	uint32_t end_add = BlockEndAdd;
		1361
		1362	if(hmmc->State == HAL_MMC_STATE_READY)
		1363	{
		1364	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		1365
		1366	if(end_add < start_add)
		1367	{
		1368	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		1369	return HAL_ERROR;
		1370	}
		1371
		1372	if(end_add > (hmmc->MmcCard.LogBlockNbr))
		1373	{
		1374	hmmc->ErrorCode \|= HAL_MMC_ERROR_ADDR_OUT_OF_RANGE;
		1375	return HAL_ERROR;
		1376	}
		1377
		1378	hmmc->State = HAL_MMC_STATE_BUSY;
		1379
		1380	/* Check if the card command class supports erase command */
		1381	if(((hmmc->MmcCard.Class) & SDIO_CCCC_ERASE) == 0U)
		1382	{
		1383	/* Clear all the static flags */
		1384	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1385	hmmc->ErrorCode \|= HAL_MMC_ERROR_REQUEST_NOT_APPLICABLE;
		1386	hmmc->State = HAL_MMC_STATE_READY;
		1387	return HAL_ERROR;
		1388	}
		1389
		1390	if((SDIO_GetResponse(hmmc->Instance, SDIO_RESP1) & SDMMC_CARD_LOCKED) == SDMMC_CARD_LOCKED)
		1391	{
		1392	/* Clear all the static flags */
		1393	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1394	hmmc->ErrorCode \|= HAL_MMC_ERROR_LOCK_UNLOCK_FAILED;
		1395	hmmc->State = HAL_MMC_STATE_READY;
		1396	return HAL_ERROR;
		1397	}
		1398
		1399	if ((hmmc->MmcCard.CardType) != MMC_HIGH_CAPACITY_CARD)
		1400	{
		1401	start_add *= 512U;
		1402	end_add *= 512U;
		1403	}
		1404
		1405	/* Send CMD35 MMC_ERASE_GRP_START with argument as addr */
		1406	errorstate = SDMMC_CmdEraseStartAdd(hmmc->Instance, start_add);
		1407	if(errorstate != HAL_MMC_ERROR_NONE)
		1408	{
		1409	/* Clear all the static flags */
		1410	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1411	hmmc->ErrorCode \|= errorstate;
		1412	hmmc->State = HAL_MMC_STATE_READY;
		1413	return HAL_ERROR;
		1414	}
		1415
		1416	/* Send CMD36 MMC_ERASE_GRP_END with argument as addr */
		1417	errorstate = SDMMC_CmdEraseEndAdd(hmmc->Instance, end_add);
		1418	if(errorstate != HAL_MMC_ERROR_NONE)
		1419	{
		1420	/* Clear all the static flags */
		1421	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1422	hmmc->ErrorCode \|= errorstate;
		1423	hmmc->State = HAL_MMC_STATE_READY;
		1424	return HAL_ERROR;
		1425	}
		1426
		1427	/* Send CMD38 ERASE */
		1428	errorstate = SDMMC_CmdErase(hmmc->Instance);
		1429	if(errorstate != HAL_MMC_ERROR_NONE)
		1430	{
		1431	/* Clear all the static flags */
		1432	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		1433	hmmc->ErrorCode \|= errorstate;
		1434	hmmc->State = HAL_MMC_STATE_READY;
		1435	return HAL_ERROR;
		1436	}
		1437
		1438	hmmc->State = HAL_MMC_STATE_READY;
		1439
		1440	return HAL_OK;
		1441	}
		1442	else
		1443	{
		1444	return HAL_BUSY;
		1445	}
		1446	}
		1447
		1448	/**
		1449	* @brief This function handles MMC card interrupt request.
		1450	* @param hmmc: Pointer to MMC handle
		1451	* @retval None
		1452	*/
		1453	void HAL_MMC_IRQHandler(MMC_HandleTypeDef *hmmc)
		1454	{
		1455	uint32_t errorstate;
		1456	uint32_t context = hmmc->Context;
		1457
		1458	/* Check for SDIO interrupt flags */
		1459	if((__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXFIFOHF) != RESET) && ((context & MMC_CONTEXT_IT) != 0U))
		1460	{
		1461	MMC_Read_IT(hmmc);
		1462	}
		1463
		1464	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DATAEND) != RESET)
		1465	{
		1466	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_FLAG_DATAEND);
		1467
		1468	__HAL_MMC_DISABLE_IT(hmmc, SDIO_IT_DATAEND \| SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT\|\
		1469	SDIO_IT_TXUNDERR\| SDIO_IT_RXOVERR);
		1470
		1471	hmmc->Instance->DCTRL &= ~(SDIO_DCTRL_DTEN);
		1472
		1473	if((context & MMC_CONTEXT_DMA) != 0U)
		1474	{
		1475	if((context & MMC_CONTEXT_WRITE_MULTIPLE_BLOCK) != 0U)
		1476	{
		1477	errorstate = SDMMC_CmdStopTransfer(hmmc->Instance);
		1478	if(errorstate != HAL_MMC_ERROR_NONE)
		1479	{
		1480	hmmc->ErrorCode \|= errorstate;
		1481	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1482	hmmc->ErrorCallback(hmmc);
		1483	#else
		1484	HAL_MMC_ErrorCallback(hmmc);
		1485	#endif
		1486	}
		1487	}
		1488	if(((context & MMC_CONTEXT_READ_SINGLE_BLOCK) == 0U) && ((context & MMC_CONTEXT_READ_MULTIPLE_BLOCK) == 0U))
		1489	{
		1490	/* Disable the DMA transfer for transmit request by setting the DMAEN bit
		1491	in the MMC DCTRL register */
		1492	hmmc->Instance->DCTRL &= (uint32_t)~((uint32_t)SDIO_DCTRL_DMAEN);
		1493
		1494	hmmc->State = HAL_MMC_STATE_READY;
		1495
		1496	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1497	hmmc->TxCpltCallback(hmmc);
		1498	#else
		1499	HAL_MMC_TxCpltCallback(hmmc);
		1500	#endif
		1501	}
		1502	}
		1503	else if((context & MMC_CONTEXT_IT) != 0U)
		1504	{
		1505	/* Stop Transfer for Write Multi blocks or Read Multi blocks */
		1506	if(((context & MMC_CONTEXT_READ_MULTIPLE_BLOCK) != 0U) \|\| ((context & MMC_CONTEXT_WRITE_MULTIPLE_BLOCK) != 0U))
		1507	{
		1508	errorstate = SDMMC_CmdStopTransfer(hmmc->Instance);
		1509	if(errorstate != HAL_MMC_ERROR_NONE)
		1510	{
		1511	hmmc->ErrorCode \|= errorstate;
		1512	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1513	hmmc->ErrorCallback(hmmc);
		1514	#else
		1515	HAL_MMC_ErrorCallback(hmmc);
		1516	#endif
		1517	}
		1518	}
		1519
		1520	/* Clear all the static flags */
		1521	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		1522
		1523	hmmc->State = HAL_MMC_STATE_READY;
		1524	if(((context & MMC_CONTEXT_READ_SINGLE_BLOCK) != 0U) \|\| ((context & MMC_CONTEXT_READ_MULTIPLE_BLOCK) != 0U))
		1525	{
		1526	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1527	hmmc->RxCpltCallback(hmmc);
		1528	#else
		1529	HAL_MMC_RxCpltCallback(hmmc);
		1530	#endif
		1531	}
		1532	else
		1533	{
		1534	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1535	hmmc->TxCpltCallback(hmmc);
		1536	#else
		1537	HAL_MMC_TxCpltCallback(hmmc);
		1538	#endif
		1539	}
		1540	}
		1541	else
		1542	{
		1543	/* Nothing to do */
		1544	}
		1545	}
		1546
		1547	else if((__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_TXFIFOHE) != RESET) && ((context & MMC_CONTEXT_IT) != 0U))
		1548	{
		1549	MMC_Write_IT(hmmc);
		1550	}
		1551
		1552	else if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DCRCFAIL \| SDIO_FLAG_DTIMEOUT \| SDIO_FLAG_RXOVERR \| SDIO_FLAG_TXUNDERR) != RESET)
		1553	{
		1554	/* Set Error code */
		1555	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DCRCFAIL) != RESET)
		1556	{
		1557	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_CRC_FAIL;
		1558	}
		1559	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_DTIMEOUT) != RESET)
		1560	{
		1561	hmmc->ErrorCode \|= HAL_MMC_ERROR_DATA_TIMEOUT;
		1562	}
		1563	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXOVERR) != RESET)
		1564	{
		1565	hmmc->ErrorCode \|= HAL_MMC_ERROR_RX_OVERRUN;
		1566	}
		1567	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_TXUNDERR) != RESET)
		1568	{
		1569	hmmc->ErrorCode \|= HAL_MMC_ERROR_TX_UNDERRUN;
		1570	}
		1571
		1572	/* Clear All flags */
		1573	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS \| SDIO_FLAG_STBITERR);
		1574
		1575	/* Disable all interrupts */
		1576	__HAL_MMC_DISABLE_IT(hmmc, SDIO_IT_DATAEND \| SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT\|\
		1577	SDIO_IT_TXUNDERR\| SDIO_IT_RXOVERR \| SDIO_IT_STBITERR);
		1578
		1579	hmmc->ErrorCode \|= SDMMC_CmdStopTransfer(hmmc->Instance);
		1580
		1581	if((context & MMC_CONTEXT_IT) != 0U)
		1582	{
		1583	/* Set the MMC state to ready to be able to start again the process */
		1584	hmmc->State = HAL_MMC_STATE_READY;
		1585	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1586	hmmc->ErrorCallback(hmmc);
		1587	#else
		1588	HAL_MMC_ErrorCallback(hmmc);
		1589	#endif /* USE_HAL_MMC_REGISTER_CALLBACKS */
		1590	}
		1591	else if((context & MMC_CONTEXT_DMA) != 0U)
		1592	{
		1593	/* Abort the MMC DMA Streams */
		1594	if(hmmc->hdmatx != NULL)
		1595	{
		1596	/* Set the DMA Tx abort callback */
		1597	hmmc->hdmatx->XferAbortCallback = MMC_DMATxAbort;
		1598	/* Abort DMA in IT mode */
		1599	if(HAL_DMA_Abort_IT(hmmc->hdmatx) != HAL_OK)
		1600	{
		1601	MMC_DMATxAbort(hmmc->hdmatx);
		1602	}
		1603	}
		1604	else if(hmmc->hdmarx != NULL)
		1605	{
		1606	/* Set the DMA Rx abort callback */
		1607	hmmc->hdmarx->XferAbortCallback = MMC_DMARxAbort;
		1608	/* Abort DMA in IT mode */
		1609	if(HAL_DMA_Abort_IT(hmmc->hdmarx) != HAL_OK)
		1610	{
		1611	MMC_DMARxAbort(hmmc->hdmarx);
		1612	}
		1613	}
		1614	else
		1615	{
		1616	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		1617	hmmc->State = HAL_MMC_STATE_READY;
		1618	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1619	hmmc->AbortCpltCallback(hmmc);
		1620	#else
		1621	HAL_MMC_AbortCallback(hmmc);
		1622	#endif
		1623	}
		1624	}
		1625	else
		1626	{
		1627	/* Nothing to do */
		1628	}
		1629	}
		1630
		1631	else
		1632	{
		1633	/* Nothing to do */
		1634	}
		1635	}
		1636
		1637	/**
		1638	* @brief return the MMC state
		1639	* @param hmmc: Pointer to mmc handle
		1640	* @retval HAL state
		1641	*/
		1642	HAL_MMC_StateTypeDef HAL_MMC_GetState(MMC_HandleTypeDef *hmmc)
		1643	{
		1644	return hmmc->State;
		1645	}
		1646
		1647	/**
		1648	* @brief Return the MMC error code
		1649	* @param hmmc : Pointer to a MMC_HandleTypeDef structure that contains
		1650	* the configuration information.
		1651	* @retval MMC Error Code
		1652	*/
		1653	uint32_t HAL_MMC_GetError(MMC_HandleTypeDef *hmmc)
		1654	{
		1655	return hmmc->ErrorCode;
		1656	}
		1657
		1658	/**
		1659	* @brief Tx Transfer completed callbacks
		1660	* @param hmmc: Pointer to MMC handle
		1661	* @retval None
		1662	*/
		1663	__weak void HAL_MMC_TxCpltCallback(MMC_HandleTypeDef *hmmc)
		1664	{
		1665	/* Prevent unused argument(s) compilation warning */
		1666	UNUSED(hmmc);
		1667
		1668	/* NOTE : This function should not be modified, when the callback is needed,
		1669	the HAL_MMC_TxCpltCallback can be implemented in the user file
		1670	*/
		1671	}
		1672
		1673	/**
		1674	* @brief Rx Transfer completed callbacks
		1675	* @param hmmc: Pointer MMC handle
		1676	* @retval None
		1677	*/
		1678	__weak void HAL_MMC_RxCpltCallback(MMC_HandleTypeDef *hmmc)
		1679	{
		1680	/* Prevent unused argument(s) compilation warning */
		1681	UNUSED(hmmc);
		1682
		1683	/* NOTE : This function should not be modified, when the callback is needed,
		1684	the HAL_MMC_RxCpltCallback can be implemented in the user file
		1685	*/
		1686	}
		1687
		1688	/**
		1689	* @brief MMC error callbacks
		1690	* @param hmmc: Pointer MMC handle
		1691	* @retval None
		1692	*/
		1693	__weak void HAL_MMC_ErrorCallback(MMC_HandleTypeDef *hmmc)
		1694	{
		1695	/* Prevent unused argument(s) compilation warning */
		1696	UNUSED(hmmc);
		1697
		1698	/* NOTE : This function should not be modified, when the callback is needed,
		1699	the HAL_MMC_ErrorCallback can be implemented in the user file
		1700	*/
		1701	}
		1702
		1703	/**
		1704	* @brief MMC Abort callbacks
		1705	* @param hmmc: Pointer MMC handle
		1706	* @retval None
		1707	*/
		1708	__weak void HAL_MMC_AbortCallback(MMC_HandleTypeDef *hmmc)
		1709	{
		1710	/* Prevent unused argument(s) compilation warning */
		1711	UNUSED(hmmc);
		1712
		1713	/* NOTE : This function should not be modified, when the callback is needed,
		1714	the HAL_MMC_AbortCallback can be implemented in the user file
		1715	*/
		1716	}
		1717
		1718	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		1719	/**
		1720	* @brief Register a User MMC Callback
		1721	* To be used instead of the weak (surcharged) predefined callback
		1722	* @param hmmc : MMC handle
		1723	* @param CallbackId : ID of the callback to be registered
		1724	* This parameter can be one of the following values:
		1725	* @arg @ref HAL_MMC_TX_CPLT_CB_ID MMC Tx Complete Callback ID
		1726	* @arg @ref HAL_MMC_RX_CPLT_CB_ID MMC Rx Complete Callback ID
		1727	* @arg @ref HAL_MMC_ERROR_CB_ID MMC Error Callback ID
		1728	* @arg @ref HAL_MMC_ABORT_CB_ID MMC Abort Callback ID
		1729	* @arg @ref HAL_MMC_MSP_INIT_CB_ID MMC MspInit Callback ID
		1730	* @arg @ref HAL_MMC_MSP_DEINIT_CB_ID MMC MspDeInit Callback ID
		1731	* @param pCallback : pointer to the Callback function
		1732	* @retval status
		1733	*/
		1734	HAL_StatusTypeDef HAL_MMC_RegisterCallback(MMC_HandleTypeDef *hmmc, HAL_MMC_CallbackIDTypeDef CallbackId, pMMC_CallbackTypeDef pCallback)
		1735	{
		1736	HAL_StatusTypeDef status = HAL_OK;
		1737
		1738	if(pCallback == NULL)
		1739	{
		1740	/* Update the error code */
		1741	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1742	return HAL_ERROR;
		1743	}
		1744
		1745	/* Process locked */
		1746	__HAL_LOCK(hmmc);
		1747
		1748	if(hmmc->State == HAL_MMC_STATE_READY)
		1749	{
		1750	switch (CallbackId)
		1751	{
		1752	case HAL_MMC_TX_CPLT_CB_ID :
		1753	hmmc->TxCpltCallback = pCallback;
		1754	break;
		1755	case HAL_MMC_RX_CPLT_CB_ID :
		1756	hmmc->RxCpltCallback = pCallback;
		1757	break;
		1758	case HAL_MMC_ERROR_CB_ID :
		1759	hmmc->ErrorCallback = pCallback;
		1760	break;
		1761	case HAL_MMC_ABORT_CB_ID :
		1762	hmmc->AbortCpltCallback = pCallback;
		1763	break;
		1764	case HAL_MMC_MSP_INIT_CB_ID :
		1765	hmmc->MspInitCallback = pCallback;
		1766	break;
		1767	case HAL_MMC_MSP_DEINIT_CB_ID :
		1768	hmmc->MspDeInitCallback = pCallback;
		1769	break;
		1770	default :
		1771	/* Update the error code */
		1772	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1773	/* update return status */
		1774	status = HAL_ERROR;
		1775	break;
		1776	}
		1777	}
		1778	else if (hmmc->State == HAL_MMC_STATE_RESET)
		1779	{
		1780	switch (CallbackId)
		1781	{
		1782	case HAL_MMC_MSP_INIT_CB_ID :
		1783	hmmc->MspInitCallback = pCallback;
		1784	break;
		1785	case HAL_MMC_MSP_DEINIT_CB_ID :
		1786	hmmc->MspDeInitCallback = pCallback;
		1787	break;
		1788	default :
		1789	/* Update the error code */
		1790	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1791	/* update return status */
		1792	status = HAL_ERROR;
		1793	break;
		1794	}
		1795	}
		1796	else
		1797	{
		1798	/* Update the error code */
		1799	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1800	/* update return status */
		1801	status = HAL_ERROR;
		1802	}
		1803
		1804	/* Release Lock */
		1805	__HAL_UNLOCK(hmmc);
		1806	return status;
		1807	}
		1808
		1809	/**
		1810	* @brief Unregister a User MMC Callback
		1811	* MMC Callback is redirected to the weak (surcharged) predefined callback
		1812	* @param hmmc : MMC handle
		1813	* @param CallbackId : ID of the callback to be unregistered
		1814	* This parameter can be one of the following values:
		1815	* @arg @ref HAL_MMC_TX_CPLT_CB_ID MMC Tx Complete Callback ID
		1816	* @arg @ref HAL_MMC_RX_CPLT_CB_ID MMC Rx Complete Callback ID
		1817	* @arg @ref HAL_MMC_ERROR_CB_ID MMC Error Callback ID
		1818	* @arg @ref HAL_MMC_ABORT_CB_ID MMC Abort Callback ID
		1819	* @arg @ref HAL_MMC_MSP_INIT_CB_ID MMC MspInit Callback ID
		1820	* @arg @ref HAL_MMC_MSP_DEINIT_CB_ID MMC MspDeInit Callback ID
		1821	* @retval status
		1822	*/
		1823	HAL_StatusTypeDef HAL_MMC_UnRegisterCallback(MMC_HandleTypeDef *hmmc, HAL_MMC_CallbackIDTypeDef CallbackId)
		1824	{
		1825	HAL_StatusTypeDef status = HAL_OK;
		1826
		1827	/* Process locked */
		1828	__HAL_LOCK(hmmc);
		1829
		1830	if(hmmc->State == HAL_MMC_STATE_READY)
		1831	{
		1832	switch (CallbackId)
		1833	{
		1834	case HAL_MMC_TX_CPLT_CB_ID :
		1835	hmmc->TxCpltCallback = HAL_MMC_TxCpltCallback;
		1836	break;
		1837	case HAL_MMC_RX_CPLT_CB_ID :
		1838	hmmc->RxCpltCallback = HAL_MMC_RxCpltCallback;
		1839	break;
		1840	case HAL_MMC_ERROR_CB_ID :
		1841	hmmc->ErrorCallback = HAL_MMC_ErrorCallback;
		1842	break;
		1843	case HAL_MMC_ABORT_CB_ID :
		1844	hmmc->AbortCpltCallback = HAL_MMC_AbortCallback;
		1845	break;
		1846	case HAL_MMC_MSP_INIT_CB_ID :
		1847	hmmc->MspInitCallback = HAL_MMC_MspInit;
		1848	break;
		1849	case HAL_MMC_MSP_DEINIT_CB_ID :
		1850	hmmc->MspDeInitCallback = HAL_MMC_MspDeInit;
		1851	break;
		1852	default :
		1853	/* Update the error code */
		1854	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1855	/* update return status */
		1856	status = HAL_ERROR;
		1857	break;
		1858	}
		1859	}
		1860	else if (hmmc->State == HAL_MMC_STATE_RESET)
		1861	{
		1862	switch (CallbackId)
		1863	{
		1864	case HAL_MMC_MSP_INIT_CB_ID :
		1865	hmmc->MspInitCallback = HAL_MMC_MspInit;
		1866	break;
		1867	case HAL_MMC_MSP_DEINIT_CB_ID :
		1868	hmmc->MspDeInitCallback = HAL_MMC_MspDeInit;
		1869	break;
		1870	default :
		1871	/* Update the error code */
		1872	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1873	/* update return status */
		1874	status = HAL_ERROR;
		1875	break;
		1876	}
		1877	}
		1878	else
		1879	{
		1880	/* Update the error code */
		1881	hmmc->ErrorCode \|= HAL_MMC_ERROR_INVALID_CALLBACK;
		1882	/* update return status */
		1883	status = HAL_ERROR;
		1884	}
		1885
		1886	/* Release Lock */
		1887	__HAL_UNLOCK(hmmc);
		1888	return status;
		1889	}
		1890	#endif
		1891
		1892	/**
		1893	* @}
		1894	*/
		1895
		1896	/** @addtogroup MMC_Exported_Functions_Group3
		1897	* @brief management functions
		1898	*
		1899	@verbatim
		1900	==============================================================================
		1901	##### Peripheral Control functions #####
		1902	==============================================================================
		1903	[..]
		1904	This subsection provides a set of functions allowing to control the MMC card
		1905	operations and get the related information
		1906
		1907	@endverbatim
		1908	* @{
		1909	*/
		1910
		1911	/**
		1912	* @brief Returns information the information of the card which are stored on
		1913	* the CID register.
		1914	* @param hmmc: Pointer to MMC handle
		1915	* @param pCID: Pointer to a HAL_MMC_CIDTypedef structure that
		1916	* contains all CID register parameters
		1917	* @retval HAL status
		1918	*/
		1919	HAL_StatusTypeDef HAL_MMC_GetCardCID(MMC_HandleTypeDef hmmc, HAL_MMC_CardCIDTypeDef pCID)
		1920	{
		1921	pCID->ManufacturerID = (uint8_t)((hmmc->CID[0] & 0xFF000000U) >> 24U);
		1922
		1923	pCID->OEM_AppliID = (uint16_t)((hmmc->CID[0] & 0x00FFFF00U) >> 8U);
		1924
		1925	pCID->ProdName1 = (((hmmc->CID[0] & 0x000000FFU) << 24U) \| ((hmmc->CID[1] & 0xFFFFFF00U) >> 8U));
		1926
		1927	pCID->ProdName2 = (uint8_t)(hmmc->CID[1] & 0x000000FFU);
		1928
		1929	pCID->ProdRev = (uint8_t)((hmmc->CID[2] & 0xFF000000U) >> 24U);
		1930
		1931	pCID->ProdSN = (((hmmc->CID[2] & 0x00FFFFFFU) << 8U) \| ((hmmc->CID[3] & 0xFF000000U) >> 24U));
		1932
		1933	pCID->Reserved1 = (uint8_t)((hmmc->CID[3] & 0x00F00000U) >> 20U);
		1934
		1935	pCID->ManufactDate = (uint16_t)((hmmc->CID[3] & 0x000FFF00U) >> 8U);
		1936
		1937	pCID->CID_CRC = (uint8_t)((hmmc->CID[3] & 0x000000FEU) >> 1U);
		1938
		1939	pCID->Reserved2 = 1U;
		1940
		1941	return HAL_OK;
		1942	}
		1943
		1944	/**
		1945	* @brief Returns information the information of the card which are stored on
		1946	* the CSD register.
		1947	* @param hmmc: Pointer to MMC handle
		1948	* @param pCSD: Pointer to a HAL_MMC_CardCSDTypeDef structure that
		1949	* contains all CSD register parameters
		1950	* @retval HAL status
		1951	*/
		1952	HAL_StatusTypeDef HAL_MMC_GetCardCSD(MMC_HandleTypeDef hmmc, HAL_MMC_CardCSDTypeDef pCSD)
		1953	{
		1954	uint32_t block_nbr = 0;
		1955
		1956	pCSD->CSDStruct = (uint8_t)((hmmc->CSD[0] & 0xC0000000U) >> 30U);
		1957
		1958	pCSD->SysSpecVersion = (uint8_t)((hmmc->CSD[0] & 0x3C000000U) >> 26U);
		1959
		1960	pCSD->Reserved1 = (uint8_t)((hmmc->CSD[0] & 0x03000000U) >> 24U);
		1961
		1962	pCSD->TAAC = (uint8_t)((hmmc->CSD[0] & 0x00FF0000U) >> 16U);
		1963
		1964	pCSD->NSAC = (uint8_t)((hmmc->CSD[0] & 0x0000FF00U) >> 8U);
		1965
		1966	pCSD->MaxBusClkFrec = (uint8_t)(hmmc->CSD[0] & 0x000000FFU);
		1967
		1968	pCSD->CardComdClasses = (uint16_t)((hmmc->CSD[1] & 0xFFF00000U) >> 20U);
		1969
		1970	pCSD->RdBlockLen = (uint8_t)((hmmc->CSD[1] & 0x000F0000U) >> 16U);
		1971
		1972	pCSD->PartBlockRead = (uint8_t)((hmmc->CSD[1] & 0x00008000U) >> 15U);
		1973
		1974	pCSD->WrBlockMisalign = (uint8_t)((hmmc->CSD[1] & 0x00004000U) >> 14U);
		1975
		1976	pCSD->RdBlockMisalign = (uint8_t)((hmmc->CSD[1] & 0x00002000U) >> 13U);
		1977
		1978	pCSD->DSRImpl = (uint8_t)((hmmc->CSD[1] & 0x00001000U) >> 12U);
		1979
		1980	pCSD->Reserved2 = 0U; /!< Reserved /
		1981
		1982	pCSD->DeviceSize = (((hmmc->CSD[1] & 0x000003FFU) << 2U) \| ((hmmc->CSD[2] & 0xC0000000U) >> 30U));
		1983
		1984	pCSD->MaxRdCurrentVDDMin = (uint8_t)((hmmc->CSD[2] & 0x38000000U) >> 27U);
		1985
		1986	pCSD->MaxRdCurrentVDDMax = (uint8_t)((hmmc->CSD[2] & 0x07000000U) >> 24U);
		1987
		1988	pCSD->MaxWrCurrentVDDMin = (uint8_t)((hmmc->CSD[2] & 0x00E00000U) >> 21U);
		1989
		1990	pCSD->MaxWrCurrentVDDMax = (uint8_t)((hmmc->CSD[2] & 0x001C0000U) >> 18U);
		1991
		1992	pCSD->DeviceSizeMul = (uint8_t)((hmmc->CSD[2] & 0x00038000U) >> 15U);
		1993
		1994	if(MMC_ReadExtCSD(hmmc, &block_nbr, 212, 0x0FFFFFFFU) != HAL_OK) /* Field SEC_COUNT [215:212] */
		1995	{
		1996	return HAL_ERROR;
		1997	}
		1998
		1999	if(hmmc->MmcCard.CardType == MMC_LOW_CAPACITY_CARD)
		2000	{
		2001	hmmc->MmcCard.BlockNbr = (pCSD->DeviceSize + 1U) ;
		2002	hmmc->MmcCard.BlockNbr *= (1UL << ((pCSD->DeviceSizeMul & 0x07U) + 2U));
		2003	hmmc->MmcCard.BlockSize = (1UL << (pCSD->RdBlockLen & 0x0FU));
		2004	hmmc->MmcCard.LogBlockNbr = (hmmc->MmcCard.BlockNbr) * ((hmmc->MmcCard.BlockSize) / 512U);
		2005	hmmc->MmcCard.LogBlockSize = 512U;
		2006	}
		2007	else if(hmmc->MmcCard.CardType == MMC_HIGH_CAPACITY_CARD)
		2008	{
		2009	hmmc->MmcCard.BlockNbr = block_nbr;
		2010	hmmc->MmcCard.LogBlockNbr = hmmc->MmcCard.BlockNbr;
		2011	hmmc->MmcCard.BlockSize = 512U;
		2012	hmmc->MmcCard.LogBlockSize = hmmc->MmcCard.BlockSize;
		2013	}
		2014	else
		2015	{
		2016	/* Clear all the static flags */
		2017	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		2018	hmmc->ErrorCode \|= HAL_MMC_ERROR_UNSUPPORTED_FEATURE;
		2019	hmmc->State = HAL_MMC_STATE_READY;
		2020	return HAL_ERROR;
		2021	}
		2022
		2023	pCSD->EraseGrSize = (uint8_t)((hmmc->CSD[2] & 0x00004000U) >> 14U);
		2024
		2025	pCSD->EraseGrMul = (uint8_t)((hmmc->CSD[2] & 0x00003F80U) >> 7U);
		2026
		2027	pCSD->WrProtectGrSize = (uint8_t)(hmmc->CSD[2] & 0x0000007FU);
		2028
		2029	pCSD->WrProtectGrEnable = (uint8_t)((hmmc->CSD[3] & 0x80000000U) >> 31U);
		2030
		2031	pCSD->ManDeflECC = (uint8_t)((hmmc->CSD[3] & 0x60000000U) >> 29U);
		2032
		2033	pCSD->WrSpeedFact = (uint8_t)((hmmc->CSD[3] & 0x1C000000U) >> 26U);
		2034
		2035	pCSD->MaxWrBlockLen= (uint8_t)((hmmc->CSD[3] & 0x03C00000U) >> 22U);
		2036
		2037	pCSD->WriteBlockPaPartial = (uint8_t)((hmmc->CSD[3] & 0x00200000U) >> 21U);
		2038
		2039	pCSD->Reserved3 = 0;
		2040
		2041	pCSD->ContentProtectAppli = (uint8_t)((hmmc->CSD[3] & 0x00010000U) >> 16U);
		2042
		2043	pCSD->FileFormatGroup = (uint8_t)((hmmc->CSD[3] & 0x00008000U) >> 15U);
		2044
		2045	pCSD->CopyFlag = (uint8_t)((hmmc->CSD[3] & 0x00004000U) >> 14U);
		2046
		2047	pCSD->PermWrProtect = (uint8_t)((hmmc->CSD[3] & 0x00002000U) >> 13U);
		2048
		2049	pCSD->TempWrProtect = (uint8_t)((hmmc->CSD[3] & 0x00001000U) >> 12U);
		2050
		2051	pCSD->FileFormat = (uint8_t)((hmmc->CSD[3] & 0x00000C00U) >> 10U);
		2052
		2053	pCSD->ECC= (uint8_t)((hmmc->CSD[3] & 0x00000300U) >> 8U);
		2054
		2055	pCSD->CSD_CRC = (uint8_t)((hmmc->CSD[3] & 0x000000FEU) >> 1U);
		2056
		2057	pCSD->Reserved4 = 1;
		2058
		2059	return HAL_OK;
		2060	}
		2061
		2062	/**
		2063	* @brief Gets the MMC card info.
		2064	* @param hmmc: Pointer to MMC handle
		2065	* @param pCardInfo: Pointer to the HAL_MMC_CardInfoTypeDef structure that
		2066	* will contain the MMC card status information
		2067	* @retval HAL status
		2068	*/
		2069	HAL_StatusTypeDef HAL_MMC_GetCardInfo(MMC_HandleTypeDef hmmc, HAL_MMC_CardInfoTypeDef pCardInfo)
		2070	{
		2071	pCardInfo->CardType = (uint32_t)(hmmc->MmcCard.CardType);
		2072	pCardInfo->Class = (uint32_t)(hmmc->MmcCard.Class);
		2073	pCardInfo->RelCardAdd = (uint32_t)(hmmc->MmcCard.RelCardAdd);
		2074	pCardInfo->BlockNbr = (uint32_t)(hmmc->MmcCard.BlockNbr);
		2075	pCardInfo->BlockSize = (uint32_t)(hmmc->MmcCard.BlockSize);
		2076	pCardInfo->LogBlockNbr = (uint32_t)(hmmc->MmcCard.LogBlockNbr);
		2077	pCardInfo->LogBlockSize = (uint32_t)(hmmc->MmcCard.LogBlockSize);
		2078
		2079	return HAL_OK;
		2080	}
		2081
		2082	/**
		2083	* @brief Enables wide bus operation for the requested card if supported by
		2084	* card.
		2085	* @param hmmc: Pointer to MMC handle
		2086	* @param WideMode: Specifies the MMC card wide bus mode
		2087	* This parameter can be one of the following values:
		2088	* @arg SDIO_BUS_WIDE_8B: 8-bit data transfer
		2089	* @arg SDIO_BUS_WIDE_4B: 4-bit data transfer
		2090	* @arg SDIO_BUS_WIDE_1B: 1-bit data transfer
		2091	* @retval HAL status
		2092	*/
		2093	HAL_StatusTypeDef HAL_MMC_ConfigWideBusOperation(MMC_HandleTypeDef *hmmc, uint32_t WideMode)
		2094	{
		2095	__IO uint32_t count = 0U;
		2096	SDIO_InitTypeDef Init;
		2097	uint32_t errorstate;
		2098	uint32_t response = 0U, busy = 0U;
		2099
		2100	/* Check the parameters */
		2101	assert_param(IS_SDIO_BUS_WIDE(WideMode));
		2102
		2103	/* Change State */
		2104	hmmc->State = HAL_MMC_STATE_BUSY;
		2105
		2106	/* Update Clock for Bus mode update */
		2107	Init.ClockEdge = SDIO_CLOCK_EDGE_RISING;
		2108	Init.ClockBypass = SDIO_CLOCK_BYPASS_DISABLE;
		2109	Init.ClockPowerSave = SDIO_CLOCK_POWER_SAVE_DISABLE;
		2110	Init.BusWide = WideMode;
		2111	Init.HardwareFlowControl = SDIO_HARDWARE_FLOW_CONTROL_DISABLE;
		2112	Init.ClockDiv = SDIO_INIT_CLK_DIV;
		2113	/* Initialize SDIO*/
		2114	(void)SDIO_Init(hmmc->Instance, Init);
		2115
		2116	if(WideMode == SDIO_BUS_WIDE_8B)
		2117	{
		2118	errorstate = SDMMC_CmdSwitch(hmmc->Instance, 0x03B70200U);
		2119	if(errorstate != HAL_MMC_ERROR_NONE)
		2120	{
		2121	hmmc->ErrorCode \|= errorstate;
		2122	}
		2123	}
		2124	else if(WideMode == SDIO_BUS_WIDE_4B)
		2125	{
		2126	errorstate = SDMMC_CmdSwitch(hmmc->Instance, 0x03B70100U);
		2127	if(errorstate != HAL_MMC_ERROR_NONE)
		2128	{
		2129	hmmc->ErrorCode \|= errorstate;
		2130	}
		2131	}
		2132	else if(WideMode == SDIO_BUS_WIDE_1B)
		2133	{
		2134	errorstate = SDMMC_CmdSwitch(hmmc->Instance, 0x03B70000U);
		2135	if(errorstate != HAL_MMC_ERROR_NONE)
		2136	{
		2137	hmmc->ErrorCode \|= errorstate;
		2138	}
		2139	}
		2140	else
		2141	{
		2142	/* WideMode is not a valid argument*/
		2143	hmmc->ErrorCode \|= HAL_MMC_ERROR_PARAM;
		2144	}
		2145
		2146	/* Check for switch error and violation of the trial number of sending CMD 13 */
		2147	while(busy == 0U)
		2148	{
		2149	if(count == SDMMC_MAX_TRIAL)
		2150	{
		2151	hmmc->State = HAL_MMC_STATE_READY;
		2152	hmmc->ErrorCode \|= HAL_MMC_ERROR_REQUEST_NOT_APPLICABLE;
		2153	return HAL_ERROR;
		2154	}
		2155	count++;
		2156
		2157	/* While card is not ready for data and trial number for sending CMD13 is not exceeded */
		2158	errorstate = SDMMC_CmdSendStatus(hmmc->Instance, (uint32_t)(((uint32_t)hmmc->MmcCard.RelCardAdd) << 16U));
		2159	if(errorstate != HAL_MMC_ERROR_NONE)
		2160	{
		2161	hmmc->ErrorCode \|= errorstate;
		2162	}
		2163
		2164	/* Get command response */
		2165	response = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2166
		2167	/* Get operating voltage*/
		2168	busy = (((response >> 7U) == 1U) ? 0U : 1U);
		2169	}
		2170
		2171	/* While card is not ready for data and trial number for sending CMD13 is not exceeded */
		2172	count = SDMMC_DATATIMEOUT;
		2173	while((response & 0x00000100U) == 0U)
		2174	{
		2175	if(count == 0U)
		2176	{
		2177	hmmc->State = HAL_MMC_STATE_READY;
		2178	hmmc->ErrorCode \|= HAL_MMC_ERROR_REQUEST_NOT_APPLICABLE;
		2179	return HAL_ERROR;
		2180	}
		2181	count--;
		2182
		2183	/* While card is not ready for data and trial number for sending CMD13 is not exceeded */
		2184	errorstate = SDMMC_CmdSendStatus(hmmc->Instance, (uint32_t)(((uint32_t)hmmc->MmcCard.RelCardAdd) << 16U));
		2185	if(errorstate != HAL_MMC_ERROR_NONE)
		2186	{
		2187	hmmc->ErrorCode \|= errorstate;
		2188	}
		2189
		2190	/* Get command response */
		2191	response = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2192	}
		2193
		2194	if(hmmc->ErrorCode != HAL_MMC_ERROR_NONE)
		2195	{
		2196	/* Clear all the static flags */
		2197	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		2198	hmmc->State = HAL_MMC_STATE_READY;
		2199	return HAL_ERROR;
		2200	}
		2201	else
		2202	{
		2203	/* Configure the SDIO peripheral */
		2204	Init.ClockEdge = hmmc->Init.ClockEdge;
		2205	Init.ClockBypass = hmmc->Init.ClockBypass;
		2206	Init.ClockPowerSave = hmmc->Init.ClockPowerSave;
		2207	Init.BusWide = WideMode;
		2208	Init.HardwareFlowControl = hmmc->Init.HardwareFlowControl;
		2209	Init.ClockDiv = hmmc->Init.ClockDiv;
		2210	(void)SDIO_Init(hmmc->Instance, Init);
		2211	}
		2212
		2213	/* Change State */
		2214	hmmc->State = HAL_MMC_STATE_READY;
		2215
		2216	return HAL_OK;
		2217	}
		2218
		2219	/**
		2220	* @brief Gets the current mmc card data state.
		2221	* @param hmmc: pointer to MMC handle
		2222	* @retval Card state
		2223	*/
		2224	HAL_MMC_CardStateTypeDef HAL_MMC_GetCardState(MMC_HandleTypeDef *hmmc)
		2225	{
		2226	uint32_t cardstate;
		2227	uint32_t errorstate;
		2228	uint32_t resp1 = 0U;
		2229
		2230	errorstate = MMC_SendStatus(hmmc, &resp1);
		2231	if(errorstate != HAL_MMC_ERROR_NONE)
		2232	{
		2233	hmmc->ErrorCode \|= errorstate;
		2234	}
		2235
		2236	cardstate = ((resp1 >> 9U) & 0x0FU);
		2237
		2238	return (HAL_MMC_CardStateTypeDef)cardstate;
		2239	}
		2240
		2241	/**
		2242	* @brief Abort the current transfer and disable the MMC.
		2243	* @param hmmc: pointer to a MMC_HandleTypeDef structure that contains
		2244	* the configuration information for MMC module.
		2245	* @retval HAL status
		2246	*/
		2247	HAL_StatusTypeDef HAL_MMC_Abort(MMC_HandleTypeDef *hmmc)
		2248	{
		2249	HAL_MMC_CardStateTypeDef CardState;
		2250
		2251	/* DIsable All interrupts */
		2252	__HAL_MMC_DISABLE_IT(hmmc, SDIO_IT_DATAEND \| SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT\|\
		2253	SDIO_IT_TXUNDERR\| SDIO_IT_RXOVERR);
		2254
		2255	/* Clear All flags */
		2256	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		2257
		2258	if((hmmc->hdmatx != NULL) \|\| (hmmc->hdmarx != NULL))
		2259	{
		2260	/* Disable the MMC DMA request */
		2261	hmmc->Instance->DCTRL &= (uint32_t)~((uint32_t)SDIO_DCTRL_DMAEN);
		2262
		2263	/* Abort the MMC DMA Tx Stream */
		2264	if(hmmc->hdmatx != NULL)
		2265	{
		2266	if(HAL_DMA_Abort(hmmc->hdmatx) != HAL_OK)
		2267	{
		2268	hmmc->ErrorCode \|= HAL_MMC_ERROR_DMA;
		2269	}
		2270	}
		2271	/* Abort the MMC DMA Rx Stream */
		2272	if(hmmc->hdmarx != NULL)
		2273	{
		2274	if(HAL_DMA_Abort(hmmc->hdmarx) != HAL_OK)
		2275	{
		2276	hmmc->ErrorCode \|= HAL_MMC_ERROR_DMA;
		2277	}
		2278	}
		2279	}
		2280
		2281	hmmc->State = HAL_MMC_STATE_READY;
		2282
		2283	/* Initialize the MMC operation */
		2284	hmmc->Context = MMC_CONTEXT_NONE;
		2285
		2286	CardState = HAL_MMC_GetCardState(hmmc);
		2287	if((CardState == HAL_MMC_CARD_RECEIVING) \|\| (CardState == HAL_MMC_CARD_SENDING))
		2288	{
		2289	hmmc->ErrorCode = SDMMC_CmdStopTransfer(hmmc->Instance);
		2290	}
		2291	if(hmmc->ErrorCode != HAL_MMC_ERROR_NONE)
		2292	{
		2293	return HAL_ERROR;
		2294	}
		2295	return HAL_OK;
		2296	}
		2297
		2298	/**
		2299	* @brief Abort the current transfer and disable the MMC (IT mode).
		2300	* @param hmmc: pointer to a MMC_HandleTypeDef structure that contains
		2301	* the configuration information for MMC module.
		2302	* @retval HAL status
		2303	*/
		2304	HAL_StatusTypeDef HAL_MMC_Abort_IT(MMC_HandleTypeDef *hmmc)
		2305	{
		2306	HAL_MMC_CardStateTypeDef CardState;
		2307
		2308	/* DIsable All interrupts */
		2309	__HAL_MMC_DISABLE_IT(hmmc, SDIO_IT_DATAEND \| SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT\|\
		2310	SDIO_IT_TXUNDERR\| SDIO_IT_RXOVERR);
		2311
		2312	/* Clear All flags */
		2313	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		2314
		2315	if((hmmc->hdmatx != NULL) \|\| (hmmc->hdmarx != NULL))
		2316	{
		2317	/* Disable the MMC DMA request */
		2318	hmmc->Instance->DCTRL &= (uint32_t)~((uint32_t)SDIO_DCTRL_DMAEN);
		2319
		2320	/* Abort the MMC DMA Tx Stream */
		2321	if(hmmc->hdmatx != NULL)
		2322	{
		2323	hmmc->hdmatx->XferAbortCallback = MMC_DMATxAbort;
		2324	if(HAL_DMA_Abort_IT(hmmc->hdmatx) != HAL_OK)
		2325	{
		2326	hmmc->hdmatx = NULL;
		2327	}
		2328	}
		2329	/* Abort the MMC DMA Rx Stream */
		2330	if(hmmc->hdmarx != NULL)
		2331	{
		2332	hmmc->hdmarx->XferAbortCallback = MMC_DMARxAbort;
		2333	if(HAL_DMA_Abort_IT(hmmc->hdmarx) != HAL_OK)
		2334	{
		2335	hmmc->hdmarx = NULL;
		2336	}
		2337	}
		2338	}
		2339
		2340	/* No transfer ongoing on both DMA channels*/
		2341	if((hmmc->hdmatx == NULL) && (hmmc->hdmarx == NULL))
		2342	{
		2343	CardState = HAL_MMC_GetCardState(hmmc);
		2344	hmmc->State = HAL_MMC_STATE_READY;
		2345
		2346	if((CardState == HAL_MMC_CARD_RECEIVING) \|\| (CardState == HAL_MMC_CARD_SENDING))
		2347	{
		2348	hmmc->ErrorCode = SDMMC_CmdStopTransfer(hmmc->Instance);
		2349	}
		2350	if(hmmc->ErrorCode != HAL_MMC_ERROR_NONE)
		2351	{
		2352	return HAL_ERROR;
		2353	}
		2354	else
		2355	{
		2356	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2357	hmmc->AbortCpltCallback(hmmc);
		2358	#else
		2359	HAL_MMC_AbortCallback(hmmc);
		2360	#endif
		2361	}
		2362	}
		2363
		2364	return HAL_OK;
		2365	}
		2366
		2367	/**
		2368	* @}
		2369	*/
		2370
		2371	/**
		2372	* @}
		2373	*/
		2374
		2375	/* Private function ----------------------------------------------------------*/
		2376	/** @addtogroup MMC_Private_Functions
		2377	* @{
		2378	*/
		2379
		2380	/**
		2381	* @brief DMA MMC transmit process complete callback
		2382	* @param hdma: DMA handle
		2383	* @retval None
		2384	*/
		2385	static void MMC_DMATransmitCplt(DMA_HandleTypeDef *hdma)
		2386	{
		2387	MMC_HandleTypeDef* hmmc = (MMC_HandleTypeDef* )(hdma->Parent);
		2388
		2389	/* Enable DATAEND Interrupt */
		2390	__HAL_MMC_ENABLE_IT(hmmc, (SDIO_IT_DATAEND));
		2391	}
		2392
		2393	/**
		2394	* @brief DMA MMC receive process complete callback
		2395	* @param hdma: DMA handle
		2396	* @retval None
		2397	*/
		2398	static void MMC_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
		2399	{
		2400	MMC_HandleTypeDef* hmmc = (MMC_HandleTypeDef* )(hdma->Parent);
		2401	uint32_t errorstate;
		2402
		2403	/* Send stop command in multiblock write */
		2404	if(hmmc->Context == (MMC_CONTEXT_READ_MULTIPLE_BLOCK \| MMC_CONTEXT_DMA))
		2405	{
		2406	errorstate = SDMMC_CmdStopTransfer(hmmc->Instance);
		2407	if(errorstate != HAL_MMC_ERROR_NONE)
		2408	{
		2409	hmmc->ErrorCode \|= errorstate;
		2410	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2411	hmmc->ErrorCallback(hmmc);
		2412	#else
		2413	HAL_MMC_ErrorCallback(hmmc);
		2414	#endif
		2415	}
		2416	}
		2417
		2418	/* Disable the DMA transfer for transmit request by setting the DMAEN bit
		2419	in the MMC DCTRL register */
		2420	hmmc->Instance->DCTRL &= (uint32_t)~((uint32_t)SDIO_DCTRL_DMAEN);
		2421
		2422	/* Clear all the static flags */
		2423	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		2424
		2425	hmmc->State = HAL_MMC_STATE_READY;
		2426
		2427	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2428	hmmc->RxCpltCallback(hmmc);
		2429	#else
		2430	HAL_MMC_RxCpltCallback(hmmc);
		2431	#endif
		2432	}
		2433
		2434	/**
		2435	* @brief DMA MMC communication error callback
		2436	* @param hdma: DMA handle
		2437	* @retval None
		2438	*/
		2439	static void MMC_DMAError(DMA_HandleTypeDef *hdma)
		2440	{
		2441	MMC_HandleTypeDef* hmmc = (MMC_HandleTypeDef* )(hdma->Parent);
		2442	HAL_MMC_CardStateTypeDef CardState;
		2443	uint32_t RxErrorCode, TxErrorCode;
		2444
		2445	RxErrorCode = hmmc->hdmarx->ErrorCode;
		2446	TxErrorCode = hmmc->hdmatx->ErrorCode;
		2447	if((RxErrorCode == HAL_DMA_ERROR_TE) \|\| (TxErrorCode == HAL_DMA_ERROR_TE))
		2448	{
		2449	/* Clear All flags */
		2450	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		2451
		2452	/* Disable All interrupts */
		2453	__HAL_MMC_DISABLE_IT(hmmc, SDIO_IT_DATAEND \| SDIO_IT_DCRCFAIL \| SDIO_IT_DTIMEOUT\|\
		2454	SDIO_IT_TXUNDERR\| SDIO_IT_RXOVERR);
		2455
		2456	hmmc->ErrorCode \|= HAL_MMC_ERROR_DMA;
		2457	CardState = HAL_MMC_GetCardState(hmmc);
		2458	if((CardState == HAL_MMC_CARD_RECEIVING) \|\| (CardState == HAL_MMC_CARD_SENDING))
		2459	{
		2460	hmmc->ErrorCode \|= SDMMC_CmdStopTransfer(hmmc->Instance);
		2461	}
		2462
		2463	hmmc->State= HAL_MMC_STATE_READY;
		2464	}
		2465
		2466	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2467	hmmc->ErrorCallback(hmmc);
		2468	#else
		2469	HAL_MMC_ErrorCallback(hmmc);
		2470	#endif
		2471	}
		2472
		2473	/**
		2474	* @brief DMA MMC Tx Abort callback
		2475	* @param hdma: DMA handle
		2476	* @retval None
		2477	*/
		2478	static void MMC_DMATxAbort(DMA_HandleTypeDef *hdma)
		2479	{
		2480	MMC_HandleTypeDef* hmmc = (MMC_HandleTypeDef* )(hdma->Parent);
		2481	HAL_MMC_CardStateTypeDef CardState;
		2482
		2483	if(hmmc->hdmatx != NULL)
		2484	{
		2485	hmmc->hdmatx = NULL;
		2486	}
		2487
		2488	/* All DMA channels are aborted */
		2489	if(hmmc->hdmarx == NULL)
		2490	{
		2491	CardState = HAL_MMC_GetCardState(hmmc);
		2492	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		2493	hmmc->State = HAL_MMC_STATE_READY;
		2494	if((CardState == HAL_MMC_CARD_RECEIVING) \|\| (CardState == HAL_MMC_CARD_SENDING))
		2495	{
		2496	hmmc->ErrorCode \|= SDMMC_CmdStopTransfer(hmmc->Instance);
		2497
		2498	if(hmmc->ErrorCode != HAL_MMC_ERROR_NONE)
		2499	{
		2500	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2501	hmmc->AbortCpltCallback(hmmc);
		2502	#else
		2503	HAL_MMC_AbortCallback(hmmc);
		2504	#endif
		2505	}
		2506	else
		2507	{
		2508	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2509	hmmc->ErrorCallback(hmmc);
		2510	#else
		2511	HAL_MMC_ErrorCallback(hmmc);
		2512	#endif
		2513	}
		2514	}
		2515	}
		2516	}
		2517
		2518	/**
		2519	* @brief DMA MMC Rx Abort callback
		2520	* @param hdma: DMA handle
		2521	* @retval None
		2522	*/
		2523	static void MMC_DMARxAbort(DMA_HandleTypeDef *hdma)
		2524	{
		2525	MMC_HandleTypeDef* hmmc = (MMC_HandleTypeDef* )(hdma->Parent);
		2526	HAL_MMC_CardStateTypeDef CardState;
		2527
		2528	if(hmmc->hdmarx != NULL)
		2529	{
		2530	hmmc->hdmarx = NULL;
		2531	}
		2532
		2533	/* All DMA channels are aborted */
		2534	if(hmmc->hdmatx == NULL)
		2535	{
		2536	CardState = HAL_MMC_GetCardState(hmmc);
		2537	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		2538	hmmc->State = HAL_MMC_STATE_READY;
		2539	if((CardState == HAL_MMC_CARD_RECEIVING) \|\| (CardState == HAL_MMC_CARD_SENDING))
		2540	{
		2541	hmmc->ErrorCode \|= SDMMC_CmdStopTransfer(hmmc->Instance);
		2542
		2543	if(hmmc->ErrorCode != HAL_MMC_ERROR_NONE)
		2544	{
		2545	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2546	hmmc->AbortCpltCallback(hmmc);
		2547	#else
		2548	HAL_MMC_AbortCallback(hmmc);
		2549	#endif
		2550	}
		2551	else
		2552	{
		2553	#if defined (USE_HAL_MMC_REGISTER_CALLBACKS) && (USE_HAL_MMC_REGISTER_CALLBACKS == 1U)
		2554	hmmc->ErrorCallback(hmmc);
		2555	#else
		2556	HAL_MMC_ErrorCallback(hmmc);
		2557	#endif
		2558	}
		2559	}
		2560	}
		2561	}
		2562
		2563	/**
		2564	* @brief Initializes the mmc card.
		2565	* @param hmmc: Pointer to MMC handle
		2566	* @retval MMC Card error state
		2567	*/
		2568	static uint32_t MMC_InitCard(MMC_HandleTypeDef *hmmc)
		2569	{
		2570	HAL_MMC_CardCSDTypeDef CSD;
		2571	uint32_t errorstate;
		2572	uint16_t mmc_rca = 1U;
		2573
		2574	/* Check the power State */
		2575	if(SDIO_GetPowerState(hmmc->Instance) == 0U)
		2576	{
		2577	/* Power off */
		2578	return HAL_MMC_ERROR_REQUEST_NOT_APPLICABLE;
		2579	}
		2580
		2581	/* Send CMD2 ALL_SEND_CID */
		2582	errorstate = SDMMC_CmdSendCID(hmmc->Instance);
		2583	if(errorstate != HAL_MMC_ERROR_NONE)
		2584	{
		2585	return errorstate;
		2586	}
		2587	else
		2588	{
		2589	/* Get Card identification number data */
		2590	hmmc->CID[0U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2591	hmmc->CID[1U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP2);
		2592	hmmc->CID[2U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP3);
		2593	hmmc->CID[3U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP4);
		2594	}
		2595
		2596	/* Send CMD3 SET_REL_ADDR with argument 0 */
		2597	/* MMC Card publishes its RCA. */
		2598	errorstate = SDMMC_CmdSetRelAdd(hmmc->Instance, &mmc_rca);
		2599	if(errorstate != HAL_MMC_ERROR_NONE)
		2600	{
		2601	return errorstate;
		2602	}
		2603
		2604	/* Get the MMC card RCA */
		2605	hmmc->MmcCard.RelCardAdd = mmc_rca;
		2606
		2607	/* Send CMD9 SEND_CSD with argument as card's RCA */
		2608	errorstate = SDMMC_CmdSendCSD(hmmc->Instance, (uint32_t)(hmmc->MmcCard.RelCardAdd << 16U));
		2609	if(errorstate != HAL_MMC_ERROR_NONE)
		2610	{
		2611	return errorstate;
		2612	}
		2613	else
		2614	{
		2615	/* Get Card Specific Data */
		2616	hmmc->CSD[0U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2617	hmmc->CSD[1U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP2);
		2618	hmmc->CSD[2U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP3);
		2619	hmmc->CSD[3U] = SDIO_GetResponse(hmmc->Instance, SDIO_RESP4);
		2620	}
		2621
		2622	/* Get the Card Class */
		2623	hmmc->MmcCard.Class = (SDIO_GetResponse(hmmc->Instance, SDIO_RESP2) >> 20U);
		2624
		2625	/* Get CSD parameters */
		2626	if (HAL_MMC_GetCardCSD(hmmc, &CSD) != HAL_OK)
		2627	{
		2628	return hmmc->ErrorCode;
		2629	}
		2630
		2631	/* Select the Card */
		2632	errorstate = SDMMC_CmdSelDesel(hmmc->Instance, (uint32_t)(((uint32_t)hmmc->MmcCard.RelCardAdd) << 16U));
		2633	if(errorstate != HAL_MMC_ERROR_NONE)
		2634	{
		2635	return errorstate;
		2636	}
		2637
		2638	/* Configure SDIO peripheral interface */
		2639	(void)SDIO_Init(hmmc->Instance, hmmc->Init);
		2640
		2641	/* All cards are initialized */
		2642	return HAL_MMC_ERROR_NONE;
		2643	}
		2644
		2645	/**
		2646	* @brief Enquires cards about their operating voltage and configures clock
		2647	* controls and stores MMC information that will be needed in future
		2648	* in the MMC handle.
		2649	* @param hmmc: Pointer to MMC handle
		2650	* @retval error state
		2651	*/
		2652	static uint32_t MMC_PowerON(MMC_HandleTypeDef *hmmc)
		2653	{
		2654	__IO uint32_t count = 0U;
		2655	uint32_t response = 0U, validvoltage = 0U;
		2656	uint32_t errorstate;
		2657
		2658	/* CMD0: GO_IDLE_STATE */
		2659	errorstate = SDMMC_CmdGoIdleState(hmmc->Instance);
		2660	if(errorstate != HAL_MMC_ERROR_NONE)
		2661	{
		2662	return errorstate;
		2663	}
		2664
		2665	while(validvoltage == 0U)
		2666	{
		2667	if(count++ == SDMMC_MAX_VOLT_TRIAL)
		2668	{
		2669	return HAL_MMC_ERROR_INVALID_VOLTRANGE;
		2670	}
		2671
		2672	/* SEND CMD1 APP_CMD with MMC_HIGH_VOLTAGE_RANGE(0xC0FF8000) as argument */
		2673	errorstate = SDMMC_CmdOpCondition(hmmc->Instance, eMMC_HIGH_VOLTAGE_RANGE);
		2674	if(errorstate != HAL_MMC_ERROR_NONE)
		2675	{
		2676	return HAL_MMC_ERROR_UNSUPPORTED_FEATURE;
		2677	}
		2678
		2679	/* Get command response */
		2680	response = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2681
		2682	/* Get operating voltage*/
		2683	validvoltage = (((response >> 31U) == 1U) ? 1U : 0U);
		2684	}
		2685
		2686	/* When power routine is finished and command returns valid voltage */
		2687	if (((response & (0xFF000000U)) >> 24U) == 0xC0U)
		2688	{
		2689	hmmc->MmcCard.CardType = MMC_HIGH_CAPACITY_CARD;
		2690	}
		2691	else
		2692	{
		2693	hmmc->MmcCard.CardType = MMC_LOW_CAPACITY_CARD;
		2694	}
		2695
		2696	return HAL_MMC_ERROR_NONE;
		2697	}
		2698
		2699	/**
		2700	* @brief Turns the SDIO output signals off.
		2701	* @param hmmc: Pointer to MMC handle
		2702	* @retval None
		2703	*/
		2704	static void MMC_PowerOFF(MMC_HandleTypeDef *hmmc)
		2705	{
		2706	/* Set Power State to OFF */
		2707	(void)SDIO_PowerState_OFF(hmmc->Instance);
		2708	}
		2709
		2710	/**
		2711	* @brief Returns the current card's status.
		2712	* @param hmmc: Pointer to MMC handle
		2713	* @param pCardStatus: pointer to the buffer that will contain the MMC card
		2714	* status (Card Status register)
		2715	* @retval error state
		2716	*/
		2717	static uint32_t MMC_SendStatus(MMC_HandleTypeDef hmmc, uint32_t pCardStatus)
		2718	{
		2719	uint32_t errorstate;
		2720
		2721	if(pCardStatus == NULL)
		2722	{
		2723	return HAL_MMC_ERROR_PARAM;
		2724	}
		2725
		2726	/* Send Status command */
		2727	errorstate = SDMMC_CmdSendStatus(hmmc->Instance, (uint32_t)(hmmc->MmcCard.RelCardAdd << 16U));
		2728	if(errorstate != HAL_MMC_ERROR_NONE)
		2729	{
		2730	return errorstate;
		2731	}
		2732
		2733	/* Get MMC card status */
		2734	*pCardStatus = SDIO_GetResponse(hmmc->Instance, SDIO_RESP1);
		2735
		2736	return HAL_MMC_ERROR_NONE;
		2737	}
		2738
		2739	/**
		2740	* @brief Reads extended CSD register to get the sectors number of the device
		2741	* @param hmmc: Pointer to MMC handle
		2742	* @param pFieldData: Pointer to the read buffer
		2743	* @param FieldIndex: Index of the field to be read
		2744	* @param Timeout: Specify timeout value
		2745	* @retval HAL status
		2746	*/
		2747	static uint32_t MMC_ReadExtCSD(MMC_HandleTypeDef hmmc, uint32_t pFieldData, uint16_t FieldIndex, uint32_t Timeout)
		2748	{
		2749	SDIO_DataInitTypeDef config;
		2750	uint32_t errorstate;
		2751	uint32_t tickstart = HAL_GetTick();
		2752	uint32_t count;
		2753	uint32_t i = 0;
		2754	uint32_t tmp_data;
		2755
		2756	hmmc->ErrorCode = HAL_MMC_ERROR_NONE;
		2757
		2758	/* Initialize data control register */
		2759	hmmc->Instance->DCTRL = 0;
		2760
		2761	/* Configure the MMC DPSM (Data Path State Machine) */
		2762	config.DataTimeOut = SDMMC_DATATIMEOUT;
		2763	config.DataLength = 512;
		2764	config.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
		2765	config.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
		2766	config.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
		2767	config.DPSM = SDIO_DPSM_ENABLE;
		2768	(void)SDIO_ConfigData(hmmc->Instance, &config);
		2769
		2770	/* Set Block Size for Card */
		2771	errorstate = SDMMC_CmdSendEXTCSD(hmmc->Instance, 0);
		2772	if(errorstate != HAL_MMC_ERROR_NONE)
		2773	{
		2774	/* Clear all the static flags */
		2775	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		2776	hmmc->ErrorCode \|= errorstate;
		2777	hmmc->State = HAL_MMC_STATE_READY;
		2778	return HAL_ERROR;
		2779	}
		2780
		2781	/* Poll on SDMMC flags */
		2782	while(!__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXOVERR \| SDIO_FLAG_DCRCFAIL \| SDIO_FLAG_DTIMEOUT \| SDIO_FLAG_DATAEND))
		2783	{
		2784	if(__HAL_MMC_GET_FLAG(hmmc, SDIO_FLAG_RXFIFOHF))
		2785	{
		2786	/* Read data from SDMMC Rx FIFO */
		2787	for(count = 0U; count < 8U; count++)
		2788	{
		2789	tmp_data = SDIO_ReadFIFO(hmmc->Instance);
		2790	/* eg : SEC_COUNT : FieldIndex = 212 => i+count = 53 */
		2791	/* DEVICE_TYPE : FieldIndex = 196 => i+count = 49 */
		2792	if ((i + count) == ((uint32_t)FieldIndex/4U))
		2793	{
		2794	*pFieldData = tmp_data;
		2795	}
		2796	}
		2797	i += 8U;
		2798	}
		2799
		2800	if(((HAL_GetTick()-tickstart) >= Timeout) \|\| (Timeout == 0U))
		2801	{
		2802	/* Clear all the static flags */
		2803	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_FLAGS);
		2804	hmmc->ErrorCode \|= HAL_MMC_ERROR_TIMEOUT;
		2805	hmmc->State= HAL_MMC_STATE_READY;
		2806	return HAL_TIMEOUT;
		2807	}
		2808	}
		2809
		2810	/* While card is not ready for data and trial number for sending CMD13 is not exceeded */
		2811	errorstate = SDMMC_CmdSendStatus(hmmc->Instance, (uint32_t)(((uint32_t)hmmc->MmcCard.RelCardAdd) << 16));
		2812	if(errorstate != HAL_MMC_ERROR_NONE)
		2813	{
		2814	hmmc->ErrorCode \|= errorstate;
		2815	}
		2816
		2817	/* Clear all the static flags */
		2818	__HAL_MMC_CLEAR_FLAG(hmmc, SDIO_STATIC_DATA_FLAGS);
		2819
		2820	hmmc->State = HAL_MMC_STATE_READY;
		2821
		2822	return HAL_OK;
		2823	}
		2824
		2825
		2826	/**
		2827	* @brief Wrap up reading in non-blocking mode.
		2828	* @param hmmc: pointer to a MMC_HandleTypeDef structure that contains
		2829	* the configuration information.
		2830	* @retval None
		2831	*/
		2832	static void MMC_Read_IT(MMC_HandleTypeDef *hmmc)
		2833	{
		2834	uint32_t count, data, dataremaining;
		2835	uint8_t* tmp;
		2836
		2837	tmp = hmmc->pRxBuffPtr;
		2838	dataremaining = hmmc->RxXferSize;
		2839
		2840	if (dataremaining > 0U)
		2841	{
		2842	/* Read data from SDIO Rx FIFO */
		2843	for(count = 0U; count < 8U; count++)
		2844	{
		2845	data = SDIO_ReadFIFO(hmmc->Instance);
		2846	*tmp = (uint8_t)(data & 0xFFU);
		2847	tmp++;
		2848	dataremaining--;
		2849	*tmp = (uint8_t)((data >> 8U) & 0xFFU);
		2850	tmp++;
		2851	dataremaining--;
		2852	*tmp = (uint8_t)((data >> 16U) & 0xFFU);
		2853	tmp++;
		2854	dataremaining--;
		2855	*tmp = (uint8_t)((data >> 24U) & 0xFFU);
		2856	tmp++;
		2857	dataremaining--;
		2858	}
		2859
		2860	hmmc->pRxBuffPtr = tmp;
		2861	hmmc->RxXferSize = dataremaining;
		2862	}
		2863	}
		2864
		2865	/**
		2866	* @brief Wrap up writing in non-blocking mode.
		2867	* @param hmmc: pointer to a MMC_HandleTypeDef structure that contains
		2868	* the configuration information.
		2869	* @retval None
		2870	*/
		2871	static void MMC_Write_IT(MMC_HandleTypeDef *hmmc)
		2872	{
		2873	uint32_t count, data, dataremaining;
		2874	uint8_t* tmp;
		2875
		2876	tmp = hmmc->pTxBuffPtr;
		2877	dataremaining = hmmc->TxXferSize;
		2878
		2879	if (dataremaining > 0U)
		2880	{
		2881	/* Write data to SDIO Tx FIFO */
		2882	for(count = 0U; count < 8U; count++)
		2883	{
		2884	data = (uint32_t)(*tmp);
		2885	tmp++;
		2886	dataremaining--;
		2887	data \|= ((uint32_t)(*tmp) << 8U);
		2888	tmp++;
		2889	dataremaining--;
		2890	data \|= ((uint32_t)(*tmp) << 16U);
		2891	tmp++;
		2892	dataremaining--;
		2893	data \|= ((uint32_t)(*tmp) << 24U);
		2894	tmp++;
		2895	dataremaining--;
		2896	(void)SDIO_WriteFIFO(hmmc->Instance, &data);
		2897	}
		2898
		2899	hmmc->pTxBuffPtr = tmp;
		2900	hmmc->TxXferSize = dataremaining;
		2901	}
		2902	}
		2903
		2904	/**
		2905	* @}
		2906	*/
		2907
		2908	#endif /* SDIO */
		2909
		2910	#endif /* HAL_MMC_MODULE_ENABLED */
		2911
		2912	/**
		2913	* @}
		2914	*/
		2915
		2916	/**
		2917	* @}
		2918	*/
		2919
		2920	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Subversion Repositories testOled

(root)/trunk/Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_mmc.c – Rev 2