完整教程下載地址：http://www.armbbs.cn/forum.php?mod=viewthread&tid=86980

第87章?????? STM32H7的SDMMC總線基礎(chǔ)知識和HAL庫API

本章節(jié)為大家講解SDMMC（Secure digital input/output MultiMediaCard interface）總線的基礎(chǔ)知識和對應(yīng)的HAL庫API。

目錄

第87章?????? STM32H7的SDMMC總線基礎(chǔ)知識和HAL庫API

87.1 初學(xué)者重要提示

87.2 SDMMC總線基礎(chǔ)知識

87.2.1 SDMMC總線的硬件框圖

87.2.2 SDMMC時(shí)鐘

87.2.3 SDMMC1和SDMMC2支持的RAM空間區(qū)別

87.2.4 SDMMC支持的速度

87.2.5 SDMMC支持UHS-I模式

87.2.6 SDMMC自帶的DMA控制器IDMA

87.3 SDMMC總線的HAL庫用法

87.3.1 SDMMC總線結(jié)構(gòu)體SD_TypeDef

87.3.2 SDMMC總線初始化結(jié)構(gòu)體SD_InitTypeDef

87.3.3 SDMMC接SD卡信息結(jié)構(gòu)體HAL_SD_CardInfoTypeDef

87.3.4 SDMMC總線句柄結(jié)構(gòu)體SD_HandleTypeDef

87.4 SDMMC總線源文件stm32h7xx_hal_sd.c

87.4.1 函數(shù)HAL_SD_Init

87.4.2 函數(shù)HAL_SD_DeInit

87.4.3 函數(shù)HAL_SD_ReadBlocks

87.4.4 函數(shù)HAL_SD_WriteBlocks

87.4.5 函數(shù)HAL_SD_ReadBlocks_DMA

87.4.6 函數(shù)HAL_SD_WriteBlocks_DMA

87.4.7 函數(shù)HAL_SD_Erase

87.5 總結(jié)

---

?

87.1 初學(xué)者重要提示

? 對于SDMMC控制SD卡或者eMMC，掌握本章的知識點(diǎn)就夠用了，更深入的認(rèn)識可以看STM32H7的參考手冊。

? 注意，操作SD卡是采用的函數(shù)HAL_SD_XXXX，而操作eMMC是采用的函數(shù)HAL_MMC_XXXX，也就是說他們采用的函數(shù)前綴是不同的。

? SD卡官網(wǎng)： www.sdcard.org 。

? SDMMC驅(qū)動eMMC支持1線，4線和8線模式，其中8線模式的最高速度可達(dá)208MB/S，實(shí)際速度受IO最大速度限制。

? SDMMC驅(qū)動SD卡支持1線和4線模式。

? STM32H7的SDMMC也支持eMMC：

• • ? 【普及貼】各個(gè)廠家eMMC讀寫速度，鎂光，東芝，三星，ISSI和旺宏http://www.armbbs.cn/forum.php?mod=viewthread&tid=95954

• • ? H7的8線SDIO DMA驅(qū)動eMMC的裸機(jī)性能，讀43MB/S，寫18.8MB/Shttp://www.armbbs.cn/forum.php?mod=viewthread&tid=95953

87.2 SDMMC總線基礎(chǔ)知識

87.2.1 SDMMC總線的硬件框圖

認(rèn)識一個(gè)外設(shè)，最好的方式就是看它的框圖，方便我們快速的了解SDMMC的基本功能，然后再看手冊了解細(xì)節(jié)。

通過這個(gè)框圖，我們可以得到如下信息：

• ?sdmmc_ker_ck輸入

SDMMC內(nèi)核時(shí)鐘。

• ? sdmmc_hclk輸入

AHB時(shí)鐘。

• ? sdmmc_it輸出

SDMMC全局中斷。

• ? sdmmc_dataend_trg輸出

MDMA的SDMMC數(shù)據(jù)接收觸發(fā)信號。

• ? SDMMC_CMD

SD/SDIO/MMC卡雙向/響應(yīng)信號。

• ? SDMMC_D[7:0]

SD/SDIO/MMC卡雙向數(shù)據(jù)線。

• ? SDMMC_CKIN

來自SD/SDIO/MMC卡的外部驅(qū)動器的時(shí)鐘反饋（用于SDR12，SDR25，SDR50和DDR50）。

• ? SDMMC_CK

SD/SDIO/MMC卡的時(shí)鐘。

• ? SDMMC_CDIR

SDMMC_CMD信號的SD/SDIO/MMC卡I/O方向指示。

• ? SDMMC_D123DIR

SDMMC_D[3:1]數(shù)據(jù)線的SD/SDIO/MMC卡I/O方向指示。

• ? SDMMC_D0DIR

SDMMC_D0數(shù)據(jù)線的SD/SDIO/MMC卡I/O方向指示。

?

STM32H7有兩個(gè)SDMMC控制器，SDMMC1和SDMMC2，這兩個(gè)控制器支持的功能是一樣的。

87.2.2 SDMMC時(shí)鐘

SDMMC控制器的時(shí)鐘來源：

?

SDMMC1和SDMMC2時(shí)鐘源是一樣的：

87.2.3 SDMMC1和SDMMC2支持的RAM空間區(qū)別

注：大家應(yīng)用時(shí)要特別注意這個(gè)問題。

使用STM32H7的SDIO1僅支持AXI SRAM，而SDIO2是AXI，SRAM1,SRAM2和SRAM3都支持的

?

87.2.4 SDMMC支持的速度

驅(qū)動SD卡支持的最大總線速度：

驅(qū)動eMMC支持的最大總線速度：

關(guān)于這兩個(gè)數(shù)據(jù)表，注意以下幾點(diǎn)：

• ? 驅(qū)動SD卡最大支持4bit，驅(qū)動eMMC最大支持8bit。
• ? 針對信號電壓1.8V或者1.2V，STM32H7需要外接專門的PHY芯片才可以驅(qū)動。
• ? 最大IO翻轉(zhuǎn)限制說的是SDR50，SDR104這種高速通信。平時(shí)用的DS，HS這種，無壓力，刷滿速不成問題。

87.2.5 SDMMC支持UHS-I模式

STM32H7的SDIO外接支持UHS-I 模式 (SDR12, SDR25, SDR50, SDR104和DDR50)需要1.8的電平轉(zhuǎn)換器。STM32H7參考手冊給了一個(gè)型號ST6G3244ME：

