在物联网设备开发中,数据存储是至关重要的一环。你是否遇到过这些问题:
Arduino-ESP32提供了多种文件系统解决方案,本文将深入解析SPIFFS、LittleFS和SD卡三种主流存储方案,帮助你做出最佳选择。

SPIFFS(SPI Flash File System)是专为SPI NOR flash设计的嵌入式文件系统:
| 特性 | 说明 | 适用场景 |
|---|---|---|
| 轻量级 | 代码体积小,内存占用低 | 资源受限设备 |
| 磨损均衡 | 基本均衡算法 | 中等写入频率 |
| 掉电保护 | 有限保护机制 | 非关键数据存储 |
| 目录支持 | 有限目录功能 | 简单文件结构 |
#include "FS.h"
#include "SPIFFS.h"
#define FORMAT_SPIFFS_IF_FAILED true
void setup() {
Serial.begin(115200);
// 初始化SPIFFS
if(!SPIFFS.begin(FORMAT_SPIFFS_IF_FAILED)){
Serial.println("SPIFFS挂载失败");
return;
}
// 获取文件系统信息
Serial.printf("总空间: %d bytes\n", SPIFFS.totalBytes());
Serial.printf("已用空间: %d bytes\n", SPIFFS.usedBytes());
// 文件操作示例
writeFile(SPIFFS, "/config.txt", "device_id=12345");
readFile(SPIFFS, "/config.txt");
}
// 写入文件函数
void writeFile(fs::FS &fs, const char *path, const char *message) {
File file = fs.open(path, FILE_WRITE);
if(file.print(message)) {
Serial.println("文件写入成功");
}
file.close();
}
// 读取文件函数
void readFile(fs::FS &fs, const char *path) {
File file = fs.open(path);
while(file.available()) {
Serial.write(file.read());
}
file.close();
}
通过实际测试,SPIFFS在不同操作下的性能表现:
| 操作类型 | 文件大小 | 耗时(ms) | 备注 |
|---|---|---|---|
| 顺序写入 | 1KB | 15 | 小文件快速写入 |
| 随机读取 | 1KB | 2 | 读取速度优秀 |
| 目录遍历 | 100文件 | 120 | 文件较多时较慢 |
LittleFS是ESP32推荐的现代文件系统,相比SPIFFS有显著。
#include <LittleFS.h>
void setup() {
Serial.begin(115200);
// LittleFS初始化
if(!LittleFS.begin(true)){
Serial.println("LittleFS挂载失败");
return;
}
// 创建多级目录
createDirRecursive("/system/config/network");
// 原子写入操作
atomicWrite("/system/config/network/wifi.txt", "ssid=MyWiFi\npassword=123456");
// 文件系统信息
printFSInfo();
}
// 递归创建目录
void createDirRecursive(const char *path) {
char *pathCopy = strdup(path);
char *ptr = strchr(pathCopy, '/');
while(ptr != NULL) {
*ptr = '\0';
if(!LittleFS.exists(pathCopy)) {
LittleFS.mkdir(pathCopy);
}
*ptr = '/';
ptr = strchr(ptr + 1, '/');
}
free(pathCopy);
}
// 原子写入(避免数据损坏)
void atomicWrite(const char *path, const char *content) {
String tempPath = String(path) + ".tmp";
File tempFile = LittleFS.open(tempPath.c_str(), FILE_WRITE);
tempFile.print(content);
tempFile.close();
// 原子重命名
LittleFS.rename(tempPath.c_str(), path);
}
// 使用缓冲区优化大文件操作
void optimizedFileCopy(const char *src, const char *dst) {
const size_t bufferSize = 4096; // 4KB缓冲区
uint8_t buffer[bufferSize];
File source = LittleFS.open(src, FILE_READ);
File destination = LittleFS.open(dst, FILE_WRITE);
while(source.available()) {
size_t bytesRead = source.read(buffer, bufferSize);
destination.write(buffer, bytesRead);
}
source.close();
destination.close();
}
// 批量文件操作
void batchFileOperations() {
// 使用事务性操作提高性能
LittleFS.beginTransaction();
for(int i = 0; i < 100; i++) {
String filename = "/data/sensor_" + String(i) + ".txt";
writeFile(LittleFS, filename.c_str(), "sensor data");
}
LittleFS.endTransaction();
}
SD卡通过SPI接口连接ESP32,典型接线方式:
| ESP32引脚 | SD卡引脚 | 功能 |
|---|---|---|
| GPIO14 | CLK | 时钟 |
| GPIO15 | MISO | 主入从出 |
| GPIO2 | MOSI | 主出从入 |
| GPIO13 | CS | 片选 |
#include "SD.h"
#include "SPI.h"
#define SD_CS 13
void setup() {
Serial.begin(115200);
// SD卡初始化
if(!SD.begin(SD_CS)){
Serial.println("SD卡挂载失败");
return;
}
uint8_t cardType = SD.cardType();
if(cardType == CARD_NONE){
Serial.println("未检测到SD卡");
return;
}
Serial.print("SD卡类型: ");
switch(cardType){
case CARD_MMC: Serial.println("MMC"); break;
case CARD_SD: Serial.println("SDSC"); break;
case CARD_SDHC: Serial.println("SDHC"); break;
default: Serial.println("未知"); break;
}
// 获取容量信息
uint64_t cardSize = SD.cardSize() / (1024 * 1024);
Serial.printf("SD卡大小: %lluMB\n", cardSize);
}
// 大数据文件处理
void processLargeData() {
File dataFile = SD.open("/sensor_data.csv", FILE_APPEND);
// 写入CSV格式数据
dataFile.print("timestamp,temperature,humidity\n");
for(int i = 0; i < 1000; i++) {
dataFile.printf("%lu,%.2f,%.2f\n",
millis(),
random(200, 300) / 10.0,
random(300, 800) / 10.0);
}
dataFile.close();
}
| 特性 | SPIFFS | LittleFS | SD卡 |
|---|---|---|---|
| 最大容量 | 4-16MB | 4-16MB | 32GB+ |
| 写入速度 | 中等 | 快 | 取决于卡速 |
| 读取速度 | 快 | 很快 | 快 |
| 目录性能 | 差 | 优秀 | 优秀 |
| 磨损均衡 | 基本 | 优秀 | 优秀 |
| 掉电保护 | 有限 | 优秀 | 优秀 |
| 适用场景 | 配置存储 | 频繁读写 | 大数据存储 |
class DeviceConfig {
private:
const char* configPath = "/config/device.json";
public:
bool saveConfig(const String& jsonConfig) {
if(!LittleFS.begin(true)) return false;
// 确保配置目录存在
if(!LittleFS.exists("/config")) {
LittleFS.mkdir("/config");
}
// 原子写入配置
atomicWrite(configPath, jsonConfig.c_str());
LittleFS.end();
return true;
}
String loadConfig() {
if(!LittleFS.begin(false)) return "";
if(LittleFS.exists(configPath)) {
File configFile = LittleFS.open(configPath, FILE_READ);
String content = configFile.readString();
configFile.close();
LittleFS.end();
return content;
}
LittleFS.end();
return "";
}
};
class DataLogger {
private:
fs::FS* filesystem;
const char* logBasePath = "/logs";
public:
DataLogger(fs::FS& fs) : filesystem(&fs) {}
bool logSensorData(const String& sensorName, float value) {
String dateStr = getDateString();
String filePath = String(logBasePath) + "/" + dateStr + "/" + sensorName + ".csv";
// 创建日期目录
String datePath = String(logBasePath) + "/" + dateStr;
if(!filesystem->exists(datePath.c_str())) {
filesystem->mkdir(datePath.c_str());
}
// 写入数据
File logFile = filesystem->open(filePath.c_str(), FILE_APPEND);
if(logFile) {
logFile.printf("%lu,%.2f\n", millis(), value);
logFile.close();
return true;
}
return false;
}
};

