stm32 CubeMx 實現(xiàn)SD卡/sd nand FATFS讀寫測試

文章目錄

stm32 CubeMx 實現(xiàn)SD卡/SD nand FATFS讀寫測試

1. 前言

2. 環(huán)境介紹

2.1 軟硬件說明

2.2 外設(shè)原理圖

3. 工程搭建

3.1 CubeMx 配置

3.2 SDIO時鐘配置說明

3.2 讀寫測試

3.2.1 添加讀寫測試代碼

3.3 FATFS文件操作

3.3.1 修改讀寫測試代碼

3.4 配置問題記錄

3.4.1 CubeMx生成代碼bug

3.4.2 SD插入檢測引腳配置

4. 結(jié)束語

1. 前言

SD卡/SD nand是嵌入式開發(fā)中常為使用的大容量存儲設(shè)備，SD nand雖然當(dāng)前價格比SD卡高，但勝在價格、封裝以及穩(wěn)定性上有優(yōu)勢，實際操作和SD卡沒什么區(qū)別。

關(guān)于 SD卡/SDnand 的驅(qū)動，有了CubeMx之后其實基本上都自動生成了對應(yīng)的驅(qū)動了，基本上把驅(qū)動配置一下之后，自己寫一些應(yīng)用就可以完成基本的讀寫了，同時關(guān)于FATFS文件系統(tǒng)，也可以直接采用CubeMx配置，也不用自己移植，因此使用STM32開發(fā)這些還是比較爽的！不過使用過程中也有一些坑，自動生成的驅(qū)動有時候也還是有一些bug，因此還是需要大家對對應(yīng)驅(qū)動有一定的了解。

本文將主要分享關(guān)于使用 CubeMx 配置 stm32 的工程，通過SDIO總線完成 SD卡/SD nand 的讀寫，并配置FATFS，采用文件操作實現(xiàn)對 SD卡/SD nand 的讀寫操作；此外還將分享博主在調(diào)試過程中遇到的一些問題，比如CubeMx自動生成的驅(qū)動存在的bug等，以及分享關(guān)于驅(qū)動部分的代碼分析！

2. 環(huán)境介紹

2.1 軟硬件說明

硬件環(huán)境：

主控：stm32f103vet6

SD nand： CSNP1GCR01-AOW【樣品CS創(chuàng)世SD NAND由深圳市雷龍發(fā)展有限公司免費提供的，感興趣的可到雷龍官網(wǎng)申請】

軟件環(huán)境：

CubeMx版本：Version 6.6.1

注意：當(dāng)前最新版本 V6.8.0，生成的工程配置存在bug，具體細(xì)節(jié)在后文描述

2.2 外設(shè)原理圖

SD卡槽原理圖部分如下：

?

?

3. 工程搭建

3.1 CubeMx 配置

1. 1.選擇芯片，ACCESS TO MCU SELECTOR

?

2. 2.搜索對應(yīng)的芯片型號，在對應(yīng)列表下方選擇對應(yīng)芯片
5. 3.配置時鐘方案，采用外部高速時鐘，無源晶振方案

?

2. 4.配置調(diào)試器，由于我采用SWD調(diào)試接口，因此選擇 Serial Wrie 串行總線

?

2. 5.配置SDIO外設(shè)，由于我們所使用的SD nand支持4線傳輸，因此此處選擇4線寬度；如果你所使用的SD nand或SD卡不支持4線傳輸，此處應(yīng)選擇1線寬度；支持4線寬度的SD卡肯定可以使用1線寬度，因此如果你實在不知道你的SD卡支持幾線寬度，你可以直接選擇1線寬度！4線和1線寬度的差別也就在于速度上相差了4倍！
3. (注意這里暫時不需要對SDIO的參數(shù)進(jìn)行配置，后面我們再回來配置！)

?

2. 6.完成時鐘樹配置：

• 配置外部晶振頻率
• 調(diào)整時鐘選擇，SYSCLK由PLL產(chǎn)生，PLL由外部時鐘倍頻產(chǎn)生
• 配置SDIO外設(shè)時鐘，注意此處SDIO外設(shè)比較特殊，有兩個時鐘！具體原因見后文！

?

1. 7.
2. 修改SDIO參數(shù)配置，主要是修改SDIOCLK的分頻

• 由于我們上述配置的SDIO時鐘為 72M，而SD卡支持的通訊速率在0MHz至25MHz之間，因此我們需要分頻，配置 SDIO Clock divider bypass 為 Disable
• 此處設(shè)置 SDIOCLK clock divide factor CLKDIV分頻系數(shù)為 8，這個受限于具體的SD卡支持的最大速度。如果設(shè)置值較小，可能由于SDIO_CK速度過高，SD卡/SDnand不支持，導(dǎo)致通訊失敗，因此建議先將此值設(shè)大點（或查看SD卡/SDnand手冊，或先設(shè)一個較大值，軟件完成SD信息讀取后再配置）
• 注意這個配置的時鐘是用于SD讀寫通訊時候的時鐘，而不是SD卡信息識別過程時的速度！

?

編輯

?

8.勾選 FATFS 配置，選擇 SD Card

編輯

?

9.配置SD卡檢測引腳，有以下兩種方案

• 方案一：選擇一個輸入IO，作為觸發(fā)引腳

編輯

?

• 方案二：不配置輸入IO，最后生成代碼的時候無視警報即可，生成的代碼會自動取消輸入檢測判斷

編輯

?

