.. _vfs-sdc-lib:

sdcard虚拟文件系统
======================

简介
-------------------------

sd卡读取，通过虚拟文件系统方式访问。只支持单个文件的访问


特点
-------------------------
 - 支持sd卡文件访问
 - 支持文件名访问文件，也支持文件序号访问文件。
 - 当文件序号访问不是文件，自动上一序号或下一序号访问到文件为止。

API说明
-------------------------

.. c:function:: int vfs_sdc_mount()

    注册sdc文件系统

    :param : None
    :returns 0: 注册成功
    :returns -1: 注册失败



.. c:function:: int vfs_sdc_set_open_type(int type,int dir);

    sdc文件打开方式

    :param type:  文件打开方式。
        0：vfs_open(char* filename)的参数表示文件名。
        1：vfs_open(char* filename)的参数表示文件在fat中的序号。
    :param dir: 当type为1，dir有效。当id不是文件，id增长方式。
        0：id对应fat不是文件，id自增。
        1：id对应fat不是文件，id自减
    :returns 0: 成功
    :returns other: 失败
    :note: 需要在vfs_sdc_open之前调用，每此调用后vfs_sdc_open（），此打开方式会失效，恢复默认

使用方法
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

    1. 调用vfs_sdc_mount()函数，注册sdc文件系统
    2. vfs_sdc_set_open_type()设置文件打开方式
    3. vfs_open(char* filename)读取文件