# 应用所用 SPIFFS 接口 本工作区使用 SPIFFS 的文件、缓存、分配、回收与 NOR flash 层。以下条款整理自随附头文件和默认移植配置,使用文件系统的公开接口描述应用需要的行为。 R01. 配置给出 flash 容量、擦除块、逻辑块和逻辑页大小;配置完成后,未挂载的文件系统可以格式化,随后挂载使用。 R02. SPIFFS_CREAT 在文件不存在时创建文件;SPIFFS_RDWR 允许读写;关闭会完成待写内容并关闭句柄。 R03. SPIFFS_write 返回写入字节数,出现错误时返回负值;SPIFFS_read 返回读出的字节数,读取内容来自此前成功写入的文件数据。 R04. 本应用在相邻的追加写入之间通过 SPIFFS_tell、SPIFFS_eof 或 SPIFFS_fflush 提交前次缓存;以 SPIFFS_APPEND 打开的句柄每次写入均接在文件末尾,先前的定位不改变追加目的地。 R05. SPIFFS_tell 返回当前读写位置;成功写入后的位置在本次写入数据之后,包含尚在缓存中的成功写入。 R06. SPIFFS_eof 在当前读写位置到达文件末尾时返回真,在末尾之前返回假;未写入的空文件,其初始位置在末尾。 R07. SPIFFS_lseek 按 SPIFFS_SEEK_SET、SPIFFS_SEEK_CUR 或 SPIFFS_SEEK_END 定位,分别相对开头、当前位置或文件末尾,成功时返回结果位置。 R08. SPIFFS_fflush 完成句柄的待写内容,成功时返回 SPIFFS_OK;完成缓存写入和重新打开文件均保留成功写入的数据。 R09. 未设置 SPIFFS_APPEND 的写入从当前位置开始,可以修改已有内容;写入范围没有到达末尾时,后续数据仍保留。 R10. SPIFFS_DIRECT 禁止该句柄的写缓存;SPIFFS_CACHE 和 SPIFFS_CACHE_WR 可在编译时关闭,文件读写语义保持一致。 R11. 已关闭句柄的写入或定位,以及只读句柄的写入,返回负的错误结果。 R12. 一次 API 调用因句柄或底层 I/O 错误返回后,应用仍能独立调用其他公开 API;错误不阻止后续的容量查询或其他文件的正常读写。 R13. SPIFFS_info 成功返回 SPIFFS_OK,给出文件系统可用总字节数和已用字节数的估计;已用字节数在总字节数范围内。 R14. SPIFFS_LOCK 和 SPIFFS_UNLOCK 用于 API 层的互斥。此移植使用 POSIX 互斥量;移植层只提供进入、退出和系统错误报告,不参与文件位置或 I/O 错误处理。 `port/flash.c` 提供内存 NOR:擦除得到 0xff,编程只能清除位。`port_fault_after(n)` 可令后续第 n+1 次物理写返回负的 I/O 错误,并自动取消该一次性故障;负值取消注入。它不改变 RAM 或文件系统元数据。不同逻辑页大小、缓存容量与编译开关均可使用;物理容量为 128 KiB,擦除块为 4096 字节。`make smoke` 是正常路径读写自检。