10.配置調(diào)試串口，用來打印信息，此處我選擇USART1，大家可根據(jù)自己硬件環(huán)境自行選擇

編輯

?

11.配置工程信息

• 配置工程名
• 選擇工程路徑
• 配置應(yīng)用程序結(jié)構(gòu)，我習(xí)慣選擇 Basic 結(jié)構(gòu)
• 選擇IDE工具及版本
• 修改堆棧大小，適當(dāng)改大一點，怕不夠用

編輯

?

12.勾選將外設(shè)初始化放置在獨立的.c和.h文件，這樣每個外設(shè)的初始化是獨立的，方便閱讀移植！

編輯

?

13.生成代碼

編輯

?

3.2 SDIO時鐘配置說明

在上述CubeMx時鐘配置中，外設(shè)的時鐘一般都是只有一路過去，但是在此處我們會發(fā)現(xiàn)SDIO的時鐘在時鐘樹中有兩個！沒弄清楚還會以為這是CubeMx出現(xiàn)bug了！

編輯

?

其實這是SDIO外設(shè)的特殊點，我們查看數(shù)據(jù)手冊上的時鐘樹，便可以發(fā)現(xiàn)，實際上是真的有兩路時鐘，分別是：1）SDIOCLK；2）至SDIO的AHB接口；

?

之后，我們看到數(shù)據(jù)手冊的SDIO章節(jié)，我們可以看到SDIO外設(shè)分為：1）AHB總線接口 和 2）SDIO適配器兩大塊，且使用不同的時鐘，這也就是我們在時鐘樹配置中可以看到有兩路時鐘配置的原因了！

從下圖我們可以知道，SDIO外設(shè)不同于其他外設(shè)，其外設(shè)模塊部分與中斷、DMA是分開的，并采用不同的時鐘！

?

關(guān)于AHB總線接口及SDIO適配器更多細(xì)節(jié)，大家可自行閱讀參考手冊部分章節(jié)內(nèi)容，此處不做贅述。

此外，關(guān)于時鐘配置有一個特別需要注意的，也就是SDIO_CK時鐘信號。SDIO_CK時鐘，也就是我們SDIO外設(shè)與SD卡/SD nand通訊的CLK時鐘，從上圖我們可知，SDIO_CK時鐘來自SDIO適配器，也就是來自SDIOCLK，對應(yīng)CubeMX時鐘配置中的：

?

?

3.2 讀寫測試

3.2.1 添加讀寫測試代碼

1. 1.使能 MicroLIB 微庫，否則調(diào)用 printf 函數(shù)會卡住

?

2.修改編碼規(guī)則為 UTF-8，這是由于我們CubeMx中配置的FATFS的編碼格式為 UTF-8導(dǎo)致，如果不修改為 UTF-8 則部分中文會亂碼！ //TODO:確認(rèn)是由FATFS配置導(dǎo)致

?

?

3.添加 printf 重映射 （位置可根據(jù)自行決定）

1. #include
2. int fputc(int ch, FILE *f)
3. {
4. HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1,0xffff);
5. return (ch);
6. }

4.添加 sdcard 信息打印函數(shù)，查看卡片信息

1. HAL_SD_CardInfoTypeDef SDCardInfo;
2. void printf_sdcard_info(void)
3. {
4. uint64_t CardCap; //SD卡容量
5. HAL_SD_CardCIDTypeDef SDCard_CID;
7. HAL_SD_GetCardCID(&hsd,&SDCard_CID); //獲取CID
8. HAL_SD_GetCardInfo(&hsd,&SDCardInfo); //獲取SD卡信息
9. CardCap=(uint64_t)(SDCardInfo.LogBlockNbr)*(uint64_t)(SDCardInfo.LogBlockSize); //計算SD卡容量
10. switch(SDCardInfo.CardType)
11. {
12. case CARD_SDSC:
13. {
14. if(SDCardInfo.CardVersion == CARD_V1_X)
15. printf("Card Type:SDSC V1\r\n");
16. else if(SDCardInfo.CardVersion == CARD_V2_X)
17. printf("Card Type:SDSC V2\r\n");
18. }
19. break;
20. case CARD_SDHC_SDXC:printf("Card Type:SDHC\r\n");break;
21. default:break;
22. }
24. printf("Card ManufacturerID: %d \r\n",SDCard_CID.ManufacturerID); //制造商ID
25. printf("CardVersion: %d \r\n",(uint32_t)(SDCardInfo.CardVersion)); //卡版本號
26. printf("Class: %d \r\n",(uint32_t)(SDCardInfo.Class)); //SD卡類別
27. printf("Card RCA(RelCardAdd):%d \r\n",SDCardInfo.RelCardAdd); //卡相對地址
28. printf("Card BlockNbr: %d \r\n",SDCardInfo.BlockNbr); //塊數(shù)量
29. printf("Card BlockSize: %d \r\n",SDCardInfo.BlockSize); //塊大小
30. printf("LogBlockNbr: %d \r\n",(uint32_t)(SDCardInfo.LogBlockNbr)); //邏輯塊數(shù)量
31. printf("LogBlockSize: %d \r\n",(uint32_t)(SDCardInfo.LogBlockSize)); //邏輯塊大小
32. printf("Card Capacity: %d MB\r\n",(uint32_t)(CardCap>>20)); //卡容量
33. }

5.添加初始化及讀寫測試代碼，注意此處我們沒有直接使用FATFS的讀寫接口，我們先測試生成的SD驅(qū)動函數(shù)接口

