Mbed OS 文档翻译 之 参考（API（存储（LittleFileSystem）））

最新推荐文章于 2024-06-15 20:41:37 发布
最新推荐文章于 2024-06-15 20:41:37 发布
阅读量1.6k 收藏
点赞数 2
分类专栏： Mbed OS 文章标签： Mbed Mbed OS Mbed OS 5

LittleFileSystem

              

                                                                              LittleFileSystem 类层次结构

小文件系统（LittleFS）是专为嵌入式系统设计的故障安全文件系统，专门用于使用外部闪存存储的微控制器。

   | | |     .---._____
  .-----.   |          |
--|o    |---| LittleFS |
--|     |---|          |
  '-----'   '----------'
   | | |

微控制器和闪存存储对嵌入式存储提出了三个挑战：功耗，磨损以及有限的 RAM 和 ROM。该文件系统为所有这三个问题提供了解决方案。

  • 有限的 RAM/ROM - 此文件系统使用有限的内存。它避免了递归并将动态内存限制为可以静态提供的可配置缓冲区。

  • 功率损耗弹性 - 我们为可能存在随机电源故障的操作系统设计了此功能。它具有强大的写时复制保证，并使磁盘上的存储保持有效状态。

  • 磨损均衡 - 由于最常见的嵌入式存储形式是易受攻击的闪存，因此文件系统为无法容纳完整闪存转换层的系统提供了一种动态耗损均衡。

有关其他信息，请参阅存储概述页面。

用例

我们为具有外部闪存存储的微控制器构建了这个产品。在这种情况下，它在 RAM，ROM，磨损和运行时方面优于其他 Mbed OS 文件系统。

要存储在可从 PC 访问的 SD 卡上，请使用 FATFileSystem，因为它具有可移植性。

用法

使用块设备和文件路径实例化 LittleFileSystem 类。

它提供的 API 是标准的 Mbed OS 文件系统 API。声明后，Mbed OS 为标准 C 库提供重定向层。

LittleFileSystem 类参考

LittleFileSystem 类参考

公共成员函数
 LittleFileSystem (const char *name=NULL, BlockDevice *bd=NULL, lfs_size_t read_size=MBED_LFS_READ_SIZE, lfs_size_t prog_size=MBED_LFS_PROG_SIZE, lfs_size_t block_size=MBED_LFS_BLOCK_SIZE, lfs_size_t lookahead=MBED_LFS_LOOKAHEAD)
virtual int mount (BlockDevice *bd)
virtual int unmount ()
virtual int reformat (BlockDevice *bd)
virtual int remove (const char *path)
virtual int rename (const char *path, const char *newpath)
virtual int stat (const char *path, struct stat *st)
virtual int mkdir (const char *path, mode_t mode)
virtual int statvfs (const char *path, struct statvfs *buf)
 公共成员函数继承自 mbed::FileSystem
 FileSystem (const char *name=NULL)
 公共成员函数继承自 mbed::FileSystemLike
 FileSystemLike (const char *name=NULL)
FileHandle * open (const char *path, int flags)
DirHandle * opendir (const char *path)
 公共成员函数继承自 mbed::FileSystemHandle
virtual ~FileSystemHandle ()
 公共成员函数继承自 mbed::FileBase
 FileBase (const char *name, PathType t)
const char * getName (void)
PathType getPathType (void)
静态公共成员函数
static int format (BlockDevice *bd, lfs_size_t read_size=MBED_LFS_READ_SIZE, lfs_size_t prog_size=MBED_LFS_PROG_SIZE, lfs_size_t block_size=MBED_LFS_BLOCK_SIZE, lfs_size_t lookahead=MBED_LFS_LOOKAHEAD)
 静态公共成员函数继承自 mbed::FileBase
