更正文檔

fatfs is a generic FAT/exFAT filesystem module for small embedded system. The fatfs module is written in compliance with ANSI C (C89). It attempts to provide AOS-compatible filesystem behaviour. 組件支持以下功能

• DOS/Windows compatible FAT/exFAT filesystem

• Very small footprint for program code and work area

• Various configuration options to support for:

• Long file name in ANSI/OEM or Unicode.

• exFAT filesystem.

• Thread safe for RTOS.

• Multiple volumes (physical drives and partitions)

• Variable sector size.

• Multiple code page including DBCS.

• Read-only, optional API, I/O buffer and etc...

fatfs
├── src
│   ├── mmc_disk
│   │   ├── mmc_disk.c
│   │   └── mmc_disk.h
│   ├── ram_disk
│   │   ├── ram_disk.c
│   │   └── ram_disk.h
│   ├── sd_disk
│   │   ├── sd_disk.c
│   │   └── sd_disk.h
│   └── usb_disk
│       ├── usb_disk.c
│       └── usb_disk.h
├── include
│   ├── diskio.h
│   ├── fatfs_diskio.h
│   ├── fatfs.h
│   ├── ff.h
│   ├── ffconf.h
│   ├── integer.h
├── package.yaml     # 編譯配置文件
├── example
│    └── fatfs_example.c # 示例代碼
└─── README.md

• rhino

• vfs

def_config:
  CONFIG_AOS_FATFS_SUPPORT_MMC: 1
  AOS_COMP_VFS: 1
  AOS_COMP_FATFS: 1

組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具 alios-studio ，所以首先需要參考《aos-studio使用說明之搭建開發環境》，下載安裝 alios-studio 。 待開發環境搭建完成后，可以按照以下步驟進行示例的測試。

步驟1 創建或打開工程

• 打開已有工程

如果用于測試的案例工程已存在，可參考《aos-studio使用說明之打開工程》打開已有工程。

• 創建新的工程

組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《aos-studio使用說明之創建工程》。

步驟2 添加組件

案例下載完成后，需要在helloworld_demo組件的package.yaml中添加對組件的依賴：

depends:
  - fatfs: dev_aos # helloworld_demo中引入fatfs組件

步驟3 下載組件

在已安裝了 alios-studio 的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：

aos install fatfs

上述命令執行成功后，組件源碼則被下載到了./components/fatfs路徑中。

步驟4 添加示例

在fatfs組件的package.yaml中添加example示例代碼： 示例代碼參考example/fatfs_example.c。

source_file:
  - "src/*.c"
  - "example/fatfs_example.c" # add fatfs_example.c

步驟5 編譯固件

在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《aos-studio使用說明之編譯固件》。

步驟6 燒錄固件

helloworld_demo案例的固件生成后，可參考《aos-studio使用說明之燒錄固件》來燒錄固件。

步驟7 打開串口

固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《aos-studio使用說明之查看日志》。

當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。

步驟8 測試示例

fatfs_example

關鍵日志

fatfs component example start!
aos_open fd1=xxx
aos_write num=xxx
aos_open fd2=xxx
aos_lseek position=xxx
aos_read: xxxx
fatfs component example end !