mbed official / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/BUILD/mbed/TARGET_NUCLEO_H743ZI/TOOLCHAIN_ARM_MICRO/stm32h7xx_hal_sd.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

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