static FileBase * lookup (const char *name, unsigned int len)
static FileBase * get (int n)
受保护的成员函数
virtual int file_open (mbed::fs_file_t *file, const char *path, int flags)
virtual int file_close (mbed::fs_file_t file)
virtual ssize_t file_read (mbed::fs_file_t file, void *buffer, size_t size)
virtual ssize_t file_write (mbed::fs_file_t file, const void *buffer, size_t size)
virtual int file_sync (mbed::fs_file_t file)
virtual off_t file_seek (mbed::fs_file_t file, off_t offset, int whence)
virtual off_t file_tell (mbed::fs_file_t file)
virtual off_t file_size (mbed::fs_file_t file)
virtual int dir_open (mbed::fs_dir_t *dir, const char *path)
virtual int dir_close (mbed::fs_dir_t dir)
virtual ssize_t dir_read (mbed::fs_dir_t dir, struct dirent *ent)
virtual void dir_seek (mbed::fs_dir_t dir, off_t offset)
virtual off_t dir_tell (mbed::fs_dir_t dir)
virtual void dir_rewind (mbed::fs_dir_t dir)
 受保护的成员函数继承自 mbed::FileSystem
virtual int file_isatty (fs_file_t file)
virtual void file_rewind (fs_file_t file)
virtual size_t dir_size (fs_dir_t dir)
virtual int open (FileHandle **file, const char *path, int flags)
virtual int open (DirHandle **dir, const char *path)

LittleFileSystem 示例

main.cpp                                                                                                                                                  导入到 Mbed IDE

