amos 1541be4f99 Add 2 MEDIUM tasks from batch 28: Mynewt FCB2 reverse alignment, SPIFFS append
After a top-up, batch 28 commit b7fd210 gave Mynewt FCB2 reverse
alignment (2 of 3 valid attempts passed) and SPIFFS append error
progress (3 of 4) as MEDIUM. Each task comes from the commit Qwen
measured, its digest matches, and it is still present at the batch
branch head.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 00:30:58 +08:00

21 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 应用所用 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` 是正常路径读写自检。