AWorksLP對存儲類設備進行了高度抽象化，為存儲類設備提供了通用的文件操作接口，應用程序可以輕松跨平臺。本文以MR6450平臺為例，介紹AWorksLP基于FatFs的SD卡的基本用法。

?簡介

SD卡（Secure Digital Card）即安全數字卡。是一種基于半導體快閃記憶器的新一代記憶設備，從MMC的基礎上發展而來。由于它的體積小、數據傳輸速度快、可熱拔插等優點，被廣泛的運用于便攜式和嵌入式設備上。FatFs是一種面向小型嵌入式系統的通用的FAT文件系統。它完全是由ANSIC語言編寫并且完全獨立于底層I/O。因此它可以很容易的移植到不同且資源有限的微控制器中。
由此可見在嵌入式開發中對SD卡中的文件進行管理時，FatFs是使用的最多的文件系統。在AWorksLP中已經集成了FatFs文件系統，并支持使用該文件系統對SD卡的文件進行管理。

?相關API

在SD卡例程中，是通過文件接口實現對SD卡中文件進行操作的。在本文中僅介紹用到的文件接口，其他文件接口，請參考SDK中《AWorksLP OS 標準API參考手冊(html)》。

AWorksLP函數列表：

部分接口參數屬性表：

?工程編譯

環境的搭建、Eclipse工程的編譯與配置、開發板的仿真與調試、請參考《AWorksLPSDK快速入門（MR6450）——開箱體驗》。

?例程介紹

本文介紹例程在{SDK}\demos\peripheral\sdcard目錄下。

在src目錄下的demo_sdcard_fs.c例程代碼中的第149行到第157行使用了while循環如代碼1示，在循環中每隔500ms打開一次SD卡設備，通過檢查返回值來檢測是否有SD卡插入。如檢測到返回值大于等于0則表明有SD卡插入。需要注意的是打開SD卡的設備名（“__BLK_NAME”在demo_sdcard_fs.c的第67行中默認被宏定義為“/dev/sdcardB0”）需要與實際檢測到的SD卡設備名一致。在AWorksLP中SD卡默認是動態監測，在SD卡插入時會在串口打印設備信息如圖1示，串口顯示SD卡設備名為“sdcardA0”，所以我們需要修改“__BLK_NAME”的宏定義為“/dev/sdcardA0”。

64 /* sd卡設備分區名，是由sd卡設備分區注冊為字符型設備65 * sd卡設備分區名一般是由SD卡設備名加上part number66 */67 #define __BLK_NAME "/dev/sdcardB0"149 do{150 fd = aw_open(__BLK_NAME, AW_O_RDWR, 0);151 if (fd < 0) {152 ? ? ? ? aw_kprintf("open device failed\r\n");153 ? ? ? ? aw_mdelay(500);154 ? ? } 155 }while(fd < 0);156 157 ? ?aw_close(fd);

代碼1SD卡設備檢測流程

圖1串口打印SD卡設備名代碼2中第159行到172行的功能為使用aw_make_fs函數接口將SD卡格式化為FatFs文件系統。第159行的宏定義默認為#if 0，本次例程為了演示該步驟將宏改為#if 1。需要注意的是格式化會把卡內的數據清除，在執行格式化之前需要確保卡內沒有重要數據。

159 #if 1 /* 格式化一次即可 */160 161 /* 卷名為"awdisk"， 卷大小為4k */162 struct aw_fs_format_arg fmt = {"awdisk", 1024 * 4, 0};163 164 /* 制作文件系統 ，將存儲器名為 "/dev/sd0"制作為"vfat"類型的文件系統 */165 ret = aw_make_fs(__BLK_NAME, "vfat", &fmt);166 if (ret != AW_OK) {167 AW_ERRF(("failed: %d\n", ret));168 return;169 }170 AW_INFOF(("make fs OK\n"));171 172 #endif

代碼2SD卡格式化

格式化完成后，代碼3中第174行通過aw_mkdir函數創建一個名為“/sd”的目錄，以該目錄為SD卡的掛載點。創建目錄的文件模式為文件所有者、用戶組和其他用戶都可以對該目錄進行讀寫。第181行通過aw_mount函數將SD卡掛載在“/sd”目錄中。需要注意的掛載前需要確保目錄存在，如果將SD卡掛載在不存在的目錄上，掛載會失敗。掛載的文件系統也需要與SD卡格式化的文件系統格式一致，否則掛載同樣會失敗。

173 /* 創建掛載節點 */174 ret = aw_mkdir("/sd", AW_S_IRWXU | AW_S_IRWXG | AW_S_IRWXO);175 if (ret != AW_OK) {176 AW_ERRF(("/sd create error: %d!\n", ret));177 return;178 }179 180 /* 文件系統掛載到"/sd"節點 */181 ret = aw_mount("/sd", __BLK_NAME, "vfat", 0, NULL);182 if (ret != AW_OK) {183 AW_ERRF(("/sd mount FATFS error: %d!\n", ret));184 return;185 }186 AW_INFOF(("mount OK\n"));187 188 /* SD 卡讀寫測試 */189 __fs_file_rw();

