1 /**
2   ******************************************************************************
3   * @file    stm32mp1xx_hal_sd.h
4   * @author  MCD Application Team
5   * @brief   Header file of SD HAL module.
6   ******************************************************************************
7   * @attention
8   *
9   * <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
10   * All rights reserved.</center></h2>
11   *
12   * This software component is licensed by ST under BSD 3-Clause license,
13   * the "License"; You may not use this file except in compliance with the
14   * License. You may obtain a copy of the License at:
15   *                        opensource.org/licenses/BSD-3-Clause
16   *
17   ******************************************************************************
18   */
19 
20 /* Define to prevent recursive inclusion -------------------------------------*/
21 #ifndef STM32MP1xx_HAL_SD_H
22 #define STM32MP1xx_HAL_SD_H
23 
24 #ifdef __cplusplus
25  extern "C" {
26 #endif
27 
28 /* Includes ------------------------------------------------------------------*/
29 #include "stm32mp1xx_ll_sdmmc.h"
30 #if defined (DLYB_SDMMC1) || defined (DLYB_SDMMC2) || defined (DLYB_SDMMC3)
31 #include "stm32mp1xx_ll_delayblock.h"
32 #endif /* (DLYB_SDMMC1) || (DLYB_SDMMC2) */
33 
34 /** @addtogroup STM32MP1xx_HAL_Driver
35   * @{
36   */
37 
38 /** @defgroup SD SD
39   * @brief SD HAL module driver
40   * @{
41   */
42 
43 /* Exported types ------------------------------------------------------------*/
44 /** @defgroup SD_Exported_Types SD Exported Types
45   * @{
46   */
47 
48 /** @defgroup SD_Exported_Types_Group1 SD State enumeration structure
49   * @{
50   */
51 typedef enum
52 {
53   HAL_SD_STATE_RESET                  = ((uint32_t)0x00000000U),  /*!< SD not yet initialized or disabled  */
54   HAL_SD_STATE_READY                  = ((uint32_t)0x00000001U),  /*!< SD initialized and ready for use    */
55   HAL_SD_STATE_TIMEOUT                = ((uint32_t)0x00000002U),  /*!< SD Timeout state                    */
56   HAL_SD_STATE_BUSY                   = ((uint32_t)0x00000003U),  /*!< SD process ongoing                  */
57   HAL_SD_STATE_PROGRAMMING            = ((uint32_t)0x00000004U),  /*!< SD Programming State                */
58   HAL_SD_STATE_RECEIVING              = ((uint32_t)0x00000005U),  /*!< SD Receiving State                  */
59   HAL_SD_STATE_TRANSFER               = ((uint32_t)0x00000006U),  /*!< SD Transfert State                  */
60   HAL_SD_STATE_ERROR                  = ((uint32_t)0x0000000FU)   /*!< SD is in error state                */
61 }HAL_SD_StateTypeDef;
62 /**
63   * @}
64   */
65 
66 /** @defgroup SD_Exported_Types_Group2 SD Card State enumeration structure
67   * @{
68   */
69 typedef enum
70 {
71   HAL_SD_CARD_READY                  = ((uint32_t)0x00000001U),  /*!< Card state is ready                     */
72   HAL_SD_CARD_IDENTIFICATION         = ((uint32_t)0x00000002U),  /*!< Card is in identification state         */
73   HAL_SD_CARD_STANDBY                = ((uint32_t)0x00000003U),  /*!< Card is in standby state                */
74   HAL_SD_CARD_TRANSFER               = ((uint32_t)0x00000004U),  /*!< Card is in transfer state               */
75   HAL_SD_CARD_SENDING                = ((uint32_t)0x00000005U),  /*!< Card is sending an operation            */
76   HAL_SD_CARD_RECEIVING              = ((uint32_t)0x00000006U),  /*!< Card is receiving operation information */
77   HAL_SD_CARD_PROGRAMMING            = ((uint32_t)0x00000007U),  /*!< Card is in programming state            */
78   HAL_SD_CARD_DISCONNECTED           = ((uint32_t)0x00000008U),  /*!< Card is disconnected                    */
79   HAL_SD_CARD_ERROR                  = ((uint32_t)0x000000FFU)   /*!< Card response Error                     */
80 }HAL_SD_CardStateTypedef;
81 /**
82   * @}
83   */
84 
85 /** @defgroup SD_Exported_Types_Group3 SD Handle Structure definition
86   * @{
87   */
88 #define SD_InitTypeDef      SDMMC_InitTypeDef
89 #define SD_TypeDef          SDMMC_TypeDef
90 
91 /**
92   * @brief  SD Card Information Structure definition
93   */
94 typedef struct
95 {
96   uint32_t CardType;                     /*!< Specifies the card Type                         */
97 
98   uint32_t CardVersion;                  /*!< Specifies the card version                      */
99 
100   uint32_t Class;                        /*!< Specifies the class of the card class           */
101 
102   uint32_t RelCardAdd;                   /*!< Specifies the Relative Card Address            */
103 
104   uint32_t BlockNbr;                     /*!< Specifies the Card Capacity in blocks           */
105 
106   uint32_t BlockSize;                    /*!< Specifies one block size in bytes               */
107 
108   uint32_t LogBlockNbr;                  /*!< Specifies the Card logical Capacity in blocks   */
109 
110   uint32_t LogBlockSize;                 /*!< Specifies logical block size in bytes           */
111 
112   uint32_t CardSpeed;                    /*!< Specifies the card Speed                        */
113 
114 }HAL_SD_CardInfoTypeDef;
115 
116 /**
117   * @brief  SD handle Structure definition
118   */
119 typedef struct __SD_HandleTypeDef
120 {
121   SD_TypeDef                   *Instance;        /*!< SD registers base address           */
122 
123   SD_InitTypeDef               Init;             /*!< SD required parameters                         */
124 
125   HAL_LockTypeDef              Lock;             /*!< SD locking object                              */
126 
127   uint8_t                      *pTxBuffPtr;      /*!< Pointer to SD Tx transfer Buffer              */
128 
129   uint32_t                     TxXferSize;       /*!< SD Tx Transfer size                           */
130 
131   uint8_t                      *pRxBuffPtr;      /*!< Pointer to SD Rx transfer Buffer              */
132 
133   uint32_t                     RxXferSize;       /*!< SD Rx Transfer size                           */
134 
135   __IO uint32_t                Context;          /*!< SD transfer context                           */
136 
137   __IO HAL_SD_StateTypeDef     State;           /*!< SD card State                                   */
138 
139   __IO uint32_t                ErrorCode;       /*!< SD Card Error codes                              */
140 
141   HAL_SD_CardInfoTypeDef       SdCard;           /*!< SD Card information                 */
142 
143   uint32_t                     CSD[4];           /*!< SD card specific data table         */
144 
145   uint32_t                     CID[4];           /*!< SD card identification number table */
146 
147 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
148   void (* TxCpltCallback)                 (struct __SD_HandleTypeDef *hsd);
149   void (* RxCpltCallback)                 (struct __SD_HandleTypeDef *hsd);
150   void (* ErrorCallback)                  (struct __SD_HandleTypeDef *hsd);
151   void (* AbortCpltCallback)              (struct __SD_HandleTypeDef *hsd);
152   void (* Read_DMADblBuf0CpltCallback)    (struct __SD_HandleTypeDef *hsd);
153   void (* Read_DMADblBuf1CpltCallback)    (struct __SD_HandleTypeDef *hsd);
154   void (* Write_DMADblBuf0CpltCallback)   (struct __SD_HandleTypeDef *hsd);
155   void (* Write_DMADblBuf1CpltCallback)   (struct __SD_HandleTypeDef *hsd);
156 
157 #if (USE_SD_TRANSCEIVER != 0U)
158   void (* DriveTransceiver_1_8V_Callback) (FlagStatus status);
159 #endif
160 
161   void (* MspInitCallback)                (struct __SD_HandleTypeDef *hsd);
162   void (* MspDeInitCallback)              (struct __SD_HandleTypeDef *hsd);
163 #endif
164 }SD_HandleTypeDef;
165 
166 /**
167   * @}
168   */
169 
170 /** @defgroup SD_Exported_Types_Group4 Card Specific Data: CSD Register
171   * @{
172   */
173 typedef struct
174 {
175   __IO uint8_t  CSDStruct;            /*!< CSD structure                         */
176   __IO uint8_t  SysSpecVersion;       /*!< System specification version          */
177   __IO uint8_t  Reserved1;            /*!< Reserved                              */
178   __IO uint8_t  TAAC;                 /*!< Data read access time 1               */
179   __IO uint8_t  NSAC;                 /*!< Data read access time 2 in CLK cycles */
180   __IO uint8_t  MaxBusClkFrec;        /*!< Max. bus clock frequency              */
181   __IO uint16_t CardComdClasses;      /*!< Card command classes                  */
182   __IO uint8_t  RdBlockLen;           /*!< Max. read data block length           */
183   __IO uint8_t  PartBlockRead;        /*!< Partial blocks for read allowed       */
184   __IO uint8_t  WrBlockMisalign;      /*!< Write block misalignment              */
185   __IO uint8_t  RdBlockMisalign;      /*!< Read block misalignment               */
186   __IO uint8_t  DSRImpl;              /*!< DSR implemented                       */
187   __IO uint8_t  Reserved2;            /*!< Reserved                              */
188   __IO uint32_t DeviceSize;           /*!< Device Size                           */
189   __IO uint8_t  MaxRdCurrentVDDMin;   /*!< Max. read current @ VDD min           */
190   __IO uint8_t  MaxRdCurrentVDDMax;   /*!< Max. read current @ VDD max           */
191   __IO uint8_t  MaxWrCurrentVDDMin;   /*!< Max. write current @ VDD min          */
192   __IO uint8_t  MaxWrCurrentVDDMax;   /*!< Max. write current @ VDD max          */
193   __IO uint8_t  DeviceSizeMul;        /*!< Device size multiplier                */
194   __IO uint8_t  EraseGrSize;          /*!< Erase group size                      */
195   __IO uint8_t  EraseGrMul;           /*!< Erase group size multiplier           */
196   __IO uint8_t  WrProtectGrSize;      /*!< Write protect group size              */
197   __IO uint8_t  WrProtectGrEnable;    /*!< Write protect group enable            */
198   __IO uint8_t  ManDeflECC;           /*!< Manufacturer default ECC              */
199   __IO uint8_t  WrSpeedFact;          /*!< Write speed factor                    */
200   __IO uint8_t  MaxWrBlockLen;        /*!< Max. write data block length          */
201   __IO uint8_t  WriteBlockPaPartial;  /*!< Partial blocks for write allowed      */
202   __IO uint8_t  Reserved3;            /*!< Reserved                              */
203   __IO uint8_t  ContentProtectAppli;  /*!< Content protection application        */
204   __IO uint8_t  FileFormatGroup;      /*!< File format group                     */
205   __IO uint8_t  CopyFlag;             /*!< Copy flag (OTP)                       */
206   __IO uint8_t  PermWrProtect;        /*!< Permanent write protection            */
207   __IO uint8_t  TempWrProtect;        /*!< Temporary write protection            */
208   __IO uint8_t  FileFormat;           /*!< File format                           */
209   __IO uint8_t  ECC;                  /*!< ECC code                              */
210   __IO uint8_t  CSD_CRC;              /*!< CSD CRC                               */
211   __IO uint8_t  Reserved4;            /*!< Always 1                              */
212 }HAL_SD_CardCSDTypedef;
213 /**
214   * @}
215   */
216 
217 /** @defgroup SD_Exported_Types_Group5 Card Identification Data: CID Register
218   * @{
219   */
220 typedef struct
221 {
222   __IO uint8_t  ManufacturerID;  /*!< Manufacturer ID       */
223   __IO uint16_t OEM_AppliID;     /*!< OEM/Application ID    */
224   __IO uint32_t ProdName1;       /*!< Product Name part1    */
225   __IO uint8_t  ProdName2;       /*!< Product Name part2    */
226   __IO uint8_t  ProdRev;         /*!< Product Revision      */
227   __IO uint32_t ProdSN;          /*!< Product Serial Number */
228   __IO uint8_t  Reserved1;       /*!< Reserved1             */
229   __IO uint16_t ManufactDate;    /*!< Manufacturing Date    */
230   __IO uint8_t  CID_CRC;         /*!< CID CRC               */
231   __IO uint8_t  Reserved2;       /*!< Always 1              */
232 
233 }HAL_SD_CardCIDTypedef;
234 /**
235   * @}
236   */
237 
238 /** @defgroup SD_Exported_Types_Group6 SD Card Status returned by ACMD13
239   * @{
240   */
241 typedef struct
242 {
243   __IO uint8_t  DataBusWidth;           /*!< Shows the currently defined data bus width                 */
244   __IO uint8_t  SecuredMode;            /*!< Card is in secured mode of operation                       */
245   __IO uint16_t CardType;               /*!< Carries information about card type                        */
246   __IO uint32_t ProtectedAreaSize;      /*!< Carries information about the capacity of protected area   */
247   __IO uint8_t  SpeedClass;             /*!< Carries information about the speed class of the card      */
248   __IO uint8_t  PerformanceMove;        /*!< Carries information about the card's performance move      */
249   __IO uint8_t  AllocationUnitSize;     /*!< Carries information about the card's allocation unit size  */
250   __IO uint16_t EraseSize;              /*!< Determines the number of AUs to be erased in one operation */
251   __IO uint8_t  EraseTimeout;           /*!< Determines the timeout for any number of AU erase          */
252   __IO uint8_t  EraseOffset;            /*!< Carries information about the erase offset                 */
253   __IO uint8_t  UhsSpeedGrade;          /*!< Carries information about the speed grade of UHS card      */
254   __IO uint8_t  UhsAllocationUnitSize;  /*!< Carries information about the UHS card's allocation unit size  */
255   __IO uint8_t  VideoSpeedClass;        /*!< Carries information about the Video Speed Class of UHS card    */
256 }HAL_SD_CardStatusTypedef;
257 /**
258   * @}
259   */
260 
261 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
262 /** @defgroup SD_Exported_Types_Group7 SD Callback ID enumeration definition
263   * @{
264   */
265 typedef enum
266 {
267   HAL_SD_TX_CPLT_CB_ID                 = 0x00U,  /*!< SD Tx Complete Callback ID                     */
268   HAL_SD_RX_CPLT_CB_ID                 = 0x01U,  /*!< SD Rx Complete Callback ID                     */
269   HAL_SD_ERROR_CB_ID                   = 0x02U,  /*!< SD Error Callback ID                           */
270   HAL_SD_ABORT_CB_ID                   = 0x03U,  /*!< SD Abort Callback ID                           */
271   HAL_SD_READ_DMA_DBL_BUF0_CPLT_CB_ID  = 0x04U,  /*!< SD Rx DMA Double Buffer 0 Complete Callback ID */
272   HAL_SD_READ_DMA_DBL_BUF1_CPLT_CB_ID  = 0x05U,  /*!< SD Rx DMA Double Buffer 1 Complete Callback ID */
273   HAL_SD_WRITE_DMA_DBL_BUF0_CPLT_CB_ID = 0x06U,  /*!< SD Tx DMA Double Buffer 0 Complete Callback ID */
274   HAL_SD_WRITE_DMA_DBL_BUF1_CPLT_CB_ID = 0x07U,  /*!< SD Tx DMA Double Buffer 1 Complete Callback ID */
275 
276   HAL_SD_MSP_INIT_CB_ID                = 0x10U,  /*!< SD MspInit Callback ID                         */
277   HAL_SD_MSP_DEINIT_CB_ID              = 0x11U   /*!< SD MspDeInit Callback ID                       */
278 }HAL_SD_CallbackIDTypeDef;
279 /**
280   * @}
281   */
282 
283 /** @defgroup SD_Exported_Types_Group8 SD Callback pointer definition
284   * @{
285   */
286 typedef void (*pSD_CallbackTypeDef)           (SD_HandleTypeDef *hsd);
287 #if (USE_SD_TRANSCEIVER != 0U)
288 typedef void (*pSD_TransceiverCallbackTypeDef)(FlagStatus status);
289 #endif
290 /**
291   * @}
292   */
293 #endif
294 /**
295   * @}
296   */
297 
298 /* Exported constants --------------------------------------------------------*/
299 /** @defgroup SD_Exported_Constants Exported Constants
300   * @{
301   */
302 
303 #define BLOCKSIZE   ((uint32_t)512U) /*!< Block size is 512 bytes */
304 
305 /** @defgroup SD_Exported_Constansts_Group1 SD Error status enumeration Structure definition
306   * @{
307   */
308 #define HAL_SD_ERROR_NONE                     SDMMC_ERROR_NONE                        /*!< No error                                                     */
309 #define HAL_SD_ERROR_CMD_CRC_FAIL             SDMMC_ERROR_CMD_CRC_FAIL                /*!< Command response received (but CRC check failed)             */
310 #define HAL_SD_ERROR_DATA_CRC_FAIL            SDMMC_ERROR_DATA_CRC_FAIL               /*!< Data block sent/received (CRC check failed)                  */
311 #define HAL_SD_ERROR_CMD_RSP_TIMEOUT          SDMMC_ERROR_CMD_RSP_TIMEOUT             /*!< Command response timeout                                     */
312 #define HAL_SD_ERROR_DATA_TIMEOUT             SDMMC_ERROR_DATA_TIMEOUT                /*!< Data timeout                                                 */
313 #define HAL_SD_ERROR_TX_UNDERRUN              SDMMC_ERROR_TX_UNDERRUN                 /*!< Transmit FIFO underrun                                       */
314 #define HAL_SD_ERROR_RX_OVERRUN               SDMMC_ERROR_RX_OVERRUN                  /*!< Receive FIFO overrun                                         */
315 #define HAL_SD_ERROR_ADDR_MISALIGNED          SDMMC_ERROR_ADDR_MISALIGNED             /*!< Misaligned address                                           */
316 #define HAL_SD_ERROR_BLOCK_LEN_ERR            SDMMC_ERROR_BLOCK_LEN_ERR               /*!< Transferred block length is not allowed for the card or the
317                                                                                           number of transferred bytes does not match the block length   */
318 #define HAL_SD_ERROR_ERASE_SEQ_ERR            SDMMC_ERROR_ERASE_SEQ_ERR               /*!< An error in the sequence of erase command occurs             */
319 #define HAL_SD_ERROR_BAD_ERASE_PARAM          SDMMC_ERROR_BAD_ERASE_PARAM             /*!< An invalid selection for erase groups                        */
320 #define HAL_SD_ERROR_WRITE_PROT_VIOLATION     SDMMC_ERROR_WRITE_PROT_VIOLATION        /*!< Attempt to program a write protect block                     */
321 #define HAL_SD_ERROR_LOCK_UNLOCK_FAILED       SDMMC_ERROR_LOCK_UNLOCK_FAILED          /*!< Sequence or password error has been detected in unlock
322                                                                                            command or if there was an attempt to access a locked card   */
323 #define HAL_SD_ERROR_COM_CRC_FAILED           SDMMC_ERROR_COM_CRC_FAILED              /*!< CRC check of the previous command failed                     */
324 #define HAL_SD_ERROR_ILLEGAL_CMD              SDMMC_ERROR_ILLEGAL_CMD                 /*!< Command is not legal for the card state                      */
325 #define HAL_SD_ERROR_CARD_ECC_FAILED          SDMMC_ERROR_CARD_ECC_FAILED             /*!< Card internal ECC was applied but failed to correct the data */
326 #define HAL_SD_ERROR_CC_ERR                   SDMMC_ERROR_CC_ERR                      /*!< Internal card controller error                               */
327 #define HAL_SD_ERROR_GENERAL_UNKNOWN_ERR      SDMMC_ERROR_GENERAL_UNKNOWN_ERR         /*!< General or unknown error                                     */
328 #define HAL_SD_ERROR_STREAM_READ_UNDERRUN     SDMMC_ERROR_STREAM_READ_UNDERRUN        /*!< The card could not sustain data reading in stream rmode      */
329 #define HAL_SD_ERROR_STREAM_WRITE_OVERRUN     SDMMC_ERROR_STREAM_WRITE_OVERRUN        /*!< The card could not sustain data programming in stream mode   */
330 #define HAL_SD_ERROR_CID_CSD_OVERWRITE        SDMMC_ERROR_CID_CSD_OVERWRITE           /*!< CID/CSD overwrite error                                      */
331 #define HAL_SD_ERROR_WP_ERASE_SKIP            SDMMC_ERROR_WP_ERASE_SKIP               /*!< Only partial address space was erased                        */
332 #define HAL_SD_ERROR_CARD_ECC_DISABLED        SDMMC_ERROR_CARD_ECC_DISABLED           /*!< Command has been executed without using internal ECC         */
333 #define HAL_SD_ERROR_ERASE_RESET              SDMMC_ERROR_ERASE_RESET                 /*!< Erase sequence was cleared before executing because an out
334                                                                                            of erase sequence command was received                       */
335 #define HAL_SD_ERROR_AKE_SEQ_ERR              SDMMC_ERROR_AKE_SEQ_ERR                 /*!< Error in sequence of authentication                          */
336 #define HAL_SD_ERROR_INVALID_VOLTRANGE        SDMMC_ERROR_INVALID_VOLTRANGE           /*!< Error in case of invalid voltage range                       */
337 #define HAL_SD_ERROR_ADDR_OUT_OF_RANGE        SDMMC_ERROR_ADDR_OUT_OF_RANGE           /*!< Error when addressed block is out of range                   */
338 #define HAL_SD_ERROR_REQUEST_NOT_APPLICABLE   SDMMC_ERROR_REQUEST_NOT_APPLICABLE      /*!< Error when command request is not applicable                 */
339 #define HAL_SD_ERROR_PARAM                    SDMMC_ERROR_INVALID_PARAMETER           /*!< the used parameter is not valid                              */
340 #define HAL_SD_ERROR_UNSUPPORTED_FEATURE      SDMMC_ERROR_UNSUPPORTED_FEATURE         /*!< Error when feature is not insupported                        */
341 #define HAL_SD_ERROR_BUSY                     SDMMC_ERROR_BUSY                        /*!< Error when transfer process is busy                          */
342 #define HAL_SD_ERROR_DMA                      SDMMC_ERROR_DMA                         /*!< Error while DMA transfer                                     */
343 #define HAL_SD_ERROR_TIMEOUT                  SDMMC_ERROR_TIMEOUT                     /*!< Timeout error                                                 */
344 
345 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
346 #define HAL_SD_ERROR_INVALID_CALLBACK         SDMMC_ERROR_INVALID_PARAMETER       /*!< Invalid callback error                                        */
347 #endif
348 
349 /**
350   * @}
351   */
352 
353 /** @defgroup SD_Exported_Constansts_Group2 SD context enumeration
354   * @{
355   */
356 #define   SD_CONTEXT_NONE                 ((uint32_t)0x00000000U)  /*!< None                             */
357 #define   SD_CONTEXT_READ_SINGLE_BLOCK    ((uint32_t)0x00000001U)  /*!< Read single block operation      */
358 #define   SD_CONTEXT_READ_MULTIPLE_BLOCK  ((uint32_t)0x00000002U)  /*!< Read multiple blocks operation   */
359 #define   SD_CONTEXT_WRITE_SINGLE_BLOCK   ((uint32_t)0x00000010U)  /*!< Write single block operation     */
360 #define   SD_CONTEXT_WRITE_MULTIPLE_BLOCK ((uint32_t)0x00000020U)  /*!< Write multiple blocks operation  */
361 #define   SD_CONTEXT_IT                   ((uint32_t)0x00000008U)  /*!< Process in Interrupt mode        */
362 #define   SD_CONTEXT_DMA                  ((uint32_t)0x00000080U)  /*!< Process in DMA mode              */
363 
364 /**
365   * @}
366   */
367 
368 /** @defgroup SD_Exported_Constansts_Group3 SD Supported Memory Cards
369   * @{
370   */
371 #define CARD_NORMAL_SPEED        ((uint32_t)0x00000000U)    /*!< Normal Speed Card <12.5Mo/s , Spec Version 1.01    */
372 #define CARD_HIGH_SPEED          ((uint32_t)0x00000100U)    /*!< High Speed Card <25Mo/s , Spec version 2.00        */
373 #define CARD_ULTRA_HIGH_SPEED    ((uint32_t)0x00000200U)    /*!< UHS-I SD Card <50Mo/s for SDR50, DDR5 Cards
374                                                                 and <104Mo/s for SDR104, Spec version 3.01          */
375 
376 #define CARD_SDSC                  ((uint32_t)0x00000000U)  /*!< SD Standard Capacity <2Go                          */
377 #define CARD_SDHC_SDXC             ((uint32_t)0x00000001U)  /*!< SD High Capacity <32Go, SD Extended Capacity <2To  */
378 #define CARD_SECURED               ((uint32_t)0x00000003U)
379 
380 /**
381   * @}
382   */
383 
384 /** @defgroup SD_Exported_Constansts_Group4 SD Supported Version
385   * @{
386   */
387 #define CARD_V1_X                  ((uint32_t)0x00000000U)
388 #define CARD_V2_X                  ((uint32_t)0x00000001U)
389 /**
390   * @}
391   */
392 
393 /**
394   * @}
395   */
396 
397 /* Exported macro ------------------------------------------------------------*/
398 /** @defgroup SD_Exported_macros SD Exported Macros
399  *  @brief macros to handle interrupts and specific clock configurations
400  * @{
401  */
402 /** @brief Reset SD handle state.
403   * @param  __HANDLE__ : SD handle.
404   * @retval None
405   */
406 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
407 #define __HAL_SD_RESET_HANDLE_STATE(__HANDLE__)           do {                                              \
408                                                                (__HANDLE__)->State = HAL_SD_STATE_RESET; \
409                                                                (__HANDLE__)->MspInitCallback = NULL;       \
410                                                                (__HANDLE__)->MspDeInitCallback = NULL;     \
411                                                              } while(0)
412 #else
413 #define __HAL_SD_RESET_HANDLE_STATE(__HANDLE__)           ((__HANDLE__)->State = HAL_SD_STATE_RESET)
414 #endif
415 
416 /**
417   * @brief  Enable the SD device interrupt.
418   * @param  __HANDLE__: SD Handle
419   * @param  __INTERRUPT__: specifies the SDMMC interrupt sources to be enabled.
420   *         This parameter can be one or a combination of the following values:
421   *            @arg SDMMC_IT_CCRCFAIL:   Command response received (CRC check failed) interrupt
422   *            @arg SDMMC_IT_DCRCFAIL:   Data block sent/received (CRC check failed) interrupt
423   *            @arg SDMMC_IT_CTIMEOUT:   Command response timeout interrupt
424   *            @arg SDMMC_IT_DTIMEOUT:   Data timeout interrupt
425   *            @arg SDMMC_IT_TXUNDERR:   Transmit FIFO underrun error interrupt
426   *            @arg SDMMC_IT_RXOVERR:    Received FIFO overrun error interrupt
427   *            @arg SDMMC_IT_CMDREND:    Command response received (CRC check passed) interrupt
428   *            @arg SDMMC_IT_CMDSENT:    Command sent (no response required) interrupt
429   *            @arg SDMMC_IT_DATAEND:    Data end (data counter, DATACOUNT, is zero) interrupt
430   *            @arg SDMMC_IT_DHOLD:      Data transfer Hold interrupt
431   *            @arg SDMMC_IT_DBCKEND:    Data block sent/received (CRC check passed) interrupt
432   *            @arg SDMMC_IT_DABORT:     Data transfer aborted by CMD12 interrupt
433   *            @arg SDMMC_IT_TXFIFOHE:   Transmit FIFO Half Empty interrupt
434   *            @arg SDMMC_IT_RXFIFOHF:   Receive FIFO Half Full interrupt
435   *            @arg SDMMC_IT_RXFIFOF:    Receive FIFO full interrupt
436   *            @arg SDMMC_IT_TXFIFOE:    Transmit FIFO empty interrupt
437   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
438   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
439   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
440   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
441   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
442   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
443   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
444   * @retval None
445   */
446 #define __HAL_SD_ENABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_ENABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
447 
448 /**
449   * @brief  Disable the SD device interrupt.
450   * @param  __HANDLE__: SD Handle
451   * @param  __INTERRUPT__: specifies the SDMMC interrupt sources to be disabled.
452   *          This parameter can be one or a combination of the following values:
453   *            @arg SDMMC_IT_CCRCFAIL:   Command response received (CRC check failed) interrupt
454   *            @arg SDMMC_IT_DCRCFAIL:   Data block sent/received (CRC check failed) interrupt
455   *            @arg SDMMC_IT_CTIMEOUT:   Command response timeout interrupt
456   *            @arg SDMMC_IT_DTIMEOUT:   Data timeout interrupt
457   *            @arg SDMMC_IT_TXUNDERR:   Transmit FIFO underrun error interrupt
458   *            @arg SDMMC_IT_RXOVERR:    Received FIFO overrun error interrupt
459   *            @arg SDMMC_IT_CMDREND:    Command response received (CRC check passed) interrupt
460   *            @arg SDMMC_IT_CMDSENT:    Command sent (no response required) interrupt
461   *            @arg SDMMC_IT_DATAEND:    Data end (data counter, DATACOUNT, is zero) interrupt
462   *            @arg SDMMC_IT_DHOLD:      Data transfer Hold interrupt
463   *            @arg SDMMC_IT_DBCKEND:    Data block sent/received (CRC check passed) interrupt
464   *            @arg SDMMC_IT_DABORT:     Data transfer aborted by CMD12 interrupt
465   *            @arg SDMMC_IT_TXFIFOHE:   Transmit FIFO Half Empty interrupt
466   *            @arg SDMMC_IT_RXFIFOHF:   Receive FIFO Half Full interrupt
467   *            @arg SDMMC_IT_RXFIFOF:    Receive FIFO full interrupt
468   *            @arg SDMMC_IT_TXFIFOE:    Transmit FIFO empty interrupt
469   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
470   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
471   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
472   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
473   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
474   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
475   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
476   * @retval None
477   */
478 #define __HAL_SD_DISABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_DISABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
479 
480 /**
481   * @brief  Check whether the specified SD flag is set or not.
482   * @param  __HANDLE__: SD Handle
483   * @param  __FLAG__: specifies the flag to check.
484   *          This parameter can be one of the following values:
485   *            @arg SDMMC_FLAG_CCRCFAIL:   Command response received (CRC check failed)
486   *            @arg SDMMC_FLAG_DCRCFAIL:   Data block sent/received (CRC check failed)
487   *            @arg SDMMC_FLAG_CTIMEOUT:   Command response timeout
488   *            @arg SDMMC_FLAG_DTIMEOUT:   Data timeout
489   *            @arg SDMMC_FLAG_TXUNDERR:   Transmit FIFO underrun error
490   *            @arg SDMMC_FLAG_RXOVERR:    Received FIFO overrun error
491   *            @arg SDMMC_FLAG_CMDREND:    Command response received (CRC check passed)
492   *            @arg SDMMC_FLAG_CMDSENT:    Command sent (no response required)
493   *            @arg SDMMC_FLAG_DATAEND:    Data end (data counter, DATACOUNT, is zero)
494   *            @arg SDMMC_FLAG_DHOLD:      Data transfer Hold
495   *            @arg SDMMC_FLAG_DBCKEND:    Data block sent/received (CRC check passed)
496   *            @arg SDMMC_FLAG_DABORT:     Data transfer aborted by CMD12
497   *            @arg SDMMC_FLAG_CPSMACT:    Command path state machine active
498   *            @arg SDMMC_FLAG_DPSMACT:    Data path state machine active
499   *            @arg SDMMC_FLAG_TXFIFOHE:   Transmit FIFO Half Empty
500   *            @arg SDMMC_FLAG_RXFIFOHF:   Receive FIFO Half Full
501   *            @arg SDMMC_FLAG_TXFIFOF:    Transmit FIFO full
502   *            @arg SDMMC_FLAG_RXFIFOF:    Receive FIFO full
503   *            @arg SDMMC_FLAG_TXFIFOE:    Transmit FIFO empty
504   *            @arg SDMMC_FLAG_RXFIFOE:    Receive FIFO empty
505   *            @arg SDMMC_FLAG_BUSYD0:     Inverted value of SDMMC_D0 line (Busy)
506   *            @arg SDMMC_FLAG_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected
507   *            @arg SDMMC_FLAG_SDIOIT:     SDIO interrupt received
508   *            @arg SDMMC_FLAG_ACKFAIL:    Boot Acknowledgment received
509   *            @arg SDMMC_FLAG_ACKTIMEOUT: Boot Acknowledgment timeout
510   *            @arg SDMMC_FLAG_VSWEND:     Voltage switch critical timing section completion
511   *            @arg SDMMC_FLAG_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure
512   *            @arg SDMMC_FLAG_IDMATE:     IDMA transfer error
513   *            @arg SDMMC_FLAG_IDMABTC:    IDMA buffer transfer complete
514   * @retval The new state of SD FLAG (SET or RESET).
515   */
516 #define __HAL_SD_GET_FLAG(__HANDLE__, __FLAG__) __SDMMC_GET_FLAG((__HANDLE__)->Instance, (__FLAG__))
517 
518 /**
519   * @brief  Clear the SD's pending flags.
520   * @param  __HANDLE__: SD Handle
521   * @param  __FLAG__: specifies the flag to clear.
522   *          This parameter can be one or a combination of the following values:
523   *            @arg SDMMC_FLAG_CCRCFAIL:   Command response received (CRC check failed)
524   *            @arg SDMMC_FLAG_DCRCFAIL:   Data block sent/received (CRC check failed)
525   *            @arg SDMMC_FLAG_CTIMEOUT:   Command response timeout
526   *            @arg SDMMC_FLAG_DTIMEOUT:   Data timeout
527   *            @arg SDMMC_FLAG_TXUNDERR:   Transmit FIFO underrun error
528   *            @arg SDMMC_FLAG_RXOVERR:    Received FIFO overrun error
529   *            @arg SDMMC_FLAG_CMDREND:    Command response received (CRC check passed)
530   *            @arg SDMMC_FLAG_CMDSENT:    Command sent (no response required)
531   *            @arg SDMMC_FLAG_DATAEND:    Data end (data counter, DATACOUNT, is zero)
532   *            @arg SDMMC_FLAG_DHOLD:      Data transfer Hold
533   *            @arg SDMMC_FLAG_DBCKEND:    Data block sent/received (CRC check passed)
534   *            @arg SDMMC_FLAG_DABORT:     Data transfer aborted by CMD12
535   *            @arg SDMMC_FLAG_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected
536   *            @arg SDMMC_FLAG_SDIOIT:     SDIO interrupt received
537   *            @arg SDMMC_FLAG_ACKFAIL:    Boot Acknowledgment received
538   *            @arg SDMMC_FLAG_ACKTIMEOUT: Boot Acknowledgment timeout
539   *            @arg SDMMC_FLAG_VSWEND:     Voltage switch critical timing section completion
540   *            @arg SDMMC_FLAG_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure
541   *            @arg SDMMC_FLAG_IDMATE:     IDMA transfer error
542   *            @arg SDMMC_FLAG_IDMABTC:    IDMA buffer transfer complete
543   * @retval None
544   */
545 #define __HAL_SD_CLEAR_FLAG(__HANDLE__, __FLAG__) __SDMMC_CLEAR_FLAG((__HANDLE__)->Instance, (__FLAG__))
546 
547 /**
548   * @brief  Check whether the specified SD interrupt has occurred or not.
549   * @param  __HANDLE__: SD Handle
550   * @param  __INTERRUPT__: specifies the SDMMC interrupt source to check.
551   *          This parameter can be one of the following values:
552   *            @arg SDMMC_IT_CCRCFAIL:   Command response received (CRC check failed) interrupt
553   *            @arg SDMMC_IT_DCRCFAIL:   Data block sent/received (CRC check failed) interrupt
554   *            @arg SDMMC_IT_CTIMEOUT:   Command response timeout interrupt
555   *            @arg SDMMC_IT_DTIMEOUT:   Data timeout interrupt
556   *            @arg SDMMC_IT_TXUNDERR:   Transmit FIFO underrun error interrupt
557   *            @arg SDMMC_IT_RXOVERR:    Received FIFO overrun error interrupt
558   *            @arg SDMMC_IT_CMDREND:    Command response received (CRC check passed) interrupt
559   *            @arg SDMMC_IT_CMDSENT:    Command sent (no response required) interrupt
560   *            @arg SDMMC_IT_DATAEND:    Data end (data counter, DATACOUNT, is zero) interrupt
561   *            @arg SDMMC_IT_DHOLD:      Data transfer Hold interrupt
562   *            @arg SDMMC_IT_DBCKEND:    Data block sent/received (CRC check passed) interrupt
563   *            @arg SDMMC_IT_DABORT:     Data transfer aborted by CMD12 interrupt
564   *            @arg SDMMC_IT_DPSMACT:    Data path state machine active interrupt
565   *            @arg SDMMC_IT_CPSMACT:    Command path state machine active interrupt
566   *            @arg SDMMC_IT_TXFIFOHE:   Transmit FIFO Half Empty interrupt
567   *            @arg SDMMC_IT_RXFIFOHF:   Receive FIFO Half Full interrupt
568   *            @arg SDMMC_IT_TXFIFOF:    Transmit FIFO full interrupt
569   *            @arg SDMMC_IT_RXFIFOF:    Receive FIFO full interrupt
570   *            @arg SDMMC_IT_TXFIFOE:    Transmit FIFO empty interrupt
571   *            @arg SDMMC_IT_RXFIFOE:    Receive FIFO empty interrupt
572   *            @arg SDMMC_IT_BUSYD0:     Inverted value of SDMMC_D0 line (Busy)
573   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
574   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
575   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
576   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
577   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
578   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
579   *            @arg SDMMC_IT_IDMATE:     IDMA transfer error interrupt
580   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
581   * @retval The new state of SD IT (SET or RESET).
582   */
583 #define __HAL_SD_GET_IT(__HANDLE__, __INTERRUPT__) __SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))
584 
585 /**
586   * @brief  Clear the SD's interrupt pending bits.
587   * @param  __HANDLE__: SD Handle
588   * @param  __INTERRUPT__: specifies the interrupt pending bit to clear.
589   *          This parameter can be one or a combination of the following values:
590   *            @arg SDMMC_IT_CCRCFAIL:   Command response received (CRC check failed) interrupt
591   *            @arg SDMMC_IT_DCRCFAIL:   Data block sent/received (CRC check failed) interrupt
592   *            @arg SDMMC_IT_CTIMEOUT:   Command response timeout interrupt
593   *            @arg SDMMC_IT_DTIMEOUT:   Data timeout interrupt
594   *            @arg SDMMC_IT_TXUNDERR:   Transmit FIFO underrun error interrupt
595   *            @arg SDMMC_IT_RXOVERR:    Received FIFO overrun error interrupt
596   *            @arg SDMMC_IT_CMDREND:    Command response received (CRC check passed) interrupt
597   *            @arg SDMMC_IT_CMDSENT:    Command sent (no response required) interrupt
598   *            @arg SDMMC_IT_DATAEND:    Data end (data counter, DATACOUNT, is zero) interrupt
599   *            @arg SDMMC_IT_DHOLD:      Data transfer Hold interrupt
600   *            @arg SDMMC_IT_DBCKEND:    Data block sent/received (CRC check passed) interrupt
601   *            @arg SDMMC_IT_DABORT:     Data transfer aborted by CMD12 interrupt
602   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
603   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
604   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
605   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
606   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
607   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
608   *            @arg SDMMC_IT_IDMATE:     IDMA transfer error interrupt
609   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
610   * @retval None
611   */
612 #define __HAL_SD_CLEAR_IT(__HANDLE__, __INTERRUPT__) __SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))
613 
614 /**
615   * @}
616   */
617 
618 /* Include SD HAL Extension module */
619 #include "stm32mp1xx_hal_sd_ex.h"
620 
621 /* Exported functions --------------------------------------------------------*/
622 /** @defgroup SD_Exported_Functions SD Exported Functions
623   * @{
624   */
625 
626 /** @defgroup SD_Exported_Functions_Group1 Initialization and de-initialization functions
627   * @{
628   */
629 HAL_StatusTypeDef HAL_SD_Init(SD_HandleTypeDef *hsd);
630 HAL_StatusTypeDef HAL_SD_InitCard(SD_HandleTypeDef *hsd);
631 HAL_StatusTypeDef HAL_SD_DeInit (SD_HandleTypeDef *hsd);
632 void HAL_SD_MspInit(SD_HandleTypeDef *hsd);
633 void HAL_SD_MspDeInit(SD_HandleTypeDef *hsd);
634 /**
635   * @}
636   */
637 
638 /** @defgroup SD_Exported_Functions_Group2 Input and Output operation functions
639   * @{
640   */
641 /* Blocking mode: Polling */
642 HAL_StatusTypeDef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout);
643 HAL_StatusTypeDef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout);
644 HAL_StatusTypeDef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint32_t BlockStartAdd, uint32_t BlockEndAdd);
645 /* Non-Blocking mode: IT */
646 HAL_StatusTypeDef HAL_SD_ReadBlocks_IT(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
647 HAL_StatusTypeDef HAL_SD_WriteBlocks_IT(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
648 /* Non-Blocking mode: DMA */
649 HAL_StatusTypeDef HAL_SD_ReadBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
650 HAL_StatusTypeDef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks);
651 
652 void HAL_SD_IRQHandler(SD_HandleTypeDef *hsd);
653 
654 /* Callback in non blocking modes (DMA) */
655 void HAL_SD_TxCpltCallback(SD_HandleTypeDef *hsd);
656 void HAL_SD_RxCpltCallback(SD_HandleTypeDef *hsd);
657 void HAL_SD_ErrorCallback(SD_HandleTypeDef *hsd);
658 void HAL_SD_AbortCallback(SD_HandleTypeDef *hsd);
659 
660 #if (USE_SD_TRANSCEIVER != 0U)
661 /* Callback to switch in 1.8V mode */
662 void HAL_SD_DriveTransceiver_1_8V_Callback(FlagStatus status);
663 #endif
664 
665 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
666 /* SD callback registering/unregistering */
667 HAL_StatusTypeDef HAL_SD_RegisterCallback  (SD_HandleTypeDef *hsd, HAL_SD_CallbackIDTypeDef CallbackID, pSD_CallbackTypeDef pCallback);
668 HAL_StatusTypeDef HAL_SD_UnRegisterCallback(SD_HandleTypeDef *hsd, HAL_SD_CallbackIDTypeDef CallbackID);
669 
670 #if (USE_SD_TRANSCEIVER != 0U)
671 HAL_StatusTypeDef HAL_SD_RegisterTransceiverCallback  (SD_HandleTypeDef *hsd, pSD_TransceiverCallbackTypeDef pCallback);
672 HAL_StatusTypeDef HAL_SD_UnRegisterTransceiverCallback(SD_HandleTypeDef *hsd);
673 #endif
674 #endif
675 
676 /**
677   * @}
678   */
679 
680 /** @defgroup SD_Exported_Functions_Group3 Peripheral Control functions
681   * @{
682   */
683 HAL_StatusTypeDef HAL_SD_ConfigWideBusOperation(SD_HandleTypeDef *hsd, uint32_t WideMode);
684 /**
685   * @}
686   */
687 
688 /** @defgroup SD_Exported_Functions_Group4 SD card related functions
689   * @{
690   */
691 HAL_StatusTypeDef       HAL_SD_SendSDStatus(SD_HandleTypeDef *hsd, uint32_t *pSDstatus);
692 HAL_SD_CardStateTypedef HAL_SD_GetCardState(SD_HandleTypeDef *hsd);
693 HAL_StatusTypeDef       HAL_SD_GetCardCID(SD_HandleTypeDef *hsd, HAL_SD_CardCIDTypedef *pCID);
694 HAL_StatusTypeDef       HAL_SD_GetCardCSD(SD_HandleTypeDef *hsd, HAL_SD_CardCSDTypedef *pCSD);
695 HAL_StatusTypeDef       HAL_SD_GetCardStatus(SD_HandleTypeDef *hsd, HAL_SD_CardStatusTypedef *pStatus);
696 HAL_StatusTypeDef       HAL_SD_GetCardInfo(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypeDef *pCardInfo);
697 /**
698   * @}
699   */
700 
701 /** @defgroup SD_Exported_Functions_Group5 Peripheral State and Errors functions
702   * @{
703   */
704 HAL_SD_StateTypeDef HAL_SD_GetState(SD_HandleTypeDef *hsd);
705 uint32_t HAL_SD_GetError(SD_HandleTypeDef *hsd);
706 /**
707   * @}
708   */
709 
710 /** @defgroup SD_Exported_Functions_Group6 Perioheral Abort management
711   * @{
712   */
713 HAL_StatusTypeDef HAL_SD_Abort(SD_HandleTypeDef *hsd);
714 HAL_StatusTypeDef HAL_SD_Abort_IT(SD_HandleTypeDef *hsd);
715 /**
716   * @}
717   */
718 
719 /* Private types -------------------------------------------------------------*/
720 /** @defgroup SD_Private_Types SD Private Types
721   * @{
722   */
723 
724 /**
725   * @}
726   */
727 
728 /* Private defines -----------------------------------------------------------*/
729 /** @defgroup SD_Private_Defines SD Private Defines
730   * @{
731   */
732 
733 /**
734   * @}
735   */
736 
737 /* Private variables ---------------------------------------------------------*/
738 /** @defgroup SD_Private_Variables SD Private Variables
739   * @{
740   */
741 
742 /**
743   * @}
744   */
745 
746 /* Private constants ---------------------------------------------------------*/
747 /** @defgroup SD_Private_Constants SD Private Constants
748   * @{
749   */
750 
751 /**
752   * @}
753   */
754 
755 /* Private macros ------------------------------------------------------------*/
756 /** @defgroup SD_Private_Macros SD Private Macros
757   * @{
758   */
759 
760 /**
761   * @}
762   */
763 
764 /* Private functions prototypes ----------------------------------------------*/
765 /** @defgroup SD_Private_Functions_Prototypes SD Private Functions Prototypes
766   * @{
767   */
768 
769 /**
770   * @}
771   */
772 
773 /* Private functions ---------------------------------------------------------*/
774 /** @defgroup SD_Private_Functions SD Private Functions
775   * @{
776   */
777 
778 /**
779   * @}
780   */
781 
782 
783 /**
784   * @}
785   */
786 
787 /**
788   * @}
789   */
790 
791 /**
792   * @}
793   */
794 
795 #ifdef __cplusplus
796 }
797 #endif
798 
799 
800 #endif /* STM32MP1xx_HAL_SD_H */
801 
802 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
803