鸿蒙轻内核M核源码分析系列二一 05 文件系统FatFS

于 2024-06-17 15:34:08 发布
阅读量694 收藏 15
点赞数 30
分类专栏： OpenHarmony HarmonyOS 鸿蒙开发 文章标签： harmonyos 鸿蒙嵌入式 鸿蒙开发 嵌入式硬件 FatFS LiteOS-M
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/maniuT/article/details/139745734
版权
HarmonyOS 同时被 3 个专栏收录
871 篇文章 14 订阅
订阅专栏
OpenHarmony
695 篇文章 17 订阅
订阅专栏
鸿蒙开发
504 篇文章 1 订阅
订阅专栏

3、LiteOS-M FATFS的文件系统操作接口

快速记录下各个操作接口，对每个接口的用途用法不再描述。可以参考之前的系列文章，《鸿蒙轻内核M核源码分析系列十九 Musl LibC》中介绍了相关的接口，那些接口会调用VFS文件系统中操作接口，然后进一步调用FatFS文件操作接口。

3.1 挂载和卸载操作

先看下挂载操作，FatFS支持重新挂载操作。如果挂载选项包含MS_REMOUNT时，会调用函数Remount()重新挂载。函数Remount()中，⑴处调用FsPartitionMatch()获取卷索引，⑵处如果卷未被挂载，不允许重新挂载，返回错误码。⑶处设置对应的卷是否可读可写标记。由此看来，重新挂载，主要是更新卷的可读可写能力。

看下挂载函数fatfs_mount()，⑷处开始判断参数有效性，不能为空，文件系统类型必须为“fat”，⑸处调用FsPartitionMatch()获取卷索引，⑹处如果卷已经被挂载，则返回错误码。⑺处调用f_mount()实现挂载，第3个参数1表示立即挂载。⑻设置对应的卷是否可读可写标记。

static int Remount(const char *path, unsigned long mountflags)
{
    INT32 index;

⑴  index = FsPartitionMatch(path, PART_NAME);
    if (index == FS_FAILURE) {
        PRINTK("Wrong volume path!\r\n");
        errno = ENOENT;
        return FS_FAILURE;
    }

    /* remount is not allowed when the device is not mounted. */
⑵  if (g_fatfs[index].fs_type == 0) {
        errno = EINVAL;
        return FS_FAILURE;
    }
⑶  g_volWriteEnable[index] = (mountflags & MS_RDONLY) ? FALSE : TRUE;

    return FS_SUCCESS;
}
......
int fatfs_mount(const char *source, const char *target,
                const char *filesystemtype, unsigned long mountflags,
                const void *data)
{
    INT32 index;
    FRESULT res;
    INT32 ret;

⑷  if ((target == NULL) || (filesystemtype == NULL)) {
        errno = EFAULT;
        return FS_FAILURE;
    }

    ret = FsLock();
    if (ret != 0) {
        errno = ret;
        return FS_FAILURE;
    }

    if (mountflags & MS_REMOUNT) {
        ret = Remount(target, mountflags);
        goto OUT;
    }

    if (strcmp(filesystemtype, "fat") != 0) {
        errno = ENODEV;
        ret = FS_FAILURE;
        goto OUT;
    }

⑸  index = FsPartitionMatch(target, VOLUME_NAME);
    if (index == FS_FAILURE) {
        errno = ENODEV;
        ret = FS_FAILURE;
        goto OUT;
    }

    /* If the volume has been mounted */
⑹  if (g_fatfs[index].fs_type != 0) {
        errno = EBUSY;
        ret = FS_FAILURE;
        goto OUT;
    }

⑺  res = f_mount(&g_fatfs[index], target, 1);
    if (res != FR_OK) {
        errno = FatfsErrno(res);
        ret = FS_FAILURE;
        goto OUT;
    }

⑻  g_volWriteEnable[index] = (mountflags & MS_RDONLY) ? FALSE : TRUE;
    ret = FS_SUCCESS;

OUT:
    FsUnlock();
    return ret;
}

接下来，看下卸载操作。函数fatfs_umount()中，先进行参数有效性，是否挂载等基础检查，⑴处调用函数f_checkopenlock()来判断要卸载的卷中是否有打开的文件或目录，⑵处调用f_mount()，第一个参数为NULL，表示卸载target指定的文件系统；，第3个参数0表示不需要挂载。如果卸载错误，转换相应的错误码。⑶处如果磁盘访问窗口（Disk access window for Directory）不为空，执行相应的释放操作。⑷处把文件卷数组对应的元素置零。

函数CloseAll()根据文件卷编号，遍历每一个打开的文件和目录进行关闭。函数fatfs_umount2()中，⑸处表示支持的卸载选项有：MNT_FORCE | MNT_DETACH | MNT_EXPIRE | UMOUNT_NOFOLLOW。⑹处处理强制卸载的情形，会首先关闭打开的文件和目录，然后再去执行⑺实现卸载操作。