代碼3掛載SD卡

最終例程會在第189行調用__fs_file_rw函數，函數體如代碼4所示。在該函數中會在“/sd”目錄下創建一個名為“aworks_sd_test.txt”的測試文件，通過對該文件進行讀寫測試，讀寫完成后對數據進行效驗，效驗通過則表明SD卡讀寫測試成功。至此SD卡例程執行完畢，整個過程會有串口信息打印如圖2所示。

69 aw_local void __fs_file_rw (void)70 {71 int i = 0;72 int handle;73 char *p_file_name = "/sd/aworks_sd_test.txt";74 uint8_t str_buf[256] = {0};75 int len;76 77 /*78 * 寫文件測試（包括創建，文件寫操作，關閉操作）79 */80 /* 創建新文件 */81 handle = aw_open(p_file_name, AW_O_RDWR | AW_O_CREAT, 0777);82 if (handle < 0) {83 AW_ERRF(("creat file error: %d\n", handle));84 return;85 }86 AW_INFOF(("creat file %s ok\n", p_file_name));87 88 len = sizeof(str_buf);89 for (i = 0; i < len; i++) {90 str_buf[i] = (uint8_t)i;91 }92 93 /* 寫文件 */94 if (aw_write(handle, str_buf, sizeof(str_buf)) != sizeof(str_buf)) {95 aw_close(handle);96 AW_ERRF(("write file error\n"));97 return;98 }99 AW_INFOF(("write file %s ok\n", p_file_name));100 101 /* 關閉文件 */102 aw_close(handle);103 AW_INFOF(("close file %s ok\n", p_file_name));104 105 /*106 * 讀文件測試（包括打開，文件讀操作，關閉操作）107 */108 /* 打開文件 */109 handle = aw_open(p_file_name, AW_O_RDONLY, 0777);110 if (handle < 0) {111 AW_ERRF(("open file error: %d\n", handle));112 return;113 }114 AW_INFOF(("open file %s ok\n", p_file_name));115 116 memset(str_buf, 0, sizeof(str_buf));117 118 /* 讀取文件 */119 len = sizeof(str_buf);120 if (aw_read(handle, str_buf, sizeof(str_buf)) != sizeof(str_buf)) {121 aw_close(handle);122 AW_ERRF(("read file error!\n"));123 return;124 }125 AW_INFOF(("read file %s ok\n", p_file_name));126 127 /* 檢驗數據是否正確 */128 for (i = 0; i < len; i++) {129 if ((uint8_t)i != str_buf[i]) {130 AW_ERRF(("file data error!\n"));131 aw_close(handle);132 return;133 }134 }135 136 AW_INFOF(("file %s data check ok\n", p_file_name));137 }

代碼4__fs_file_rw讀寫測試函數

圖2SD卡例程執行成功的串口信息

?擴展介紹

在上節中有提到AWorksLP SD卡默認是動態檢測設備，即支持熱拔插，這是通過一個檢測引腳實現的。在實際應用中，可能出于節約I/O資源的考慮，需要將檢測引腳復用為其他功能。在這種情況下可以將SD卡定義為靜態設備，這樣檢測引腳就能復用作其他功能了。

在AWorksLP中SD卡的動態設備在圖形化配置界面中沒有SD卡設備可供使用，只需將對應的SDIO控制器選上即可。上文例程中SD卡是通過sdio1設備來控制的，所以僅需保證sdio1設備使能即可，如圖3所示。

圖3 動態設備下確認控制器被選上

將SD卡設備以靜態方式注冊時，則需要進行如下操作：

將pins.dts({board}\dts\pins.dts)文件中CD引腳配置注釋,修改完成后如代碼5所示；

1. 在board.dts文件中添加SD卡設備，如代碼5所示。

/* cd-pins = <&pin1 PIN_PD28(IOC_PD28_FUNC_CTL_SDC1_CDN|HPM_PIN_DS(6)|HPM_PIN_PE(_HPM_PIN_PE_ON)|AW_PIN_CFG_PULL_UP) (IOC_PD28_FUNC_CTL_SDC1_CDN|HPM_PIN_DS(6)|HPM_PIN_PE(_HPM_PIN_PE_ON)|AW_PIN_CFG_PULL_UP) (IOC_PD28_FUNC_CTL_SDC1_CDN|HPM_PIN_DS(6)|HPM_PIN_PE(_HPM_PIN_PE_ON)|AW_PIN_CFG_PULL_UP) >; */

代碼5 注釋引腳

&sdio1 { sdio_mem_card0:sdio_mem_card0 { compatible = "general,sdio_mem_card"; label = "sdcardA"; status = "disabled"; }; };

代碼6添加SD卡設備

完成修改后，重新打開例程編譯圖形化配置界面，即可在Board EPC6450-AWI/Devices/External Memories選項下看到板卡下新增sdcardA設備如圖4所示，使能該項并保存退出，再次編譯工程并執行固件，例程現象與上節中所描述完全一致。

圖4 選擇SD卡設備

注意：例程在靜態SD卡設備下執行需要在固件運行前將SD卡插入。