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