int fatfs_umount(const char *target)
{
    FRESULT res;
    INT32 ret;
    INT32 index;

    if (target == NULL) {
        errno = EFAULT;
        return FS_FAILURE;
    }

    ret = FsLock();
    if (ret != 0) {
        errno = ret;
        return FS_FAILURE;
    }

    index = FsPartitionMatch(target, VOLUME_NAME);
    if (index == FS_FAILURE) {
        errno = ENOENT;
        ret = FS_FAILURE;
        goto OUT;
    }

    /* The volume is not mounted */
    if (g_fatfs[index].fs_type == 0) {
        errno = EINVAL;
        ret = FS_FAILURE;
        goto OUT;
    }

    /* umount is not allowed when a file or diretory is opened. */
⑴  if (f_checkopenlock(index) != FR_OK) {
        errno = EBUSY;
        ret = FS_FAILURE;
        goto OUT;
    }

⑵  res = f_mount((FATFS *)NULL, target, 0);
    if (res != FR_OK) {
        errno = FatfsErrno(res);
        ret = FS_FAILURE;
        goto OUT;
    }

⑶  if (g_fatfs[index].win != NULL) {
        ff_memfree(g_fatfs[index].win);
    }

⑷  (void)memset_s(&g_fatfs[index], sizeof(FATFS), 0x0, sizeof(FATFS));

    ret = FS_SUCCESS;

OUT:
    FsUnlock();
    return ret;
}

static int CloseAll(int index)
{
    INT32 i;
    FRESULT res;

    for (i = 0; i < FAT_MAX_OPEN_FILES; i++) {
        if (g_fileNum <= 0) {
            break;
        }
        if ((g_handle[i].useFlag == 1) && (g_handle[i].fil.obj.fs == &g_fatfs[index])) {
            res = f_close(&g_handle[i].fil);
            if (res != FR_OK) {
                errno = FatfsErrno(res);
                return FS_FAILURE;
            }
            (void)memset_s(&g_handle[i], sizeof(FatHandleStruct), 0x0, sizeof(FatHandleStruct));
            g_fileNum--;
        }
    }

    for (i = 0; i < FAT_MAX_OPEN_DIRS; i++) {
        if (g_dirNum <= 0) {
            break;
        }
        if (g_dir[i].obj.fs == &g_fatfs[index]) {
            res = f_closedir(&g_dir[i]);
            if (res != FR_OK) {
                errno = FatfsErrno(res);
                return FS_FAILURE;
            }
            (void)memset_s(&g_dir[i], sizeof(DIR), 0x0, sizeof(DIR));
            g_dirNum--;
        }
    }

    return FS_SUCCESS;
}

int fatfs_umount2(const char *target, int flag)
{
    INT32 index;
    INT32 ret;
    UINT32 flags;
    FRESULT res;

    if (target == NULL) {
        errno = EFAULT;
        return FS_FAILURE;
    }

⑸  flags = MNT_FORCE | MNT_DETACH | MNT_EXPIRE | UMOUNT_NOFOLLOW;
    if ((UINT32)flag & ~flags) {
        errno = EINVAL;
        return FS_FAILURE;
    }

    ret = FsLock();
    if (ret != 0) {
        errno = ret;
        return FS_FAILURE;
    }

    index = FsPartitionMatch(target, VOLUME_NAME);
    if (index == FS_FAILURE) {
        errno = ENOENT;
        ret =  FS_FAILURE;
        goto OUT;
    }

    /* The volume is not mounted */
    if (g_fatfs[index].fs_type == 0) {
        errno = EINVAL;
        ret = FS_FAILURE;
        goto OUT;
    }

⑹  if ((UINT32)flag & MNT_FORCE) {
        ret = CloseAll(index);
        if (ret != FS_SUCCESS) {
            goto OUT;
        }
    }

⑺  res = f_mount((FATFS *)NULL, target, 0);
    if (res != FR_OK) {
        errno = FatfsErrno(res);
        ret = FS_FAILURE;
        goto OUT;
    }

    if (g_fatfs[index].win != NULL) {
        ff_memfree(g_fatfs[index].win);
    }

    (void)memset_s(&g_fatfs[index], sizeof(FATFS), 0x0, sizeof(FATFS));
    ret = FS_SUCCESS;

OUT:
    FsUnlock();
    return ret;
}

3.2 文件目录操作接口

文件目录操作接口包含fatfs_mkdir、fatfs_unlink、fatfs_rmdir、fatfs_readdir、fatfs_closedir、fatfs_open、fatfs_close等等，会进一步调用FatFS的文件目录操作接口进行封装，代码比较简单，自行阅读即可，部分代码片段如下。

