20#ifndef STM32H7xx_HAL_SD_H
21#define STM32H7xx_HAL_SD_H
29#if defined (DLYB_SDMMC1) || defined (DLYB_SDMMC2) || defined (DLYB_SDMMC3)
36#if defined (SDMMC1) || defined (SDMMC2)
53 HAL_SD_STATE_RESET = ((uint32_t)0x00000000U),
54 HAL_SD_STATE_READY = ((uint32_t)0x00000001U),
55 HAL_SD_STATE_TIMEOUT = ((uint32_t)0x00000002U),
56 HAL_SD_STATE_BUSY = ((uint32_t)0x00000003U),
57 HAL_SD_STATE_PROGRAMMING = ((uint32_t)0x00000004U),
58 HAL_SD_STATE_RECEIVING = ((uint32_t)0x00000005U),
59 HAL_SD_STATE_TRANSFER = ((uint32_t)0x00000006U),
60 HAL_SD_STATE_ERROR = ((uint32_t)0x0000000FU)
69typedef uint32_t HAL_SD_CardStateTypeDef;
71#define HAL_SD_CARD_READY 0x00000001U
72#define HAL_SD_CARD_IDENTIFICATION 0x00000002U
73#define HAL_SD_CARD_STANDBY 0x00000003U
74#define HAL_SD_CARD_TRANSFER 0x00000004U
75#define HAL_SD_CARD_SENDING 0x00000005U
76#define HAL_SD_CARD_RECEIVING 0x00000006U
77#define HAL_SD_CARD_PROGRAMMING 0x00000007U
78#define HAL_SD_CARD_DISCONNECTED 0x00000008U
79#define HAL_SD_CARD_ERROR 0x000000FFU
87#define SD_InitTypeDef SDMMC_InitTypeDef
88#define SD_TypeDef SDMMC_TypeDef
107 uint32_t LogBlockNbr;
109 uint32_t LogBlockSize;
113} HAL_SD_CardInfoTypeDef;
118#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
119typedef struct __SD_HandleTypeDef
124 SD_TypeDef *Instance;
130 const uint8_t *pTxBuffPtr;
138 __IO uint32_t Context;
142 __IO uint32_t ErrorCode;
144 HAL_SD_CardInfoTypeDef SdCard;
150#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
151 void (* TxCpltCallback)(
struct __SD_HandleTypeDef *hsd);
152 void (* RxCpltCallback)(
struct __SD_HandleTypeDef *hsd);
153 void (* ErrorCallback)(
struct __SD_HandleTypeDef *hsd);
154 void (* AbortCpltCallback)(
struct __SD_HandleTypeDef *hsd);
155 void (* Read_DMADblBuf0CpltCallback)(
struct __SD_HandleTypeDef *hsd);
156 void (* Read_DMADblBuf1CpltCallback)(
struct __SD_HandleTypeDef *hsd);
157 void (* Write_DMADblBuf0CpltCallback)(
struct __SD_HandleTypeDef *hsd);
158 void (* Write_DMADblBuf1CpltCallback)(
struct __SD_HandleTypeDef *hsd);
159#if (USE_SD_TRANSCEIVER != 0U)
163 void (* MspInitCallback)(
struct __SD_HandleTypeDef *hsd);
164 void (* MspDeInitCallback)(
struct __SD_HandleTypeDef *hsd);
177 __IO uint8_t CSDStruct;
178 __IO uint8_t SysSpecVersion;
179 __IO uint8_t Reserved1;
182 __IO uint8_t MaxBusClkFrec;
183 __IO uint16_t CardComdClasses;
184 __IO uint8_t RdBlockLen;
185 __IO uint8_t PartBlockRead;
186 __IO uint8_t WrBlockMisalign;
187 __IO uint8_t RdBlockMisalign;
188 __IO uint8_t DSRImpl;
189 __IO uint8_t Reserved2;
190 __IO uint32_t DeviceSize;
191 __IO uint8_t MaxRdCurrentVDDMin;
192 __IO uint8_t MaxRdCurrentVDDMax;
193 __IO uint8_t MaxWrCurrentVDDMin;
194 __IO uint8_t MaxWrCurrentVDDMax;
195 __IO uint8_t DeviceSizeMul;
196 __IO uint8_t EraseGrSize;
197 __IO uint8_t EraseGrMul;
198 __IO uint8_t WrProtectGrSize;
199 __IO uint8_t WrProtectGrEnable;
200 __IO uint8_t ManDeflECC;
201 __IO uint8_t WrSpeedFact;
202 __IO uint8_t MaxWrBlockLen;
203 __IO uint8_t WriteBlockPaPartial;
204 __IO uint8_t Reserved3;
205 __IO uint8_t ContentProtectAppli;
206 __IO uint8_t FileFormatGroup;
207 __IO uint8_t CopyFlag;
208 __IO uint8_t PermWrProtect;
209 __IO uint8_t TempWrProtect;
210 __IO uint8_t FileFormat;
212 __IO uint8_t CSD_CRC;
213 __IO uint8_t Reserved4;
214} HAL_SD_CardCSDTypeDef;
224 __IO uint8_t ManufacturerID;
225 __IO uint16_t OEM_AppliID;
226 __IO uint32_t ProdName1;
227 __IO uint8_t ProdName2;
228 __IO uint8_t ProdRev;
229 __IO uint32_t ProdSN;
230 __IO uint8_t Reserved1;
231 __IO uint16_t ManufactDate;
232 __IO uint8_t CID_CRC;
233 __IO uint8_t Reserved2;
235} HAL_SD_CardCIDTypeDef;
245 __IO uint8_t DataBusWidth;
246 __IO uint8_t SecuredMode;
247 __IO uint16_t CardType;
248 __IO uint32_t ProtectedAreaSize;
249 __IO uint8_t SpeedClass;
250 __IO uint8_t PerformanceMove;
251 __IO uint8_t AllocationUnitSize;
252 __IO uint16_t EraseSize;
253 __IO uint8_t EraseTimeout;
254 __IO uint8_t EraseOffset;
255 __IO uint8_t UhsSpeedGrade;
256 __IO uint8_t UhsAllocationUnitSize;
257 __IO uint8_t VideoSpeedClass;
258} HAL_SD_CardStatusTypeDef;
263#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
269 HAL_SD_TX_CPLT_CB_ID = 0x00U,
270 HAL_SD_RX_CPLT_CB_ID = 0x01U,
271 HAL_SD_ERROR_CB_ID = 0x02U,
272 HAL_SD_ABORT_CB_ID = 0x03U,
273 HAL_SD_READ_DMA_DBL_BUF0_CPLT_CB_ID = 0x04U,
274 HAL_SD_READ_DMA_DBL_BUF1_CPLT_CB_ID = 0x05U,
275 HAL_SD_WRITE_DMA_DBL_BUF0_CPLT_CB_ID = 0x06U,
276 HAL_SD_WRITE_DMA_DBL_BUF1_CPLT_CB_ID = 0x07U,
278 HAL_SD_MSP_INIT_CB_ID = 0x10U,
279 HAL_SD_MSP_DEINIT_CB_ID = 0x11U
280} HAL_SD_CallbackIDTypeDef;
288typedef void (*pSD_CallbackTypeDef)(SD_HandleTypeDef *hsd);
289#if (USE_SD_TRANSCEIVER != 0U)
305#define BLOCKSIZE ((uint32_t)512U)
310#define HAL_SD_ERROR_NONE SDMMC_ERROR_NONE
311#define HAL_SD_ERROR_CMD_CRC_FAIL SDMMC_ERROR_CMD_CRC_FAIL
312#define HAL_SD_ERROR_DATA_CRC_FAIL SDMMC_ERROR_DATA_CRC_FAIL
313#define HAL_SD_ERROR_CMD_RSP_TIMEOUT SDMMC_ERROR_CMD_RSP_TIMEOUT
314#define HAL_SD_ERROR_DATA_TIMEOUT SDMMC_ERROR_DATA_TIMEOUT
315#define HAL_SD_ERROR_TX_UNDERRUN SDMMC_ERROR_TX_UNDERRUN
316#define HAL_SD_ERROR_RX_OVERRUN SDMMC_ERROR_RX_OVERRUN
317#define HAL_SD_ERROR_ADDR_MISALIGNED SDMMC_ERROR_ADDR_MISALIGNED
318#define HAL_SD_ERROR_BLOCK_LEN_ERR SDMMC_ERROR_BLOCK_LEN_ERR
320#define HAL_SD_ERROR_ERASE_SEQ_ERR SDMMC_ERROR_ERASE_SEQ_ERR
321#define HAL_SD_ERROR_BAD_ERASE_PARAM SDMMC_ERROR_BAD_ERASE_PARAM
322#define HAL_SD_ERROR_WRITE_PROT_VIOLATION SDMMC_ERROR_WRITE_PROT_VIOLATION
323#define HAL_SD_ERROR_LOCK_UNLOCK_FAILED SDMMC_ERROR_LOCK_UNLOCK_FAILED
325#define HAL_SD_ERROR_COM_CRC_FAILED SDMMC_ERROR_COM_CRC_FAILED
326#define HAL_SD_ERROR_ILLEGAL_CMD SDMMC_ERROR_ILLEGAL_CMD
327#define HAL_SD_ERROR_CARD_ECC_FAILED SDMMC_ERROR_CARD_ECC_FAILED
328#define HAL_SD_ERROR_CC_ERR SDMMC_ERROR_CC_ERR
329#define HAL_SD_ERROR_GENERAL_UNKNOWN_ERR SDMMC_ERROR_GENERAL_UNKNOWN_ERR
330#define HAL_SD_ERROR_STREAM_READ_UNDERRUN SDMMC_ERROR_STREAM_READ_UNDERRUN
331#define HAL_SD_ERROR_STREAM_WRITE_OVERRUN SDMMC_ERROR_STREAM_WRITE_OVERRUN
332#define HAL_SD_ERROR_CID_CSD_OVERWRITE SDMMC_ERROR_CID_CSD_OVERWRITE
333#define HAL_SD_ERROR_WP_ERASE_SKIP SDMMC_ERROR_WP_ERASE_SKIP
334#define HAL_SD_ERROR_CARD_ECC_DISABLED SDMMC_ERROR_CARD_ECC_DISABLED
335#define HAL_SD_ERROR_ERASE_RESET SDMMC_ERROR_ERASE_RESET
337#define HAL_SD_ERROR_AKE_SEQ_ERR SDMMC_ERROR_AKE_SEQ_ERR
338#define HAL_SD_ERROR_INVALID_VOLTRANGE SDMMC_ERROR_INVALID_VOLTRANGE
339#define HAL_SD_ERROR_ADDR_OUT_OF_RANGE SDMMC_ERROR_ADDR_OUT_OF_RANGE
340#define HAL_SD_ERROR_REQUEST_NOT_APPLICABLE SDMMC_ERROR_REQUEST_NOT_APPLICABLE
341#define HAL_SD_ERROR_PARAM SDMMC_ERROR_INVALID_PARAMETER
342#define HAL_SD_ERROR_UNSUPPORTED_FEATURE SDMMC_ERROR_UNSUPPORTED_FEATURE
343#define HAL_SD_ERROR_BUSY SDMMC_ERROR_BUSY
344#define HAL_SD_ERROR_DMA SDMMC_ERROR_DMA
345#define HAL_SD_ERROR_TIMEOUT SDMMC_ERROR_TIMEOUT
347#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
348#define HAL_SD_ERROR_INVALID_CALLBACK SDMMC_ERROR_INVALID_PARAMETER
357#define SD_CONTEXT_NONE ((uint32_t)0x00000000U)
358#define SD_CONTEXT_READ_SINGLE_BLOCK ((uint32_t)0x00000001U)
359#define SD_CONTEXT_READ_MULTIPLE_BLOCK ((uint32_t)0x00000002U)
360#define SD_CONTEXT_WRITE_SINGLE_BLOCK ((uint32_t)0x00000010U)
361#define SD_CONTEXT_WRITE_MULTIPLE_BLOCK ((uint32_t)0x00000020U)
362#define SD_CONTEXT_IT ((uint32_t)0x00000008U)
363#define SD_CONTEXT_DMA ((uint32_t)0x00000080U)
372#define CARD_NORMAL_SPEED ((uint32_t)0x00000000U)
373#define CARD_HIGH_SPEED ((uint32_t)0x00000100U)
374#define CARD_ULTRA_HIGH_SPEED ((uint32_t)0x00000200U)
377#define CARD_SDSC ((uint32_t)0x00000000U)
378#define CARD_SDHC_SDXC ((uint32_t)0x00000001U)
379#define CARD_SECURED ((uint32_t)0x00000003U)
388#define CARD_V1_X ((uint32_t)0x00000000U)
389#define CARD_V2_X ((uint32_t)0x00000001U)
407#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
408#define __HAL_SD_RESET_HANDLE_STATE(__HANDLE__) do { \
409 (__HANDLE__)->State = HAL_SD_STATE_RESET; \
410 (__HANDLE__)->MspInitCallback = NULL; \
411 (__HANDLE__)->MspDeInitCallback = NULL; \
414#define __HAL_SD_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SD_STATE_RESET)
447#define __HAL_SD_ENABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_ENABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
479#define __HAL_SD_DISABLE_IT(__HANDLE__, __INTERRUPT__) __SDMMC_DISABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
517#define __HAL_SD_GET_FLAG(__HANDLE__, __FLAG__) __SDMMC_GET_FLAG((__HANDLE__)->Instance, (__FLAG__))
546#define __HAL_SD_CLEAR_FLAG(__HANDLE__, __FLAG__) __SDMMC_CLEAR_FLAG((__HANDLE__)->Instance, (__FLAG__))
578#define __HAL_SD_GET_IT(__HANDLE__, __INTERRUPT__) __SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))
606#define __HAL_SD_CLEAR_IT(__HANDLE__, __INTERRUPT__) __SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))
626void HAL_SD_MspInit(SD_HandleTypeDef *hsd);
627void HAL_SD_MspDeInit(SD_HandleTypeDef *hsd);
636HAL_StatusTypeDef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks,
638HAL_StatusTypeDef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd,
const uint8_t *pData, uint32_t BlockAdd,
639 uint32_t NumberOfBlocks, uint32_t Timeout);
640HAL_StatusTypeDef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint32_t BlockStartAdd, uint32_t BlockEndAdd);
642HAL_StatusTypeDef HAL_SD_ReadBlocks_IT(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd,
643 uint32_t NumberOfBlocks);
644HAL_StatusTypeDef HAL_SD_WriteBlocks_IT(SD_HandleTypeDef *hsd,
const uint8_t *pData, uint32_t BlockAdd,
645 uint32_t NumberOfBlocks);
647HAL_StatusTypeDef HAL_SD_ReadBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd,
648 uint32_t NumberOfBlocks);
649HAL_StatusTypeDef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd,
const uint8_t *pData, uint32_t BlockAdd,
650 uint32_t NumberOfBlocks);
652void HAL_SD_IRQHandler(SD_HandleTypeDef *hsd);
655void HAL_SD_TxCpltCallback(SD_HandleTypeDef *hsd);
656void HAL_SD_RxCpltCallback(SD_HandleTypeDef *hsd);
657void HAL_SD_ErrorCallback(SD_HandleTypeDef *hsd);
658void HAL_SD_AbortCallback(SD_HandleTypeDef *hsd);
660#if (USE_SD_TRANSCEIVER != 0U)
662void HAL_SD_DriveTransceiver_1_8V_Callback(
FlagStatus status);
665#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)
667HAL_StatusTypeDef HAL_SD_RegisterCallback(SD_HandleTypeDef *hsd, HAL_SD_CallbackIDTypeDef CallbackID,
668 pSD_CallbackTypeDef pCallback);
669HAL_StatusTypeDef HAL_SD_UnRegisterCallback(SD_HandleTypeDef *hsd, HAL_SD_CallbackIDTypeDef CallbackID);
671#if (USE_SD_TRANSCEIVER != 0U)
672HAL_StatusTypeDef HAL_SD_RegisterTransceiverCallback(SD_HandleTypeDef *hsd, pSD_TransceiverCallbackTypeDef pCallback);
684HAL_StatusTypeDef HAL_SD_ConfigWideBusOperation(SD_HandleTypeDef *hsd, uint32_t WideMode);
685HAL_StatusTypeDef HAL_SD_ConfigSpeedBusOperation(SD_HandleTypeDef *hsd, uint32_t SpeedMode);
693HAL_SD_CardStateTypeDef HAL_SD_GetCardState(SD_HandleTypeDef *hsd);
694HAL_StatusTypeDef HAL_SD_GetCardCID(
const SD_HandleTypeDef *hsd, HAL_SD_CardCIDTypeDef *pCID);
695HAL_StatusTypeDef HAL_SD_GetCardCSD(SD_HandleTypeDef *hsd, HAL_SD_CardCSDTypeDef *pCSD);
696HAL_StatusTypeDef HAL_SD_GetCardStatus(SD_HandleTypeDef *hsd, HAL_SD_CardStatusTypeDef *pStatus);
697HAL_StatusTypeDef HAL_SD_GetCardInfo(
const SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypeDef *pCardInfo);
705HAL_SD_StateTypeDef HAL_SD_GetState(
const SD_HandleTypeDef *hsd);
706uint32_t HAL_SD_GetError(
const SD_HandleTypeDef *hsd);
#define __IO
Defines 'read / write' permissions.
HAL_StatusTypeDef
HAL Status structures definition.
HAL_LockTypeDef
HAL Lock structures definition.
Header file of SD HAL extended module.
Header file of Delay Block module.
Header file of SDMMC HAL module.