87.2.6 SDMMC自帶的DMA控制器IDMA

STM32H7的SDMMC自帶了專用的DMA控制器IDMA，支持突發(fā)，也支持雙緩沖。為什么要自帶DMA控制器？ 主要原因是STM32H7的通用DMA1和DMA2已經(jīng)無法滿足SDMMC高速通信速度。在本教程的第62章專門為大家測試過。通過讓SDMMC自帶控制器，這個(gè)問題就迎刃而解。

87.3 SDMMC總線的HAL庫用法

87.3.1 SDMMC總線結(jié)構(gòu)體SD_TypeDef

SDMMC總線相關(guān)的寄存器是通過HAL庫中的結(jié)構(gòu)體SD_TypeDef定義，在stm32h743xx.h中可以找到這個(gè)類型定義：

#define SD_TypeDef SDMMC_TypeDef typedef struct {__IO uint32_t POWER; /*!< SDMMC power control register, Address offset: 0x00 */__IO uint32_t CLKCR; /*!< SDMMC clock control register, Address offset: 0x04 */__IO uint32_t ARG; /*!< SDMMC argument register, Address offset: 0x08 */__IO uint32_t CMD; /*!< SDMMC command register, Address offset: 0x0C */__I uint32_t RESPCMD; /*!< SDMMC command response register, Address offset: 0x10 */__I uint32_t RESP1; /*!< SDMMC response 1 register, Address offset: 0x14 */__I uint32_t RESP2; /*!< SDMMC response 2 register, Address offset: 0x18 */__I uint32_t RESP3; /*!< SDMMC response 3 register, Address offset: 0x1C */__I uint32_t RESP4; /*!< SDMMC response 4 register, Address offset: 0x20 */__IO uint32_t DTIMER; /*!< SDMMC data timer register, Address offset: 0x24 */__IO uint32_t DLEN; /*!< SDMMC data length register, Address offset: 0x28 */__IO uint32_t DCTRL; /*!< SDMMC data control register, Address offset: 0x2C */__I uint32_t DCOUNT; /*!< SDMMC data counter register, Address offset: 0x30 */__I uint32_t STA; /*!< SDMMC status register, Address offset: 0x34 */__IO uint32_t ICR; /*!< SDMMC interrupt clear register, Address offset: 0x38 */__IO uint32_t MASK; /*!< SDMMC mask register, Address offset: 0x3C */__IO uint32_t ACKTIME; /*!< SDMMC Acknowledgement timer register, Address offset: 0x40 */uint32_t RESERVED0[3]; /*!< Reserved, 0x44 - 0x4C - 0x4C */__IO uint32_t IDMACTRL; /*!< SDMMC DMA control register, Address offset: 0x50 */__IO uint32_t IDMABSIZE; /*!< SDMMC DMA buffer size register, Address offset: 0x54 */__IO uint32_t IDMABASE0; /*!< SDMMC DMA buffer 0 base address register, Address offset: 0x58 */__IO uint32_t IDMABASE1; /*!< SDMMC DMA buffer 1 base address register, Address offset: 0x5C */uint32_t RESERVED1[8]; /*!< Reserved, 0x60-0x7C */__IO uint32_t FIFO; /*!< SDMMC data FIFO register, Address offset: 0x80 */uint32_t RESERVED2[222]; /*!< Reserved, 0x84-0x3F8 */__IO uint32_t IPVR; /*!< SDMMC data FIFO register, Address offset: 0x3FC */ } SDMMC_TypeDef;

這個(gè)結(jié)構(gòu)體的成員名稱和排列次序和CPU的寄存器是一 一對應(yīng)的。

__IO表示volatile, 這是標(biāo)準(zhǔn)C語言中的一個(gè)修飾字，表示這個(gè)變量是非易失性的，編譯器不要將其優(yōu)化掉。core_m7.h 文件定義了這個(gè)宏：

#define __O volatile /*!< Defines 'write only' permissions */ #define __IO volatile /*!< Defines 'read / write' permissions */

下面我們看下SDMMC的定義，在stm32h743xx.h文件。

#define PERIPH_BASE (0x40000000UL) #define D1_AHB1PERIPH_BASE (PERIPH_BASE + 0x12000000UL) #define D2_AHB2PERIPH_BASE (PERIPH_BASE + 0x08020000UL)#define SDMMC1_BASE (D1_AHB1PERIPH_BASE + 0x7000UL) #define SDMMC2_BASE (D2_AHB2PERIPH_BASE + 0x2400UL)#define SDMMC1 ((SDMMC_TypeDef *) SDMMC1_BASE) #define SDMMC2 ((SDMMC_TypeDef *) SDMMC2_BASE) <----- 展開這個(gè)宏，(SDMMC_TypeDef *)0x48022400

我們訪問SDMMC1的CMD寄存器可以采用這種形式：SDMMC1->CMD = 0。

87.3.2 SDMMC總線初始化結(jié)構(gòu)體SD_InitTypeDef

下面是SDMMC總線的初始化結(jié)構(gòu)體：

#define SD_InitTypeDef SDMMC_InitTypeDef typedef struct {uint32_t ClockEdge; uint32_t ClockPowerSave; uint32_t BusWide; uint32_t HardwareFlowControl; uint32_t ClockDiv; #if (USE_SD_TRANSCEIVER != 0U)uint32_t TranceiverPresent; #endif }SDMMC_InitTypeDef;

下面將結(jié)構(gòu)體成員逐一做個(gè)說明：

• ? ClockEdge

用于設(shè)置SDMMC的數(shù)據(jù)或者命令變化的時(shí)鐘沿。

#define SDMMC_CLOCK_EDGE_RISING ((uint32_t)0x00000000U) #define SDMMC_CLOCK_EDGE_FALLING SDMMC_CLKCR_NEGEDGE

• ? ClockPowerSave

用于設(shè)置空閑狀態(tài)，是否輸出時(shí)鐘。

#define SDMMC_CLOCK_POWER_SAVE_DISABLE ((uint32_t)0x00000000U) #define SDMMC_CLOCK_POWER_SAVE_ENABLE SDMMC_CLKCR_PWRSAV

• ? BusWide

用于設(shè)置SDMMC總線位寬。