挂载失败
写入速度慢
数据损坏
来源:https://blog.csdn.net/gitblog_00074/article/details/151563479
LED点阵屏通过LED(发光二极管)组成,以灯珠亮灭来显示文字、图片、动画、视频等,是各部分组件都模块化的显示器件,通常由显示模块、控制系统及电源系统组成。
本小节使用音频开发框架实现一个音频录制到文件的示例。
I2S协议通过BCLK、LRCLK和DATA三线精准传输音频数据,但时序边沿、帧格式、时钟源等细节常引发噪声或断连。本文详解ESP32的I2S实现,从协议原理到ESP-IDF v5.x代码配置,助你避开常见陷阱,确保音频稳定传输。
本小节介绍音频的基础知识、音频开发框架和AudioCodec的简介,用一个音频播放示例来说明音频管道的使用。
MimiClaw是基于ESP32-S3芯片的超轻量级AI助手,通过Telegram或WebSocket提供Claude/GPT智能服务。
本小节是一个Web服务结合SD卡文件系统的应用示例。
本节主要讲解FileSystem类的使用,以及Flash文件系统配置和SD存储模块的使用。
本节主要讲解Wifi热点的Web服务使用,以及使用网页交互来控制LED。
本节主要讲解WifiBoard类的功能和HTTPClient库及cJSON的使用。
本节主要讲解TFT-LCD显示屏的使用和Window派生类与TFT_eSPI库的使用。
这篇文章展示了如何将化学与工程、信息技术、现代制造技术紧密结合,以“血氧指标控制的简易供氧器”为载体,组织一次真实的跨学科项目。设计中突出“从需求出发”“闭环控制”“可视化反馈”,不仅呼应了新课标中“跨学科实践”的要求,更贴近生活实际需求,尤其适用于对科技应用、健康关怀有兴趣的学生群体,可作为项目式学习或社团活动的优质课例。