?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
Merge pull request #10592 from iNavFlight/MrD_Update-parameter-description
[inav.git] / lib / main / STM32F7 / Drivers / STM32F7xx_HAL_Driver / Inc / stm32f7xx_hal_mmc.h
blob5d4ec6ea70eb6407c3b452bb78f75d181b07c51b
1 /**
2 ******************************************************************************
3 * @file stm32f7xx_hal_mmc.h
4 * @author MCD Application Team
5 * @version V1.2.2
6 * @date 14-April-2017
7 * @brief Header file of MMC HAL module.
8 ******************************************************************************
9 * @attention
10 *
11 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
12 *
13 * Redistribution and use in source and binary forms, with or without modification,
14 * are permitted provided that the following conditions are met:
15 * 1. Redistributions of source code must retain the above copyright notice,
16 * this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright notice,
18 * this list of conditions and the following disclaimer in the documentation
19 * and/or other materials provided with the distribution.
20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34 *
35 ******************************************************************************
36 */
37
38 /* Define to prevent recursive inclusion -------------------------------------*/
39 #ifndef __STM32F7xx_HAL_MMC_H
40 #define __STM32F7xx_HAL_MMC_H
41
42 #ifdef __cplusplus
43 extern "C" {
44 #endif
45
46 /* Includes ------------------------------------------------------------------*/
47 #include "stm32f7xx_ll_sdmmc.h"
48
49 /** @addtogroup STM32F7xx_HAL_Driver
50 * @{
51 */
52
53 /** @addtogroup MMC
54 * @{
55 */
56
57 /* Exported types ------------------------------------------------------------*/
58 /** @defgroup MMC_Exported_Types MMC Exported Types
59 * @{
60 */
61
62 /** @defgroup MMC_Exported_Types_Group1 MMC State enumeration structure
63 * @{
64 */
65 typedef enum
66 {
67 HAL_MMC_STATE_RESET = ((uint32_t)0x00000000U), /*!< MMC not yet initialized or disabled */
68 HAL_MMC_STATE_READY = ((uint32_t)0x00000001U), /*!< MMC initialized and ready for use */
69 HAL_MMC_STATE_TIMEOUT = ((uint32_t)0x00000002U), /*!< MMC Timeout state */
70 HAL_MMC_STATE_BUSY = ((uint32_t)0x00000003U), /*!< MMC process ongoing */
71 HAL_MMC_STATE_PROGRAMMING = ((uint32_t)0x00000004U), /*!< MMC Programming State */
72 HAL_MMC_STATE_RECEIVING = ((uint32_t)0x00000005U), /*!< MMC Receinving State */
73 HAL_MMC_STATE_TRANSFER = ((uint32_t)0x00000006U), /*!< MMC Transfert State */
74 HAL_MMC_STATE_ERROR = ((uint32_t)0x0000000FU) /*!< MMC is in error state */
75 }HAL_MMC_StateTypeDef;
76 /**
77 * @}
78 */
79
80 /** @defgroup MMC_Exported_Types_Group2 MMC Card State enumeration structure
81 * @{
82 */
83 typedef enum
84 {
85 HAL_MMC_CARD_READY = ((uint32_t)0x00000001U), /*!< Card state is ready */
86 HAL_MMC_CARD_IDENTIFICATION = ((uint32_t)0x00000002U), /*!< Card is in identification state */
87 HAL_MMC_CARD_STANDBY = ((uint32_t)0x00000003U), /*!< Card is in standby state */
88 HAL_MMC_CARD_TRANSFER = ((uint32_t)0x00000004U), /*!< Card is in transfer state */
89 HAL_MMC_CARD_SENDING = ((uint32_t)0x00000005U), /*!< Card is sending an operation */
90 HAL_MMC_CARD_RECEIVING = ((uint32_t)0x00000006U), /*!< Card is receiving operation information */
91 HAL_MMC_CARD_PROGRAMMING = ((uint32_t)0x00000007U), /*!< Card is in programming state */
92 HAL_MMC_CARD_DISCONNECTED = ((uint32_t)0x00000008U), /*!< Card is disconnected */
93 HAL_MMC_CARD_ERROR = ((uint32_t)0x000000FFU) /*!< Card response Error */
94 }HAL_MMC_CardStateTypeDef;
95 /**
96 * @}
97 */
98
99 /** @defgroup MMC_Exported_Types_Group3 MMC Handle Structure definition
100 * @{
101 */
102 #define MMC_InitTypeDef SDMMC_InitTypeDef
103 #define MMC_TypeDef SDMMC_TypeDef
104
105 /**
106 * @brief MMC Card Information Structure definition
107 */
108 typedef struct
109 {
110 uint32_t CardType; /*!< Specifies the card Type */
111
112 uint32_t Class; /*!< Specifies the class of the card class */
113
114 uint32_t RelCardAdd; /*!< Specifies the Relative Card Address */
115
116 uint32_t BlockNbr; /*!< Specifies the Card Capacity in blocks */
117
118 uint32_t BlockSize; /*!< Specifies one block size in bytes */
119
120 uint32_t LogBlockNbr; /*!< Specifies the Card logical Capacity in blocks */
121
122 uint32_t LogBlockSize; /*!< Specifies logical block size in bytes */
123
124 }HAL_MMC_CardInfoTypeDef;
125
126 /**
127 * @brief MMC handle Structure definition
128 */
129 typedef struct
130 {
131 MMC_TypeDef *Instance; /*!< MMC registers base address */
132
133 MMC_InitTypeDef Init; /*!< MMC required parameters */
134
135 HAL_LockTypeDef Lock; /*!< MMC locking object */
136
137 uint32_t *pTxBuffPtr; /*!< Pointer to MMC Tx transfer Buffer */
138
139 uint32_t TxXferSize; /*!< MMC Tx Transfer size */
140
141 uint32_t *pRxBuffPtr; /*!< Pointer to MMC Rx transfer Buffer */
142
143 uint32_t RxXferSize; /*!< MMC Rx Transfer size */
144
145 __IO uint32_t Context; /*!< MMC transfer context */
146
147 __IO HAL_MMC_StateTypeDef State; /*!< MMC card State */
148
149 __IO uint32_t ErrorCode; /*!< MMC Card Error codes */
150
151 DMA_HandleTypeDef *hdmarx; /*!< MMC Rx DMA handle parameters */
152
153 DMA_HandleTypeDef *hdmatx; /*!< MMC Tx DMA handle parameters */
154
155 HAL_MMC_CardInfoTypeDef MmcCard; /*!< MMC Card information */
156
157 uint32_t CSD[4]; /*!< MMC card specific data table */
158
159 uint32_t CID[4]; /*!< MMC card identification number table */
160
161 }MMC_HandleTypeDef;
162
163 /**
164 * @}
165 */
166
167 /** @defgroup MMC_Exported_Types_Group4 Card Specific Data: CSD Register
168 * @{
169 */
170 typedef struct
171 {
172 __IO uint8_t CSDStruct; /*!< CSD structure */
173 __IO uint8_t SysSpecVersion; /*!< System specification version */
174 __IO uint8_t Reserved1; /*!< Reserved */
175 __IO uint8_t TAAC; /*!< Data read access time 1 */
176 __IO uint8_t NSAC; /*!< Data read access time 2 in CLK cycles */
177 __IO uint8_t MaxBusClkFrec; /*!< Max. bus clock frequency */
178 __IO uint16_t CardComdClasses; /*!< Card command classes */
179 __IO uint8_t RdBlockLen; /*!< Max. read data block length */
180 __IO uint8_t PartBlockRead; /*!< Partial blocks for read allowed */
181 __IO uint8_t WrBlockMisalign; /*!< Write block misalignment */
182 __IO uint8_t RdBlockMisalign; /*!< Read block misalignment */
183 __IO uint8_t DSRImpl; /*!< DSR implemented */
184 __IO uint8_t Reserved2; /*!< Reserved */
185 __IO uint32_t DeviceSize; /*!< Device Size */
186 __IO uint8_t MaxRdCurrentVDDMin; /*!< Max. read current @ VDD min */
187 __IO uint8_t MaxRdCurrentVDDMax; /*!< Max. read current @ VDD max */
188 __IO uint8_t MaxWrCurrentVDDMin; /*!< Max. write current @ VDD min */
189 __IO uint8_t MaxWrCurrentVDDMax; /*!< Max. write current @ VDD max */
190 __IO uint8_t DeviceSizeMul; /*!< Device size multiplier */
191 __IO uint8_t EraseGrSize; /*!< Erase group size */
192 __IO uint8_t EraseGrMul; /*!< Erase group size multiplier */
193 __IO uint8_t WrProtectGrSize; /*!< Write protect group size */
194 __IO uint8_t WrProtectGrEnable; /*!< Write protect group enable */
195 __IO uint8_t ManDeflECC; /*!< Manufacturer default ECC */
196 __IO uint8_t WrSpeedFact; /*!< Write speed factor */
197 __IO uint8_t MaxWrBlockLen; /*!< Max. write data block length */
198 __IO uint8_t WriteBlockPaPartial; /*!< Partial blocks for write allowed */
199 __IO uint8_t Reserved3; /*!< Reserved */
200 __IO uint8_t ContentProtectAppli; /*!< Content protection application */
201 __IO uint8_t FileFormatGrouop; /*!< File format group */
202 __IO uint8_t CopyFlag; /*!< Copy flag (OTP) */
203 __IO uint8_t PermWrProtect; /*!< Permanent write protection */
204 __IO uint8_t TempWrProtect; /*!< Temporary write protection */
205 __IO uint8_t FileFormat; /*!< File format */
206 __IO uint8_t ECC; /*!< ECC code */
207 __IO uint8_t CSD_CRC; /*!< CSD CRC */
208 __IO uint8_t Reserved4; /*!< Always 1 */
209
210 }HAL_MMC_CardCSDTypeDef;
211 /**
212 * @}
213 */
214
215 /** @defgroup MMC_Exported_Types_Group5 Card Identification Data: CID Register
216 * @{
217 */
218 typedef struct
219 {
220 __IO uint8_t ManufacturerID; /*!< Manufacturer ID */
221 __IO uint16_t OEM_AppliID; /*!< OEM/Application ID */
222 __IO uint32_t ProdName1; /*!< Product Name part1 */
223 __IO uint8_t ProdName2; /*!< Product Name part2 */
224 __IO uint8_t ProdRev; /*!< Product Revision */
225 __IO uint32_t ProdSN; /*!< Product Serial Number */
226 __IO uint8_t Reserved1; /*!< Reserved1 */
227 __IO uint16_t ManufactDate; /*!< Manufacturing Date */
228 __IO uint8_t CID_CRC; /*!< CID CRC */
229 __IO uint8_t Reserved2; /*!< Always 1 */
230
231 }HAL_MMC_CardCIDTypeDef;
232 /**
233 * @}
234 */
235
236 /**
237 * @}
238 */
239
240 /* Exported constants --------------------------------------------------------*/
241 /** @defgroup MMC_Exported_Constants Exported Constants
242 * @{
243 */
244
245 #define BLOCKSIZE ((uint32_t)512U) /*!< Block size is 512 bytes */
246 #define CAPACITY ((uint32_t)0x80000000U) /*!< 2 G bytes constant */
247
248 /** @defgroup MMC_Exported_Constansts_Group1 MMC Error status enumeration Structure definition
249 * @{
250 */
251 #define HAL_MMC_ERROR_NONE SDMMC_ERROR_NONE /*!< No error */
252 #define HAL_MMC_ERROR_CMD_CRC_FAIL SDMMC_ERROR_CMD_CRC_FAIL /*!< Command response received (but CRC check failed) */
253 #define HAL_MMC_ERROR_DATA_CRC_FAIL SDMMC_ERROR_DATA_CRC_FAIL /*!< Data block sent/received (CRC check failed) */
254 #define HAL_MMC_ERROR_CMD_RSP_TIMEOUT SDMMC_ERROR_CMD_RSP_TIMEOUT /*!< Command response timeout */
255 #define HAL_MMC_ERROR_DATA_TIMEOUT SDMMC_ERROR_DATA_TIMEOUT /*!< Data timeout */
256 #define HAL_MMC_ERROR_TX_UNDERRUN SDMMC_ERROR_TX_UNDERRUN /*!< Transmit FIFO underrun */
257 #define HAL_MMC_ERROR_RX_OVERRUN SDMMC_ERROR_RX_OVERRUN /*!< Receive FIFO overrun */
258 #define HAL_MMC_ERROR_ADDR_MISALIGNED SDMMC_ERROR_ADDR_MISALIGNED /*!< Misaligned address */
259 #define HAL_MMC_ERROR_BLOCK_LEN_ERR SDMMC_ERROR_BLOCK_LEN_ERR /*!< Transferred block length is not allowed for the card or the
260 number of transferred bytes does not match the block length */
261 #define HAL_MMC_ERROR_ERASE_SEQ_ERR SDMMC_ERROR_ERASE_SEQ_ERR /*!< An error in the sequence of erase command occurs */
262 #define HAL_MMC_ERROR_BAD_ERASE_PARAM SDMMC_ERROR_BAD_ERASE_PARAM /*!< An invalid selection for erase groups */
263 #define HAL_MMC_ERROR_WRITE_PROT_VIOLATION SDMMC_ERROR_WRITE_PROT_VIOLATION /*!< Attempt to program a write protect block */
264 #define HAL_MMC_ERROR_LOCK_UNLOCK_FAILED SDMMC_ERROR_LOCK_UNLOCK_FAILED /*!< Sequence or password error has been detected in unlock
265 command or if there was an attempt to access a locked card */
266 #define HAL_MMC_ERROR_COM_CRC_FAILED SDMMC_ERROR_COM_CRC_FAILED /*!< CRC check of the previous command failed */
267 #define HAL_MMC_ERROR_ILLEGAL_CMD SDMMC_ERROR_ILLEGAL_CMD /*!< Command is not legal for the card state */
268 #define HAL_MMC_ERROR_CARD_ECC_FAILED SDMMC_ERROR_CARD_ECC_FAILED /*!< Card internal ECC was applied but failed to correct the data */
269 #define HAL_MMC_ERROR_CC_ERR SDMMC_ERROR_CC_ERR /*!< Internal card controller error */
270 #define HAL_MMC_ERROR_GENERAL_UNKNOWN_ERR SDMMC_ERROR_GENERAL_UNKNOWN_ERR /*!< General or unknown error */
271 #define HAL_MMC_ERROR_STREAM_READ_UNDERRUN SDMMC_ERROR_STREAM_READ_UNDERRUN /*!< The card could not sustain data reading in stream rmode */
272 #define HAL_MMC_ERROR_STREAM_WRITE_OVERRUN SDMMC_ERROR_STREAM_WRITE_OVERRUN /*!< The card could not sustain data programming in stream mode */
273 #define HAL_MMC_ERROR_CID_CSD_OVERWRITE SDMMC_ERROR_CID_CSD_OVERWRITE /*!< CID/CSD overwrite error */
274 #define HAL_MMC_ERROR_WP_ERASE_SKIP SDMMC_ERROR_WP_ERASE_SKIP /*!< Only partial address space was erased */
275 #define HAL_MMC_ERROR_CARD_ECC_DISABLED SDMMC_ERROR_CARD_ECC_DISABLED /*!< Command has been executed without using internal ECC */
276 #define HAL_MMC_ERROR_ERASE_RESET SDMMC_ERROR_ERASE_RESET /*!< Erase sequence was cleared before executing because an out
277 of erase sequence command was received */
278 #define HAL_MMC_ERROR_AKE_SEQ_ERR SDMMC_ERROR_AKE_SEQ_ERR /*!< Error in sequence of authentication */
279 #define HAL_MMC_ERROR_INVALID_VOLTRANGE SDMMC_ERROR_INVALID_VOLTRANGE /*!< Error in case of invalid voltage range */
280 #define HAL_MMC_ERROR_ADDR_OUT_OF_RANGE SDMMC_ERROR_ADDR_OUT_OF_RANGE /*!< Error when addressed block is out of range */
281 #define HAL_MMC_ERROR_REQUEST_NOT_APPLICABLE SDMMC_ERROR_REQUEST_NOT_APPLICABLE /*!< Error when command request is not applicable */
282 #define HAL_MMC_ERROR_PARAM SDMMC_ERROR_INVALID_PARAMETER /*!< the used parameter is not valid */
283 #define HAL_MMC_ERROR_UNSUPPORTED_FEATURE SDMMC_ERROR_UNSUPPORTED_FEATURE /*!< Error when feature is not insupported */
284 #define HAL_MMC_ERROR_BUSY SDMMC_ERROR_BUSY /*!< Error when transfer process is busy */
285 #define HAL_MMC_ERROR_DMA SDMMC_ERROR_DMA /*!< Error while DMA transfer */
286 #define HAL_MMC_ERROR_TIMEOUT SDMMC_ERROR_TIMEOUT /*!< Timeout error */
287
288 /**
289 * @}
290 */
291
292 /** @defgroup MMC_Exported_Constansts_Group2 MMC context enumeration
293 * @{
294 */
295 #define MMC_CONTEXT_NONE ((uint32_t)0x00000000U) /*!< None */
296 #define MMC_CONTEXT_READ_SINGLE_BLOCK ((uint32_t)0x00000001U) /*!< Read single block operation */
297 #define MMC_CONTEXT_READ_MULTIPLE_BLOCK ((uint32_t)0x00000002U) /*!< Read multiple blocks operation */
298 #define MMC_CONTEXT_WRITE_SINGLE_BLOCK ((uint32_t)0x00000010U) /*!< Write single block operation */
299 #define MMC_CONTEXT_WRITE_MULTIPLE_BLOCK ((uint32_t)0x00000020U) /*!< Write multiple blocks operation */
300 #define MMC_CONTEXT_IT ((uint32_t)0x00000008U) /*!< Process in Interrupt mode */
301 #define MMC_CONTEXT_DMA ((uint32_t)0x00000080U) /*!< Process in DMA mode */
302
303 /**
304 * @}
305 */
306
307 /** @defgroup MMC_Exported_Constansts_Group3 MMC Voltage mode
308 * @{
309 */
310 /**
311 * @brief
312 */
313 #define MMC_HIGH_VOLTAGE_RANGE 0x80FF8000U /*!< VALUE OF ARGUMENT */
314 #define MMC_DUAL_VOLTAGE_RANGE 0x80FF8080U /*!< VALUE OF ARGUMENT */
315 #define eMMC_HIGH_VOLTAGE_RANGE 0xC0FF8000U /*!< for eMMC > 2Gb sector mode */
316 #define eMMC_DUAL_VOLTAGE_RANGE 0xC0FF8080U /*!< for eMMC > 2Gb sector mode */
317 #define MMC_INVALID_VOLTAGE_RANGE 0x0001FF01U
318 /**
319 * @}
320 */
321
322 /** @defgroup MMC_Exported_Constansts_Group4 MMC Memory Cards
323 * @{
324 */
325 #define MMC_HIGH_VOLTAGE_CARD ((uint32_t)0x00000000U)
326 #define MMC_DUAL_VOLTAGE_CARD ((uint32_t)0x00000001U)
327 /**
328 * @}
329 */
330
331 /**
332 * @}
333 */
334
335 /* Exported macro ------------------------------------------------------------*/
336 /** @defgroup MMC_Exported_macros MMC Exported Macros
337 * @brief macros to handle interrupts and specific clock configurations
338 * @{
339 */
340
341 /**
342 * @brief Enable the MMC device.
343 * @retval None
344 */
345 #define __HAL_MMC_ENABLE(__HANDLE__) __SDMMC_ENABLE((__HANDLE__)->Instance)
346
347 /**
348 * @brief Disable the MMC device.
349 * @retval None
350 */
351 #define __HAL_MMC_DISABLE(__HANDLE__) __SDMMC_DISABLE((__HANDLE__)->Instance)
352
353 /**
354 * @brief Enable the SDMMC DMA transfer.
355 * @retval None
356 */
357 #define __HAL_MMC_DMA_ENABLE(__HANDLE__) __SDMMC_DMA_ENABLE((__HANDLE__)->Instance)
358
359 /**
360 * @brief Disable the SDMMC DMA transfer.
361 * @retval None
362 */
363 #define __HAL_MMC_DMA_DISABLE(__HANDLE__) __SDMMC_DMA_DISABLE((__HANDLE__)->Instance)
364
365 /**
366 * @brief Enable the MMC device interrupt.
367 * @param __HANDLE__: MMC Handle
368 * @param __INTERRUPT__: specifies the SDMMC interrupt sources to be enabled.
369 * This parameter can be one or a combination of the following values:
370 * @arg SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
371 * @arg SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
372 * @arg SDMMC_IT_CTIMEOUT: Command response timeout interrupt
373 * @arg SDMMC_IT_DTIMEOUT: Data timeout interrupt
374 * @arg SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt
375 * @arg SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt
376 * @arg SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt
377 * @arg SDMMC_IT_CMDSENT: Command sent (no response required) interrupt
378 * @arg SDMMC_IT_DATAEND: Data end (data counter, SDIDCOUNT, is zero) interrupt
379 * @arg SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
380 * @arg SDMMC_IT_CMDACT: Command transfer in progress interrupt
381 * @arg SDMMC_IT_TXACT: Data transmit in progress interrupt
382 * @arg SDMMC_IT_RXACT: Data receive in progress interrupt
383 * @arg SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
384 * @arg SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt
385 * @arg SDMMC_IT_TXFIFOF: Transmit FIFO full interrupt
386 * @arg SDMMC_IT_RXFIFOF: Receive FIFO full interrupt
387 * @arg SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt
388 * @arg SDMMC_IT_RXFIFOE: Receive FIFO empty interrupt
389 * @arg SDMMC_IT_TXDAVL: Data available in transmit FIFO interrupt
390 * @arg SDMMC_IT_RXDAVL: Data available in receive FIFO interrupt
391 * @arg SDMMC_IT_SDIOIT: SD I/O interrupt received interrupt
392 * @retval None
393 */
394 #define __HAL_MMC_ENABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_ENABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
395
396 /**
397 * @brief Disable the MMC device interrupt.
398 * @param __HANDLE__: MMC Handle
399 * @param __INTERRUPT__: specifies the SDMMC interrupt sources to be disabled.
400 * This parameter can be one or a combination of the following values:
401 * @arg SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
402 * @arg SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
403 * @arg SDMMC_IT_CTIMEOUT: Command response timeout interrupt
404 * @arg SDMMC_IT_DTIMEOUT: Data timeout interrupt
405 * @arg SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt
406 * @arg SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt
407 * @arg SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt
408 * @arg SDMMC_IT_CMDSENT: Command sent (no response required) interrupt
409 * @arg SDMMC_IT_DATAEND: Data end (data counter, SDIDCOUNT, is zero) interrupt
410 * @arg SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
411 * @arg SDMMC_IT_CMDACT: Command transfer in progress interrupt
412 * @arg SDMMC_IT_TXACT: Data transmit in progress interrupt
413 * @arg SDMMC_IT_RXACT: Data receive in progress interrupt
414 * @arg SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
415 * @arg SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt
416 * @arg SDMMC_IT_TXFIFOF: Transmit FIFO full interrupt
417 * @arg SDMMC_IT_RXFIFOF: Receive FIFO full interrupt
418 * @arg SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt
419 * @arg SDMMC_IT_RXFIFOE: Receive FIFO empty interrupt
420 * @arg SDMMC_IT_TXDAVL: Data available in transmit FIFO interrupt
421 * @arg SDMMC_IT_RXDAVL: Data available in receive FIFO interrupt
422 * @arg SDMMC_IT_SDIOIT: SD I/O interrupt received interrupt
423 * @retval None
424 */
425 #define __HAL_MMC_DISABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_DISABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
426
427 /**
428 * @brief Check whether the specified MMC flag is set or not.
429 * @param __HANDLE__: MMC Handle
430 * @param __FLAG__: specifies the flag to check.
431 * This parameter can be one of the following values:
432 * @arg SDMMC_FLAG_CCRCFAIL: Command response received (CRC check failed)
433 * @arg SDMMC_FLAG_DCRCFAIL: Data block sent/received (CRC check failed)
434 * @arg SDMMC_FLAG_CTIMEOUT: Command response timeout
435 * @arg SDMMC_FLAG_DTIMEOUT: Data timeout
436 * @arg SDMMC_FLAG_TXUNDERR: Transmit FIFO underrun error
437 * @arg SDMMC_FLAG_RXOVERR: Received FIFO overrun error
438 * @arg SDMMC_FLAG_CMDREND: Command response received (CRC check passed)
439 * @arg SDMMC_FLAG_CMDSENT: Command sent (no response required)
440 * @arg SDMMC_FLAG_DATAEND: Data end (data counter, SDIDCOUNT, is zero)
441 * @arg SDMMC_FLAG_DBCKEND: Data block sent/received (CRC check passed)
442 * @arg SDMMC_FLAG_CMDACT: Command transfer in progress
443 * @arg SDMMC_FLAG_TXACT: Data transmit in progress
444 * @arg SDMMC_FLAG_RXACT: Data receive in progress
445 * @arg SDMMC_FLAG_TXFIFOHE: Transmit FIFO Half Empty
446 * @arg SDMMC_FLAG_RXFIFOHF: Receive FIFO Half Full
447 * @arg SDMMC_FLAG_TXFIFOF: Transmit FIFO full
448 * @arg SDMMC_FLAG_RXFIFOF: Receive FIFO full
449 * @arg SDMMC_FLAG_TXFIFOE: Transmit FIFO empty
450 * @arg SDMMC_FLAG_RXFIFOE: Receive FIFO empty
451 * @arg SDMMC_FLAG_TXDAVL: Data available in transmit FIFO
452 * @arg SDMMC_FLAG_RXDAVL: Data available in receive FIFO
453 * @arg SDMMC_FLAG_SDIOIT: SD I/O interrupt received
454 * @retval The new state of MMC FLAG (SET or RESET).
455 */
456 #define __HAL_MMC_GET_FLAG(__HANDLE__, __FLAG__) __SDMMC_GET_FLAG((__HANDLE__)->Instance, (__FLAG__))
457
458 /**
459 * @brief Clear the MMC's pending flags.
460 * @param __HANDLE__: MMC Handle
461 * @param __FLAG__: specifies the flag to clear.
462 * This parameter can be one or a combination of the following values:
463 * @arg SDMMC_FLAG_CCRCFAIL: Command response received (CRC check failed)
464 * @arg SDMMC_FLAG_DCRCFAIL: Data block sent/received (CRC check failed)
465 * @arg SDMMC_FLAG_CTIMEOUT: Command response timeout
466 * @arg SDMMC_FLAG_DTIMEOUT: Data timeout
467 * @arg SDMMC_FLAG_TXUNDERR: Transmit FIFO underrun error
468 * @arg SDMMC_FLAG_RXOVERR: Received FIFO overrun error
469 * @arg SDMMC_FLAG_CMDREND: Command response received (CRC check passed)
470 * @arg SDMMC_FLAG_CMDSENT: Command sent (no response required)
471 * @arg SDMMC_FLAG_DATAEND: Data end (data counter, SDIDCOUNT, is zero)
472 * @arg SDMMC_FLAG_DBCKEND: Data block sent/received (CRC check passed)
473 * @arg SDMMC_FLAG_SDIOIT: SD I/O interrupt received
474 * @retval None
475 */
476 #define __HAL_MMC_CLEAR_FLAG(__HANDLE__, __FLAG__) __SDMMC_CLEAR_FLAG((__HANDLE__)->Instance, (__FLAG__))
477
478 /**
479 * @brief Check whether the specified MMC interrupt has occurred or not.
480 * @param __HANDLE__: MMC Handle
481 * @param __INTERRUPT__: specifies the SDMMC interrupt source to check.
482 * This parameter can be one of the following values:
483 * @arg SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
484 * @arg SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
485 * @arg SDMMC_IT_CTIMEOUT: Command response timeout interrupt
486 * @arg SDMMC_IT_DTIMEOUT: Data timeout interrupt
487 * @arg SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt
488 * @arg SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt
489 * @arg SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt
490 * @arg SDMMC_IT_CMDSENT: Command sent (no response required) interrupt
491 * @arg SDMMC_IT_DATAEND: Data end (data counter, SDIDCOUNT, is zero) interrupt
492 * @arg SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
493 * @arg SDMMC_IT_CMDACT: Command transfer in progress interrupt
494 * @arg SDMMC_IT_TXACT: Data transmit in progress interrupt
495 * @arg SDMMC_IT_RXACT: Data receive in progress interrupt
496 * @arg SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
497 * @arg SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt
498 * @arg SDMMC_IT_TXFIFOF: Transmit FIFO full interrupt
499 * @arg SDMMC_IT_RXFIFOF: Receive FIFO full interrupt
500 * @arg SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt
501 * @arg SDMMC_IT_RXFIFOE: Receive FIFO empty interrupt
502 * @arg SDMMC_IT_TXDAVL: Data available in transmit FIFO interrupt
503 * @arg SDMMC_IT_RXDAVL: Data available in receive FIFO interrupt
504 * @arg SDMMC_IT_SDIOIT: SD I/O interrupt received interrupt
505 * @retval The new state of SD IT (SET or RESET).
506 */
507 #define __HAL_MMC_GET_IT(__HANDLE__, __INTERRUPT__) __SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))
508
509 /**
510 * @brief Clear the MMC's interrupt pending bits.
511 * @param __HANDLE__: MMC Handle
512 * @param __INTERRUPT__: specifies the interrupt pending bit to clear.
513 * This parameter can be one or a combination of the following values:
514 * @arg SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
515 * @arg SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
516 * @arg SDMMC_IT_CTIMEOUT: Command response timeout interrupt
517 * @arg SDMMC_IT_DTIMEOUT: Data timeout interrupt
518 * @arg SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt
519 * @arg SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt
520 * @arg SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt
521 * @arg SDMMC_IT_CMDSENT: Command sent (no response required) interrupt
522 * @arg SDMMC_IT_DATAEND: Data end (data counter, SDMMC_DCOUNT, is zero) interrupt
523 * @arg SDMMC_IT_SDIOIT: SD I/O interrupt received interrupt
524 * @retval None
525 */
526 #define __HAL_MMC_CLEAR_IT(__HANDLE__, __INTERRUPT__) __SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))
527
528 /**
529 * @}
530 */
531
532 /* Exported functions --------------------------------------------------------*/
533 /** @defgroup MMC_Exported_Functions MMC Exported Functions
534 * @{
535 */
536
537 /** @defgroup MMC_Exported_Functions_Group1 Initialization and de-initialization functions
538 * @{
539 */
540 HAL_StatusTypeDef HAL_MMC_Init(MMC_HandleTypeDef *hmmc);
541 HAL_StatusTypeDef HAL_MMC_InitCard(MMC_HandleTypeDef *hmmc);
542 HAL_StatusTypeDef HAL_MMC_DeInit (MMC_HandleTypeDef *hmmc);
543 void HAL_MMC_MspInit(MMC_HandleTypeDef *hmmc);
544 void HAL_MMC_MspDeInit(MMC_HandleTypeDef *hmmc);
545 /**
546 * @}
547 */
548
549 /** @defgroup MMC_Exported_Functions_Group2 Input and Output operation functions
550 * @{
551 */
552 /* Blocking mode: Polling */
553 HAL_StatusTypeDef HAL_MMC_ReadBlocks(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout);
554 HAL_StatusTypeDef HAL_MMC_WriteBlocks(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout);
555 HAL_StatusTypeDef HAL_MMC_Erase(MMC_HandleTypeDef *hmmc, uint32_t BlockStartAdd, uint32_t BlockEndAdd);
556 /* Non-Blocking mode: IT */
557 HAL_StatusTypeDef HAL_MMC_ReadBlocks_IT(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
558 HAL_StatusTypeDef HAL_MMC_WriteBlocks_IT(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
559 /* Non-Blocking mode: DMA */
560 HAL_StatusTypeDef HAL_MMC_ReadBlocks_DMA(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
561 HAL_StatusTypeDef HAL_MMC_WriteBlocks_DMA(MMC_HandleTypeDef *hmmc, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
562
563 void HAL_MMC_IRQHandler(MMC_HandleTypeDef *hmmc);
564
565 /* Callback in non blocking modes (DMA) */
566 void HAL_MMC_TxCpltCallback(MMC_HandleTypeDef *hmmc);
567 void HAL_MMC_RxCpltCallback(MMC_HandleTypeDef *hmmc);
568 void HAL_MMC_ErrorCallback(MMC_HandleTypeDef *hmmc);
569 void HAL_MMC_AbortCallback(MMC_HandleTypeDef *hmmc);
570 /**
571 * @}
572 */
573
574 /** @defgroup MMC_Exported_Functions_Group3 Peripheral Control functions
575 * @{
576 */
577 HAL_StatusTypeDef HAL_MMC_ConfigWideBusOperation(MMC_HandleTypeDef *hmmc, uint32_t WideMode);
578 /**
579 * @}
580 */
581
582 /** @defgroup MMC_Exported_Functions_Group4 MMC card related functions
583 * @{
584 */
585 HAL_MMC_CardStateTypeDef HAL_MMC_GetCardState(MMC_HandleTypeDef *hmmc);
586 HAL_StatusTypeDef HAL_MMC_GetCardCID(MMC_HandleTypeDef *hmmc, HAL_MMC_CardCIDTypeDef *pCID);
587 HAL_StatusTypeDef HAL_MMC_GetCardCSD(MMC_HandleTypeDef *hmmc, HAL_MMC_CardCSDTypeDef *pCSD);
588 HAL_StatusTypeDef HAL_MMC_GetCardInfo(MMC_HandleTypeDef *hmmc, HAL_MMC_CardInfoTypeDef *pCardInfo);
589 /**
590 * @}
591 */
592
593 /** @defgroup MMC_Exported_Functions_Group5 Peripheral State and Errors functions
594 * @{
595 */
596 HAL_MMC_StateTypeDef HAL_MMC_GetState(MMC_HandleTypeDef *hmmc);
597 uint32_t HAL_MMC_GetError(MMC_HandleTypeDef *hmmc);
598 /**
599 * @}
600 */
601
602 /** @defgroup MMC_Exported_Functions_Group6 Perioheral Abort management
603 * @{
604 */
605 HAL_StatusTypeDef HAL_MMC_Abort(MMC_HandleTypeDef *hmmc);
606 HAL_StatusTypeDef HAL_MMC_Abort_IT(MMC_HandleTypeDef *hmmc);
607 /**
608 * @}
609 */
610
611 /* Private types -------------------------------------------------------------*/
612 /** @defgroup MMC_Private_Types MMC Private Types
613 * @{
614 */
615
616 /**
617 * @}
618 */
619
620 /* Private defines -----------------------------------------------------------*/
621 /** @defgroup MMC_Private_Defines MMC Private Defines
622 * @{
623 */
624
625 /**
626 * @}
627 */
628
629 /* Private variables ---------------------------------------------------------*/
630 /** @defgroup MMC_Private_Variables MMC Private Variables
631 * @{
632 */
633
634 /**
635 * @}
636 */
637
638 /* Private constants ---------------------------------------------------------*/
639 /** @defgroup MMC_Private_Constants MMC Private Constants
640 * @{
641 */
642
643 /**
644 * @}
645 */
646
647 /* Private macros ------------------------------------------------------------*/
648 /** @defgroup MMC_Private_Macros MMC Private Macros
649 * @{
650 */
651
652 /**
653 * @}
654 */
655
656 /* Private functions prototypes ----------------------------------------------*/
657 /** @defgroup MMC_Private_Functions_Prototypes MMC Private Functions Prototypes
658 * @{
659 */
660
661 /**
662 * @}
663 */
664
665 /* Private functions ---------------------------------------------------------*/
666 /** @defgroup MMC_Private_Functions MMC Private Functions
667 * @{
668 */
669
670 /**
671 * @}
672 */
673
674
675 /**
676 * @}
677 */
678
679 /**
680 * @}
681 */
682
683 /**
684 * @}
685 */
686
687
688 #ifdef __cplusplus
689 }
690 #endif
691
692
693 #endif /* __STM32F7xx_HAL_MMC_H */
694
695 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
INAV: Navigation-enabled flight control software