#define SDMMC_BUS_WIDE_1B ((uint32_t)0x00000000U) #define SDMMC_BUS_WIDE_4B SDMMC_CLKCR_WIDBUS_0 #define SDMMC_BUS_WIDE_8B SDMMC_CLKCR_WIDBUS_1

• ? HardwareFlowControl

用于設(shè)置時(shí)候使能硬件流控制。

#define SDMMC_HARDWARE_FLOW_CONTROL_DISABLE ((uint32_t)0x00000000U) #define SDMMC_HARDWARE_FLOW_CONTROL_ENABLE SDMMC_CLKCR_HWFC_EN

• ? ClockDiv

用于設(shè)置SDMMC時(shí)鐘分頻，參數(shù)范圍0到1023。

• ? TranceiverPresent

用于設(shè)置是否帶1.8V收發(fā)器。

#define SDMMC_TRANSCEIVER_UNKNOWN ((uint32_t)0x00000000U) #define SDMMC_TRANSCEIVER_NOT_PRESENT ((uint32_t)0x00000001U) #define SDMMC_TRANSCEIVER_PRESENT ((uint32_t)0x00000002U)

87.3.3 SDMMC接SD卡信息結(jié)構(gòu)體HAL_SD_CardInfoTypeDef

下面是SDMMC總線的卡信息結(jié)構(gòu)體：

typedef struct {uint32_t CardType; /*!< Specifies the card Type */uint32_t CardVersion; /*!< Specifies the card version */uint32_t Class; /*!< Specifies the class of the card class */uint32_t RelCardAdd; /*!< Specifies the Relative Card Address */uint32_t BlockNbr; /*!< Specifies the Card Capacity in blocks */uint32_t BlockSize; /*!< Specifies one block size in bytes */uint32_t LogBlockNbr; /*!< Specifies the Card logical Capacity in blocks */uint32_t LogBlockSize; /*!< Specifies logical block size in bytes */uint32_t CardSpeed; /*!< Specifies the card Speed */ }HAL_SD_CardInfoTypeDef;

下面將結(jié)構(gòu)體成員逐一做個(gè)說明：

• ?CardType

卡類型。

/*!< SD Standard Capacity <2Go */ #define CARD_SDSC ((uint32_t)0x00000000U) /*!< SD High Capacity <32Go, SD Extended Capacity <2To */ #define CARD_SDHC_SDXC ((uint32_t)0x00000001U) #define CARD_SECURED ((uint32_t)0x00000003U)

• ? CardVersion

卡版本。

#define CARD_V1_X ((uint32_t)0x00000000U) #define CARD_V2_X ((uint32_t)0x00000001U)

• ? Class

卡類型。

• ? RelCardAdd

卡相對地址。

• ? BlockNbr

整個(gè)卡的塊數(shù)。

• ? BlockSize

每個(gè)塊的字節(jié)數(shù)。

• ? LogBlockNbr

整個(gè)卡的邏輯塊數(shù)。

• ? LogBlockSize

邏輯塊大小

#define SPI_FIRSTBIT_MSB (0x00000000UL) #define SPI_FIRSTBIT_LSB SPI_CFG2_LSBFRST

• ?CardSpeed

用于設(shè)置是否使能SPI總線的TI模式。

/*!< Normal Speed Card <12.5Mo/s , Spec Version 1.01 */ #define CARD_NORMAL_SPEED ((uint32_t)0x00000000U) /*!< High Speed Card <25Mo/s , Spec version 2.00 */ #define CARD_HIGH_SPEED ((uint32_t)0x00000100U) /*!< UHS-I SD Card <50Mo/s for SDR50, DDR5 Cardsand <104Mo/s for SDR104, Spec version 3.01 */ #define CARD_ULTRA_HIGH_SPEED ((uint32_t)0x00000200U)

87.3.4 SDMMC總線句柄結(jié)構(gòu)體SD_HandleTypeDef

下面是SDMMC句柄結(jié)構(gòu)體：

#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U) typedef struct __SD_HandleTypeDef #else typedef struct #endif /* USE_HAL_SD_REGISTER_CALLBACKS */ {SD_TypeDef *Instance; /*!< SD registers base address */SD_InitTypeDef Init; /*!< SD required parameters */HAL_LockTypeDef Lock; /*!< SD locking object */uint8_t *pTxBuffPtr; /*!< Pointer to SD Tx transfer Buffer */uint32_t TxXferSize; /*!< SD Tx Transfer size */uint8_t *pRxBuffPtr; /*!< Pointer to SD Rx transfer Buffer */uint32_t RxXferSize; /*!< SD Rx Transfer size */__IO uint32_t Context; /*!< SD transfer context */__IO HAL_SD_StateTypeDef State; /*!< SD card State */__IO uint32_t ErrorCode; /*!< SD Card Error codes */HAL_SD_CardInfoTypeDef SdCard; /*!< SD Card information */uint32_t CSD[4]; /*!< SD card specific data table */uint32_t CID[4]; /*!< SD card identification number table */#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)void (* TxCpltCallback) (struct __SD_HandleTypeDef *hsd);void (* RxCpltCallback) (struct __SD_HandleTypeDef *hsd);void (* ErrorCallback) (struct __SD_HandleTypeDef *hsd);void (* AbortCpltCallback) (struct __SD_HandleTypeDef *hsd);void (* Read_DMADblBuf0CpltCallback) (struct __SD_HandleTypeDef *hsd);void (* Read_DMADblBuf1CpltCallback) (struct __SD_HandleTypeDef *hsd);void (* Write_DMADblBuf0CpltCallback) (struct __SD_HandleTypeDef *hsd);void (* Write_DMADblBuf1CpltCallback) (struct __SD_HandleTypeDef *hsd); #if (USE_SD_TRANSCEIVER != 0U)void (* DriveTransceiver_1_8V_Callback) (FlagStatus status); #endif /* USE_SD_TRANSCEIVER */void (* MspInitCallback) (struct __SD_HandleTypeDef *hsd);void (* MspDeInitCallback) (struct __SD_HandleTypeDef *hsd); #endif /* USE_HAL_SD_REGISTER_CALLBACKS */ }SD_HandleTypeDef;

注意事項(xiàng)：

條件編譯USE_HAL_SD_REGISTER_CALLBACKS用來設(shè)置使用自定義回調(diào)還是使用默認(rèn)回調(diào)，此定義一般放在stm32h7xx_hal_conf.h文件里面設(shè)置：

