FAT 文件系统
==================

概述
-------------------
WQSDK 使用 FatFs 开源库来实现对 FAT/exFAT 文件系统的支持，新增 adaptor 适配层动态注册磁盘 io，允许应用在运行时将 FatFs 映射到物理磁盘。

功能特性
-------------------

- 支持两种物理磁盘格式：片上 flash（仅 WQ7036AX 支持），片外 sd/mmc 卡（当前仅支持 spi 外接 sd/mmc 卡）。
- 支持文件系统常用 API，详见 FatFs 官方文档（http://elm-chan.org/fsw/ff/00index_e.html）。

资源依赖
-------------------
- flash
- spi，dma，sd_card 组件

配置选项
-------------------

- CONFIG_FATFS_LIB_ENABLE 使能 Fatfs 文件系统
- CONFIG_FLASH_DISK       使能片上 flash 文件系统支持
- CONFIG_MMC_DISK         使能片外 sd/mmc 卡文件系统支持
- CONFIG_FATFS_CODE_PAGE  配置文件系统支持的编码格式，默认为 U.S
- CONFIG_FATFS_VOLUMES    配置文件系统支持的卷数量，有效值（1-10）
- CONFIG_FATFS_MIN_SS     配置文件系统的最小 sector size，有效值（512，1024，2048，4096）
- CONFIG_FATFS_MAX_SS     配置文件系统的最大 sector size，有效值（512，1024，2048，4096）
- CONFIG_FATFS_EXFAT      配置文件系统是否支持 exFAT 格式
- CONFIG_FATFS_LOCK       配置文件系统可以同时操作的文件或文件夹数量
- CONFIG_FATFS_TIMEOUT    配置文件系统互斥信号量的超时时间
- CONFIG_FATFS_USE_LFN    使能文件系统长文件名支持
- CONFIG_FATFS_MAX_LFN    配置文件系统长文件名的最大长度

用法流程--以 spi 外接 sd/mmc 卡为例
------------------------------------

- 初始化 spi、dma :cpp:func:`wq_spi_init`，:cpp:func:`wq_spi_open`，:cpp:func:`wq_dma_init`
- 注册 sd/mmc 卡磁盘 io :cpp:func:`diskio_install_mmc_driver`
- 操作文件系统 API :cpp:func:`f_mount`，:cpp:func:`f_open`，:cpp:func:`f_read`，:cpp:func:`f_write` 等
- 注销 sd/mmc 卡磁盘 io :cpp:func:`diskio_uninstall_mmc_driver`
- 注销 spi、dma :cpp:func:`wq_spi_close`，:cpp:func:`wq_spi_deinit`，:cpp:func:`wq_dma_deinit`

参考示例
-----------
::

    examples/fatfs/flash, examples/fatfs/sd

API 介绍
------------
.. doxygenfile:: diskio_flash.h
.. doxygenfile:: diskio_mmc.h