基于Arduino IDE 野火ESP8266模块 文件系统LittleFS 的开发

一、文件系统LittleFS的介绍

 LittleFS是一个为微控制器设计的轻量级、可靠且高性能的文件系统。它专为嵌入式设备打造,拥有占用空间小、对硬件要求低的特点,同时保证在断电情况下数据的完整性和稳定性。
1.设计与特点
LittleFS的设计旨在提供嵌入式系统所需的高效、可靠的文件存储解决方案。它采用日志结构的文件系统设计,确保在突然断电或系统崩溃时数据不会损坏。同时,LittleFS通过磨损均衡算法来延长闪存的使用寿命,这对于使用有限次写入周期的闪存设备来说尤为重要。
2.性能
LittleFS在写入性能方面表现出色,特别是在处理大量小文件时。它的写入速度通常优于许多其他嵌入式文件系统,这使得它成为需要频繁写入操作的嵌入式应用的理想选择。
3. 灵活性
LittleFS非常灵活,可以配置为使用设备的任何部分作为存储。这意味着你可以根据项目的需求选择使用内部闪存、外部SD卡或其他存储设备来存储文件。
4. 兼容性
LittleFS与多种嵌入式开发环境和平台兼容,包括Arduino IDE。这使得它易于集成到各种嵌入式项目中,无论是使用ESP8266还是其他微控制器。
5.使用与集成
使用LittleFS库,你可以通过简单的API调用进行文件的创建、打开、读取、写入和删除等操作。这些API函数提供了直观且易于使用的接口,使得文件操作变得简单而高效。
6.安全性与稳定性
LittleFS注重数据的完整性和安全性。它采用了一系列措施来确保数据的完整性和稳定性,即使在恶劣的嵌入式环境中也能保持可靠的性能。
 总的来说,LittleFS是一个强大、可靠且高效的嵌入式文件系统解决方案。它提供了易于使用的API、出色的性能和灵活的配置选项,使得在嵌入式设备上管理文件变得更加简单和高效。无论是用于数据存储、日志记录还是其他文件操作,LittleFS都是一个值得考虑的优秀选择。

二、库文件

需要Arduino IDE中已经安装LittleFS库。

三、代码

初始化LittleFS,代码如下

#include <LittleFS.h>  

void setup() {  
  Serial.begin(115200);  
  if (!LittleFS.begin()) {  
    Serial.println("LittleFS Mount Failed");  
    return;  
  }  
  Serial.println("LittleFS Mounted");  
  // ... 其他初始化代码 ...  
}

一旦LittleFS被成功挂载,就可以使用它提供的API来创建、读取、写入和删除文件了。
写入文件,代码如下:

void writeToFile(const char *filename, const char *data) {  
  File file = LittleFS.open(filename, FILE_WRITE);  
  if (!file) {  
    Serial.println("Failed to open file for writing");  
    return;  
  }  
  if (file.print(data)) {  
    Serial.println("File written");  
  } else {  
    Serial.println("Write failed");  
  }  
  file.close();  
}

读取文件

void readFromFile(const char *filename) {  
  File file = LittleFS.open(filename, FILE_READ);  
  if (!file) {  
    Serial.println("Failed to open file for reading");  
    return;  
  }  
  Serial.println("Reading file:");  
  while (file.available()) {  
    Serial.write(file.read());  
  }  
  file.close();  
}

清理和卸载LittleFS
代码结束时,可以选择清理LittleFS占用的资源。在loop()函数的末尾或setup()函数中的某个错误处理路径中完成。

void loop() {  
  // ... 代码 ...  
}  

void shutdown() {  
  LittleFS.end();  
}

处理存储空间
由于ESP8266的存储空间有限,需要确保不会超出其限制。LittleFS提供了一些API来检查和管理存储空间,比如LittleFS.space() 可以获取剩余空间。

注意事项
1.确保ESP8266有足够的闪存空间来支持LittleFS。
2.注意文件路径和名称的长度,因为嵌入式系统的资源有限。
3.频繁地创建和删除文件可能会降低闪存的使用寿命,所以尽量优化文件操作。
4.如果ESP8266断电或重启,LittleFS通常会保留其状态,建议在关键数据上进行额外的持久性保护。

完整代码如下

#include <LittleFS.h>  
//#include "FS.h"

const char* testPath ="/log.txt";
const char* testInfo ="this is log";