? #define?? USE_HAL_SD_REGISTER_CALLBACKS?? 1

通過函數(shù)HAL_SD_RegisterCallback注冊回調(diào)，取消注冊使用函數(shù)HAL_SD_UnRegisterCallback。

這里重點(diǎn)介紹下面幾個(gè)參數(shù)，其它參數(shù)主要是HAL庫內(nèi)部使用和自定義回調(diào)函數(shù)。

• ? SD_TypeDef?? *Instance

這個(gè)參數(shù)是寄存器的例化，方便操作寄存器。

• ? SD_InitTypeDef? Init

這個(gè)參數(shù)在本章節(jié)3.2小節(jié)已經(jīng)進(jìn)行了詳細(xì)說明。

87.4 SDMMC總線源文件stm32h7xx_hal_sd.c

此文件涉及到的函數(shù)較多，這里把幾個(gè)常用的函數(shù)做個(gè)說明：

• ? HAL_SD_Init
• ? HAL_SD_DeInit
• ? HAL_SD_ReadBlocks
• ? HAL_SD_WriteBlocks
• ? HAL_SD_ReadBlocks_DMA
• ? HAL_SD_WriteBlocks_DMA
• ? HAL_SD_Erase

87.4.1 函數(shù)HAL_SD_Init

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_Init(SD_HandleTypeDef *hsd) {HAL_SD_CardStatusTypeDef CardStatus;uint32_t speedgrade, unitsize;uint32_t tickstart;/* 檢查句柄是否有效 */if(hsd == NULL){return HAL_ERROR;}/* 檢查參數(shù) */assert_param(IS_SDMMC_ALL_INSTANCE(hsd->Instance));assert_param(IS_SDMMC_CLOCK_EDGE(hsd->Init.ClockEdge));assert_param(IS_SDMMC_CLOCK_POWER_SAVE(hsd->Init.ClockPowerSave));assert_param(IS_SDMMC_BUS_WIDE(hsd->Init.BusWide));assert_param(IS_SDMMC_HARDWARE_FLOW_CONTROL(hsd->Init.HardwareFlowControl));assert_param(IS_SDMMC_CLKDIV(hsd->Init.ClockDiv));if(hsd->State == HAL_SD_STATE_RESET){/* 開鎖 */hsd->Lock = HAL_UNLOCKED;#if (USE_SD_TRANSCEIVER != 0U)/* 兼容 */if (hsd->Init.TranceiverPresent == SDMMC_TRANSCEIVER_UNKNOWN){hsd->Init.TranceiverPresent = SDMMC_TRANSCEIVER_PRESENT;} #endif #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)/* 復(fù)位回調(diào) */hsd->TxCpltCallback = HAL_SD_TxCpltCallback;hsd->RxCpltCallback = HAL_SD_RxCpltCallback;hsd->ErrorCallback = HAL_SD_ErrorCallback;hsd->AbortCpltCallback = HAL_SD_AbortCallback;hsd->Read_DMADblBuf0CpltCallback = HAL_SDEx_Read_DMADoubleBuf0CpltCallback;hsd->Read_DMADblBuf1CpltCallback = HAL_SDEx_Read_DMADoubleBuf1CpltCallback;hsd->Write_DMADblBuf0CpltCallback = HAL_SDEx_Write_DMADoubleBuf0CpltCallback;hsd->Write_DMADblBuf1CpltCallback = HAL_SDEx_Write_DMADoubleBuf1CpltCallback; #if (USE_SD_TRANSCEIVER != 0U)if (hsd->Init.TranceiverPresent == SDMMC_TRANSCEIVER_PRESENT){hsd->DriveTransceiver_1_8V_Callback = HAL_SD_DriveTransceiver_1_8V_Callback;} #endif if(hsd->MspInitCallback == NULL){hsd->MspInitCallback = HAL_SD_MspInit;}/* 初始化底層 */hsd->MspInitCallback(hsd); #else/* 初始化底層硬件 GPIO, CLOCK, CORTEX...etc */HAL_SD_MspInit(hsd); #endif /* USE_HAL_SD_REGISTER_CALLBACKS */}hsd->State = HAL_SD_STATE_BUSY;/* 初始化卡參數(shù) */if (HAL_SD_InitCard(hsd) != HAL_OK){return HAL_ERROR;}if( HAL_SD_GetCardStatus(hsd, &CardStatus) != HAL_OK){return HAL_ERROR;}/* 獲取卡速度等信息 */speedgrade = CardStatus.UhsSpeedGrade;unitsize = CardStatus.UhsAllocationUnitSize;if ((hsd->SdCard.CardType == CARD_SDHC_SDXC) && ((speedgrade != 0U) || (unitsize != 0U))){hsd->SdCard.CardSpeed = CARD_ULTRA_HIGH_SPEED;}else{if (hsd->SdCard.CardType == CARD_SDHC_SDXC){hsd->SdCard.CardSpeed = CARD_HIGH_SPEED;}else{hsd->SdCard.CardSpeed = CARD_NORMAL_SPEED;}}/* 配置總線位寬 */if(HAL_SD_ConfigWideBusOperation(hsd, hsd->Init.BusWide) != HAL_OK){return HAL_ERROR;}/* 驗(yàn)證卡初始化后是否就緒 */tickstart = HAL_GetTick();while((HAL_SD_GetCardState(hsd) != HAL_SD_CARD_TRANSFER)){if((HAL_GetTick()-tickstart) >= SDMMC_DATATIMEOUT){hsd->ErrorCode = HAL_SD_ERROR_TIMEOUT;hsd->State= HAL_SD_STATE_READY;return HAL_TIMEOUT;}}hsd->ErrorCode = HAL_SD_ERROR_NONE;hsd->Context = SD_CONTEXT_NONE;hsd->State = HAL_SD_STATE_READY;return HAL_OK; }

函數(shù)描述：

此函數(shù)用于初始化SD卡。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量，用于配置要初始化的參數(shù)。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

注意事項(xiàng)：

函數(shù)HAL_SD_MspInit用于初始化SD的底層時(shí)鐘、引腳等功能。需要用戶自己在此函數(shù)里面實(shí)現(xiàn)具體的功能。由于這個(gè)函數(shù)是弱定義的，允許用戶在工程其它源文件里面重新實(shí)現(xiàn)此函數(shù)。當(dāng)然，不限制一定要在此函數(shù)里面實(shí)現(xiàn)，也可以像早期的標(biāo)準(zhǔn)庫那樣，用戶自己初始化即可，更靈活些。

如果形參hsd的結(jié)構(gòu)體成員State沒有做初始狀態(tài)，這個(gè)地方就是個(gè)坑。特別是用戶搞了一個(gè)局部變量SD_HandleTypeDef SdHandle。

對于局部變量來說，這個(gè)參數(shù)就是一個(gè)隨機(jī)值，如果是全局變量還好，一般MDK和IAR都會將全部變量初始化為0，而恰好這個(gè) HAL_SD_STATE_RESET? = 0x00U。

解決辦法有三

方法1：用戶自己初始化SD和涉及到的GPIO等。

方法2：定義SD_HandleTypeDef SdHandle為全局變量。

方法3：下面的方法

if(HAL_SD_DeInit(&SdHandle) != HAL_OK) {Error_Handler(); } if(HAL_SD_Init(&SdHandle) != HAL_OK) {Error_Handler(); }

使用舉例：

SD_HandleTypeDef uSdHandle;uSdHandle.Instance = SDMMC1;/* if CLKDIV = 0 then SDMMC Clock frequency = SDMMC Kernel Clockelse SDMMC Clock frequency = SDMMC Kernel Clock / [2 * CLKDIV].200MHz / (2*2) = 50MHz */ uSdHandle.Init.ClockDiv = 2; uSdHandle.Init.ClockPowerSave = SDMMC_CLOCK_POWER_SAVE_DISABLE; uSdHandle.Init.ClockEdge = SDMMC_CLOCK_EDGE_RISING; uSdHandle.Init.HardwareFlowControl = SDMMC_HARDWARE_FLOW_CONTROL_DISABLE; uSdHandle.Init.BusWide = SDMMC_BUS_WIDE_4B; if(HAL_SD_Init(&uSdHandle) != HAL_OK) {sd_state = MSD_ERROR; }

87.4.2 函數(shù)HAL_SD_DeInit

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_DeInit(SD_HandleTypeDef *hsd) {/* 檢查SD卡句柄是否有效 */if(hsd == NULL){return HAL_ERROR;}/* 檢查參數(shù) */assert_param(IS_SDMMC_ALL_INSTANCE(hsd->Instance));hsd->State = HAL_SD_STATE_BUSY;#if (USE_SD_TRANSCEIVER != 0U)/* 關(guān)閉1.8V模式 */if (hsd->Init.TranceiverPresent == SDMMC_TRANSCEIVER_PRESENT){ #if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)if(hsd->DriveTransceiver_1_8V_Callback == NULL){hsd->DriveTransceiver_1_8V_Callback = HAL_SD_DriveTransceiver_1_8V_Callback;}hsd->DriveTransceiver_1_8V_Callback(RESET); #elseHAL_SD_DriveTransceiver_1_8V_Callback(RESET); #endif } #endif/* 關(guān)閉SD卡電源 */SD_PowerOFF(hsd);#if defined (USE_HAL_SD_REGISTER_CALLBACKS) && (USE_HAL_SD_REGISTER_CALLBACKS == 1U)if(hsd->MspDeInitCallback == NULL){hsd->MspDeInitCallback = HAL_SD_MspDeInit;}/* 復(fù)位底層硬件 */hsd->MspDeInitCallback(hsd); #else/* 復(fù)位底層硬件 */HAL_SD_MspDeInit(hsd); #endif hsd->ErrorCode = HAL_SD_ERROR_NONE;hsd->State = HAL_SD_STATE_RESET;return HAL_OK; }

函數(shù)描述：

用于復(fù)位SD總線初始化。

函數(shù)參數(shù)：

• ?第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ?返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

87.4.3 函數(shù)HAL_SD_ReadBlocks

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout) {SDMMC_DataInitTypeDef config;uint32_t errorstate;uint32_t tickstart = HAL_GetTick();uint32_t count, data, dataremaining;uint32_t add = BlockAdd;uint8_t *tempbuff = pData;if(NULL == pData){hsd->ErrorCode |= HAL_SD_ERROR_PARAM;return HAL_ERROR;}if(hsd->State == HAL_SD_STATE_READY){hsd->ErrorCode = HAL_SD_ERROR_NONE;if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr)){hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;return HAL_ERROR;}hsd->State = HAL_SD_STATE_BUSY;/* 初始化數(shù)據(jù)控制寄存器 */hsd->Instance->DCTRL = 0U;if(hsd->SdCard.CardType != CARD_SDHC_SDXC){add *= 512U;}/* 配置SD DPSM (Data Path State Machine) */config.DataTimeOut = SDMMC_DATATIMEOUT;config.DataLength = NumberOfBlocks * BLOCKSIZE;config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;config.TransferDir = SDMMC_TRANSFER_DIR_TO_SDMMC;config.TransferMode = SDMMC_TRANSFER_MODE_BLOCK;config.DPSM = SDMMC_DPSM_DISABLE;(void)SDMMC_ConfigData(hsd->Instance, &config);__SDMMC_CMDTRANS_ENABLE( hsd->Instance);/* 查詢方式塊讀取 */if(NumberOfBlocks > 1U){hsd->Context = SD_CONTEXT_READ_MULTIPLE_BLOCK;/* 多塊讀取命令 */errorstate = SDMMC_CmdReadMultiBlock(hsd->Instance, add);}else{hsd->Context = SD_CONTEXT_READ_SINGLE_BLOCK;/* 單塊讀取命令 */errorstate = SDMMC_CmdReadSingleBlock(hsd->Instance, add);}if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}/* 查詢SDMMC標(biāo)志 */dataremaining = config.DataLength;while(!__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_RXOVERR | SDMMC_FLAG_DCRCFAIL | SDMMC_FLAG_DTIMEOUT | SDMMC_FLAG_DATAEND)){if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_RXFIFOHF) && (dataremaining >= 32U)){/* 從SDMMC Rx FIFO讀取數(shù)據(jù) */for(count = 0U; count < 8U; count++){data = SDMMC_ReadFIFO(hsd->Instance);*tempbuff = (uint8_t)(data & 0xFFU);tempbuff++;*tempbuff = (uint8_t)((data >> 8U) & 0xFFU);tempbuff++;*tempbuff = (uint8_t)((data >> 16U) & 0xFFU);tempbuff++;*tempbuff = (uint8_t)((data >> 24U) & 0xFFU);tempbuff++;}dataremaining -= 32U;}if(((HAL_GetTick()-tickstart) >= Timeout) || (Timeout == 0U)){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_TIMEOUT;hsd->State= HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_TIMEOUT;}}__SDMMC_CMDTRANS_DISABLE( hsd->Instance);/* 多塊讀取發(fā)送停止傳輸命令 */if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DATAEND) && (NumberOfBlocks > 1U)){if(hsd->SdCard.CardType != CARD_SECURED){/* 發(fā)送停止傳輸命令 */errorstate = SDMMC_CmdStopTransfer(hsd->Instance);if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}}}/* 獲取錯(cuò)誤狀態(tài) */if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DTIMEOUT)){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_DATA_TIMEOUT;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DCRCFAIL)){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_DATA_CRC_FAIL;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_RXOVERR)){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_RX_OVERRUN;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else{/* 什么都不做 */}/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_DATA_FLAGS);hsd->State = HAL_SD_STATE_READY;return HAL_OK;}else{hsd->ErrorCode |= HAL_SD_ERROR_BUSY;return HAL_ERROR;} }