/* mbed Microcontroller Library
 * Copyright (c) 2006-2013 ARM Limited
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#include "mbed.h"
#include <stdio.h>
#include <errno.h>

// Block devices
#include "SPIFBlockDevice.h"
#include "SDBlockDevice.h"
#include "HeapBlockDevice.h"

// File systems
#include "LittleFileSystem.h"
#include "FATFileSystem.h"


// Physical block device, can be any device that supports the BlockDevice API
SPIFBlockDevice bd(
        MBED_CONF_SPIF_DRIVER_SPI_MOSI,
        MBED_CONF_SPIF_DRIVER_SPI_MISO,
        MBED_CONF_SPIF_DRIVER_SPI_CLK,
        MBED_CONF_SPIF_DRIVER_SPI_CS);

// File system declaration
LittleFileSystem fs("fs");


// Set up the button to trigger an erase
InterruptIn irq(BUTTON1);
void erase() {
    printf("Initializing the block device... ");
    fflush(stdout);
    int err = bd.init();
    printf("%s\n", (err ? "Fail :(" : "OK"));
    if (err) {
        error("error: %s (%d)\n", strerror(-err), err);
    }

    printf("Erasing the block device... ");
    fflush(stdout);
    err = bd.erase(0, bd.size());
    printf("%s\n", (err ? "Fail :(" : "OK"));
    if (err) {
        error("error: %s (%d)\n", strerror(-err), err);
    }

    printf("Deinitializing the block device... ");
    fflush(stdout);
    err = bd.deinit();
    printf("%s\n", (err ? "Fail :(" : "OK"));
    if (err) {
        error("error: %s (%d)\n", strerror(-err), err);
    }
}


// Entry point for the example
int main() {
    printf("--- Mbed OS filesystem example ---\n");

    // Setup the irq in case we want to use it
    irq.fall(erase);

    // Try to mount the filesystem
    printf("Mounting the filesystem... ");
    fflush(stdout);
    int err = fs.mount(&bd);
    printf("%s\n", (err ? "Fail :(" : "OK"));
    if (err) {
        // Reformat if we can't mount the filesystem
        // this should only happen on the first boot
        printf("No filesystem found, formatting... ");
        fflush(stdout);
        err = fs.reformat(&bd);
        printf("%s\n", (err ? "Fail :(" : "OK"));
        if (err) {
            error("error: %s (%d)\n", strerror(-err), err);
        }
    }

    // Open the numbers file
    printf("Opening \"/fs/numbers.txt\"... ");
    fflush(stdout);
    FILE *f = fopen("/fs/numbers.txt", "r+");
    printf("%s\n", (!f ? "Fail :(" : "OK"));
    if (!f) {
        // Create the numbers file if it doesn't exist
        printf("No file found, creating a new file... ");
        fflush(stdout);
        f = fopen("/fs/numbers.txt", "w+");
        printf("%s\n", (!f ? "Fail :(" : "OK"));
        if (!f) {
            error("error: %s (%d)\n", strerror(errno), -errno);
        }

        for (int i = 0; i < 10; i++) {
            printf("\rWriting numbers (%d/%d)... ", i, 10);
            fflush(stdout);
            err = fprintf(f, "    %d\n", i);
            if (err < 0) {
                printf("Fail :(\n");
                error("error: %s (%d)\n", strerror(errno), -errno);
            }
        }
        printf("\rWriting numbers (%d/%d)... OK\n", 10, 10);

        printf("Seeking file... ");
        fflush(stdout);
        err = fseek(f, 0, SEEK_SET);
        printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
        if (err < 0) {
            error("error: %s (%d)\n", strerror(errno), -errno);
        }
    }

    // Go through and increment the numbers
    for (int i = 0; i < 10; i++) {
        printf("\rIncrementing numbers (%d/%d)... ", i, 10);
        fflush(stdout);

        // Get current stream position
        long pos = ftell(f);

        // Parse out the number and increment
        int32_t number;
        fscanf(f, "%d", &number);
        number += 1;

        // Seek to beginning of number
        fseek(f, pos, SEEK_SET);
    
        // Store number
        fprintf(f, "    %d\n", number);
    }
    printf("\rIncrementing numbers (%d/%d)... OK\n", 10, 10);

    // Close the file which also flushes any cached writes
    printf("Closing \"/fs/numbers.txt\"... ");
    fflush(stdout);
    err = fclose(f);
    printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
    if (err < 0) {
        error("error: %s (%d)\n", strerror(errno), -errno);
    }
    
    // Display the root directory
    printf("Opening the root directory... ");
    fflush(stdout);
    DIR *d = opendir("/fs/");
    printf("%s\n", (!d ? "Fail :(" : "OK"));
    if (!d) {
        error("error: %s (%d)\n", strerror(errno), -errno);
    }

    printf("root directory:\n");
    while (true) {
        struct dirent *e = readdir(d);
        if (!e) {
            break;
        }

        printf("    %s\n", e->d_name);
    }

    printf("Closing the root directory... ");
    fflush(stdout);
    err = closedir(d);
    printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
    if (err < 0) {
        error("error: %s (%d)\n", strerror(errno), -errno);
    }

    // Display the numbers file
    printf("Opening \"/fs/numbers.txt\"... ");
    fflush(stdout);
    f = fopen("/fs/numbers.txt", "r");
    printf("%s\n", (!f ? "Fail :(" : "OK"));
    if (!f) {
        error("error: %s (%d)\n", strerror(errno), -errno);
    }

    printf("numbers:\n");
    while (!feof(f)) {
        int c = fgetc(f);
        printf("%c", c);
    }

    printf("\rClosing \"/fs/numbers.txt\"... ");
    fflush(stdout);
    err = fclose(f);
    printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
    if (err < 0) {
        error("error: %s (%d)\n", strerror(errno), -errno);
    }

    // Tidy up
    printf("Unmounting... ");
    fflush(stdout);
    err = fs.unmount();
    printf("%s\n", (err < 0 ? "Fail :(" : "OK"));
    if (err < 0) {
        error("error: %s (%d)\n", strerror(-err), err);
    }
        
    printf("Mbed OS filesystem example done!\n");
}

相关内容

XinLiBK
关注
  • 2
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
littlefs文件系统源码
10-29
断电恢复能力 - 要求文件系统保持一致，并将数据刷新到底层存储。 平均磨损 - 通常情况下，存储支持每块数量有限的擦除，因此使用整个存储设备对于可靠性非常重要。 微小的占地面积 - 物联网设备受到ROM和RAM的限制。占地面积小可以节省资金。
SPI FLASH移植littleFS文件系统
01-19
littleFS是ARM公司开源的文件系统项目，专门用于解决SPI FLASH在嵌入式系统上的文件管理。已成功移植，经过测试可以正常使用。
鸿蒙轻内核M核源码分析系列二一 02 文件系统LittleFS
最新发布
maniuT的博客
06-15 981
会分2部分来介绍结构体部分，先介绍LittleFS文件系统的结构体，然后介绍LiteOS-M内核中提供的和LittleFS相关的一些结构体。
littlefs
CSDN博客
09-23 6096
1、littlefs主要用在微控制器和flash上，是一种嵌入式文件系统。主要有3个特点： 1)、掉电恢复 在写入时即使复位或者掉电也可以恢复到上一个正确的状态。 2)、擦写均衡 有效延长flash的使用寿命 3)、有限的RAM/ROM 节省ROM和RAM空间 2、已有的文件系统 1）非掉电恢复，基于block的文件系统，常见的有FAT和EXT2。这两个文件系统在写入文件时是原地更新的，不具备非掉电恢复的特性。 2) 日志式的文件系统，比如JFFS,YAFFS等，具备掉电恢复的特性。.
Mbed OS 文档翻译 之 参考（API（存储（FileSystem）））
XinLiBK的博客
08-29 343
FileSystem 文件系统 API 提供用于在基于块的存储设备上实现文件系统的公共接口。文件系统 API 是基于类的接口，但实现文件系统 API 提供了 C 用户熟悉的标准 POSIX 文件 API。 FileSystem 的主要目的是实例化。FileSystem 的构造函数可以接受指定为字符串的 BlockDevice 和挂载点，以及其他特定于实现的配置选项。然后，当与 POSIX AP...
Littlefs的接口说明
weiguang119的博客
06-10 1753
在compact的时候，会先计算一下压缩后需要多少空间，当需要的空间大于一般block大小的时候，会进行分片处理，分裂出一个新的block pair，把前一半的文件信息（LFS_TYPE_NAME、LFS_TYPE_USERATTR、LFS_TYPE_STRUCT）放到前一个block pair，把后一半的文件信息放到新的block pair，并且前一个block pair通过LFS_TYPE_HARDTAIL指向新的block pair。会自动从旧的目录中复制过来。如果某一级目录不存在，则会创建失败。
LittleFS - 一个高度完整的嵌入式文件系统
xk100的专栏
12-28 1万+
LittleFS - 一个高度完整的嵌入式文件系统   拥有小巧灵活的文件系统对许多物联网设备至关重要。使用文件系统并将其与正确的存储技术（如外部闪存或SD卡）配对可能很困难。Mbed操作系统使文件系统的组合变得简单。Mbed OS 5.7既支持FAT文件系统，又引入了高度集成的嵌入式文件系统。这包括对没有自己的磨损平衡控制器的闪存芯片的磨损平衡支持。 LittleFS  - 一个高度完整的...
MBEDOS参考手册
02-24
应用代码采用C++编写，使用MbedOS提供的API，在不同的微处理器上按照统一的编程实现。便于应用的开发。基本架构图2.1.1入口点MbedOS提供了两个入口点·main(void)-所有的标准应用都使用该代码入口点·mbed_main(void...
mbed_blinky_mbed创建头文件_mbedos_sincesyh_
10-01
【标题】"mbed_blinky_mbed创建头文件_mbedos_sincesyh_" 指的是一个基于mbed OS的项目，目标是实现一个简单的LED闪烁程序，它使用了mbed创建的头文件来实现这一功能。mbed OS是一个开源的实时操作系统（RTOS），专...
实时操作系统mbedOS的移植方法
05-06
在此基础上，实现了mbedOS在ARM Cortex-M系列的不同内核及不同MCU上的移植，还给出了不同开发环境间移植共性问题分析，为mbedOS的应用研究提供了基础，有效地降低了mbedOS的移植难度，也可为其他RTOS的移植提供参考.
在本地KEIL环境建立mBedOS调试环境
01-27
在线集成开发环境、命令行开发环境、以及第三方开发环境。 一般开发人员，都喜欢在本地建立工程，使用自己熟悉的开发环境进行...下面的内容源自https://os.mbed.com/docs/v5.6/introduction/index.html，以及关联网页
mbed-littlefs:[实验]用于LittleFS v2.0（alpha）的Mbed OS包装器
05-11
小文件系统的Mbed OS API 这是用于littlefs的Mbed OS API，这是一个为嵌入式系统设计的故障保护文件系统。 | | | .---._____ .-----. | | --|o |---| littlefs | --| |---| | '-----' '----------' | | | 有限的RAM / ROM -littlefs设计用于有限的内存。 避免了递归，并且动态内存仅限于可以静态提供的可配置缓冲区。 功率损耗弹性强-littlefs专为可能发生随机电源故障的系统而设计。 littlefs具有很强的写时复制保证，并且磁盘上的存储始终保持有效状态。 损耗均衡-由于嵌入式存储的最常见形式是易腐蚀的闪存，因此littlefs为无法容纳完整闪存转换层的系统提供了一种动态损耗
spiffs_littlefs_fatfs_easyflash.rar
03-11
文件系统源码包
ESP8266-MyWidget-Demo：该项目可以用作框架，学习工具或用作启动新ESP8266项目的模板。 它包含许多用于构建ESP8266项目的UI和API组件。 该项目包括：ESP8266开发，mDNS-组播DNS（mywidget.local），异步Web服务器（ESPAsyncWebServer），异步Web服务（ESPAsyncWebServer），异步MQTT（PangolinMQTT），LittleFS文件系统，嵌入式Bootstrap（3.4.1），嵌入式jQuery（3.5.1），S
02-13
ESP8266-MyWidget 该项目可以用作学习工具，也可以用作启动新ESP8266项目的模板。 它包含许多用于使用Web界面构建ESP8266项目的组件。 该项目包括： ESP8266开发 mDNS-组播DNS（mywidget.local） 异步Web服务器（ESPAsyncWebServer） 异步Web服务（ESPAsyncWebServer） 异步MQTT（PangolinMQTT） LittleFS文件系统 嵌入式引导程序（3.4.1） 嵌入式jQuery（3.5.1） 保存/加载配置文件（文本） OTA（空中下载）更新 HTTP API支持HTTP GET / POST 自动更新网站（使用JS的Web服务） 多个中断定时器（ESP8266TimerInterrupt） 使用中断计时器闪烁板载LED 再加上更多... 历史 我从亚马逊购买了 ，用
LittleFS：一个完整的嵌入式文件系统介绍、移植使用教程
热门推荐
^_^
09-15 2万+
LittleFS - 一个高度完整的嵌入式文件系统、移植使用教程 1、介绍 源码下载地址：https://github.com/littlefs-project/littlefs/tags 截止2021年9月15日10:21:17，最新版本为2.4.1，当前移植使用教程基于2.4.1版本为例。 LittleFS 由ARM官方发布，ARM mbedOS的官方推荐文件系统，具有轻量级，掉电安全的特性。主要用在微控制器和flash上，特点如下： 掉电恢复，在写入时即使复位或者掉电也可以恢复到上一个正确的状态。
探索小巧玲珑的文件系统：littlefs
gitblog_00059的博客
03-21 380
探索小巧玲珑的文件系统：littlefs 项目地址:https://gitcode.com/ARMmbed/littlefs 在嵌入式领域，存储管理是一个关键的问题，尤其是在资源有限的小型设备上。今天，我们想要向您推荐一个专为微控制器和IoT设备设计的小巧而强大的文件系统——littlefs。 项目简介 littlefs是由ARM mbed团队开发的一款开源文件系统，旨在解决微控制器（MCU）和其...
Mbed OS 文档翻译 之 参考（API（存储（FATFileSystem）））
XinLiBK的博客
08-30 473
FATFileSystem                                                                                             FATFileSystem 类层次结构 FAT 文件系统是一个已建立的面向磁盘的文件系统，您可以在 Mbed OS，Windows，Linux 和 Mac OS X 上找到它。由于...
Mbed OS 文档翻译 之 参考（贡献（移植目标（线程安全和移植）））
XinLiBK的博客
09-01 966
线程安全和移植 关于这份文件 本文档介绍了 Arm Mbed OS RTOS 和线程安全机制，然后讨论将它们移植到新目标。 RTOS Mbed OS 5 中引入的主要改进之一是基于实时操作系统（RTOS）的新编程模型。一些早期版本的 Arm Mbed 已经为 RTOS 提供了可选支持。在版本 5 中，RTOS 支持是平台的标准功能，因此开发人员可以利用基于多线程的更灵活的编程模型。 与任...
小型文件系统FatFS和LittleFS对比和区别
strongerHuang
04-26 1万+
关注、星标公众号，不错过精彩内容素材来源：网络编辑整理：strongerHuang对于许多物联网设备而言，拥有一个小型且具有弹性的文件系统至关重要。在MCU上运行的文件系统不多，绝大部分...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值