跳转至

使用RT-Thread文件系统

视频 PPT 下载

SD 卡挂载操作代码

挂载文件系统的源代码位于 qemu-vexpress-a9\applications\mnt.c 中。在实际代码中会将块设备 sd0 中的文件系统挂载到根目录 / 上。

#include <rtthread.h>

#ifdef RT_USING_DFS
#include <dfs_fs.h>

int mnt_init(void)
{
    rt_thread_delay(RT_TICK_PER_SECOND);

    if (dfs_mount("sd0", "/", "elm", 0, 0) == 0)
    {
        rt_kprintf("file system initialization done!\n");
    }

    return 0;
}
INIT_ENV_EXPORT(mnt_init);
#endif

常用命令展示

在挂载文件系统成功之后,就可以在 msh 中使用一些常用命令体验文件系统了。

ls: 查看当前目录信息

msh />ls                          # 使用 ls 命令查看文件系统目录信息              
Directory /:                      # 可以看到已经存在根目录 /

mkdir: 创建文件夹

msh />mkdir rt-thread             # 创建 rt-thread 文件夹
msh />ls                          # 查看目录信息如下
Directory /:
rt-thread           <DIR>

echo: 将输入的字符串输出到指定输出位置

msh />echo "hello rt-thread!!!"                    # 将字符串输出到标准输出
hello rt-thread!!!
msh />echo "hello rt-thread!!!" hello.txt          # 将字符串输出到 hello.txt 文件
msh />ls
Directory /:
rt-thread           <DIR>                    
hello.txt           18                       
msh />

cat: 查看文件内容

msh />cat hello.txt                     # 查看 hello.txt 文件的内容并输出
hello rt-thread!!!

rm: 删除文件夹或文件

msh />ls                                # 查看当前目录信息
Directory /:
rt-thread           <DIR>                    
hello.txt           18                       
msh />rm rt-thread                      # 删除 rt-thread 文件夹
msh />ls
Directory /:
hello.txt           18                       
msh />rm hello.txt                      # 删除 hello.txt 文件
msh />ls
Directory /:
msh />

运行文件系统示例程序

了解了文件系统的一些常用命令之后,下面带领大家通过运行文件系统的一些示例程序,来熟悉文件系统的基本操作。示例程序通过使用一些 DFS 的 API 接口来实现,并将示例导出到 msh 命令,通过运行示例程序并对照示例程序源码,有利于我们尽快上手操作文件系统。

获取示例代码

文件系统的示例代码包含在 RT-Thread samples 软件包中,可以通过 env 配置将示例代码加入到项目中,路径如下所示。

 RT-Thread online packages  --->
     miscellaneous packages  --->
         samples: RT-Thread kernel and components samples  --->
             [*] a filesystem_samples package for rt-thread  --->

将示例代码全部选中,然后退出保存更新软件包即可将示例代码加入到工程里。

获取示例程序

运行示例代码

在运行示例代码之前需要先输入 scons 编译一遍工程。

然后输入 .\qemu.bat 运行工程

RT-Thread 启动完成之后,按 TAB 键查看 msh 命令,文件系统 samples 命令已经导出到 msh :

查看所有例程

然后就可以输入命令运行相应的示例代码了。

例如:执行命令 mkdir_sample 的运行结果是

msh />mkdir_sample
mkdir ok!
msh />ls
Directory /:
dir_test            <DIR>

然后我们就可以对照这几个示例代码的源码来详细的了解文件系统 API 的用法了。

QEMU SD卡的读写

QEMU 运行起来之后会在 bsp\qemu-vexpress-a9 目录下创建一个 sd.bin 文件。这是一个虚拟的 SD 卡,RT-Thread 默认的文件系统就是搭建在这个里面的。

sd.bin 位置

读取 QEMU SD 卡的内容

因 sd.bin 本质上就是一个 FAT 文件系统的镜像文件,所以我们利用支持提取 FAT 格式的解压软件 7-Zip 就可以将 sd.bin 里的文件读取出来。

读取 QEMU SD 卡的内容

制作 QEMU SD 卡

在 env 工具的 tools/fatdisk 目录下有一个打包 FAT 格式文件的工具 fatdisk.exe,我们可以利用这个工具将我们要存储到QEMU SD卡里的文件打包成 sd.bin 文件。然后用新生成的 sd.bin 替换掉 bsp\qemu-vexpress-a9 目录下原来的 sd.bin 文件即可。

打开路径 env/tools/fatdisk 并在该目录下新建文件夹 sd

新建文件夹 sd

打开上一步我们创建好的文件夹,放入我们需要存储到QEMU SD卡里的文件或文件夹

在 sd 文件夹里放入文件

修改 env/tools/fatdisk 目录下 fatdisk.xml 文件为下面的内容(视频中内容有误)

<?xml version="1.0" encoding="UTF-8"?>
<fatdisk>
   <disk_size>65536</disk_size>
   <sector_size>512</sector_size>
   <root_dir>sd</root_dir>
   <output>sd.bin</output>
   <strip>0</strip>
</fatdisk>

env/tools/fatdisk 目录下右键打开 env 工具,输入命令 fatdisk 运行,就会在当前目录下生成 sd.bin 文件了。

运行 fatdisk

然后用新生成的 sd.bin 替换掉 bsp\qemu-vexpress-a9 目录下原来的 sd.bin 文件