1. int main(void)
2. {
3. /* USER CODE BEGIN 1 */
4. BYTE send_buf[512];
5. DRESULT ret;
6. /* USER CODE END 1 */
8. /* ...省略若干自動生成代碼... */
10. /* USER CODE BEGIN 2 */
12. SD_Driver.disk_initialize(0);
13. printf_sdcard_info();
15. printf("\r\n\r\n********** 英文讀寫測試 **********\r\n");
17. ret = SD_Driver.disk_write(0,
18. (BYTE *)"Life is too short to spend time with people who suck the happiness out of you. \
19. If someone wants you in their life, they’ll make room for you. You shouldn’t have to fight for a spot. Never, ever\
20. insist yourself to someone who continuously overlooks your worth. And remember, it’s not the people that stand by \
21. your side when you’re at your best, but the ones who stand beside you when you’re at your worst that are your true\
22. friends",20,2);
23. printf("sd write result:%d\r\n", ret);
24. ret = SD_Driver.disk_read(0, send_buf, 20, 2);
25. printf("sd reak result:%d\r\n", ret);
26. printf("sd read content:\r\n%s\r\n", send_buf);
28. printf("\r\n\r\n********** 中文讀寫測試 **********\r\n");
30. ret = SD_Driver.disk_write(0,
31. (BYTE *)"開發(fā)者社區(qū)的明天需要大家一同開源共創(chuàng)，期待下一次你的分享，讓我們一同攜手共進(jìn)，推動人類科技的發(fā)展！?。r\n\
32. 創(chuàng)作不易，轉(zhuǎn)載請注明出處~\r\n\
33. 更多文章敬請關(guān)注：愛出名的狗腿子\r\n", 22, 2);
34. printf("sd write result:%d\r\n", ret);
35. ret = SD_Driver.disk_read(0, send_buf, 22, 2);
36. printf("sd reak result:%d\r\n", ret);
37. printf("sd read content:\r\n%s\r\n", send_buf);
38. /* USER CODE END 2 */
39. while (1)
40. {
41. /* USER CODE END WHILE */
43. /* USER CODE BEGIN 3 */
44. }
45. /* USER CODE END 3 */
46. }

6.修改燒錄器配置，配置為燒錄后自動運行

?

7.下載測試，這里由于我們采用UTF-8編碼，所以使用的串口上位機也需要支持UTF-8解析，我們這里使用Mobaxterm上位機，測試結(jié)果如下:

?

8.main.c 文件全部代碼如下，供大家參考：

