LuatOS-Air AT应用指南--文件系统操作指令流程

1 概述：
模块具有64Mb的flash空间，除了模块自身程序占用以外还剩余了一部分空间可供用户使用，AT和LuatOS-Air均支持进行操作。

2 相关AT指令介绍和示例
文件系统读写命令
创建一个文件：AT+FSCREATE
语法规则：

命令类型 语法 返回
设置命令 AT+FSCREATE= OK或ERROR
查询命令 AT+FSCREATE=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
文件名 字符串型，不用加双引号，不超过 64 个字节
读文件：AT+FSREAD
语法规则：

命令类型 语法 返回
设置命令 AT+FSREAD=, , , OK或ERROR
查询命令 AT+FSREAD=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
文件名 字符串型，不用加双引号，不超过 64 个字节
读文件的模式 0 从文件开头读文件
1 从文件的位置开始读文件
要读取的文件的长度 不能大于 10240 个字节。如果文件的实际长度小于该值，则读取的是文件的实际长度。
读文件的起始位置 该取值应小于文件的大小。当=0 时，该值无效
读取的文件数据
写文件：AT+FSWRITE
语法规则：

命令类型 语法 返回

（出现>后写入数据）
设置命令 AT+FSWRITE=, , , OK或ERROR
或
TimeOut
查询命令 AT+FSWRITE=? OK或ERROR
注意事项 当输入数据的长度达到时，自动写入。或输入数据的时间超过时，返回TimeOut
参数定义：

参数 定义 取值 对取值的说明
文件名 字符串型，不用加双引号，不超过 64 个字节
写文件的模式 0 从文件的开头开始写文件
1 从文件的末尾开始写文件
要写的数据的长度 不能大于 10240 个字节
输入持续的时间 单位：秒
获取盘符：AT+FSDRIVE
语法规则：

命令类型 语法 返回
执行命令 AT+FSDRIVE= +FSDRIVE: OK
查询命令 AT+FSDRIVE=? OK
参数定义：

参数 定义 取值 对取值的说明
盘符类型 0 本地盘符
1 SD 卡盘符
盘符 字符串型。加不加双引号皆可. 如果是本地存储，则盘符为 C；如果是SD 卡，则盘符为 D
显示文件目录列表：AT+FSLS
语法规则：

命令类型 语法 返回
设置命令 AT+FSLS= list of subdirectories/files OK
查询命令 AT+FSLS=? OK
注意事项 1) 如果返回的结果最后一个字符是\，则表示为目录名，否则为文件名2) 查询模块本地FLASH根目录使用：AT+FSLS="/"或AT+FSLS="C:/"3) 查询外接TF卡根目录使用：AT+FSLS=“D:/”
参数定义：

参数 定义 取值 对取值的说明
文件路径 字符串型，不用加双引号，不超过 64 个字节。
获取可用空间大小：AT+FSMEM
执行命令用来获取文件系统剩余空间大小。语法规则：

命令类型 语法 返回
执行命令 AT+FSMEM +FSMEM: OK
查询命令 AT+FSMEM=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
文件系统可用空间大小 单位：字节
创建目录：AT+FSMKDIR
语法规则：

命令类型 语法 返回
设置命令 AT+FSMKDIR=<dir_name> OK或ERROR
查询命令 AT+FSMKDIR=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
<dir_name> 目录名 字符串型，不用加双引号，不超过 64 个字节
删除目录：AT+FSRMDIR
语法规则：

命令类型 语法 返回
设置命令 AT+FSRMDIR=<dir_name> OK或ERROR
查询命令 AT+FSRMDIR=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
<dir_name> 文件名 字符串型，不用加双引号，不超过 64 个字节
删除文件：AT+FSDEL
语法规则：

命令类型 语法 返回
设置命令 AT+FSDEL= OK或ERROR
查询命令 AT+FSDEL=? OK或ERROR
参数定义：

参数 定义 取值 对取值的说明
文件名 字符串型，不用加双引号，不超过 64 个字节
获取文件大小：AT+FSFLSIZE
语法规则：

命令类型 语法 返回
设置命令 AT+FSFLSIZE= +FSFLSIZE: OK
查询命令 AT+FSFLSIZE=? OK
参数定义：

参数 定义 取值 对取值的说明
文件名 字符串型，不用加双引号，不超过 64 个字节
文件大小 单位：字节
使用方法举例
由于这部分的命令具有高度相关性，所以将各个命令的应用例程集中在一起描述。

命令（→）/返回（←） 实例 解释和说明
→ AT+FSMKDIR=“/testdir” 创建一级目录
← OK
→ AT+FSMKDIR=“/testdir/testdir” 创建二级目录
← OK
→ AT+FSCREATE=“/testdir/test.txt” 一级目录下创建文件
← OK
→ AT+FSLS=“/testdir” 显示一级目录列表
← testdir\ test.txt OK
→ AT+FSWRITE=“/testdir/test.txt”, 0, 10, 10 写文件
→ >1234567890 当出现”>”后，输入写入的数据：1234567890。
← OK
→ AT+FSREAD=“/testdir/test.txt”, 0, 10, 10 读取文件数据
← 1234567890OK
→ AT+FSMEM 获取文件系统可用空间大小
← +FSMEM: 1304000 bytes OK
→ AT+FSFLSIZE=“/testdir/test.txt” 获取文件大小
← +FSFLSIZE: 10 OK
→ AT+FSDEL=“/testdir/test.txt” 删除文件
← OK
→ AT+FSRMDIR=“/testdir/testdir” 删除目录
← OK