void setup() {  
  Serial.begin(115200);  
  Serial.println();
  if (!LittleFS.begin()) {  
    Serial.println("LittleFS Mount Failed");  
    return;  
  }  
  Serial.println("LittleFS Mounted");  
  // ... 其他初始化代码 ...  
  writeToFile(testPath,testInfo);
  readFromFile(testPath);
  shutdown();
}

void writeToFile(const char *filename, const char *data) {  
  File file = LittleFS.open(filename, "w");  
  if (!file) {  
    Serial.println("Failed to open file for writing");  
    return;  
  }  
  if (file.print(data)) {  
    Serial.println("File written");  
  } else {  
    Serial.println("Write failed");  
  }  
  file.close();  
}

void readFromFile(const char *filename) {  
  File file = LittleFS.open(filename, "r");  
  if (!file) {  
    Serial.println("Failed to open file for reading");  
    return;  
  }  
  Serial.println("Reading file:");  
  while (file.available()) {  
    Serial.write(file.read());  
  }  
  file.close();  
}

void shutdown() {  
  LittleFS.end();  
}

void loop() {  
  // ... 代码 ...  
}  

运行效果,如下:
在这里插入图片描述

四、综合实验

LittleFS和JSON数据处理

// Example: storing JSON configuration file in flash file system
//
// Uses ArduinoJson library by Benoit Blanchon.
// https://github.com/bblanchon/ArduinoJson
//
// Created Aug 10, 2015 by Ivan Grokhotkov.
//
// This example code is in the public domain.

#include <ArduinoJson.h>
#include "FS.h"
#include <LittleFS.h>

// more and possibly updated information can be found at:
// https://arduinojson.org/v6/example/config/

bool loadConfig() {
  File configFile = LittleFS.open("/config.json", "r");
  if (!configFile) {
    Serial.println("Failed to open config file");
    return false;
  }

  StaticJsonDocument<200> doc;
  auto error = deserializeJson(doc, configFile);
  if (error) {
    Serial.println("Failed to parse config file");
    return false;
  }

  const char* serverName = doc["serverName"];
  const char* accessToken = doc["accessToken"];

  // Real world application would store these values in some variables for
  // later use.

  Serial.print("Loaded serverName: ");
  Serial.println(serverName);
  Serial.print("Loaded accessToken: ");
  Serial.println(accessToken);
  return true;
}

bool saveConfig() {
  StaticJsonDocument<200> doc;
  doc["serverName"] = "api.example.com";
  doc["accessToken"] = "128du9as8du12eoue8da98h123ueh9h98";

  File configFile = LittleFS.open("/config.json", "w");
  if (!configFile) {
    Serial.println("Failed to open config file for writing");
    return false;
  }

  serializeJson(doc, configFile);
  return true;
}

void setup() {
  Serial.begin(115200);
  Serial.println("");
  delay(1000);
  Serial.println("Mounting FS...");

  if (!LittleFS.begin()) {
    Serial.println("Failed to mount file system");
    return;
  }


  if (!saveConfig()) {
    Serial.println("Failed to save config");
  } else {
    Serial.println("Config saved");
  }

  if (!loadConfig()) {
    Serial.println("Failed to load config");
  } else {
    Serial.println("Config loaded");
  }
}

void loop() {}

运行效果:
在这里插入图片描述

最近更新

  1. docker php8.1+nginx base 镜像 dockerfile 配置

    2024-04-02 12:58:01       98 阅读
  2. Could not load dynamic library ‘cudart64_100.dll‘

    2024-04-02 12:58:01       106 阅读
  3. 在Django里面运行非项目文件

    2024-04-02 12:58:01       87 阅读
  4. Python语言-面向对象

    2024-04-02 12:58:01       96 阅读

热门阅读

  1. UDP端口连不上的情况

    2024-04-02 12:58:01       37 阅读
  2. Mybatis——SqlSession的工作流程

    2024-04-02 12:58:01       34 阅读
  3. 数据类型与变量

    2024-04-02 12:58:01       39 阅读
  4. php获取拼多多详情api接口、商品主图

    2024-04-02 12:58:01       35 阅读
  5. C++ 类

    C++ 类

    2024-04-02 12:58:01      33 阅读
  6. 摄像头读取数据

    2024-04-02 12:58:01       36 阅读