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

最新推荐文章于 2024-11-26 16:18:29 发布
最新推荐文章于 2024-11-26 16:18:29 发布
阅读量1.7k 收藏
点赞数 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");
}

相关内容

LittleFS - 一个高度完整的嵌入式文件系统
xk100的专栏
12-28 1万+
LittleFS - 一个高度完整的嵌入式文件系统   拥有小巧灵活的文件系统对许多物联网设备至关重要。使用文件系统并将其与正确的存储技术（如外部闪存或SD卡）配对可能很困难。Mbed操作系统使文件系统的组合变得简单。Mbed OS 5.7既支持FAT文件系统，又引入了高度集成的嵌入式文件系统。这包括对没有自己的磨损平衡控制器的闪存芯片的磨损平衡支持。 LittleFS  - 一个高度完整的...
SPI FLASH移植littleFS文件系统
01-19
littleFS是ARM公司开源的文件系统项目，专门用于解决SPI FLASH在嵌入式系统上的文件管理。已成功移植，经过测试可以正常使用。
LittleFS是什么
最新发布
KillCSDN666的博客
11-26 475
是一个小型嵌入式文件系统，专为嵌入式设备设计，以满足资源受限环境下的高效性和可靠性需求。它由项目开发，目前广泛应用于各种嵌入式系统中。openreadwrite每次写入操作都会记录新的文件数据和元数据，旧的数据会保留，直到被标记为可回收。支持嵌套目录（类似传统文件系统），并采用紧凑的存储格式来减少占用空间。通过分布式写入，均匀地使用存储器的每个块，避免某些块过早老化。
littlefs
CSDN博客
09-23 6422
1、littlefs主要用在微控制器和flash上，是一种嵌入式文件系统。主要有3个特点： 1)、掉电恢复 在写入时即使复位或者掉电也可以恢复到上一个正确的状态。 2)、擦写均衡 有效延长flash的使用寿命 3)、有限的RAM/ROM 节省ROM和RAM空间 2、已有的文件系统 1）非掉电恢复，基于block的文件系统，常见的有FAT和EXT2。这两个文件系统在写入文件时是原地更新的，不具备非掉电恢复的特性。 2) 日志式的文件系统，比如JFFS,YAFFS等，具备掉电恢复的特性。.
littlefs文件系统源码
10-29
断电恢复能力 - 要求文件系统保持一致，并将数据刷新到底层存储。 平均磨损 - 通常情况下，存储支持每块数量有限的擦除，因此使用整个存储设备对于可靠性非常重要。 微小的占地面积 - 物联网设备受到ROM和RAM的限制。占地面积小可以节省资金。
LittleFS 文件系统使用教程
gitblog_00171的博客
08-08 580
LittleFS 文件系统使用教程 littlefsA little fail-safe filesystem designed for microcontrollers项目地址:https://gitcode.com/gh_mirrors/li/littlefs 项目介绍 LittleFS 是一个专为微控制器设计的故障保护文件系统，特别适用于受限于 ROM 和 RAM 的物联网设备。它具有以下...
初学littlefs文件系统
weixin_45270358的博客
12-14 9981
一个为微控制器设计的小故障安全文件系统。掉电恢复能力: 设计用于处理随机电源故障。所有文件操作都有很强的写时拷贝保证，如果断电，文件系统将恢复到上一次已知的良好状态。动态磨损均衡: 设计考虑到闪存，并提供动态块磨损均衡。此外，littlefs可以检测坏块并在它们周围工作。有限RAM/ROM: 被设计为使用少量内存。RAM的使用是严格限制的，这意味着RAM的使用不会随着文件系统的增长而改变。文件系统不包含无界递归，动态内存仅限于可静态提供的可配置缓冲区。
mbed-os-tools
03-06
Mbed OS工具 该存储库包含使用Mbed OS所需的Python模块。 从历史上看，Mbed OS工具是在单独的程序包和存储库中交付的。 随着时间的推移，它们的API分别发展，每种都有自己的样式和语法。 该项目将这些软件包统一为一个直观的API。 配套 下表显示了从该存储库交付哪些软件包： PyPI包 来源 取决于 稳定的API mbed-os-tools （） 不 mbed-ls （） mbed-os-tools 是的 mbed-host-tests （） mbed-os-tools 是的 mbed-greentea （） mbed-os-tools 是的 如上所述， mbed-os-tools提供的API不稳定。 因此，请继续使用其他软件包。 执照和捐款 该软件根据。 在相同的许可下，可以接受对此项目的贡献。 请参阅以获取更多信息。 该项目包含来自其他项目的代码
mbed和mbed OS
weichushun的专栏
02-21 4376
（1）基本区别 mbed 指传统的；mbed OS指正在推出的。 When an mbed Classic platform is converted to an mbed OS board, we will no longer update and support this platform in the mbed SDK. This means you can continue t
MBedOS.txt
01-20
使用VScode移植MbedOS。
mbed API 应用笔记
04-09
该文档是mbed API的学习笔记，70多页，一晚上可读完；可作为mbed的参考资料，有兴趣的工程师朋友可参考；
MBEDOS参考手册
02-24
应用代码采用C++编写，使用MbedOS提供的API，在不同的微处理器上按照统一的编程实现。便于应用的开发。基本架构图2.1.1入口点MbedOS提供了两个入口点·main(void)-所有的标准应用都使用该代码入口点·mbed_main(void...
Mbed OS 文档翻译 之 参考（API（存储（FileSystem）））
XinLiBK的博客
08-29 363
FileSystem 文件系统 API 提供用于在基于块的存储设备上实现文件系统的公共接口。文件系统 API 是基于类的接口，但实现文件系统 API 提供了 C 用户熟悉的标准 POSIX 文件 API。 FileSystem 的主要目的是实例化。FileSystem 的构造函数可以接受指定为字符串的 BlockDevice 和挂载点，以及其他特定于实现的配置选项。然后，当与 POSIX AP...
Littlefs的接口说明
weiguang119的博客
06-10 2326
在compact的时候，会先计算一下压缩后需要多少空间，当需要的空间大于一般block大小的时候，会进行分片处理，分裂出一个新的block pair，把前一半的文件信息（LFS_TYPE_NAME、LFS_TYPE_USERATTR、LFS_TYPE_STRUCT）放到前一个block pair，把后一半的文件信息放到新的block pair，并且前一个block pair通过LFS_TYPE_HARDTAIL指向新的block pair。会自动从旧的目录中复制过来。如果某一级目录不存在，则会创建失败。
基于Arduino IDE 野火ESP8266模块 文件系统LittleFS 的开发
weixin_46158019的博客
03-29 1888
LittleFS是一个为微控制器设计的轻量级、可靠且高性能的文件系统。它专为嵌入式设备打造，拥有占用空间小、对硬件要求低的特点，同时保证在断电情况下数据的完整性和稳定性。1.设计与特点LittleFS的设计旨在提供嵌入式系统所需的高效、可靠的文件存储解决方案。它采用日志结构的文件系统设计，确保在突然断电或系统崩溃时数据不会损坏。同时，LittleFS通过磨损均衡算法来延长闪存的使用寿命，这对于使用有限次写入周期的闪存设备来说尤为重要。2.性能。
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
文件系统源码包
mbed os 学习笔记2：Arm Mbed在线编译
piaoyaofenfanl的专栏
05-01 2525
mbed的开放编译环境分为在线编译，本地编译两种。1：在线编译，使用Arm Mbed Online Compiler2：本地编译，使用Arm Mbed CLI在线编译过程：1：Setup帐户注册选择一块支持mbed的开发板，以备使用。手头没有设备的话，可以在 os.mbed.com/platforms上在线选择一块合适的开发。                                    ...
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 再加上更多... 历史 我从亚马逊购买了 ，用
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值