......
int fatfs_close(int fd)
{
    FRESULT res;
    INT32 ret;

    ret = FsLock();
    if (ret != 0) {
        errno = ret;
        return FS_FAILURE;
    }

    if (!IsValidFd(fd)) {
        FsUnlock();
        errno = EBADF;
        return FS_FAILURE;
    }

    if (g_handle[fd].fil.obj.fs == NULL) {
        FsUnlock();
        errno = ENOENT;
        return FS_FAILURE;
    }

    res = f_close(&g_handle[fd].fil);
    if (res != FR_OK) {
        PRINTK("FAT close err 0x%x!\r\n", res);
        FsUnlock();
        errno = FatfsErrno(res);
        return FS_FAILURE;
    }

#if !FF_FS_TINY
    if (g_handle[fd].fil.buf != NULL) {
        (void)ff_memfree(g_handle[fd].fil.buf);
    }
#endif

    (void)memset_s(&g_handle[fd], sizeof(FatHandleStruct), 0x0, sizeof(FatHandleStruct));

    if (g_fileNum > 0) {
        g_fileNum--;
    }

    FsUnlock();

    return FS_SUCCESS;
}
......

小结

本文介绍了FatFS的结构体和全局变量，全局变量的操作接口，分析了下FatFS文件操作接口。

如果大家想更加深入的学习 OpenHarmony 开发的内容，不妨可以参考以下相关学习文档进行学习，助你快速提升自己：

OpenHarmony 开发环境搭建：https://qr18.cn/CgxrRy

《OpenHarmony源码解析》：https://qr18.cn/CgxrRy

  • 搭建开发环境
  • Windows 开发环境的搭建
  • Ubuntu 开发环境搭建
  • Linux 与 Windows 之间的文件共享
  • ……

系统架构分析：https://qr18.cn/CgxrRy

  • 构建子系统
  • 启动流程
  • 子系统
  • 分布式任务调度子系统
  • 分布式通信子系统
  • 驱动子系统
  • ……

OpenHarmony 设备开发学习手册：https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题（内含参考答案）：https://qr18.cn/CgxrRy

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：https://qr21.cn/FV7h05

