文件系统 AT 命令集

[English]

介绍

重要

默认的 AT 固件不支持此页面下的 AT 命令。如果您需要 ESP32 支持文件系统命令,请自行 编译 ESP-AT 工程,在第五步配置工程里选择:

  • 启用 Component config -> AT -> AT FS command support

AT+FS:文件系统操作

设置命令

命令:

AT+FS=<type>,<operation>,<filename>,<offset>,<length>

响应:

OK

参数

  • <type>:目前仅支持 FATFS

    • 0:FATFS

  • <operation>:

    • 0:删除文件

    • 1:写文件

    • 2:读文件

    • 3:查询文件大小

    • 4:查询路径下文件,目前仅支持根目录

  • <offset>:偏移地址,仅针对读写操作设置

  • <length>:长度,仅针对读写操作设置

说明

  • 本命令会自动挂载文件系统。AT+FS 文件系统操作完成后,强烈建议使用 AT+FSMOUNT=0 命令卸载文件系统,来释放大量 RAM 空间。

  • 使用本命令需烧录 at_customize.bin,详细信息可参考 ESP-IDF 分区表如何自定义分区

  • 若读取数据的长度大于实际文件大小,仅返回实际长度的数据。

  • <operator>write 时,系统收到此命令后先换行返回 >,此时您可以输入要写的数据,数据长度应与 <length> 一致。

示例

// 删除某个文件
AT+FS=0,0,"filename"

// 在某个文件偏移地址 100 处写入 10 字节
AT+FS=0,1,"filename",100,10

// 从某个文件偏移地址 0 处读取 100 字节
AT+FS=0,2,"filename",0,100

// 列出根目录下所有文件
AT+FS=0,4,"."

AT+FSMOUNT:挂载/卸载 FS 文件系统

设置命令

命令:

AT+FSMOUNT=<mount>

响应:

OK

参数

  • <mount>

    • 0:卸载 FS 文件系统

    • 1:挂载 FS 文件系统

说明

  • AT+FS 文件系统操作完成后,强烈建议使用本命令 AT+FSMOUNT=0 命令卸载文件系统,来释放大量 RAM 空间。

示例

// 手动卸载文件系统
AT+FSMOUNT=0

// 手动挂载文件系统
AT+FSMOUNT=1