1 /**
2   ******************************************************************************
3   * @file    stm32h7xx_hal_sd.h
4   * @author  MCD Application Team
5   * @brief   Header file of SD HAL module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2017 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32H7xx_HAL_SD_H
21 #define STM32H7xx_HAL_SD_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32h7xx_ll_sdmmc.h"
29 #if defined (DLYB_SDMMC1) || defined (DLYB_SDMMC2) || defined (DLYB_SDMMC3)
30 #include "stm32h7xx_ll_delayblock.h"
31 #endif /* (DLYB_SDMMC1) || (DLYB_SDMMC2) */
32 
33 /** @addtogroup STM32H7xx_HAL_Driver
34   * @{
35   */
36 
37 /** @defgroup SD SD
38   * @brief SD HAL module driver
39   * @{
40   */
41 
42 /* Exported types ------------------------------------------------------------*/
43 /** @defgroup SD_Exported_Types SD Exported Types
44   * @{
45   */
46 
47 /** @defgroup SD_Exported_Types_Group1 SD State enumeration structure
48   * @{
49   */
50 typedef enum
51 {
52   HAL_SD_STATE_RESET                  = ((uint32_t)0x00000000U),  /*!< SD not yet initialized or disabled  */
53   HAL_SD_STATE_READY                  = ((uint32_t)0x00000001U),  /*!< SD initialized and ready for use    */
54   HAL_SD_STATE_TIMEOUT                = ((uint32_t)0x00000002U),  /*!< SD Timeout state                    */
55   HAL_SD_STATE_BUSY                   = ((uint32_t)0x00000003U),  /*!< SD process ongoing                  */
56   HAL_SD_STATE_PROGRAMMING            = ((uint32_t)0x00000004U),  /*!< SD Programming State                */
57   HAL_SD_STATE_RECEIVING              = ((uint32_t)0x00000005U),  /*!< SD Receiving State                  */
58   HAL_SD_STATE_TRANSFER               = ((uint32_t)0x00000006U),  /*!< SD Transfer State                   */
59   HAL_SD_STATE_ERROR                  = ((uint32_t)0x0000000FU)   /*!< SD is in error state                */
60 } HAL_SD_StateTypeDef;
61 /**
62   * @}
63   */
64 
65 /** @defgroup SD_Exported_Types_Group2 SD Card State enumeration structure
66   * @{
67   */
68 typedef uint32_t HAL_SD_CardStateTypeDef;
69 
70 #define HAL_SD_CARD_READY          0x00000001U  /*!< Card state is ready                     */
71 #define HAL_SD_CARD_IDENTIFICATION 0x00000002U  /*!< Card is in identification state         */
72 #define HAL_SD_CARD_STANDBY        0x00000003U  /*!< Card is in standby state                */
73 #define HAL_SD_CARD_TRANSFER       0x00000004U  /*!< Card is in transfer state               */
74 #define HAL_SD_CARD_SENDING        0x00000005U  /*!< Card is sending an operation            */
75 #define HAL_SD_CARD_RECEIVING      0x00000006U  /*!< Card is receiving operation information */
76 #define HAL_SD_CARD_PROGRAMMING    0x00000007U  /*!< Card is in programming state            */
77 #define HAL_SD_CARD_DISCONNECTED   0x00000008U  /*!< Card is disconnected                    */
78 #define HAL_SD_CARD_ERROR          0x000000FFU  /*!< Card response Error                     */
79 /**
80   * @}
81   */
82 
83 /** @defgroup SD_Exported_Types_Group3 SD Handle Structure definition
84   * @{
85   */
86 #define SD_InitTypeDef      SDMMC_InitTypeDef
87 #define SD_TypeDef          SDMMC_TypeDef
88 
89 /**
90   * @brief  SD Card Information Structure definition
91   */
92 typedef struct
93 {
94   uint32_t CardType;                     /*!< Specifies the card Type                         */
95 
96   uint32_t CardVersion;                  /*!< Specifies the card version                      */
97 
98   uint32_t Class;                        /*!< Specifies the class of the card class           */
99 
100   uint32_t RelCardAdd;                   /*!< Specifies the Relative Card Address             */
101 
102   uint32_t BlockNbr;                     /*!< Specifies the Card Capacity in blocks           */
103 
104   uint32_t BlockSize;                    /*!< Specifies one block size in bytes               */
105 
106   uint32_t LogBlockNbr;                  /*!< Specifies the Card logical Capacity in blocks   */
107 
108   uint32_t LogBlockSize;                 /*!< Specifies logical block size in bytes           */
109 
110   uint32_t CardSpeed;                    /*!< Specifies the card Speed                        */
111 
112 } HAL_SD_CardInfoTypeDef;
113 
114 /**
115   * @brief  SD handle Structure definition
116   */
117 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
118 typedef struct __SD_HandleTypeDef
119 #else
120 typedef struct
121 #endif /* USE_HAL_SD_REGISTER_CALLBACKS */
122 {
123   SD_TypeDef                   *Instance;        /*!< SD registers base address           */
124 
125   SD_InitTypeDef               Init;             /*!< SD required parameters              */
126 
127   HAL_LockTypeDef              Lock;             /*!< SD locking object                   */
128 
129   const uint8_t                *pTxBuffPtr;      /*!< Pointer to SD Tx transfer Buffer    */
130 
131   uint32_t                     TxXferSize;       /*!< SD Tx Transfer size                 */
132 
133   uint8_t                      *pRxBuffPtr;      /*!< Pointer to SD Rx transfer Buffer    */
134 
135   uint32_t                     RxXferSize;       /*!< SD Rx Transfer size                 */
136 
137   __IO uint32_t                Context;          /*!< SD transfer context                 */
138 
139   __IO HAL_SD_StateTypeDef     State;            /*!< SD card State                       */
140 
141   __IO uint32_t                ErrorCode;        /*!< SD Card Error codes                 */
142 
143   HAL_SD_CardInfoTypeDef       SdCard;           /*!< SD Card information                 */
144 
145   uint32_t                     CSD[4];           /*!< SD card specific data table         */
146 
147   uint32_t                     CID[4];           /*!< SD card identification number table */
148 
149 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
150   void (* TxCpltCallback)(struct __SD_HandleTypeDef *hsd);
151   void (* RxCpltCallback)(struct __SD_HandleTypeDef *hsd);
152   void (* ErrorCallback)(struct __SD_HandleTypeDef *hsd);
153   void (* AbortCpltCallback)(struct __SD_HandleTypeDef *hsd);
154   void (* Read_DMADblBuf0CpltCallback)(struct __SD_HandleTypeDef *hsd);
155   void (* Read_DMADblBuf1CpltCallback)(struct __SD_HandleTypeDef *hsd);
156   void (* Write_DMADblBuf0CpltCallback)(struct __SD_HandleTypeDef *hsd);
157   void (* Write_DMADblBuf1CpltCallback)(struct __SD_HandleTypeDef *hsd);
158 #if (USE_SD_TRANSCEIVER != 0U)
159   void (* DriveTransceiver_1_8V_Callback)(FlagStatus status);
160 #endif /* USE_SD_TRANSCEIVER */
161 
162   void (* MspInitCallback)(struct __SD_HandleTypeDef *hsd);
163   void (* MspDeInitCallback)(struct __SD_HandleTypeDef *hsd);
164 #endif /* USE_HAL_SD_REGISTER_CALLBACKS */
165 } SD_HandleTypeDef;
166 
167 /**
168   * @}
169   */
170 
171 /** @defgroup SD_Exported_Types_Group4 Card Specific Data: CSD Register
172   * @{
173   */
174 typedef struct
175 {
176   __IO uint8_t  CSDStruct;            /*!< CSD structure                         */
177   __IO uint8_t  SysSpecVersion;       /*!< System specification version          */
178   __IO uint8_t  Reserved1;            /*!< Reserved                              */
179   __IO uint8_t  TAAC;                 /*!< Data read access time 1               */
180   __IO uint8_t  NSAC;                 /*!< Data read access time 2 in CLK cycles */
181   __IO uint8_t  MaxBusClkFrec;        /*!< Max. bus clock frequency              */
182   __IO uint16_t CardComdClasses;      /*!< Card command classes                  */
183   __IO uint8_t  RdBlockLen;           /*!< Max. read data block length           */
184   __IO uint8_t  PartBlockRead;        /*!< Partial blocks for read allowed       */
185   __IO uint8_t  WrBlockMisalign;      /*!< Write block misalignment              */
186   __IO uint8_t  RdBlockMisalign;      /*!< Read block misalignment               */
187   __IO uint8_t  DSRImpl;              /*!< DSR implemented                       */
188   __IO uint8_t  Reserved2;            /*!< Reserved                              */
189   __IO uint32_t DeviceSize;           /*!< Device Size                           */
190   __IO uint8_t  MaxRdCurrentVDDMin;   /*!< Max. read current @ VDD min           */
191   __IO uint8_t  MaxRdCurrentVDDMax;   /*!< Max. read current @ VDD max           */
192   __IO uint8_t  MaxWrCurrentVDDMin;   /*!< Max. write current @ VDD min          */
193   __IO uint8_t  MaxWrCurrentVDDMax;   /*!< Max. write current @ VDD max          */
194   __IO uint8_t  DeviceSizeMul;        /*!< Device size multiplier                */
195   __IO uint8_t  EraseGrSize;          /*!< Erase group size                      */
196   __IO uint8_t  EraseGrMul;           /*!< Erase group size multiplier           */
197   __IO uint8_t  WrProtectGrSize;      /*!< Write protect group size              */
198   __IO uint8_t  WrProtectGrEnable;    /*!< Write protect group enable            */
199   __IO uint8_t  ManDeflECC;           /*!< Manufacturer default ECC              */
200   __IO uint8_t  WrSpeedFact;          /*!< Write speed factor                    */
201   __IO uint8_t  MaxWrBlockLen;        /*!< Max. write data block length          */
202   __IO uint8_t  WriteBlockPaPartial;  /*!< Partial blocks for write allowed      */
203   __IO uint8_t  Reserved3;            /*!< Reserved                              */
204   __IO uint8_t  ContentProtectAppli;  /*!< Content protection application        */
205   __IO uint8_t  FileFormatGroup;      /*!< File format group                     */
206   __IO uint8_t  CopyFlag;             /*!< Copy flag (OTP)                       */
207   __IO uint8_t  PermWrProtect;        /*!< Permanent write protection            */
208   __IO uint8_t  TempWrProtect;        /*!< Temporary write protection            */
209   __IO uint8_t  FileFormat;           /*!< File format                           */
210   __IO uint8_t  ECC;                  /*!< ECC code                              */
211   __IO uint8_t  CSD_CRC;              /*!< CSD CRC                               */
212   __IO uint8_t  Reserved4;            /*!< Always 1                              */
213 } HAL_SD_CardCSDTypeDef;
214 /**
215   * @}
216   */
217 
218 /** @defgroup SD_Exported_Types_Group5 Card Identification Data: CID Register
219   * @{
220   */
221 typedef struct
222 {
223   __IO uint8_t  ManufacturerID;  /*!< Manufacturer ID       */
224   __IO uint16_t OEM_AppliID;     /*!< OEM/Application ID    */
225   __IO uint32_t ProdName1;       /*!< Product Name part1    */
226   __IO uint8_t  ProdName2;       /*!< Product Name part2    */
227   __IO uint8_t  ProdRev;         /*!< Product Revision      */
228   __IO uint32_t ProdSN;          /*!< Product Serial Number */
229   __IO uint8_t  Reserved1;       /*!< Reserved1             */
230   __IO uint16_t ManufactDate;    /*!< Manufacturing Date    */
231   __IO uint8_t  CID_CRC;         /*!< CID CRC               */
232   __IO uint8_t  Reserved2;       /*!< Always 1              */
233 
234 } HAL_SD_CardCIDTypeDef;
235 /**
236   * @}
237   */
238 
239 /** @defgroup SD_Exported_Types_Group6 SD Card Status returned by ACMD13
240   * @{
241   */
242 typedef struct
243 {
244   __IO uint8_t  DataBusWidth;           /*!< Shows the currently defined data bus width                 */
245   __IO uint8_t  SecuredMode;            /*!< Card is in secured mode of operation                       */
246   __IO uint16_t CardType;               /*!< Carries information about card type                        */
247   __IO uint32_t ProtectedAreaSize;      /*!< Carries information about the capacity of protected area   */
248   __IO uint8_t  SpeedClass;             /*!< Carries information about the speed class of the card      */
249   __IO uint8_t  PerformanceMove;        /*!< Carries information about the card's performance move      */
250   __IO uint8_t  AllocationUnitSize;     /*!< Carries information about the card's allocation unit size  */
251   __IO uint16_t EraseSize;              /*!< Determines the number of AUs to be erased in one operation */
252   __IO uint8_t  EraseTimeout;           /*!< Determines the timeout for any number of AU erase          */
253   __IO uint8_t  EraseOffset;            /*!< Carries information about the erase offset                 */
254   __IO uint8_t  UhsSpeedGrade;          /*!< Carries information about the speed grade of UHS card      */
255   __IO uint8_t  UhsAllocationUnitSize;  /*!< Carries information about the UHS card's allocation unit size  */
256   __IO uint8_t  VideoSpeedClass;        /*!< Carries information about the Video Speed Class of UHS card    */
257 } HAL_SD_CardStatusTypeDef;
258 /**
259   * @}
260   */
261 
262 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
263 /** @defgroup SD_Exported_Types_Group7 SD Callback ID enumeration definition
264   * @{
265   */
266 typedef enum
267 {
268   HAL_SD_TX_CPLT_CB_ID                 = 0x00U,  /*!< SD Tx Complete Callback ID                     */
269   HAL_SD_RX_CPLT_CB_ID                 = 0x01U,  /*!< SD Rx Complete Callback ID                     */
270   HAL_SD_ERROR_CB_ID                   = 0x02U,  /*!< SD Error Callback ID                           */
271   HAL_SD_ABORT_CB_ID                   = 0x03U,  /*!< SD Abort Callback ID                           */
272   HAL_SD_READ_DMA_DBL_BUF0_CPLT_CB_ID  = 0x04U,  /*!< SD Rx DMA Double Buffer 0 Complete Callback ID */
273   HAL_SD_READ_DMA_DBL_BUF1_CPLT_CB_ID  = 0x05U,  /*!< SD Rx DMA Double Buffer 1 Complete Callback ID */
274   HAL_SD_WRITE_DMA_DBL_BUF0_CPLT_CB_ID = 0x06U,  /*!< SD Tx DMA Double Buffer 0 Complete Callback ID */
275   HAL_SD_WRITE_DMA_DBL_BUF1_CPLT_CB_ID = 0x07U,  /*!< SD Tx DMA Double Buffer 1 Complete Callback ID */
276 
277   HAL_SD_MSP_INIT_CB_ID                = 0x10U,  /*!< SD MspInit Callback ID                         */
278   HAL_SD_MSP_DEINIT_CB_ID              = 0x11U   /*!< SD MspDeInit Callback ID                       */
279 } HAL_SD_CallbackIDTypeDef;
280 /**
281   * @}
282   */
283 
284 /** @defgroup SD_Exported_Types_Group8 SD Callback pointer definition
285   * @{
286   */
287 typedef void (*pSD_CallbackTypeDef)(SD_HandleTypeDef *hsd);
288 #if (USE_SD_TRANSCEIVER != 0U)
289 typedef void (*pSD_TransceiverCallbackTypeDef)(FlagStatus status);
290 #endif /* USE_SD_TRANSCEIVER */
291 /**
292   * @}
293   */
294 #endif /* USE_HAL_SD_REGISTER_CALLBACKS */
295 /**
296   * @}
297   */
298 
299 /* Exported constants --------------------------------------------------------*/
300 /** @defgroup SD_Exported_Constants SD Exported Constants
301   * @{
302   */
303 
304 #define BLOCKSIZE   ((uint32_t)512U) /*!< Block size is 512 bytes */
305 
306 /** @defgroup SD_Exported_Constansts_Group1 SD Error status enumeration Structure definition
307   * @{
308   */
309 #define HAL_SD_ERROR_NONE                     SDMMC_ERROR_NONE                        /*!< No error                                                     */
310 #define HAL_SD_ERROR_CMD_CRC_FAIL             SDMMC_ERROR_CMD_CRC_FAIL                /*!< Command response received (but CRC check failed)             */
311 #define HAL_SD_ERROR_DATA_CRC_FAIL            SDMMC_ERROR_DATA_CRC_FAIL               /*!< Data block sent/received (CRC check failed)                  */
312 #define HAL_SD_ERROR_CMD_RSP_TIMEOUT          SDMMC_ERROR_CMD_RSP_TIMEOUT             /*!< Command response timeout                                     */
313 #define HAL_SD_ERROR_DATA_TIMEOUT             SDMMC_ERROR_DATA_TIMEOUT                /*!< Data timeout                                                 */
314 #define HAL_SD_ERROR_TX_UNDERRUN              SDMMC_ERROR_TX_UNDERRUN                 /*!< Transmit FIFO underrun                                       */
315 #define HAL_SD_ERROR_RX_OVERRUN               SDMMC_ERROR_RX_OVERRUN                  /*!< Receive FIFO overrun                                         */
316 #define HAL_SD_ERROR_ADDR_MISALIGNED          SDMMC_ERROR_ADDR_MISALIGNED             /*!< Misaligned address                                           */
317 #define HAL_SD_ERROR_BLOCK_LEN_ERR            SDMMC_ERROR_BLOCK_LEN_ERR               /*!< Transferred block length is not allowed for the card or the  */
318                                                                                       /*!< number of transferred bytes does not match the block length  */
319 #define HAL_SD_ERROR_ERASE_SEQ_ERR            SDMMC_ERROR_ERASE_SEQ_ERR               /*!< An error in the sequence of erase command occurs             */
320 #define HAL_SD_ERROR_BAD_ERASE_PARAM          SDMMC_ERROR_BAD_ERASE_PARAM             /*!< An invalid selection for erase groups                        */
321 #define HAL_SD_ERROR_WRITE_PROT_VIOLATION     SDMMC_ERROR_WRITE_PROT_VIOLATION        /*!< Attempt to program a write protect block                     */
322 #define HAL_SD_ERROR_LOCK_UNLOCK_FAILED       SDMMC_ERROR_LOCK_UNLOCK_FAILED          /*!< Sequence or password error has been detected in unlock       */
323                                                                                       /*!< command or if there was an attempt to access a locked card   */
324 #define HAL_SD_ERROR_COM_CRC_FAILED           SDMMC_ERROR_COM_CRC_FAILED              /*!< CRC check of the previous command failed                     */
325 #define HAL_SD_ERROR_ILLEGAL_CMD              SDMMC_ERROR_ILLEGAL_CMD                 /*!< Command is not legal for the card state                      */
326 #define HAL_SD_ERROR_CARD_ECC_FAILED          SDMMC_ERROR_CARD_ECC_FAILED             /*!< Card internal ECC was applied but failed to correct the data */
327 #define HAL_SD_ERROR_CC_ERR                   SDMMC_ERROR_CC_ERR                      /*!< Internal card controller error                               */
328 #define HAL_SD_ERROR_GENERAL_UNKNOWN_ERR      SDMMC_ERROR_GENERAL_UNKNOWN_ERR         /*!< General or unknown error                                     */
329 #define HAL_SD_ERROR_STREAM_READ_UNDERRUN     SDMMC_ERROR_STREAM_READ_UNDERRUN        /*!< The card could not sustain data reading in stream rmode      */
330 #define HAL_SD_ERROR_STREAM_WRITE_OVERRUN     SDMMC_ERROR_STREAM_WRITE_OVERRUN        /*!< The card could not sustain data programming in stream mode   */
331 #define HAL_SD_ERROR_CID_CSD_OVERWRITE        SDMMC_ERROR_CID_CSD_OVERWRITE           /*!< CID/CSD overwrite error                                      */
332 #define HAL_SD_ERROR_WP_ERASE_SKIP            SDMMC_ERROR_WP_ERASE_SKIP               /*!< Only partial address space was erased                        */
333 #define HAL_SD_ERROR_CARD_ECC_DISABLED        SDMMC_ERROR_CARD_ECC_DISABLED           /*!< Command has been executed without using internal ECC         */
334 #define HAL_SD_ERROR_ERASE_RESET              SDMMC_ERROR_ERASE_RESET                 /*!< Erase sequence was cleared before executing because an out   */
335                                                                                       /*!< of erase sequence command was received                       */
336 #define HAL_SD_ERROR_AKE_SEQ_ERR              SDMMC_ERROR_AKE_SEQ_ERR                 /*!< Error in sequence of authentication                          */
337 #define HAL_SD_ERROR_INVALID_VOLTRANGE        SDMMC_ERROR_INVALID_VOLTRANGE           /*!< Error in case of invalid voltage range                       */
338 #define HAL_SD_ERROR_ADDR_OUT_OF_RANGE        SDMMC_ERROR_ADDR_OUT_OF_RANGE           /*!< Error when addressed block is out of range                   */
339 #define HAL_SD_ERROR_REQUEST_NOT_APPLICABLE   SDMMC_ERROR_REQUEST_NOT_APPLICABLE      /*!< Error when command request is not applicable                 */
340 #define HAL_SD_ERROR_PARAM                    SDMMC_ERROR_INVALID_PARAMETER           /*!< the used parameter is not valid                              */
341 #define HAL_SD_ERROR_UNSUPPORTED_FEATURE      SDMMC_ERROR_UNSUPPORTED_FEATURE         /*!< Error when feature is not insupported                        */
342 #define HAL_SD_ERROR_BUSY                     SDMMC_ERROR_BUSY                        /*!< Error when transfer process is busy                          */
343 #define HAL_SD_ERROR_DMA                      SDMMC_ERROR_DMA                         /*!< Error while DMA transfer                                     */
344 #define HAL_SD_ERROR_TIMEOUT                  SDMMC_ERROR_TIMEOUT                     /*!< Timeout error                                                */
345 
346 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
347 #define HAL_SD_ERROR_INVALID_CALLBACK         SDMMC_ERROR_INVALID_PARAMETER       /*!< Invalid callback error                                        */
348 #endif /* USE_HAL_SD_REGISTER_CALLBACKS */
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 /* USE_HAL_SD_REGISTER_CALLBACKS */
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_DPSMACT:    Data path state machine active
498   *            @arg SDMMC_FLAG_CPSMACT:    Command 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_TXFIFOHE:   Transmit FIFO Half Empty interrupt
565   *            @arg SDMMC_IT_RXFIFOHF:   Receive FIFO Half Full interrupt
566   *            @arg SDMMC_IT_RXFIFOF:    Receive FIFO full interrupt
567   *            @arg SDMMC_IT_TXFIFOE:    Transmit FIFO empty interrupt
568   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
569   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
570   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
571   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
572   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
573   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
574   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
575   * @retval The new state of SD IT (SET or RESET).
576   */
577 #define __HAL_SD_GET_IT(__HANDLE__, __INTERRUPT__) __SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))
578 
579 /**
580   * @brief  Clear the SD's interrupt pending bits.
581   * @param  __HANDLE__ SD Handle.
582   * @param  __INTERRUPT__ specifies the interrupt pending bit to clear.
583   *          This parameter can be one or a combination of the following values:
584   *            @arg SDMMC_IT_CCRCFAIL:   Command response received (CRC check failed) interrupt
585   *            @arg SDMMC_IT_DCRCFAIL:   Data block sent/received (CRC check failed) interrupt
586   *            @arg SDMMC_IT_CTIMEOUT:   Command response timeout interrupt
587   *            @arg SDMMC_IT_DTIMEOUT:   Data timeout interrupt
588   *            @arg SDMMC_IT_TXUNDERR:   Transmit FIFO underrun error interrupt
589   *            @arg SDMMC_IT_RXOVERR:    Received FIFO overrun error interrupt
590   *            @arg SDMMC_IT_CMDREND:    Command response received (CRC check passed) interrupt
591   *            @arg SDMMC_IT_CMDSENT:    Command sent (no response required) interrupt
592   *            @arg SDMMC_IT_DATAEND:    Data end (data counter, DATACOUNT, is zero) interrupt
593   *            @arg SDMMC_IT_DHOLD:      Data transfer Hold interrupt
594   *            @arg SDMMC_IT_DBCKEND:    Data block sent/received (CRC check passed) interrupt
595   *            @arg SDMMC_IT_DABORT:     Data transfer aborted by CMD12 interrupt
596   *            @arg SDMMC_IT_BUSYD0END:  End of SDMMC_D0 Busy following a CMD response detected interrupt
597   *            @arg SDMMC_IT_SDIOIT:     SDIO interrupt received interrupt
598   *            @arg SDMMC_IT_ACKFAIL:    Boot Acknowledgment received interrupt
599   *            @arg SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt
600   *            @arg SDMMC_IT_VSWEND:     Voltage switch critical timing section completion interrupt
601   *            @arg SDMMC_IT_CKSTOP:     SDMMC_CK stopped in Voltage switch procedure interrupt
602   *            @arg SDMMC_IT_IDMABTC:    IDMA buffer transfer complete interrupt
603   * @retval None
604   */
605 #define __HAL_SD_CLEAR_IT(__HANDLE__, __INTERRUPT__) __SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))
606 
607 /**
608   * @}
609   */
610 
611 /* Include SD HAL Extension module */
612 #include "stm32h7xx_hal_sd_ex.h"
613 
614 /* Exported functions --------------------------------------------------------*/
615 /** @defgroup SD_Exported_Functions SD Exported Functions
616   * @{
617   */
618 
619 /** @defgroup SD_Exported_Functions_Group1 Initialization and de-initialization functions
620   * @{
621   */
622 HAL_StatusTypeDef HAL_SD_Init(SD_HandleTypeDef *hsd);
623 HAL_StatusTypeDef HAL_SD_InitCard(SD_HandleTypeDef *hsd);
624 HAL_StatusTypeDef HAL_SD_DeInit(SD_HandleTypeDef *hsd);
625 void              HAL_SD_MspInit(SD_HandleTypeDef *hsd);
626 void              HAL_SD_MspDeInit(SD_HandleTypeDef *hsd);
627 /**
628   * @}
629   */
630 
631 /** @defgroup SD_Exported_Functions_Group2 Input and Output operation functions
632   * @{
633   */
634 /* Blocking mode: Polling */
635 HAL_StatusTypeDef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks,
636                                     uint32_t Timeout);
637 HAL_StatusTypeDef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd, const uint8_t *pData, uint32_t BlockAdd,
638                                      uint32_t NumberOfBlocks, uint32_t Timeout);
639 HAL_StatusTypeDef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint32_t BlockStartAdd, uint32_t BlockEndAdd);
640 /* Non-Blocking mode: IT */
641 HAL_StatusTypeDef HAL_SD_ReadBlocks_IT(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd,
642                                        uint32_t NumberOfBlocks);
643 HAL_StatusTypeDef HAL_SD_WriteBlocks_IT(SD_HandleTypeDef *hsd, const uint8_t *pData, uint32_t BlockAdd,
644                                         uint32_t NumberOfBlocks);
645 /* Non-Blocking mode: DMA */
646 HAL_StatusTypeDef HAL_SD_ReadBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd,
647                                         uint32_t NumberOfBlocks);
648 HAL_StatusTypeDef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd, const uint8_t *pData, uint32_t BlockAdd,
649                                          uint32_t NumberOfBlocks);
650 
651 void              HAL_SD_IRQHandler(SD_HandleTypeDef *hsd);
652 
653 /* Callback in non blocking modes (DMA) */
654 void              HAL_SD_TxCpltCallback(SD_HandleTypeDef *hsd);
655 void              HAL_SD_RxCpltCallback(SD_HandleTypeDef *hsd);
656 void              HAL_SD_ErrorCallback(SD_HandleTypeDef *hsd);
657 void              HAL_SD_AbortCallback(SD_HandleTypeDef *hsd);
658 
659 #if (USE_SD_TRANSCEIVER != 0U)
660 /* Callback to switch in 1.8V mode */
661 void              HAL_SD_DriveTransceiver_1_8V_Callback(FlagStatus status);
662 #endif /* USE_SD_TRANSCEIVER */
663 
664 #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
665 /* SD callback registering/unregistering */
666 HAL_StatusTypeDef HAL_SD_RegisterCallback(SD_HandleTypeDef *hsd, HAL_SD_CallbackIDTypeDef CallbackID,
667                                           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 /* USE_SD_TRANSCEIVER */
674 #endif /* USE_HAL_SD_REGISTER_CALLBACKS */
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 HAL_StatusTypeDef HAL_SD_ConfigSpeedBusOperation(SD_HandleTypeDef *hsd, uint32_t SpeedMode);
685 /**
686   * @}
687   */
688 
689 /** @defgroup SD_Exported_Functions_Group4 SD card related functions
690   * @{
691   */
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 /* STM32H7xx_HAL_SD_H */
801