OpenHarmony_小贾
关注
专栏目录
openharmony标准系统移植之init启动流程分析
qq_41795122的博客
05-09 4385
接上篇移植openharmony标准系统后，系统进入终端后，发现执行指令特别卡顿，太影响调试了。目前还不知道是什么问题导致的，不知道是不是cpu性能不够，但是感觉不太像是这个问题，卡顿如下图。基本一个操作需要卡半天。 为了解决下这个问题，也为了更熟悉openharmony代码启动流程。现在追踪下启动过程。记录如下。 首先可以知道的是openharmony系统启动后，执行的是init进程。可以查看源码目录下base/startup/init_lite/services/BUILD.gn文件，首先是不管小型还
linux下mount()/umount()函数解析
但行前路 无问西东
06-17 2375
本文转载自：https://blog.csdn.net/bingyu880101/article/details/50481507 功能描述：mount挂上文件系统，umount执行相反的操作。 头文件： #include <sys/mount.h> #include <errno.h> //errno的判断 用法： int mount(const char *source, const char *target, const char *filesystemtype, unsign
FatFs通用FAT文件系统模块中文手册（添加了跳转目录）
03-04
fatfs的中文手册，加入了详细的跳转目录，就是http://elm-chan.org/fsw/ff/00index_e.html下载的包里面的那个手册的汉化版，很棒的手册，值得加上跳转目录，方便查看。
FatFs文件和目录管理接口中文版
阿荣嵌入式
09-28 2096
文件和目录管理 f_stat - 检查文件或子目录是否存在 函数原型 FRESULT f_stat ( const TCHAR* path, /* [IN] Object name */ FILINFO* fno /* [OUT] FILINFO structure */ ); 形参 path 指向以null结尾的字符串的指针，该字符串指定要获取其信息的对象。对象不能是根目录。 fno 指向FILINFO结构体来存储对象的信息。如果不需要此信息，请设置空指针。 返回值 FR_OK,
Linux系统调用-- mount/umount函数详解
zhaominyong的专栏
12-10 1118
【 mount/umount系统调用】 功能描述： mount挂上文件系统，umount执行相反的操作。 用法： #include <sys/mount.h> int mount(const char *source, const char *target, const char *filesystemtype, unsigned long mountflags, const void *data); int umount(const char *target...
FATFS文件系统源码
01-07
FATFS文件系统是一种轻量级的、高度可移植的文件系统，主要用于嵌入式系统，如STM32、C51等单片机上实现对SD卡和FLASH介质的读写操作。本文将深入解析FATFS的R0.14版本，探讨其设计原理、主要功能以及如何进行源码...
FATFS 文件系统源码
05-10
FATFS文件系统是广泛应用于嵌入式系统中的一个轻量级文件系统，它由Richard Barry开发，主要用于处理FAT12、FAT16和FAT32这些常见的FAT文件系统格式。FATFS源码的使用，使得开发者能够在资源有限的微控制器（MCU）或...
FATFS文件系统复制文件和文件夹
10-22
FATFS文件系统是一种轻量级的文件系统，广泛应用于嵌入式系统和便携式存储设备中。在STM32F103RCT6芯片上，使用SDIO口接口TF卡1，SPI2口接口TF卡2，实现了FATFS文件系统的移植和文件复制功能。但是在复制文件夹时，...
ALIENTEK MINISTM32 实验29 FATFS文件系统实验_FATFS文件系统实验_fatfs_
10-02
在ALIENTEK MINISTM32的实验29中，我们深入探讨了FATFS文件系统，这是一个在嵌入式系统中广泛使用的轻量级文件系统模块。FATFS是ChaN软件公司开发的，它允许微控制器通过标准C语言接口来操作存储设备上的文件系统。...
基于stm32f407 spi flash 移植 fatfs0.15文件系统
01-20
FatFS是一个轻量级的文件系统模块，适用于资源有限的嵌入式系统，而SPI Flash是一种常见的非易失性存储器，通过SPI接口与微控制器通信。 首先，要进行移植工作，你需要了解FatFS的基本结构和工作原理。FatFS支持FAT...
linux mount/umount系统调用
我学习，我快乐~~~
07-06 2071
【 mount/umount系统调用】       功能描述： mount挂上文件系统，umount执行相反的操作。   用法：  #include int mount(const char *source, const char *target,   const char *filesystemtype, unsigned long mountflags, const void *data)
【Linux系统编程】| 【10】设备、磁盘、分区
weixin_45926547的博客
06-09 292
2、磁盘和分区 磁盘驱动器 磁盘分区 3、文件系统 3.1 ext2文件系统 3.2 文件系统结构 4.1 ext2的i节点和数据块指针 5、虚拟文件系统VFS
linux mount_nodev函数,Linux系统调用-- mount/umount函数详解
weixin_30794639的博客
05-03 504
【mount/umount系统调用】功能描述：mount挂上文件系统，umount执行相反的操作。用法：#include int mount(const char *source, const char *target,const char *filesystemtype,unsigned long mountflags, const void *data);int umount(const ...
【嵌入式开发】572
最新发布
宅男很神经
03-28 552
当应用层调用一个API函数时，FatFs层会根据请求的类型和参数来执行相应的操作，如读取或写入磁盘上的数据、解析文件系统的数据结构等。此外，为了充分利用FatFs的功能并保障数据存储的可靠性和安全性，开发者还需要仔细阅读FatFs的文档并遵循最佳实践来编写和管理代码。使用稳定的存储设备；磁盘I/O抽象：FatFs将底层存储设备的读写操作抽象为磁盘I/O接口，开发者只需要实现这些接口函数，就可以将FatFs与各种不同类型的存储设备（如SD卡、NOR FLASH、NAND FLASH等）进行对接。
Linux虚拟文件系统之文件系统卸载（sys_umount())
wxie的Linux人生
05-19 2770
Linux中卸载文件系统由umount系统调用实现，入口函数为sys_umount()。较于文件系统的安装较为简单，下面是具体的实现。 1. /*sys_umont系统调用*/ 2. SYSCALL_DEFINE2(umount, char __user *, name, int, flags) 3. { 4. struct path path;
FatFS操作的流程
dijianfei2190的博客
08-19 1181
在主程序中，有FatFS操作的流程，我的流程分析就以这个为基础。 一、读文件流程。 1、程序结构 res = f_mount(0, &fs); res = f_open(&file, "data.txt", FA_OPEN_EXISTING | FA_READ); while(1) { if(fgets(data, size...
linux fs源代码分析,linux内核umount源代码分析
weixin_31653971的博客
05-13 485
之前我们讲过mount的内核源代码，今天我们来一起看一下umount系统调用的内核源代码实现吧。首先看sys_umount函数，定义在fs/namespace.c，定义如下asmlinkage long sys_umount(char __user * name, int flags){struct nameidata nd;int retval;/*之前讲过的，格局传入的路径名返回文件的inod...
FATFS文件系统详解：架构与源码分析
FATFS是一个轻量级的文件系统，专为嵌入式系统设计，具有高性能和易移植性。它主要用于处理遵循FAT（File Allocation Table）文件系统的存储设备，如SD卡、USB驱动器等。FATFS不依赖操作系统，而是直接在硬件层面上...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值