ESP32 SPIFFS和LittleFS

403 字

2 分钟

ESP32 SPIFFS和LittleFS

2025-11-24

嵌入式

ESP32

/

arduino

前言#

硬件：ESP32-S2-WROOM-1
FS库：esp32/LittleFS@^3.3.2
平台：arduino/PlatformIO

在兼容 ESP32 的wakenet和中文TTS的情况下，使用文件系统

虽然不知道具体原理，但根据网络上相关反馈，LittleFS是全面优于SPIFFS，并且LittleFS和SPIFFS是相互兼容的，只需要修改前缀即可。

准备#

修改分区 partitions.csv#

测试中使用的分区：

1
# Name,   Type, SubType, Offset,  Size, Flags
2
nvs,      data, nvs,       0x9000,   0x5000,
3
otadata,  data, ota,       0xe000,   0x2000,
4
app0,     app,  ota_0,    0x10000, 0x300000,
5
app1,     app,  ota_1,   0x310000, 0x300000,
6
model,    data, spiffs,  0x610000, 0x300000,
7
voice_data,data,fat,     0x910000, 0x400000,
8
storage,  data, spiffs,  0xD10000, 0x100000,
9
coredump, data, coredump,0xFF0000,  0x10000,

IMPORTANT
如果分区中存在多个 spiffs 或 fat 类型的分区，并且使用的是 platformio，请将文件系统分区的位置移动到最后一个分区

修改项目配置#

在 platformio.ini 中增加如下内容：

1
; upload_protocol = esptool
2
board_build.filesystem = littlefs

准备需要烧录的文件#

参考 How-to: Upload files to SPIFFS with platformio (windows)

在项目目录中创建 data 文件夹，项目结构如下：

1
PS D:\workspace\...\firmware> tree
2
├─.pio
3
├─.vscode
4
├─data
5
├─include
6
├─lib
7
├─src
8
└─test

在希望烧录的文件放入 data 文件夹中。

测试代码#

1
#include <Arduino.h>
2
#include <LittleFS.h>
3

4
void listDir(fs::FS &fs, const char *dirname, uint8_t levels)
5
{
6
    Serial.printf("Listing directory: %s\r\n", dirname);
7

8
    File root = fs.open(dirname);
9
    if (!root)
10
    {
11
        Serial.println("- failed to open directory");
12
        return;
13
    }
14
    if (!root.isDirectory())
15
    {
16
        Serial.println(" - not a directory");
17
        return;
18
    }
19

20
    File file = root.openNextFile();
21
    while (file)
22
    {
23
        if (file.isDirectory())
24
        {
25
            Serial.print("  DIR : ");
26
            Serial.println(file.name());
27
            if (levels)
28
            {
29
                listDir(fs, file.path(), levels - 1);
30
            }
31
        }
32
        else
33
        {
34
            Serial.print("  FILE: ");
35
            Serial.print(file.name());
36
            Serial.print("\tSIZE: ");
37
            Serial.println(file.size());
38
        }
39
        file = root.openNextFile();
40
    }
41
}
42

43
void setup()
44
{
45
    Serial.begin(115200);
46

47
    if (!LittleFS.begin(true, "/littlefs", 10, "storage"))
48
    {
49
        ESP_LOGE("setup", "LittleFS 挂载失败");
50
    }
51

52
    listDir(LittleFS, "/", 0);
53
}
54

55
void loop()
56
{
57

58
}