函數(shù)描述：

此函數(shù)主要用于SD卡數(shù)據(jù)讀取。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ? 第2個(gè)參數(shù)是接收數(shù)據(jù)的緩沖地址。
• ? 第3個(gè)參數(shù)是要讀取的扇區(qū)地址，即從第幾個(gè)扇區(qū)開始讀取（512字節(jié)為一個(gè)扇區(qū)）。
• ? 第4個(gè)參數(shù)是讀取的扇區(qū)數(shù)。
• ? 第5個(gè)參數(shù)是傳輸過程的溢出時(shí)間，單位ms。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

使用舉例：

/*** @brief Reads block(s) from a specified address in an SD card, in polling mode.* @param pData: Pointer to the buffer that will contain the data to transmit* @param ReadAddr: Address from where data is to be read* @param NumOfBlocks: Number of SD blocks to read* @param Timeout: Timeout for read operation* @retval SD status*/ uint8_t BSP_SD_ReadBlocks(uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks, uint32_t Timeout) {if( HAL_SD_ReadBlocks(&uSdHandle, (uint8_t *)pData, ReadAddr, NumOfBlocks, Timeout) == HAL_OK){return MSD_OK;}else{return MSD_ERROR;}}

87.4.4 函數(shù)HAL_SD_WriteBlocks

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout) {SDMMC_DataInitTypeDef config;uint32_t errorstate;uint32_t tickstart = HAL_GetTick();uint32_t count, data, dataremaining;uint32_t add = BlockAdd;uint8_t *tempbuff = pData;if(NULL == pData){hsd->ErrorCode |= HAL_SD_ERROR_PARAM;return HAL_ERROR;}if(hsd->State == HAL_SD_STATE_READY){hsd->ErrorCode = HAL_SD_ERROR_NONE;if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr)){hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;return HAL_ERROR;}hsd->State = HAL_SD_STATE_BUSY;/* 初始化數(shù)據(jù)控制寄存器 */hsd->Instance->DCTRL = 0U;if(hsd->SdCard.CardType != CARD_SDHC_SDXC){add *= 512U;}/* 配置SD DPSM */config.DataTimeOut = SDMMC_DATATIMEOUT;config.DataLength = NumberOfBlocks * BLOCKSIZE;config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;config.TransferDir = SDMMC_TRANSFER_DIR_TO_CARD;config.TransferMode = SDMMC_TRANSFER_MODE_BLOCK;config.DPSM = SDMMC_DPSM_DISABLE;(void)SDMMC_ConfigData(hsd->Instance, &config);__SDMMC_CMDTRANS_ENABLE( hsd->Instance);/* 查詢方式塊寫操作 */if(NumberOfBlocks > 1U){hsd->Context = SD_CONTEXT_WRITE_MULTIPLE_BLOCK;/* 寫多塊命令 */errorstate = SDMMC_CmdWriteMultiBlock(hsd->Instance, add);}else{hsd->Context = SD_CONTEXT_WRITE_SINGLE_BLOCK;/* 寫單塊命令 */errorstate = SDMMC_CmdWriteSingleBlock(hsd->Instance, add);}if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)命令 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}/* 查詢方式塊寫操作 */dataremaining = config.DataLength;while(!__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_TXUNDERR | SDMMC_FLAG_DCRCFAIL | SDMMC_FLAG_DTIMEOUT | SDMMC_FLAG_DATAEND)){if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_TXFIFOHE) && (dataremaining >= 32U)){/* 寫數(shù)據(jù)到SDMMC Tx FIFO */for(count = 0U; count < 8U; count++){data = (uint32_t)(*tempbuff);tempbuff++;data |= ((uint32_t)(*tempbuff) << 8U);tempbuff++;data |= ((uint32_t)(*tempbuff) << 16U);tempbuff++;data |= ((uint32_t)(*tempbuff) << 24U);tempbuff++;(void)SDMMC_WriteFIFO(hsd->Instance, &data);}dataremaining -= 32U;}if(((HAL_GetTick()-tickstart) >= Timeout) || (Timeout == 0U)){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_TIMEOUT;}}__SDMMC_CMDTRANS_DISABLE( hsd->Instance);/* 多塊寫操作，發(fā)送停止傳輸命令 */if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DATAEND) && (NumberOfBlocks > 1U)){if(hsd->SdCard.CardType != CARD_SECURED){/* 發(fā)送停止傳輸命令 */errorstate = SDMMC_CmdStopTransfer(hsd->Instance);if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)傳輸標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}}}/* Get error state */if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DTIMEOUT)){/* 清除所有靜態(tài)傳輸標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_DATA_TIMEOUT;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_DCRCFAIL)){/* 清除所有靜態(tài)傳輸標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_DATA_CRC_FAIL;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else if(__HAL_SD_GET_FLAG(hsd, SDMMC_FLAG_TXUNDERR)){/* 清除所有靜態(tài)傳輸標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_TX_UNDERRUN;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}else{/* 什么都不做 */}/* 清除所有靜態(tài)傳輸標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_DATA_FLAGS);hsd->State = HAL_SD_STATE_READY;return HAL_OK;}else{hsd->ErrorCode |= HAL_SD_ERROR_BUSY;return HAL_ERROR;} }

函數(shù)描述：

此函數(shù)主要用于向SD卡寫入數(shù)據(jù)。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ? 第2個(gè)參數(shù)是要寫入到SD卡的數(shù)據(jù)緩沖地址。
• ? 第3個(gè)參數(shù)是要寫入的扇區(qū)地址，即從第幾個(gè)扇區(qū)開始寫入（512字節(jié)為一個(gè)扇區(qū)）。
• ? 第4個(gè)參數(shù)是讀取的扇區(qū)數(shù)。
• ? 第5個(gè)參數(shù)是傳輸過程的溢出時(shí)間，單位ms。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

使用舉例：

/*** @brief Writes block(s) to a specified address in an SD card, in polling mode.* @param pData: Pointer to the buffer that will contain the data to transmit* @param WriteAddr: Address from where data is to be written* @param NumOfBlocks: Number of SD blocks to write* @param Timeout: Timeout for write operation* @retval SD status*/ uint8_t BSP_SD_WriteBlocks(uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks, uint32_t Timeout) {if( HAL_SD_WriteBlocks(&uSdHandle, (uint8_t *)pData, WriteAddr, NumOfBlocks, Timeout) == HAL_OK){return MSD_OK;}else{return MSD_ERROR;} }