1. /* USER CODE BEGIN Header */
2. /**
3. ******************************************************************************
4. * @file : main.c
5. * @brief : Main program body
6. ******************************************************************************
7. * @attention
8. *
9. * Copyright (c) 2023 STMicroelectronics.
10. * All rights reserved.
11. *
12. * This software is licensed under terms that can be found in the LICENSE file
13. * in the root directory of this software component.
14. * If no LICENSE file comes with this software, it is provided AS-IS.
15. *
16. ******************************************************************************
17. */
18. /* USER CODE END Header */
19. /* Includes ------------------------------------------------------------------*/
20. #include "main.h"
21. #include "fatfs.h"
22. #include "sdio.h"
23. #include "usart.h"
24. #include "gpio.h"
26. /* Private includes ----------------------------------------------------------*/
27. /* USER CODE BEGIN Includes */
29. #include
30. /* USER CODE END Includes */
32. /* Private typedef -----------------------------------------------------------*/
33. /* USER CODE BEGIN PTD */
35. /* USER CODE END PTD */
37. /* Private define ------------------------------------------------------------*/
38. /* USER CODE BEGIN PD */
39. /* USER CODE END PD */
41. /* Private macro -------------------------------------------------------------*/
42. /* USER CODE BEGIN PM */
44. /* USER CODE END PM */
46. /* Private variables ---------------------------------------------------------*/
48. /* USER CODE BEGIN PV */
50. /* USER CODE END PV */
52. /* Private function prototypes -----------------------------------------------*/
53. void SystemClock_Config(void);
54. /* USER CODE BEGIN PFP */
56. /* USER CODE END PFP */
58. /* Private user code ---------------------------------------------------------*/
59. /* USER CODE BEGIN 0 */
61. HAL_SD_CardInfoTypeDef SDCardInfo;
62. void printf_sdcard_info(void)
63. {
64. uint64_t CardCap; //SD卡容量
65. HAL_SD_CardCIDTypeDef SDCard_CID;
67. HAL_SD_GetCardCID(&hsd,&SDCard_CID); //獲取CID
68. HAL_SD_GetCardInfo(&hsd,&SDCardInfo); //獲取SD卡信息
69. CardCap=(uint64_t)(SDCardInfo.LogBlockNbr)*(uint64_t)(SDCardInfo.LogBlockSize); //計算SD卡容量
70. switch(SDCardInfo.CardType)
71. {
72. case CARD_SDSC:
73. {
74. if(SDCardInfo.CardVersion == CARD_V1_X)
75. printf("Card Type:SDSC V1\r\n");
76. else if(SDCardInfo.CardVersion == CARD_V2_X)
77. printf("Card Type:SDSC V2\r\n");
78. }
79. break;
80. case CARD_SDHC_SDXC:printf("Card Type:SDHC\r\n");break;
81. default:break;
82. }
84. printf("Card ManufacturerID: %d \r\n",SDCard_CID.ManufacturerID); //制造商ID
85. printf("CardVersion: %d \r\n",(uint32_t)(SDCardInfo.CardVersion)); //卡版本號
86. printf("Class: %d \r\n",(uint32_t)(SDCardInfo.Class)); //SD卡類別
87. printf("Card RCA(RelCardAdd):%d \r\n",SDCardInfo.RelCardAdd); //卡相對地址
88. printf("Card BlockNbr: %d \r\n",SDCardInfo.BlockNbr); //塊數(shù)量
89. printf("Card BlockSize: %d \r\n",SDCardInfo.BlockSize); //塊大小
90. printf("LogBlockNbr: %d \r\n",(uint32_t)(SDCardInfo.LogBlockNbr)); //邏輯塊數(shù)量
91. printf("LogBlockSize: %d \r\n",(uint32_t)(SDCardInfo.LogBlockSize)); //邏輯塊大小
92. printf("Card Capacity: %d MB\r\n",(uint32_t)(CardCap>>20)); //卡容量
93. }
95. int fputc(int ch, FILE *f)
96. {
97. HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1,0xffff);
98. return (ch);
99. }
100. /* USER CODE END 0 */
102. /**
103. * @brief The application entry point.
104. * @retval int
105. */
106. int main(void)
107. {
108. /* USER CODE BEGIN 1 */
109. BYTE send_buf[512];
110. DRESULT ret;
111. /* USER CODE END 1 */
113. /* MCU Configuration--------------------------------------------------------*/
115. /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
116. HAL_Init();
118. /* USER CODE BEGIN Init */
120. /* USER CODE END Init */
122. /* Configure the system clock */
123. SystemClock_Config();
125. /* USER CODE BEGIN SysInit */
127. /* USER CODE END SysInit */
129. /* Initialize all configured peripherals */
130. MX_GPIO_Init();
131. MX_SDIO_SD_Init();
132. MX_USART1_UART_Init();
133. MX_FATFS_Init();
134. /* USER CODE BEGIN 2 */
136. SD_Driver.disk_initialize(0);
137. printf_sdcard_info();
139. printf("\r\n\r\n********** 英文讀寫測試 **********\r\n");
141. ret = SD_Driver.disk_write(0,
142. (BYTE *)"Life is too short to spend time with people who suck the happiness out of you. \
143. If someone wants you in their life, they’ll make room for you. You shouldn’t have to fight for a spot. Never, ever\
144. insist yourself to someone who continuously overlooks your worth. And remember, it’s not the people that stand by \
145. your side when you’re at your best, but the ones who stand beside you when you’re at your worst that are your true\
146. friends",20,2);
147. printf("sd write result:%d\r\n", ret);
148. ret = SD_Driver.disk_read(0, send_buf, 20, 2);
149. printf("sd reak result:%d\r\n", ret);
150. printf("sd read content:\r\n%s\r\n", send_buf);
152. printf("\r\n\r\n********** 中文讀寫測試 **********\r\n");
154. ret = SD_Driver.disk_write(0,
155. (BYTE *)"開發(fā)者社區(qū)的明天需要大家一同開源共創(chuàng)，期待下一次你的分享，讓我們一同攜手共進(jìn)，推動人類科技的發(fā)展?。?！\r\n\
156. 創(chuàng)作不易，轉(zhuǎn)載請注明出處~\r\n\
157. 更多文章敬請關(guān)注：愛出名的狗腿子\r\n", 22, 2);
158. printf("sd write result:%d\r\n", ret);
159. ret = SD_Driver.disk_read(0, send_buf, 22, 2);
160. printf("sd reak result:%d\r\n", ret);
161. printf("sd read content:\r\n%s\r\n", send_buf);
163. /* USER CODE END 2 */
165. /* Infinite loop */
166. /* USER CODE BEGIN WHILE */
167. while (1)
168. {
169. /* USER CODE END WHILE */
171. /* USER CODE BEGIN 3 */
172. }
173. /* USER CODE END 3 */
174. }
176. /**
177. * @brief System Clock Configuration
178. * @retval None
179. */
180. void SystemClock_Config(void)
181. {
182. RCC_OscInitTypeDef RCC_OscInitStruct = {0};
183. RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
185. /** Initializes the RCC Oscillators according to the specified parameters
186. * in the RCC_OscInitTypeDef structure.
187. */
188. RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
189. RCC_OscInitStruct.HSEState = RCC_HSE_ON;
190. RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
191. RCC_OscInitStruct.HSIState = RCC_HSI_ON;
192. RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
193. RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
194. RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
195. if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
196. {
197. Error_Handler();
198. }
200. /** Initializes the CPU, AHB and APB buses clocks
201. */
202. RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
203. |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
204. RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
205. RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
206. RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
207. RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
209. if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
210. {
211. Error_Handler();
212. }
213. }
215. /* USER CODE BEGIN 4 */
217. /* USER CODE END 4 */
219. /**
220. * @brief This function is executed in case of error occurrence.
221. * @retval None
222. */
223. void Error_Handler(void)
224. {
225. /* USER CODE BEGIN Error_Handler_Debug */
226. /* User can add his own implementation to report the HAL error return state */
227. __disable_irq();
228. while (1)
229. {
230. }
231. /* USER CODE END Error_Handler_Debug */
232. }
234. #ifdef USE_FULL_ASSERT
235. /**
236. * @brief Reports the name of the source file and the source line number
237. * where the assert_param error has occurred.
238. * @param file: pointer to the source file name
239. * @param line: assert_param error line source number
240. * @retval None
241. */
242. void assert_failed(uint8_t *file, uint32_t line)
243. {
244. /* USER CODE BEGIN 6 */
245. /* User can add his own implementation to report the file name and line number,
246. ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
247. /* USER CODE END 6 */
248. }
249. #endif /* USE_FULL_ASSERT */

