#ifndef __FS_H__ #define __FS_H__ #include "generic/typedef.h" #include "generic/list.h" #include "generic/ioctl.h" #include "generic/atomic.h" #include "system/task.h" #include "system/malloc.h" #include "system/sys_time.h" #include "stdarg.h" #include "fs_file_name.h" #define SEEK_SET 0 /* Seek from beginning of file. */ #define SEEK_CUR 1 /* Seek from current position. */ #define SEEK_END 2 /* Seek from end of file. */ #include "sdfile.h" #define F_ATTR_RO 0x01 #define F_ATTR_ARC 0x02 #define F_ATTR_DIR 0x04 #define F_ATTR_VOL 0x08 #if (VFS_ENABLE == 1) #ifndef FSELECT_MODE #define FSELECT_MODE #define FSEL_FIRST_FILE 0 #define FSEL_LAST_FILE 1 #define FSEL_NEXT_FILE 2 #define FSEL_PREV_FILE 3 #define FSEL_CURR_FILE 4 #define FSEL_BY_NUMBER 5 #define FSEL_BY_SCLUST 6 #define FSEL_AUTO_FILE 7 #define FSEL_NEXT_FOLDER_FILE 8 #define FSEL_PREV_FOLDER_FILE 9 #define FSEL_BY_PATH 10 #endif #ifndef FCYCLE_MODE #define FCYCLE_MODE #define FCYCLE_LIST 0 #define FCYCLE_ALL 1 #define FCYCLE_ONE 2 #define FCYCLE_FOLDER 3 #define FCYCLE_RANDOM 4 #define FCYCLE_MAX 5 #endif enum { FS_IOCTL_GET_FILE_NUM, FS_IOCTL_FILE_CHECK, FS_IOCTL_GET_ERR_CODE, //暂不支持 FS_IOCTL_FREE_CACHE, FS_IOCTL_SET_NAME_FILTER, //设置文件过滤 FS_IOCTL_GET_FOLDER_INFO, //获取文件夹序号和文件夹内文件数目 FS_IOCTL_SET_LFN_BUF, // 512 FS_IOCTL_SET_LDN_BUF, // 512 FS_IOCTL_SET_EXT_TYPE, //设置后缀类型 FS_IOCTL_OPEN_DIR, //打开目录 FS_IOCTL_ENTER_DIR, //进入目录 FS_IOCTL_EXIT_DIR, //退出 FS_IOCTL_GET_DIR_INFO, //获取目录信息 FS_IOCTL_GETFILE_BYNAME_INDIR, //由歌曲名称获得歌词 FS_IOCTL_GET_DISP_INFO, //用于长文件名获取 FS_IOCTL_MK_DIR, //创建文件夹 FS_IOCTL_GET_ENCFOLDER_INFO, //获取录音文件信息 FS_IOCTL_GET_OUTFLASH_ADDR, //获取外置flash实际物理地址（暂时用于手表case,特殊fat系统） FS_IOCTL_FLUSH_WBUF, //刷新wbuf FS_IOCTL_SAVE_FAT_TABLE, //seek加速处理 FS_IOCTL_INSERT_FILE, //插入文件 FS_IOCTL_DIVISION_FILE, //分割文件 FS_IOCTL_STORE_CLUST_RANG, //存储CLUST_RANG 信息 }; struct vfs_devinfo; struct vfscan; struct vfs_operations; struct vfs_devinfo { void *fd; u32 sector_size; void *private_data; }; #define VFS_PART_DIR_MAX 16 struct vfs_partition { struct vfs_partition *next; u32 offset; u32 clust_size; u32 total_size; u8 fs_attr; u8 fs_type; char dir[VFS_PART_DIR_MAX]; void *private_data; }; struct fiter { u32 index; }; struct ffolder { u16 fileStart; u16 fileTotal; }; struct imount { int fd; const char *path; struct vfs_operations *ops; struct vfs_devinfo dev; struct vfs_partition part; struct list_head entry; atomic_t ref; OS_MUTEX mutex; u8 avaliable; u8 part_num; }; struct vfs_attr { u8 attr; u32 fsize; u32 sclust; struct sys_time crt_time; struct sys_time wrt_time; struct sys_time acc_time; }; typedef struct { struct imount *mt; struct vfs_devinfo *dev; struct vfs_partition *part; void *private_data; } FILE; struct vfscan { u8 scan_file; u8 subpath; //子目录，设置是否只扫描一层 u8 scan_dir; u8 attr; u8 cycle_mode; char sort; char ftype[20 * 3 + 1]; u16 file_number; u16 file_counter; u16 dir_totalnumber; // 文件夹总数 u16 musicdir_counter; // 播放文件所在文件夹序号 u16 fileTotalInDir; //文件夹下的文件数目 void *priv; struct vfs_devinfo *dev; struct vfs_partition *part; char filt_dir[12]; }; struct vfs_operations { const char *fs_type; int (*mount)(struct imount *, int); int (*unmount)(struct imount *); int (*format)(struct vfs_devinfo *, struct vfs_partition *); int (*fset_vol)(struct vfs_partition *, const char *name); int (*fget_free_space)(struct vfs_devinfo *, struct vfs_partition *, u32 *space); int (*fopen)(FILE *, const char *path, const char *mode); int (*fread)(FILE *, void *buf, u32 len); int (*fread_fast)(FILE *, void *buf, u32 len); int (*fwrite)(FILE *, void *buf, u32 len); int (*fseek)(FILE *, int offset, int); int (*fseek_fast)(FILE *, int offset, int); int (*flen)(FILE *); int (*fpos)(FILE *); int (*fcopy)(FILE *, FILE *); int (*fget_name)(FILE *, u8 *name, int len); int (*fget_path)(FILE *, struct vfscan *, u8 *name, int len, u8 is_relative_path); int (*frename)(FILE *, const char *path); int (*fclose)(FILE *); int (*fdelete)(FILE *); int (*fscan)(struct vfscan *, const char *path, u8 max_deepth); int (*fscan_interrupt)(struct vfscan *, const char *path, u8 max_deepth, int (*callback)(void)); void (*fscan_release)(struct vfscan *); int (*fsel)(struct vfscan *, int sel_mode, FILE *, int); int (*fget_attr)(FILE *, int *attr); int (*fset_attr)(FILE *, int attr); int (*fget_attrs)(FILE *, struct vfs_attr *); int (*fmove)(FILE *file, const char *path_dst, FILE *, int clr_attr, int path_len); int (*ioctl)(void *, int cmd, int arg); }; #define REGISTER_VFS_OPERATIONS(ops) \ const struct vfs_operations ops SEC(.vfs_operations) static inline struct vfs_partition *vfs_partition_next(struct vfs_partition *p) { struct vfs_partition *n = (struct vfs_partition *)zalloc(sizeof(*n)); if (n) { p->next = n; } return n; } static inline void vfs_partition_free(struct vfs_partition *p) { struct vfs_partition *n = p->next; while (n) { p = n->next; free(n); n = p; } } /* --------------------------------------------------------------------------*/ /** * @brief 挂载文件系统 * * @param dev_name 设备名称 * @param path 路径 * @param fs_type 文件系统类型 * @param cache_num 分区数 * @param dev_arg 设备参数 * * @return mt结构句柄 */ /* ----------------------------------------------------------------------------*/ struct imount *mount(const char *dev_name, const char *path, const char *fs_type, int cache_num, void *dev_arg); //挂载 /* --------------------------------------------------------------------------*/ /** * @brief 卸载 * * @param path 路径 * * @return 返回相应的操作消息处理值 0为成功 */ /* ----------------------------------------------------------------------------*/ int unmount(const char *path); /* --------------------------------------------------------------------------*/ /** * @brief 格式化接口 * * @param path 路径 * @param fs_type 文件系统类型 * @param clust_size 簇大小,簇为0时默认为卡本身簇大小。 * * @return 0格式化成功，非0 失败 */ /* ----------------------------------------------------------------------------*/ int f_format(const char *path, const char *fs_type, u32 clust_size); //格式化接口 int f_free_cache(const char *path); #if 0 /*----------------------------------------------------------------------------*/ /** @brief: @param: fopen 扩展功能 @note: fopen自动打开、创建文件夹和文件。 说明： 1. 设备路径+文件，其中文件传入格式:"music/test/1/2/3/pk*.wav" "JL_REC/AC69****.wav" "JL_REC/AC690000.wav" 2. 文件名带*号，带多少个*表示多少个可变数字，最多为8+3的大小，如表示可变数字名称变为XXX0001,XXXX002这样得格式，不带*号则只创建一个文件，写覆盖。 @date: 2020-07-22 */ /*----------------------------------------------------------------------------*/ #endif /* --------------------------------------------------------------------------*/ /** * @brief 打开文件 * * @param path 文件路径 * @param mode 打开模式（只读("r")，写("w")，可创建("w+")） * * @return 返回获得得文件句柄 */ /* ----------------------------------------------------------------------------*/ FILE *fopen(const char *path, const char *mode); /* --------------------------------------------------------------------------*/ /** * @brief 读文件 * * @param file 文件句柄 * @param buf 读出内容放置buf * @param len 需要读出内容得长度（一般为buf长度） * * @return 返回读出得长度 */ /* ----------------------------------------------------------------------------*/ int fread(FILE *file, void *buf, u32 len); /* --------------------------------------------------------------------------*/ /** * @brief 写资源文件 * * @param file 文件句柄 * @param buf 写入得内容放置buf * @param len 需要写入内容得长度（一般为buf长度） * * @return 返回写入得长度 */ /* ----------------------------------------------------------------------------*/ int fwrite(FILE *file, void *buf, u32 len); /* --------------------------------------------------------------------------*/ /** * @brief Seek到相应得位置 * * @param file 文件句柄 * @param offset 偏移量 * @param orig 偏移方式 * * @return 返回偏移得值 */ /* ----------------------------------------------------------------------------*/ int fseek(FILE *file, int offset, int orig); /* --------------------------------------------------------------------------*/ /** * @brief 快速seek * * @param file 文件句柄 * @param offset 偏移量 * @param orig 偏移方式 * * @note 一般手表case使用,去除互斥,设置ram里面跑 * @return 返回偏移得值 */ /* ----------------------------------------------------------------------------*/ int fseek_fast(FILE *file, int offset, int orig);// 快速seek /* --------------------------------------------------------------------------*/ /** * @brief 快速read * * @param file 文件句柄 * @param buf 读出内容放置buf * @param len 需要读出内容得长度（一般为buf长度） * * @note 一般手表case使用,去除互斥,设置ram里面跑 * @return 返回读出得长度 */ /* ----------------------------------------------------------------------------*/ int fread_fast(FILE *file, void *buf, u32 len); //快速read /* --------------------------------------------------------------------------*/ /** * @brief 获取文件长度 * * @param file 文件句柄 * * @return 当前文件长度 */ /* ----------------------------------------------------------------------------*/ int flen(FILE *file); /* --------------------------------------------------------------------------*/ /** * @brief 获取文件指针位置 * * @param file 文件句柄 * * @return 当前文件指针位置 */ /* ----------------------------------------------------------------------------*/ int fpos(FILE *file); int fcopy(const char *format, ...); /* --------------------------------------------------------------------------*/ /** * @brief 获取当前文件名称 * * @param file 文件句柄 * @param name 文件名buf * @param len 长度 * * @return 获取到的文件名长度 */ /* ----------------------------------------------------------------------------*/ int fget_name(FILE *file, u8 *name, int len); /* --------------------------------------------------------------------------*/ /** * @brief 重命名 * * @param file 文件句柄 * @param path 重命名的文件名 * * @return 0成功，非0 失败 */ /* ----------------------------------------------------------------------------*/ int frename(FILE *file, const char *path); /* --------------------------------------------------------------------------*/ /** * @brief 关闭文件 * * @param file 文件句柄 * * @return 无意义 */ /* ----------------------------------------------------------------------------*/ int fclose(FILE *file); /* --------------------------------------------------------------------------*/ /** * @brief 删除文件 * * @param file 文件句柄 * * @return 无意义 */ /* ----------------------------------------------------------------------------*/ int fdelete(FILE *file); int fdelete_by_name(const char *fname); /* --------------------------------------------------------------------------*/ /** * @brief 获取设备剩余容量 * * @param path 根路径 * @param space 剩余空间 K 为单位 * * @return 无意义 */ /* ----------------------------------------------------------------------------*/ int fget_free_space(const char *path, u32 *space); /* --------------------------------------------------------------------------*/ /** * @brief 获取当前文件相对路径和绝对路径 * * @param file 文件句柄 * @param fscan 扫描句柄 * @param name 路径buf * @param len buf长度 * @param is_relative_path 是否相对路径 * * @return 获取到的文件名长度 */ /* ----------------------------------------------------------------------------*/ int fget_path(FILE *file, struct vfscan *fscan, u8 *name, int len, u8 is_relative_path); /* arg: * -t 文件类型 * -r 包含子目录 * -d 扫描文件夹 * -a 文件属性 r: 读， /: 非 * -s 排序方式， t:按时间排序， n:按文件号排序 */ /* --------------------------------------------------------------------------*/ /** * @brief 文件扫描 * * @param path 路径 * @param arg 扫描方式 * @param max_deepth 扫描深度，最大为9 * * @return vfscan句柄 */ /* ----------------------------------------------------------------------------*/ struct vfscan *fscan(const char *path, const char *arg, u8 max_deepth); //扫描接口，参数配置如上。 /* --------------------------------------------------------------------------*/ /** * @brief 文件扫描，可打断。 * * @param path 路径 * @param arg 扫描方式 * @param max_deepth 扫描深度，最大为9 * @param callback 回调函数，用于打断、同时进行其他操作等 * * @return vfscan句柄 */ /* ----------------------------------------------------------------------------*/ struct vfscan *fscan_interrupt(const char *path, const char *arg, u8 max_deepth, int (*callback)(void)); //可打断扫描 /* --------------------------------------------------------------------------*/ /** * @brief 进入指定子目录，只扫此目录下文件信息 * * @param fs vfscan句柄 * @param path 子目录相对路径 * * @return vfscan句柄 */ /* ----------------------------------------------------------------------------*/ struct vfscan *fscan_enterdir(struct vfscan *fs, const char *path);//进入指定子目录，只扫此目录下文件信息 /* --------------------------------------------------------------------------*/ /** * @brief 返回上一层目录 * * @param fs vfscan句柄 * * @return vfscan句柄 */ /* ----------------------------------------------------------------------------*/ struct vfscan *fscan_exitdir(struct vfscan *fs); //返回上一层 /* --------------------------------------------------------------------------*/ /** * @brief 释放句柄 * * @param fs vfscan句柄 */ /* ----------------------------------------------------------------------------*/ void fscan_release(struct vfscan *fs); /* --------------------------------------------------------------------------*/ /** * @brief 选择指定文件打开 * * @param fs vfscan句柄 * @param selt_mode 按什么方式选择 (支持按簇号、序号、路径选择) * @param arg 传入选择的参数 * * @return 文件句柄 */ /* ----------------------------------------------------------------------------*/ FILE *fselect(struct vfscan *fs, int selt_mode, int arg); //选择指定文件 /* --------------------------------------------------------------------------*/ /** * @brief 检查挂载目录是否存在 * * @param dir 目录路径 * * @return 0存在 ， 1不存在 */ /* ----------------------------------------------------------------------------*/ int fdir_exist(const char *dir); //check 目录是否存在 int fdir(FILE *file, const char *arg, char *name, int len, struct fiter *iter);//暂无此接口 /* --------------------------------------------------------------------------*/ /** * @brief 获取文件属性 * * @param file 文件句柄 * @param attr 属性 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fget_attr(FILE *file, int *attr); //获取文件属性 /* --------------------------------------------------------------------------*/ /** * @brief 设置文件属性 * * @param file 文件句柄 * @param attr 属性 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fset_attr(FILE *file, int attr); //设置文件属性 /* --------------------------------------------------------------------------*/ /** * @brief 获取文件相关信息 * * @param file 文件句柄 * @param attr 记录相应信息的结构体 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fget_attrs(FILE *file, struct vfs_attr *attr);//获得文件相关信息如属性、簇号、大小等 /* --------------------------------------------------------------------------*/ /** * @brief 获取分区part * * @param path 路径 * * @return vfs_partition句柄 */ /* ----------------------------------------------------------------------------*/ struct vfs_partition *fget_partition(const char *path);//获得分区part /* --------------------------------------------------------------------------*/ /** * @brief 设置卷标 * * @param path 设备路径 * @param name 卷标名字 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fset_vol(const char *path, const char *name);//设置卷标 int fmove(FILE *file, const char *path_dst, FILE **newFile, int clr_attr, int path_len); int fcheck(FILE *file);//暂不支持 int fget_err_code(const char *path); //暂不支持 int fset_name_filter(const char *path, void *name_filter);//暂不支持 /* --------------------------------------------------------------------------*/ /** * @brief 获取文件夹信息 * * @param fs vfscan 结构句柄 * @param arg 文件夹信息结构句柄 * * @return 无意义 */ /* ----------------------------------------------------------------------------*/ int fget_folder(struct vfscan *fs, struct ffolder *arg); //获取文件夹序号和文件夹内文件数目 /* --------------------------------------------------------------------------*/ /** * @brief 设置长文件名Buf (现已不常用) * * @param fs vfscan 句柄 * @param arg buf * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fset_lfn_buf(struct vfscan *fs, void *arg);//设置长文件名buf /* --------------------------------------------------------------------------*/ /** * @brief 设置长文件夹名Buf (现已不常用) * * @param fs vfscan 句柄 * @param arg buf * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fset_ldn_buf(struct vfscan *fs, void *arg);//设置长文件夹名buf /* --------------------------------------------------------------------------*/ /** * @brief 设置后缀名过滤（现已不常用） * * @param path 根路径 * @param ext_type 后缀名 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fset_ext_type(const char *path, void *ext_type);//设置后缀类型 /* --------------------------------------------------------------------------*/ /** * @brief 文件浏览使用，打开目录 * * @param path 路径 * @param pp_file 文件句柄 * @param dir_dj 目录信息句柄 * * @return 无意义 */ /* ----------------------------------------------------------------------------*/ int fopen_dir_info(const char *path, FILE **pp_file, void *dir_dj); //打开目录 /* --------------------------------------------------------------------------*/ /** * @brief 文件浏览使用，进入目录 * * @param file 文件句柄 * @param dir_dj 目录信息句柄 * * @return 目录项总数 */ /* ----------------------------------------------------------------------------*/ int fenter_dir_info(FILE *file, void *dir_dj); //进入目录 /* --------------------------------------------------------------------------*/ /** * @brief 文件浏览使用，退出目录 * * @param file 文件句柄 * * @return 目录项总数 */ /* ----------------------------------------------------------------------------*/ int fexit_dir_info(FILE *file); //退出 /* --------------------------------------------------------------------------*/ /** * @brief 文件浏览使用，获取目录信息 * * @param file 文件句柄 * @param start_num 起始位置 * @param total_num 获取目录个数 * @param buf_info 目录信息句柄 * * @return 获取的目录数 */ /* ----------------------------------------------------------------------------*/ int fget_dir_info(FILE *file, u32 start_num, u32 total_num, void *buf_info); ////获取目录信息 /* --------------------------------------------------------------------------*/ /** * @brief 存储文件簇信息 * * @param file 文件句柄 * * @note 一般手表case使用, 用于fget_fat_outflash_addr()之前调用，节省fget_fat_outflash_addr()时间 * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fstore_clust_rang(FILE *file); /* --------------------------------------------------------------------------*/ /** * @brief 获取外置flash实际物理地址 * * @param file 文件句柄 * @param name sdfile格式文件名 * @param buf_info 存储相关信息结构buf指针 * @param buf_len buf 长度 * * @note 一般手表case使用 * @return 0表示buf不够 大于 0 表示存储多少个信息结构，其他 错误 */ /* ----------------------------------------------------------------------------*/ int fget_fat_outflash_addr(FILE *file, char *name, void *buf_info, int buf_len); //获取外置flash实际物理地址 /* --------------------------------------------------------------------------*/ /** * @brief 文件浏览使用，由歌曲名称获取歌词 * * @param file 歌曲文件句柄 * @param newFile 歌词文件句柄 * @param ext_name 后缀名称 * * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fget_file_byname_indir(FILE *file, FILE **newFile, void *ext_name); //由歌曲名称获得歌词 /* --------------------------------------------------------------------------*/ /** * @brief 获取长文件名和长文件夹名信息（现在不常使用） * * @param file 歌曲文件句柄 * @param arg 长文件相关信息结构指针 * * @note 需要先设置长文件名或者长文件夹名buf进去 * @return 0成功， 非0错误。 */ /* ----------------------------------------------------------------------------*/ int fget_disp_info(FILE *file, void *arg); //用于长文件名获取 /* --------------------------------------------------------------------------*/ /** * @brief 创建目录 * * @param path 路径 * @param folder 文件夹名称,不需要 / * @param mode 目录属性（1 设置为隐藏属性， 0 不设置 ） * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int fmk_dir(const char *path, char *folder, u8 mode); //创建目录 /* --------------------------------------------------------------------------*/ /** * @brief 获取录音文件信息(现在不常用) * * @param path 路径 * @param folder 文件夹名称 * @param ext 文件名后缀 * @param last_num 可变数字最大数字 * @param total_num 文件总数 * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int fget_encfolder_info(const char *path, char *folder, char *ext, u32 *last_num, u32 *total_num); //获取录音文件信息 /* --------------------------------------------------------------------------*/ /** * @brief 拼接字符 * * @param result 最终结果指针 * @param path 前路径指针 * @param fname 需要拼接的字符 * @param len fname长度 * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int fname_to_path(char *result, const char *path, const char *fname, int len); //把路径和文件名拼接 /* --------------------------------------------------------------------------*/ /** * @brief 截取path中根目录之后的文件名 * * @param path 路径 * * @return 文件名 */ /* ----------------------------------------------------------------------------*/ const char *fname_after_root(const char *path); // 截取path中根目录之后的文件名 /* --------------------------------------------------------------------------*/ /** * @brief 获取文件系统类型 * * @param path 路径 * * @return 文件系统类型 */ /* ----------------------------------------------------------------------------*/ const char *fget_fs_type(const char *path); // 获取文件系统类型 /* --------------------------------------------------------------------------*/ /** * @brief 录音获取最后序号 * * @return 最后序号 */ /* ----------------------------------------------------------------------------*/ int get_last_num(void); //录音获取最后序号。 /* --------------------------------------------------------------------------*/ /** * @brief 设置断点参数 * * @param clust 记录的簇号 * @param fsize 记录的文件大小 * @param flag 文件是否存在标志 * * @note 1.接口调用在扫描前 * 2.使用完需要put_bp_info对应释放buf */ /* ----------------------------------------------------------------------------*/ void set_bp_info(u32 clust, u32 fsize, u32 *flag); //扫描前设置断点参数，需要put_bp_info对应释放buf. /* --------------------------------------------------------------------------*/ /** * @brief 释放内存 */ /* ----------------------------------------------------------------------------*/ void put_bp_info(void); /* --------------------------------------------------------------------------*/ /** * @brief 优化扫盘速度 * * @param enable 开关 * @note 1.目的是是否去除获取文件夹内所有文件功能，默认enable 是1 获取数目，置0不获取，所以不需要切换文件夹操作的功能，可置0 关闭 * 2.在扫描前调用接口 */ /* ----------------------------------------------------------------------------*/ void ff_set_FileInDir_enable(u8 enable); // 优化文件打开速度，如果不需要切换文件夹的操作，可置0关闭 /* --------------------------------------------------------------------------*/ /** * @brief 设置目录项基点信息（用于加速） * * @param buf 存储基点buf (长度 12 * n) * @param n 基点数目 * @note 1.加速序号选择文件，明显效果体现在上一曲加速 * 2.注意buf使用 */ /* ----------------------------------------------------------------------------*/ void ff_set_DirBaseInfo(void *buf, u16 n); /* --------------------------------------------------------------------------*/ /** * @brief 设置文件的创建时间 * * @param year 年 * @param month 月 * @param day 日 * @param hour 小时 * @param minute 分钟 * @param second 秒 */ /* ----------------------------------------------------------------------------*/ void fat_set_datetime_info(u16 year, u8 month, u8 day, u8 hour, u8 minute, u8 second); /* --------------------------------------------------------------------------*/ /** * @brief 隐藏属性文件是否过滤 * * @param flag 置1 为过滤 */ /* ----------------------------------------------------------------------------*/ void hidden_file(u8 flag); /* --------------------------------------------------------------------------*/ /** * @brief 是否保存预申请长度 * * @param enable 1保存，0 不保存 */ /* ----------------------------------------------------------------------------*/ void fat_save_already_size_enable(char enable); /* --------------------------------------------------------------------------*/ /** * @brief 设置预申请簇数目 * * @param num 数目（1-0x1fe） */ /* ----------------------------------------------------------------------------*/ void fat_set_pre_create_chain_num(u16 num); /* --------------------------------------------------------------------------*/ /** * @brief 存储文件簇信息 * * @param file 文件句柄 * @param btr buf 长度 * @param buf buf指针 * * @note seek加速，4字节对齐 * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int fsave_fat_table(FILE *file, u16 btr, u8 *buf); /* --------------------------------------------------------------------------*/ /** * @brief 刷新文件系统缓存buf * * @param path 设备路径 * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int f_flush_wbuf(const char *path); /* --------------------------------------------------------------------------*/ /** * @brief 插入文件 * * @param file 源文件 * @param i_file 需要插入的文件 * @param fptr 源文件被插入的位置 * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int finsert_file(FILE *file, FILE *i_file, u32 fptr); /* --------------------------------------------------------------------------*/ /** * @brief 分割文件 * * @param file 源文件 * @param file_name 分割后第二个文件文件名 * @param fptr 源文件被分割位置 * * @return 0成功，非0不成功 */ /* ----------------------------------------------------------------------------*/ int fdicvision_file(FILE *file, char *file_name, u32 fptr); /* --------------------------------------------------------------------------*/ /** * @brief 长文件名切割00 00 后面的数据 * * @param str 数据buff * @param len 数据buff长度 * * @return 切割后的长度 */ /* ----------------------------------------------------------------------------*/ int long_name_fix(u8 *str, u16 len); /* --------------------------------------------------------------------------*/ /** * @brief UFT8 转换 Unicode * * @param utf8_buf UTF8编码的字符串 * @param pUniBuf short 类型Unicode字符串 * @param utf8_len utf8数据长度 * * @return 得到的unicode码大小 */ /* ----------------------------------------------------------------------------*/ int UTF82Unicode(const char *utf8_buf, u16 *pUniBuf, int utf8_len); /* --------------------------------------------------------------------------*/ /** * @brief Unicode 转 UTF8 * * * @param utf8_buf UTF8编码的字符串 * @param pUniBuf short 类型Unicode字符串 * @param uni_len unicode数据长度 * * @return 得到的UTF8码大小 */ /* ----------------------------------------------------------------------------*/ int Unicode2UTF8(char *utf8_buf, u16 *pUniBuf, int uni_len); /* --------------------------------------------------------------------------*/ /** * @brief 检查是否UTF8 码格式 * * @param str 数据buff * @param length 数据buff长度 * * @return 1:是UTF8 0:不是 */ /* ----------------------------------------------------------------------------*/ bool utf8_check(const char *str, int length); #endif /* VFS_ENABLE */ #endif /* __FS_H__ */