87.4.5 函數(shù)HAL_SD_ReadBlocks_DMA

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_ReadBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks) {SDMMC_DataInitTypeDef config;uint32_t errorstate;uint32_t add = BlockAdd;if(NULL == pData){hsd->ErrorCode |= HAL_SD_ERROR_PARAM;return HAL_ERROR;}if(hsd->State == HAL_SD_STATE_READY){hsd->ErrorCode = HAL_SD_ERROR_NONE;if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr)){hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;return HAL_ERROR;}hsd->State = HAL_SD_STATE_BUSY;/* 初始化數(shù)據(jù)控制寄存器 */hsd->Instance->DCTRL = 0U;hsd->pRxBuffPtr = pData;hsd->RxXferSize = BLOCKSIZE * NumberOfBlocks;if(hsd->SdCard.CardType != CARD_SDHC_SDXC){add *= 512U;}/* 配置SD DPSM (Data Path State Machine) */config.DataTimeOut = SDMMC_DATATIMEOUT;config.DataLength = BLOCKSIZE * NumberOfBlocks;config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;config.TransferDir = SDMMC_TRANSFER_DIR_TO_SDMMC;config.TransferMode = SDMMC_TRANSFER_MODE_BLOCK;config.DPSM = SDMMC_DPSM_DISABLE;(void)SDMMC_ConfigData(hsd->Instance, &config);__SDMMC_CMDTRANS_ENABLE( hsd->Instance);hsd->Instance->IDMABASE0 = (uint32_t) pData ;hsd->Instance->IDMACTRL = SDMMC_ENABLE_IDMA_SINGLE_BUFF;/* DMA方式讀取多個(gè)塊 */if(NumberOfBlocks > 1U){hsd->Context = (SD_CONTEXT_READ_MULTIPLE_BLOCK | SD_CONTEXT_DMA);/* DMA方式讀取多塊命令 */errorstate = SDMMC_CmdReadMultiBlock(hsd->Instance, add);}else{hsd->Context = (SD_CONTEXT_READ_SINGLE_BLOCK | SD_CONTEXT_DMA);/* 讀取單塊命令 */errorstate = SDMMC_CmdReadSingleBlock(hsd->Instance, add);}if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}/* 使能傳輸中斷 */__HAL_SD_ENABLE_IT(hsd, (SDMMC_IT_DCRCFAIL | SDMMC_IT_DTIMEOUT | SDMMC_IT_RXOVERR | SDMMC_IT_DATAEND));return HAL_OK;}else{return HAL_BUSY;} }