3.3 FATFS文件操作

移植了FATFS，當(dāng)然也就可以只用通用的文件系統(tǒng)操作函數(shù)完成文件的讀寫，通用的文件系統(tǒng)操作API 在 ff.c 文件內(nèi)，聲明在 ff.h 文件內(nèi)，主要使用的API接口如下：

1. FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
2. FRESULT f_close (FIL* fp); /* Close an open file object */
3. FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from a file */
4. FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to a file */
5. FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
6. FRESULT f_lseek (FIL* fp, DWORD ofs); /* Move file pointer of a file object */
7. FRESULT f_truncate (FIL* fp); /* Truncate file */
8. FRESULT f_sync (FIL* fp); /* Flush cached data of a writing file */
9. FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */
10. FRESULT f_closedir (DIR* dp); /* Close an open directory */
11. FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */
12. FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */
13. FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */
14. FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */
15. FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */
16. FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */
17. FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */
18. FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of the file/dir */
19. FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change times-tamp of the file/dir */
20. FRESULT f_chdir (const TCHAR* path); /* Change current directory */
21. FRESULT f_chdrive (const TCHAR* path); /* Change current drive */
22. FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */
23. FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */
24. FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */
25. FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
26. FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */
27. FRESULT f_mkfs (const TCHAR* path, BYTE sfd, UINT au); /* Create a file system on the volume */
28. FRESULT f_fdisk (BYTE pdrv, const DWORD szt[], void* work); /* Divide a physical drive into some partitions */
29. int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */
30. int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */
31. int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */
32. TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */

關(guān)于API的使用此處不做過多贅述，大家可以自行上官網(wǎng)查閱 FATFS官網(wǎng)，或者網(wǎng)上搜索，或直接看下述示例亦可。

3.3.1 修改讀寫測試代碼

修改3.2.1章節(jié)所使用的讀寫測試代碼，此處我們直接使用FATFS文件系統(tǒng)的讀寫函數(shù)接口，修改主函數(shù)如下，注意需要包含fatfs.h頭文件！

1. #include "fatfs.h"
2. int main()
3. {
4. /* USER CODE BEGIN 1 */
5. #define USERPath "0:/"
7. BYTE write_buf[] = "\r\n\r\n\
8. hello world!\r\n\
9. 開發(fā)者社區(qū)的明天需要大家一同開源共創(chuàng)，期待下一次你的分享，讓我們一同攜手共進(jìn)，推動人類科技的發(fā)展?。?！\r\n\
10. 創(chuàng)作不易，轉(zhuǎn)載請注明出處~\r\n\
11. 更多文章敬請關(guān)注：愛出名的狗腿子\r\n\r\n\
12. ";
13. BYTE read_buf[1024] = {0};
14. UINT num;
15. FRESULT ret;
16. /* USER CODE END 1 */
18. /* ... 省略初始化代碼... */
20. /* USER CODE BEGIN 2 */
22. /* 掛載文件系統(tǒng)，掛載的時候會完成對應(yīng)硬件設(shè)備（SD卡/SDnand）初始化 */
23. ret = f_mount(&SDFatFS, USERPath, 1);
24. if (ret != FR_OK) {
25. printf("f_mount error!\r\n");
26. goto mount_error;
27. } else if(ret == FR_NO_FILESYSTEM) { /* 檢測是否存在文件系統(tǒng)，如果沒有則進(jìn)行格式化 */
28. printf("未檢測到FATFS文件系統(tǒng)，執(zhí)行格式化...\r\n");
29. ret = f_mkfs(USERPath, 0, 0);
30. if(ret == FR_OK) {
31. printf("格式化成功！\r\n");
32. f_mount(NULL, USERPath, 1); /* 先取消掛載，后重新掛載 */
33. ret = f_mount(&SDFatFS, USERPath, 1);
34. } else {
35. printf("格式化失敗！\r\n");
36. goto mount_error;
37. }
38. } else {
39. printf("f_mount success!\r\n");
40. }
42. /* 讀寫測試 */
43. printf("\r\n ========== write test ==========\r\n");
44. ret = f_open(&SDFile, "hello.txt", FA_CREATE_ALWAYS | FA_WRITE);
45. if(ret == FR_OK) {
46. printf("open file sucess!\r\n");
47. ret = f_write(&SDFile, write_buf, sizeof(write_buf), &num);
48. if(ret == FR_OK) {
49. printf("write "%s" success!\r\nwrite len：%d\r\n", write_buf, num);
50. } else {
51. printf("write error! ret:%d \r\n", ret);
52. goto rw_error;
53. }
54. f_close(&SDFile);
55. } else {
56. printf("open file error!\r\n");
57. goto rw_error;
58. }
60. printf("\r\n ========== read test ==========\r\n");
61. ret = f_open(&SDFile, "hello.txt",FA_OPEN_EXISTING | FA_READ);
62. if(ret == FR_OK) {
63. printf("open file sucess!\r\n");
64. ret = f_read(&SDFile, read_buf, sizeof(read_buf), &num);
65. if(ret == FR_OK) {
66. printf("read data:"%s"!\r\nread len：%d\r\n", read_buf, num);
67. } else {
68. printf("read error! ret:%d \r\n", ret);
69. goto rw_error;
70. }
71. } else {
72. printf("open file error!\r\n");
73. goto rw_error;
74. }
76. rw_error:
77. f_close(&SDFile);
79. mount_error:
80. f_mount(NULL, USERPath, 1);
81. /* USER CODE END 2 */
82. while (1) {
84. }
85. }

