这个页面的 最新开发版本 可能比这个发布的 2.1.0rc1 版本新。

FATFS (外部 Flash 磁盘)

功能概述

此应用程序是使用 WM IoT SDK 进行 FATFS 文件系统的全面示例。它演示了如何使用 WM IoT SDK 中的 FATFS API 在外部 Flash 磁盘上进行 SD 卡挂载及文件读写操作。示例包括：

  1. 注册外部 Flash 磁盘：将外部 Flash 磁盘注册到 FATFS 系统；

  2. 挂载文件系统：将外部 Flash 磁盘挂载到文件系统中，如果没有格式化，则先格式化，请注意格式化之后的文件类型（FAT12/16/32/EXFAT），会影响后续后续 API 的使用；

  3. 创建文件：创建一个名为 test.txt 的文件，并写入字符串 “Hello, FatFs!”；

  4. 读取文件：读取 test.txt 文件的内容，并与写入的内容进行比较，验证数据一致性；

  5. 卸载文件系统：卸载文件系统。

本示例使用外部 Flash 作为存储介质，展示了如何在外部 Flash 上使用 FATFS 文件系统。

环境要求

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

  2. 需要支持外部 Flash 的硬件环境，并连接上外部 Flash 设备，同时需要正确配置 CONFIG_FATFS_EXTERNAL_FLASH_DEVICE_NAME 为外部 Flash Device Name;

  3. 需要正确配置 CONFIG_FATFS_EXTERNAL_FLASH_START_ADDRESS 为外部 Flash 用于 FATFS 起始地址;

  4. 需要正确配置 CONFIG_FATFS_EXTERNAL_FLASH_SIZE 为外部 Flash 用于 FATFS 大小;

编译和烧录

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

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

运行结果

成功运行将输出如下日志

[I] (146) main: ver: 2.0.5dev build at Sep 30 2024 13:41:31
[I] (250) example: FATFS demo start.
[I] (250) example: External flash driver registered successfully.
[I] (250) example: File system not found. Formatting...
[I] (1255) example: File system formatted successfully.
[I] (1328) example: write txt: Hello, FatFs!
[I] (1328) example: read txt: Hello, FatFs!
[I] (1328) example: This example succeeds in running.