2026-10-01 23:13:42 +08:00
|
|
|
|
/* f32io.h — fat32_io.h 单编译单元封装（M0）
|
|
|
|
|
|
*
|
|
|
|
|
|
* fat32_io.h 是 header-only static inline 实现，含 ~4.3MB 静态缓冲
|
|
|
|
|
|
* （f32_disk 128KB + f32_cluster 4KB + f32_data 4MB）。多模块需要 FAT32
|
|
|
|
|
|
* 访问时若各自 include 会每 TU 复制一份缓冲——f32io.c 是唯一包含者，
|
|
|
|
|
|
* 本头导出薄封装（_w 后缀）供其他模块调用。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 纯字符串助手（fat32_lfn_streq_ci / fat32_lfn_ends_with_ci / f32_entry）
|
|
|
|
|
|
* 无状态，各模块直接 include fat32_lfn.h 即可，不经此封装。
|
|
|
|
|
|
*/
|
|
|
|
|
|
#ifndef DESHAB_F32IO_H
|
|
|
|
|
|
#define DESHAB_F32IO_H
|
|
|
|
|
|
|
|
|
|
|
|
/* f32_entry / 回调签名（与 fat32_io.h 一致；f32_entry 来自 fat32_lfn.h） */
|
|
|
|
|
|
#include "../tools/fat32_lfn.h"
|
|
|
|
|
|
|
|
|
|
|
|
typedef int (*f32_list_cb_fn)(const char *name, unsigned int size,
|
|
|
|
|
|
unsigned char attr, void *user_data);
|
|
|
|
|
|
typedef int (*f32_list_entry_fn)(const f32_entry *e, void *user_data);
|
|
|
|
|
|
|
|
|
|
|
|
/* 初始化（对应 f32_init，注入 block read/write） */
|
|
|
|
|
|
void f32_io_init(desktop_block_read_fn rd, desktop_block_write_fn wr);
|
|
|
|
|
|
|
|
|
|
|
|
/* 根目录文件读/写/列举 */
|
|
|
|
|
|
int f32_read_root_file_w(const char *name11, u8 **out_data, u32 *out_size);
|
|
|
|
|
|
int f32_write_root_file_w(const char *name11, const u8 *data, u32 size);
|
|
|
|
|
|
int f32_list_root_w(f32_list_cb_fn emit, void *user_data);
|
|
|
|
|
|
|
2026-10-12 23:57:19 +08:00
|
|
|
|
/* 目录列举 / 路径定位 / 长路径读取 / 按簇读文件 */
|
2026-10-01 23:13:42 +08:00
|
|
|
|
int f32_list_dir_w(u32 dir_clus, f32_list_entry_fn emit, void *user_data);
|
|
|
|
|
|
int f32_find_path_dir_lfn_w(const char *path, u32 *out_clus);
|
|
|
|
|
|
int f32_read_path_lfn_w(const char *path, u8 **out_data, u32 *out_size);
|
2026-10-12 23:57:19 +08:00
|
|
|
|
int f32_read_file_by_clus_w(u32 clus, u32 size, u8 *out_buf, u32 buf_cap);
|
2026-10-01 23:13:42 +08:00
|
|
|
|
|
|
|
|
|
|
/* 流式直读到指定缓冲（绕过 f32_data 4MB 上限，zhfont 字库加载用） */
|
|
|
|
|
|
int f32_read_path_lfn_to_w(const char *path, u8 *dst, u32 cap, u32 *out_size);
|
|
|
|
|
|
|
|
|
|
|
|
/* 8.3 名转换（纯函数，但定义于 fat32_io.h，故同样封装） */
|
|
|
|
|
|
int f32_name_to_83_w(const char *in, char out[11]);
|
|
|
|
|
|
void f32_name_from_83_w(const char in[11], char out[13]);
|
|
|
|
|
|
int f32_neq11_w(const char *a, const char *b);
|
|
|
|
|
|
|
|
|
|
|
|
#endif /* DESHAB_F32IO_H */
|