#define USERPath "0:/" 表示掛載的位置，這是由于FATFS初始化的時候鏈接的根目錄為 0:/ ，所以掛載的文件系統(tǒng)需要在此目錄下，當(dāng)然也可以是此目錄下的路徑，如0:/hello，但不能是其他目錄，如 1:/

?

測試結(jié)果如下：

?

main.c完整內(nèi)容如下：

1. /* USER CODE BEGIN Header */
2. /**
3. ******************************************************************************
4. * @file : main.c
5. * @brief : Main program body
6. ******************************************************************************
7. * @attention
8. *
9. * Copyright (c) 2023 STMicroelectronics.
10. * All rights reserved.
11. *
12. * This software is licensed under terms that can be found in the LICENSE file
13. * in the root directory of this software component.
14. * If no LICENSE file comes with this software, it is provided AS-IS.
15. *
16. ******************************************************************************
17. */
18. /* USER CODE END Header */
19. /* Includes ------------------------------------------------------------------*/
20. #include "main.h"
21. #include "fatfs.h"
22. #include "sdio.h"
23. #include "usart.h"
24. #include "gpio.h"
26. /* Private includes ----------------------------------------------------------*/
27. /* USER CODE BEGIN Includes */
29. #include
30. #include "fatfs.h"
31. /* USER CODE END Includes */
33. /* Private typedef -----------------------------------------------------------*/
34. /* USER CODE BEGIN PTD */
36. /* USER CODE END PTD */
38. /* Private define ------------------------------------------------------------*/
39. /* USER CODE BEGIN PD */
40. /* USER CODE END PD */
42. /* Private macro -------------------------------------------------------------*/
43. /* USER CODE BEGIN PM */
45. /* USER CODE END PM */
47. /* Private variables ---------------------------------------------------------*/
49. /* USER CODE BEGIN PV */
51. /* USER CODE END PV */
53. /* Private function prototypes -----------------------------------------------*/
54. void SystemClock_Config(void);
55. /* USER CODE BEGIN PFP */
57. /* USER CODE END PFP */
59. /* Private user code ---------------------------------------------------------*/
60. /* USER CODE BEGIN 0 */
62. HAL_SD_CardInfoTypeDef SDCardInfo;
63. void printf_sdcard_info(void)
64. {
65. uint64_t CardCap; //SD卡容釿
66. HAL_SD_CardCIDTypeDef SDCard_CID;
68. HAL_SD_GetCardCID(&hsd,&SDCard_CID); //獲取CID
69. HAL_SD_GetCardInfo(&hsd,&SDCardInfo); //獲取SD卡信恿
70. CardCap=(uint64_t)(SDCardInfo.LogBlockNbr)*(uint64_t)(SDCardInfo.LogBlockSize); //計算SD卡容釿
71. switch(SDCardInfo.CardType)
72. {
73. case CARD_SDSC:
74. {
75. if(SDCardInfo.CardVersion == CARD_V1_X)
76. printf("Card Type:SDSC V1\r\n");
77. else if(SDCardInfo.CardVersion == CARD_V2_X)
78. printf("Card Type:SDSC V2\r\n");
79. }
80. break;
81. case CARD_SDHC_SDXC:printf("Card Type:SDHC\r\n");break;
82. default:break;
83. }
85. printf("Card ManufacturerID: %d \r\n",SDCard_CID.ManufacturerID); //制?商ID
86. printf("CardVersion: %d \r\n",(uint32_t)(SDCardInfo.CardVersion)); //卡版本號
87. printf("Class: %d \r\n",(uint32_t)(SDCardInfo.Class)); //SD卡類劌
88. printf("Card RCA(RelCardAdd):%d \r\n",SDCardInfo.RelCardAdd); //卡相對地坿
89. printf("Card BlockNbr: %d \r\n",SDCardInfo.BlockNbr); //塊數(shù)釿
90. printf("Card BlockSize: %d \r\n",SDCardInfo.BlockSize); //塊大尿
91. printf("LogBlockNbr: %d \r\n",(uint32_t)(SDCardInfo.LogBlockNbr)); //邏輯塊數(shù)釿
92. printf("LogBlockSize: %d \r\n",(uint32_t)(SDCardInfo.LogBlockSize)); //邏輯塊大尿
93. printf("Card Capacity: %d MB\r\n",(uint32_t)(CardCap>>20)); //卡容釿
94. }
96. int fputc(int ch, FILE *f)
97. {
98. HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1,0xffff);
99. return (ch);
100. }
102. /* USER CODE END 0 */
104. /**
105. * @brief The application entry point.
106. * @retval int
107. */
108. int main(void)
109. {
110. /* USER CODE BEGIN 1 */
111. #define USERPath "0:/"
113. BYTE write_buf[] = "\r\n\r\n\
114. hello world!\r\n\
115. 開發(fā)者社區(qū)的明天需要大家一同開源共創(chuàng)，期待下一次你的分享，讓我們一同攜手共進(jìn)，推動人類科技的發(fā)展！?。r\n\
116. 創(chuàng)作不易，轉(zhuǎn)載請注明出處~\r\n\
117. 更多文章敬請關(guān)注：愛出名的狗腿子\r\n\r\n\
118. ";
119. BYTE read_buf[1024] = {0};
120. UINT num;
121. FRESULT ret;
122. /* USER CODE END 1 */
124. /* MCU Configuration--------------------------------------------------------*/
126. /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
127. HAL_Init();
129. /* USER CODE BEGIN Init */
131. /* USER CODE END Init */
133. /* Configure the system clock */
134. SystemClock_Config();
136. /* USER CODE BEGIN SysInit */
138. /* USER CODE END SysInit */
140. /* Initialize all configured peripherals */
141. MX_GPIO_Init();
142. MX_SDIO_SD_Init();
143. MX_USART1_UART_Init();
144. MX_FATFS_Init();
145. /* USER CODE BEGIN 2 */
147. /* 掛載文件系統(tǒng)，掛載的時候會完成對應(yīng)硬件設(shè)備（SD卡/SDnand）初始化 */
148. ret = f_mount(&SDFatFS, USERPath, 1);
149. if (ret != FR_OK) {
150. printf("f_mount error!\r\n");
151. goto mount_error;
152. } else if(ret == FR_NO_FILESYSTEM) { /* 檢測是否存在文件系統(tǒng)，如果沒有則進(jìn)行格式化 */
153. printf("未檢測到FATFS文件系統(tǒng)，執(zhí)行格式化...\r\n");
154. ret = f_mkfs(USERPath, 0, 0);
155. if(ret == FR_OK) {
156. printf("格式化成功！\r\n");
157. f_mount(NULL, USERPath, 1); /* 先取消掛載，后重新掛載 */
158. ret = f_mount(&SDFatFS, USERPath, 1);
159. } else {
160. printf("格式化失?。r\n");
161. goto mount_error;
162. }
163. } else {
164. printf("f_mount success!\r\n");
165. }
167. /* 讀寫測試 */
168. printf("\r\n ========== write test ==========\r\n");
169. ret = f_open(&SDFile, "hello.txt", FA_CREATE_ALWAYS | FA_WRITE);
170. if(ret == FR_OK) {
171. printf("open file sucess!\r\n");
172. ret = f_write(&SDFile, write_buf, sizeof(write_buf), &num);
173. if(ret == FR_OK) {
174. printf("write "%s" success!\r\nwrite len：%d\r\n", write_buf, num);
175. } else {
176. printf("write error! ret:%d \r\n", ret);
177. goto rw_error;
178. }
179. f_close(&SDFile);
180. } else {
181. printf("open file error!\r\n");
182. goto rw_error;
183. }
185. printf("\r\n ========== read test ==========\r\n");
186. ret = f_open(&SDFile, "hello.txt",FA_OPEN_EXISTING | FA_READ);
187. if(ret == FR_OK) {
188. printf("open file sucess!\r\n");
189. ret = f_read(&SDFile, read_buf, sizeof(read_buf), &num);
190. if(ret == FR_OK) {
191. printf("read data:"%s"!\r\nread len：%d\r\n", read_buf, num);
192. } else {
193. printf("read error! ret:%d \r\n", ret);
194. goto rw_error;
195. }
196. } else {
197. printf("open file error!\r\n");
198. goto rw_error;
199. }
201. rw_error:
202. f_close(&SDFile);
204. mount_error:
205. f_mount(NULL, USERPath, 1);
206. /* USER CODE END 2 */
208. /* Infinite loop */
209. /* USER CODE BEGIN WHILE */
210. while (1)
211. {
212. /* USER CODE END WHILE */
214. /* USER CODE BEGIN 3 */
215. }
216. /* USER CODE END 3 */
217. }
219. /**
220. * @brief System Clock Configuration
221. * @retval None
222. */
223. void SystemClock_Config(void)
224. {
225. RCC_OscInitTypeDef RCC_OscInitStruct = {0};
226. RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
228. /** Initializes the RCC Oscillators according to the specified parameters
229. * in the RCC_OscInitTypeDef structure.
230. */
231. RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
232. RCC_OscInitStruct.HSEState = RCC_HSE_ON;
233. RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
234. RCC_OscInitStruct.HSIState = RCC_HSI_ON;
235. RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
236. RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
237. RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
238. if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
239. {
240. Error_Handler();
241. }
243. /** Initializes the CPU, AHB and APB buses clocks
244. */
245. RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
246. |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
247. RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
248. RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
249. RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
250. RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
252. if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
253. {
254. Error_Handler();
255. }
256. }
258. /* USER CODE BEGIN 4 */
260. /* USER CODE END 4 */
262. /**
263. * @brief This function is executed in case of error occurrence.
264. * @retval None
265. */
266. void Error_Handler(void)
267. {
268. /* USER CODE BEGIN Error_Handler_Debug */
269. /* User can add his own implementation to report the HAL error return state */
270. __disable_irq();
271. while (1)
272. {
273. }
274. /* USER CODE END Error_Handler_Debug */
275. }
277. #ifdef USE_FULL_ASSERT
278. /**
279. * @brief Reports the name of the source file and the source line number
280. * where the assert_param error has occurred.
281. * @param file: pointer to the source file name
282. * @param line: assert_param error line source number
283. * @retval None
284. */
285. void assert_failed(uint8_t *file, uint32_t line)
286. {
287. /* USER CODE BEGIN 6 */
288. /* User can add his own implementation to report the file name and line number,
289. ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
290. /* USER CODE END 6 */
291. }
292. #endif /* USE_FULL_ASSERT */

