这是最新(主)开发分支的文档。如果您正在查找以前版本的文档，使用左侧的下拉菜单选择所需的版本。

LittleFS (内部 Flash 磁盘)

功能概述

此应用程序是使用 WM IoT SDK 进行 LittleFS 文件系统的基础示例。它演示了如何使用 WM IoT SDK 中的 LittleFS API 在内部 Flash 上进行基本的文件操作。示例包括：

  1. 初始化 LittleFS：使用内部 Flash 初始化 LittleFS 配置；

  2. 格式化文件系统：对文件系统进行格式化；

  3. 挂载文件系统：将文件系统挂载到内部 Flash；

  4. 文件操作演示：

    • 创建并写入文件：创建一个名为 hello.txt 的文件，并写入字符串 “Hello LittleFS!”；

    • 读取文件：读取 hello.txt 文件的内容并显示；

  5. 卸载文件系统：卸载文件系统并清理资源。

本示例使用内部 Flash 作为存储介质，展示了如何在内部 Flash 上使用 LittleFS 文件系统进行基本的文件操作。

环境要求

  1. 需要正确配置 wm_drv_flash 驱动；

  2. 使用用户自定义分区 partition_table_custom.csv，并添加 CONFIG_LITTLEFS_INTERNAL_FLASH_PARTITION_NAME(默认名称为 littlefs) 分区, 0x2000(8KB)，否则会导致格式化失败；

编译和烧录

示例位置：examples\storage\fatfs\internal_flash_disk

编译、烧录等操作请参考：快速入门

运行结果

成功运行将输出如下日志

[I] (3) main: ver: 2.3-beta.2 build at Apr 14 2025 11:49:06
[I] (4) main: boot reason 0
[I] (4) main: heap size 272560(266.17KB)
[I] (5) main: flash size 0x200000(2MB)
[I] (5) lfs: LittleFS demo start.     
[I] (16) lfs: Writing to file: hello.txt
[I] (22) lfs: Reading from file: hello.txt
[I] (23) lfs: Read content: Hello LittleFS!
[I] (23) lfs: File operations completed successfully.
[I] (24) lfs: This example succeeds in running.