函數(shù)描述：

此函數(shù)主要用于SD卡數(shù)據(jù)讀取，DMA方式。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ? 第2個(gè)參數(shù)是接收數(shù)據(jù)的緩沖地址。
• ? 第3個(gè)參數(shù)是要讀取的扇區(qū)地址，即從第幾個(gè)扇區(qū)開始讀取（512字節(jié)為一個(gè)扇區(qū)）。
• ? 第4個(gè)參數(shù)是讀取的扇區(qū)數(shù)。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

使用舉例：

/** * @brief Reads block(s) from a specified address in an SD card, in DMA mode. * @param pData: Pointer to the buffer that will contain the data to transmit * @param ReadAddr: Address from where data is to be read * @param NumOfBlocks: Number of SD blocks to read * @retval SD status */ uint8_t BSP_SD_ReadBlocks_DMA(uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks) {if( HAL_SD_ReadBlocks_DMA(&uSdHandle, (uint8_t *)pData, ReadAddr, NumOfBlocks) == HAL_OK){return MSD_OK;}else{return MSD_ERROR;} }

87.4.6 函數(shù)HAL_SD_WriteBlocks_DMA

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd, uint8_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks) {SDMMC_DataInitTypeDef config;uint32_t errorstate;uint32_t add = BlockAdd;if(NULL == pData){hsd->ErrorCode |= HAL_SD_ERROR_PARAM;return HAL_ERROR;}if(hsd->State == HAL_SD_STATE_READY){hsd->ErrorCode = HAL_SD_ERROR_NONE;if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr)){hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;return HAL_ERROR;}hsd->State = HAL_SD_STATE_BUSY;/* 初始化數(shù)據(jù)控制寄存器 */hsd->Instance->DCTRL = 0U;hsd->pTxBuffPtr = pData;hsd->TxXferSize = BLOCKSIZE * NumberOfBlocks;if(hsd->SdCard.CardType != CARD_SDHC_SDXC){add *= 512U;}/* 配置SD DPSM (Data Path State Machine) */config.DataTimeOut = SDMMC_DATATIMEOUT;config.DataLength = BLOCKSIZE * NumberOfBlocks;config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;config.TransferDir = SDMMC_TRANSFER_DIR_TO_CARD;config.TransferMode = SDMMC_TRANSFER_MODE_BLOCK;config.DPSM = SDMMC_DPSM_DISABLE;(void)SDMMC_ConfigData(hsd->Instance, &config);__SDMMC_CMDTRANS_ENABLE( hsd->Instance);hsd->Instance->IDMABASE0 = (uint32_t) pData ;hsd->Instance->IDMACTRL = SDMMC_ENABLE_IDMA_SINGLE_BUFF;/* 查詢模式寫塊 */if(NumberOfBlocks > 1U){hsd->Context = (SD_CONTEXT_WRITE_MULTIPLE_BLOCK | SD_CONTEXT_DMA);/* 多塊寫命令 */errorstate = SDMMC_CmdWriteMultiBlock(hsd->Instance, add);}else{hsd->Context = (SD_CONTEXT_WRITE_SINGLE_BLOCK | SD_CONTEXT_DMA);/* 單塊寫命令 */errorstate = SDMMC_CmdWriteSingleBlock(hsd->Instance, add);}if(errorstate != HAL_SD_ERROR_NONE){/* 清除靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;hsd->Context = SD_CONTEXT_NONE;return HAL_ERROR;}/* 使能傳輸中斷 Enable */__HAL_SD_ENABLE_IT(hsd, (SDMMC_IT_DCRCFAIL | SDMMC_IT_DTIMEOUT | SDMMC_IT_TXUNDERR | SDMMC_IT_DATAEND));return HAL_OK;}else{return HAL_BUSY;} }