3.4 配置問題記錄

3.4.1 CubeMx生成代碼bug

測試發(fā)現(xiàn)，使用CubeMx當(dāng)前最新版本：V6.8.0版本，生成代碼會存在以下問題：

• SD卡/SDnand 卡片信息讀取成功，但是讀寫測試失敗

經(jīng)過仔細(xì)分析代碼后發(fā)現(xiàn)，出現(xiàn)的問題在 MX_SDIO_SD_Init() 此初始化函數(shù)內(nèi)的配置項錯誤導(dǎo)致，具體分析如下：

1. 我們在CubeMx里面配置的時候選擇的是4線寬度模式 SD 4bit Wide bus
2. v6.8.0版本CubeMx生成的 MX_SDIO_SD_Init() SD初始化函數(shù)內(nèi)，hsd.Init.BusWide = SDIO_BUS_WIDE_4B;
3. 看上去沒有什么問題，配置4線模式，對應(yīng)的初始化項也使用4線模式，但是不然，我們繼續(xù)分析 MX_SDIO_SD_Init() 此初始配置的調(diào)用
4. MX_SDIO_SD_Init() 此函數(shù)在main函數(shù)內(nèi)初始化的時候調(diào)用，此函數(shù)只配置了 hsd 結(jié)構(gòu)體，并未配置給SDIO硬件寄存器
5. 之后調(diào)用 SD_Driver.disk_initialize(0); 函數(shù)的時候才真正開始進(jìn)行SDIO外設(shè)配置