运行 qemu 输入 ls 可以看到我们存储到QEMU SD卡里的文件和文件夹了。

查看文件及文件夹

使用 RomFS

RomFS 是在嵌入式设备上常用的一种文件系统,具备体积小,可靠性高,读取速度快等优点,常用来作为系统初始文件系统。但也具有其局限性,RomFS 是一种只读文件系统。

不同的数据存储方式对文件系统占用空间,读写效率,查找速度等主要性能影响极大。RomFS 使用顺序存储方式,所有数据都是顺序存放的。因此 RomFS 中的数据一旦确定就无法修改,这是 RomFS 是一种只读文件系统的原因。也由于这种顺序存放策略,RomFS 中每个文件的数据都能连续存放,读取过程中只需要一次寻址操作,就可以读入整块数据,因此 RomFS 中读取数据效率很高。

配置使能 RomFS

开启 RT-Thread 对 RomFS 的支持,并调整最大支持的文件系统类型数目。

打开 menuconfig 菜单,保证 “RT-Thread Components” → “Device virtual file system” → “Enable ReadOnly file system on flash” 为开启状态:

开启 romfs

打开子菜单 "RT-Thread Components" → "Device virtual file system" 调整最大支持文件系统系统类型数:

调整文件系统参数

生成 romfs.c 文件

由于 RomFS 是只读文件系统,所以需要放入到 RomFS 的文件都需要在系统运行前加入。我们可以将要存入 RomFS 中的文件数据放在 romfs.c 文件中,RT-Thread提供了制作 romfs.c 的 Python 脚本文件,根据用户需要加入到 RomFS 的文件和目录生成对应的数据结构。

打开路径 rt-thread\components\dfs\filesystems\romfs 并在该目录下新建文件夹 romfs

新建文件夹 romfs

打开上一步我们创建好的文件夹,放入我们需要在 RomFS 中放置的文件或文件夹。

在文件夹romfs中放入文件

回到上一级目录 rt-thread\components\dfs\filesystems\romfs,在该目录下打开 env 工具,并运行命令

python mkromfs.py romfs romfs.c 

可以看到目录下成功生成 romfs.c 文件:

romfs.c 所在路径

挂载 RomFS

在系统任务调度开始之后,通过 dfs_mount() 函数挂载 RomFS ,在添加挂载函数的文件中需添加头文件 #include "dfs_romfs.h"

我们将 qemu-vexpress-a9\applications\mnt.c 文件中的内容替换成下面的代码,即可将 RomFS 挂载到根目录。

#include <rtthread.h>

#ifdef RT_USING_DFS
#include <dfs_fs.h>
#include "dfs_romfs.h"

int mnt_init(void)
{
    if (dfs_mount(RT_NULL, "/", "rom", 0, &(romfs_root)) == 0)
    {
        rt_kprintf("ROM file system initializated!\n");
    }
    else
    {
        rt_kprintf("ROM file system initializate failed!\n");
    }

    return 0;
}
INIT_ENV_EXPORT(mnt_init);
#endif

预期结果

编译并运行工程之后,可以看到 RomFS 文件系统挂载成功,使用 ls 命令可以看到 RomFS 文件系统里面的文件夹和文件:

预期结果

使用 RamFS

RamFS 顾名思义是内存文件系统,它不能格式化,可以同时创建多个,在创建时可以指定其最大能使用的内存大小。其优点是读写速度很快,但存在掉电丢失的风险。如果一个进程的性能瓶颈是硬盘的读写,那么可以考虑在 RamFS 或 tmpfs 上进行大文件的读写操作。

RamFS 使用链式存储方式,并且数据存储在内存空间,因此 RamFS 具备了可读写文件系统的特征,同时也拥有较快的读写速度。

配置使能 RamFS

打开 menuconfig 菜单,保证 “RT-Thread Components” → “Device virtual file system” → “Enable RAM file system” 为开启状态:

开启 ramfs

挂载 RamFS

由于 RamFS 是在系统运行过程中动态创建的,所以在挂载之前我们应该先创建 RamFS ,RT-Thread 提供了创建 RamFS 的 API 接口:

struct dfs_ramfs* dfs_ramfs_create(rt_uint8_t *pool, rt_size_t size)
参数 描述
pool 文件系统内存池地址
size 文件系统大小
返回 ——
> 0 文件系统根目录对应的数据结构
< = 0 失败

在系统任务调度开始之后,通过 dfs_mount() 函数挂载 RamFS

我们将 qemu-vexpress-a9\applications\mnt.c 文件中的内容替换成下面的代码,即可将 RamFS 挂载到根目录。

#include <rtthread.h>

#ifdef RT_USING_DFS
#include <dfs_fs.h>

int mnt_init(void)
{
    if (dfs_mount(RT_NULL, "/", "ram", 0, dfs_ramfs_create(rt_malloc(1024),1024)) == 0)
    {
        rt_kprintf("RAM file system initializated!\n");
    }
    else
    {
        rt_kprintf("RAM file system initializate failed!\n");
    }

    return 0;
}
INIT_ENV_EXPORT(mnt_init);
#endif

预期结果

编译并运行工程之后, 可以看到 RamFS 文件系统挂载成功了。然后我们使用 echo 命令创建一个文件,可以看到创建成功了。

运行结果

引用参考

评论