函數(shù)描述：

此函數(shù)主要用于向SD卡寫入數(shù)據(jù)，DMA方式。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ? 第2個(gè)參數(shù)是要寫入到SD卡的數(shù)據(jù)緩沖地址。
• ? 第3個(gè)參數(shù)是要寫入的扇區(qū)地址，即從第幾個(gè)扇區(qū)開始寫入（512字節(jié)為一個(gè)扇區(qū)）。
• ? 第4個(gè)參數(shù)是讀取的扇區(qū)數(shù)。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

使用舉例：

/** * @brief Writes block(s) to a specified address in an SD card, in DMA mode. * @param pData: Pointer to the buffer that will contain the data to transmit * @param WriteAddr: Address from where data is to be written * @param NumOfBlocks: Number of SD blocks to write * @retval SD status */ uint8_t BSP_SD_WriteBlocks_DMA(uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks) {if( HAL_SD_WriteBlocks_DMA(&uSdHandle, (uint8_t *)pData, WriteAddr, NumOfBlocks) == HAL_OK){return MSD_OK;}else{return MSD_ERROR;} }

87.4.7 函數(shù)HAL_SD_Erase

函數(shù)原型：

HAL_StatusTypeDef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint32_t BlockStartAdd, uint32_t BlockEndAdd) {uint32_t errorstate;uint32_t start_add = BlockStartAdd;uint32_t end_add = BlockEndAdd;if(hsd->State == HAL_SD_STATE_READY){hsd->ErrorCode = HAL_SD_ERROR_NONE;if(end_add < start_add){hsd->ErrorCode |= HAL_SD_ERROR_PARAM;return HAL_ERROR;}if(end_add > (hsd->SdCard.LogBlockNbr)){hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;return HAL_ERROR;}hsd->State = HAL_SD_STATE_BUSY;/* 檢測是否支持擦除命令 */if(((hsd->SdCard.Class) & SDMMC_CCCC_ERASE) == 0U){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_REQUEST_NOT_APPLICABLE;hsd->State = HAL_SD_STATE_READY;return HAL_ERROR;}if((SDMMC_GetResponse(hsd->Instance, SDMMC_RESP1) & SDMMC_CARD_LOCKED) == SDMMC_CARD_LOCKED){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= HAL_SD_ERROR_LOCK_UNLOCK_FAILED;hsd->State = HAL_SD_STATE_READY;return HAL_ERROR;}/* 對于高容量卡，獲取起始塊和結(jié)束塊 */if(hsd->SdCard.CardType != CARD_SDHC_SDXC){start_add *= 512U;end_add *= 512U;}/* 根據(jù)sd-card spec 1.0 ERASE_GROUP_START (CMD32) 和 erase_group_end(CMD33) */if(hsd->SdCard.CardType != CARD_SECURED){/* 發(fā)送CMD32 SD_ERASE_GRP_START命令帶地址參數(shù) */errorstate = SDMMC_CmdSDEraseStartAdd(hsd->Instance, start_add);if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;return HAL_ERROR;}/* 發(fā)送CMD33 SD_ERASE_GRP_END命令，帶地址參數(shù) */errorstate = SDMMC_CmdSDEraseEndAdd(hsd->Instance, end_add);if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;return HAL_ERROR;}}/* 發(fā)送CMD38 ERASE命令 */errorstate = SDMMC_CmdErase(hsd->Instance, 0UL);if(errorstate != HAL_SD_ERROR_NONE){/* 清除所有靜態(tài)標(biāo)志 */__HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);hsd->ErrorCode |= errorstate;hsd->State = HAL_SD_STATE_READY;return HAL_ERROR;}hsd->State = HAL_SD_STATE_READY;return HAL_OK;}else{return HAL_BUSY;} }

函數(shù)描述：

此函數(shù)主要用于SD卡擦除。

函數(shù)參數(shù)：

• ? 第1個(gè)參數(shù)是SD_HandleTypeDef類型結(jié)構(gòu)體指針變量。
• ? 第2個(gè)參數(shù)是擦除的起始扇區(qū)地址，地址單位是第幾個(gè)扇區(qū)（512字節(jié)為一個(gè)扇區(qū)）。
• ? 第3個(gè)參數(shù)是擦除的結(jié)束扇區(qū)地址，地址單位是第幾個(gè)扇區(qū)（512字節(jié)為一個(gè)扇區(qū)）。
• ? 返回值，返回HAL_TIMEOUT表示超時(shí)，HAL_ERROR表示參數(shù)錯(cuò)誤，HAL_OK表示發(fā)送成功，HAL_BUSY表示忙，正在使用中。

使用舉例：

/** * @brief Erases the specified memory area of the given SD card. * @param StartAddr: Start byte address * @param EndAddr: End byte address * @retval SD status */ uint8_t BSP_SD_Erase(uint32_t StartAddr, uint32_t EndAddr) {if( HAL_SD_Erase(&uSdHandle, StartAddr, EndAddr) == HAL_OK){return MSD_OK;}else{return MSD_ERROR;} }

87.5 總結(jié)

本章節(jié)就為大家講解這么多，更多SDMMC知識可以看STM32H7的參考手冊。

?

總結(jié)

以上是生活随笔為你收集整理的【STM32H7教程】第87章 STM32H7的SDMMC总线基础知识和HAL库API的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。