BSP_SD_Init()

??->HAL_SD_Init()

????->HAL_SD_InitCard()

在 HAL_SD_InitCard() 函數(shù)內(nèi)使用Init結(jié)構(gòu)體配置SDIO外設(shè)，總線寬度1bit，時鐘速度<400k，以進(jìn)行卡片的初始化識別。

??????-> SD_InitCard()

????????-> SDIO_Init(hsd->Instance, hsd->Init)

??????-> SDMMC_CmdBlockLength(hsd->Instance, BLOCKSIZE)

· 在 SD_InitCard() 函數(shù)內(nèi)實現(xiàn)SD卡的初始化識別，之后調(diào)用 SDIO_Init() 將 MX_SDIO_SD_Init() 內(nèi)對 hsd 的配置配置給SDIO外設(shè)，此處的作用主要是提升SDIO外設(shè)時鐘速率為我們配置的速率；

· v6.8.0版本的代碼此時hsd.Init.BusWide = SDIO_BUS_WIDE_4B; ，因此v6.8.0版本代碼后續(xù)SDIO外設(shè)使用4線通訊；

· 之后調(diào)用 SDMMC_CmdBlockLength() 設(shè)置塊大小，由于SDIO外設(shè)已切換到4線模式，而SD卡/SDnand此時仍然處于1線模式，因此配置會出錯

?? -> HAL_SD_ConfigWideBusOperation(&hsd, SDIO_BUS_WIDE_4B)

根據(jù)前面獲取到的SD卡SCR寄存器值，判斷是否支持4線模式，如果支持則發(fā)送配置命令通知SD卡/SDnand進(jìn)入4線模式，之后修改SDIO外設(shè)總線寬度為4線模式

6.通過以上分析可知，MX_SDIO_SD_Init() 函數(shù)內(nèi)對 hsd.Init.BusWide = SDIO_BUS_WIDE_4B; 的配置會導(dǎo)致對SD卡塊大小的配置失敗，從而導(dǎo)致后續(xù)讀寫時失敗，報錯為塊大小設(shè)置失?。?/p>

7.綜上，針對當(dāng)前最新版本 V6.8.0 版本CubeMx的處理方法是：手動修改此 hsd.Init.BusWide 配置為 SDIO_BUS_WIDE_1B 或更換低版本CubeMx，本人更換V6.6.1版本后無此bug。

3.4.2 SD插入檢測引腳配置

使用CubeMx配置FATFS 選擇 SD Card 之后，有一個配置參數(shù)，用來配置SD Card的輸入檢測引腳。如果我們在硬件上有設(shè)計SD卡的卡槽插入檢測引腳插入連接到了MCU的IO，則可配置對應(yīng)IO為輸入模式，并設(shè)置對應(yīng)IO為輸入檢測引腳，比如，我們設(shè)置PD12為輸入檢測引腳，則配置如下：

對應(yīng)代碼如下，輸入檢測 IO 低電平有效！

?

?

如果硬件上，沒有此插入檢測引腳，則可以在CubeMx內(nèi)不進(jìn)行配置，只是在生成代碼的時候會提示警報而已，可以不用關(guān)心，生成的代碼項會自動屏蔽插入檢測！

?

4. 結(jié)束語

• 以上便是本文的全部內(nèi)容了，歡迎大家評論區(qū)留言討論！
• 使用CubeMx雖然能幫助我們快速生成驅(qū)動，但是對于SD卡/SD nand的驅(qū)動流程，我們還是需要有清晰的認(rèn)識，推薦閱讀： SD Nand 與 SD卡 SDIO模式應(yīng)用流程

————————————————

【本文轉(zhuǎn)載自CSDN，作者： 愛出名的狗腿子】