/ FatFs - Generic FAT Filesystem module R0.15a /
/-----------------------------------------------------------------------------/
/
/ Copyright (C) 2024, ChaN, all right reserved.
/
/ FatFs module is an open source software. Redistribution and use of FatFs in
/ source and binary forms, with or without modification, are permitted provided
/ that the following condition is met:
/ 1. Redistributions of source code must retain the above copyright notice,
/ this condition and the following disclaimer.
/
/ This software is provided by the copyright holder and contributors "AS IS"
/ and any warranties related to this software are DISCLAIMED.
/ The copyright owner or contributors be NOT LIABLE for any damages caused
/ by use of this software.
/
/----------------------------------------------------------------------------*/
#ifndef FF_DEFINED
#define FF_DEFINED 5380
#ifdef __cplusplus
extern "C" {
#endif
#include <dirent.h>
#include "integer.h"
#include "ffconf.h"
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
#include "virpart.h"
#endif
#ifndef __LITEOS_M__
#include "los_list.h"
#endif
#if FF_DEFINED != FFCONF_DEF
#error Wrong configuration file (ffconf.h).
#endif
#if FF_USE_LFN == 0
#define DEF_NAMBUF
#define INIT_NAMBUF(fs)
#define FREE_NAMBUF()
#define LEAVE_MKFS(res) return res
#else
#if FF_MAX_LFN < 12 || FF_MAX_LFN > 255
#error Wrong setting of FF_MAX_LFN
#endif
#if FF_LFN_BUF < FF_SFN_BUF || FF_SFN_BUF < 12
#error Wrong setting of FF_LFN_BUF or FF_SFN_BUF
#endif
#if FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3
#error Wrong setting of FF_LFN_UNICODE
#endif
static const BYTE LfnOfs[] = {1,3,5,7,9,14,16,18,20,22,24,28,30};
#if FF_USE_LFN == 1
static WCHAR LfnBuf[FF_MAX_LFN + 1];
#define DEF_NAMBUF
#define INIT_NAMBUF(fs)
#define FREE_NAMBUF()
#define LEAVE_MKFS(res) return res
#elif FF_USE_LFN == 2
#define DEF_NAMBUF WCHAR lbuf[FF_MAX_LFN+1];
#define INIT_NAMBUF(fs) { (fs)->lfnbuf = lbuf; }
#define FREE_NAMBUF()
#define LEAVE_MKFS(res) return res
#elif FF_USE_LFN == 3
#define DEF_NAMBUF WCHAR *lfn;
#define INIT_NAMBUF(fs) { lfn = ff_memalloc((FF_MAX_LFN+1)*2); if (!lfn) LEAVE_FF(fs, FR_NOT_ENOUGH_CORE); (fs)->lfnbuf = lfn; }
#define FREE_NAMBUF() ff_memfree(lfn)
#define LEAVE_MKFS(res) { if (!work) ff_memfree(buf); return res; }
#define MAX_MALLOC 0x8000
#else
#error Wrong setting of FF_USE_LFN
#endif
#endif
#define NS_NONAME 0x80
#define NSFLAG 11
typedef struct {
BYTE di;
BYTE pd;
BYTE pt;
QWORD ps;
QWORD pc;
} PARTITION;
extern PARTITION VolToPart[];
#define LD2DI(vol) (VolToPart[vol].di)
#define LD2PD(vol) (VolToPart[vol].pd)
#if FF_MULTI_PARTITION
#define LD2PT(vol) (VolToPart[vol].pt)
#define LD2PS(vol) (VolToPart[vol].ps)
#define LD2PC(vol) (VolToPart[vol].pc)
#else
#define LD2PT(vol) 0
#define LD2PS(vol) 0
#define LD2PC(vol) 0
#endif
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
typedef struct FAT_VIRTUAL_PARTITION {
virpartinfo virtualinfo;
BOOL isparamset;
} FAT_VIR_PART;
#define ISVIRPART(fs) ((fs)->vir_avail == FS_VIRENABLE)
#define ISNORMAL(fs) ((fs)->vir_avail != FS_VIRENABLE)
#define ISPARENT(fs) ((fs)->vir_flag == FS_PARENT)
#define ISCHILD(fs) ((fs)->vir_flag != FS_PARENT)
#define VIRINFO_EXTERNAL 0
#define VIRINFO_BUILDIN 1
#endif
#ifndef _INC_TCHAR
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1
typedef WCHAR TCHAR;
#define _T(x) L ## x
#define _TEXT(x) L ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 2
typedef char TCHAR;
#define _T(x) u8 ## x
#define _TEXT(x) u8 ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 3
typedef DWORD TCHAR;
#define _T(x) U ## x
#define _TEXT(x) U ## x
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3)
#error Wrong FF_LFN_UNICODE setting
#else
typedef char TCHAR;
#define _T(x) x
#define _TEXT(x) x
#endif
#endif
#if (FF_MAX_SS == FF_MIN_SS)
#define SS(fs) ((UINT)FF_MAX_SS)
#else
#define SS(fs) ((fs)->ssize)
#endif
typedef DWORD FSIZE_t;
typedef QWORD LBA_t;
#define DIR_Name 0
#define DIR_Attr 11
#define DIR_NTres 12
#define DIR_CrtTime10 13
#define DIR_CrtTime 14
#define DIR_LstAccDate 18
#define DIR_FstClusHI 20
#define DIR_ModTime 22
#define DIR_FstClusLO 26
#define DIR_FileSize 28
#define LDIR_Ord 0
#define LDIR_Attr 11
#define LDIR_Type 12
#define LDIR_Chksum 13
#define LDIR_FstClusLO 26
#define MAX_DIR 0x200000
#define MAX_FAT12 0xFF5
#define MAX_FAT16 0xFFF5
#define MAX_FAT32 0x0FFFFFF5
#if FF_FS_NORTC == 1
#if FF_NORTC_YEAR < 1980 || FF_NORTC_YEAR > 2107 || FF_NORTC_MON < 1 || FF_NORTC_MON > 12 || FF_NORTC_MDAY < 1 || FF_NORTC_MDAY > 31
#error Invalid FF_FS_NORTC settings
#endif
#define GET_FATTIME() ((DWORD)(FF_NORTC_YEAR - 1980) << 25 | (DWORD)FF_NORTC_MON << 21 | (DWORD)FF_NORTC_MDAY << 16)
#else
#define GET_FATTIME() get_fattime()
#endif
extern UINT time_status;
typedef struct {
BYTE fs_type;
BYTE pdrv;
BYTE n_fats;
BYTE wflag;
BYTE fsi_flag;
WORD id;
WORD n_rootdir;
WORD csize;
#if FF_MAX_SS != FF_MIN_SS
size_t ssize;
#endif
#if FF_USE_LFN
WCHAR* lfnbuf;
#endif
#if FF_FS_REENTRANT
FF_SYNC_t sobj;
#endif
#if !FF_FS_READONLY
DWORD last_clst;
DWORD free_clst;
#endif
#if FF_FS_RPATH
DWORD cdir;
#endif
DWORD n_fatent;
DWORD fsize;
LBA_t volbase;
LBA_t fatbase;
LBA_t dirbase;
LBA_t database;
LBA_t winsect;
BYTE* win;
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
DWORD st_clst;
DWORD ct_clst;
BYTE vir_flag;
BYTE vir_avail;
DWORD vir_amount;
VOID* parent_fs;
CHAR namelabel[_MAX_ENTRYLENGTH + 1];
VOID** child_fs;
#endif
#ifndef __LITEOS_M__
int fs_uid;
int fs_gid;
mode_t fs_mode;
#endif
unsigned short fs_dmask;
unsigned short fs_fmask;
} FATFS;
typedef struct {
FATFS* fs;
WORD id;
BYTE attr;
BYTE stat;
DWORD sclust;
FSIZE_t objsize;
#if FF_FS_LOCK
UINT lockid;
#endif
} FFOBJID;
typedef struct {
FFOBJID obj;
BYTE flag;
BYTE err;
FSIZE_t fptr;
DWORD clust;
LBA_t sect;
#if !FF_FS_READONLY
LBA_t dir_sect;
BYTE* dir_ptr;
#endif
#if FF_USE_FASTSEEK
DWORD* cltbl;
#endif
#if !FF_FS_TINY
BYTE* buf;
#endif
#ifndef __LITEOS_M__
LOS_DL_LIST fp_entry;
#endif
} FIL;
struct __dirstream {
FFOBJID obj;
DWORD dptr;
DWORD clust;
LBA_t sect;
BYTE* dir;
BYTE fn[12];
#if FF_USE_LFN
DWORD blk_ofs;
#endif
#if FF_USE_FIND
const TCHAR* pat;
#endif
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
BYTE atrootdir;
#endif
};
typedef struct {
FSIZE_t fsize;
WORD fdate;
WORD ftime;
BYTE fattrib;
#if FF_USE_LFN
TCHAR altname[FF_SFN_BUF + 1];
TCHAR fname[FF_LFN_BUF + 1];
#else
TCHAR fname[12 + 1];
#endif
DWORD sclst;
#ifndef __LITEOS_M__
LOS_DL_LIST fp_list;
#endif
} FILINFO;
#ifndef __LITEOS_M__
typedef struct {
DWORD clst;
FSIZE_t pos;
} FAT_ENTRY;
#endif
typedef struct {
BYTE fmt;
BYTE n_fat;
UINT align;
UINT n_root;
int n_sect;
} MKFS_PARM;
typedef struct {
DIR f_dir;
FILINFO fno;
#ifndef __LITEOS_M__
FAT_ENTRY fat_entry;
#endif
} DIR_FILE;
typedef enum {
FR_OK = 0,
FR_DISK_ERR,
FR_INT_ERR,
FR_NOT_READY,
FR_NO_FILE,
FR_NO_PATH,
FR_INVALID_NAME,
FR_DENIED,
FR_EXIST,
FR_INVALID_OBJECT,
FR_WRITE_PROTECTED,
FR_INVALID_DRIVE,
FR_NOT_ENABLED,
FR_NO_FILESYSTEM,
FR_MKFS_ABORTED,
FR_TIMEOUT,
FR_LOCKED,
FR_NOT_ENOUGH_CORE,
FR_TOO_MANY_OPEN_FILES,
FR_INVALID_PARAMETER,
FR_NO_SPACE_LEFT,
FR_NO_DIRENTRY,
FR_NO_EMPTY_DIR,
FR_IS_DIR,
FR_NO_DIR,
FR_NO_EPERM,
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
FR_MODIFIED,
FR_CHAIN_ERR,
FR_INVAILD_FATFS,
FR_NOVIRPART,
FR_OCCUPIED,
FR_NOTCLEAR,
FR_NOTFIT,
#endif
} FRESULT;
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
FATFS* f_getfatfs (int vol);
FRESULT f_scanfat (FATFS* fs);
FRESULT f_boundary (FATFS *fs, DWORD clust);
FRESULT f_disvirfs (FATFS* fs);
FRESULT f_unregvirfs (FATFS* fs);
FRESULT f_regvirfs (FATFS* fs);
FRESULT f_checkvirpart (FATFS* fs, const TCHAR* path, BYTE vol);
FRESULT f_makevirpart (FATFS* fs, const TCHAR* path, BYTE vol);
FRESULT f_getvirfree (const TCHAR* path, DWORD* nclst, DWORD* cclst);
FRESULT f_checkname (const TCHAR* path);
#endif
FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode);
FRESULT f_close (FIL* fp);
FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br);
FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw);
FRESULT f_lseek (FIL* fp, FSIZE_t ofs);
FRESULT f_truncate (FIL* fp, FSIZE_t length);
FRESULT f_sync (FIL* fp);
FRESULT f_opendir (DIR* dp, const TCHAR* path);
FRESULT f_closedir (DIR* dp);
FRESULT f_readdir (DIR* dp, FILINFO* fno);
FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern);
FRESULT f_findnext (DIR* dp, FILINFO* fno);
FRESULT f_mkdir (const TCHAR* path);
FRESULT f_unlink (const TCHAR* path);
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new);
FRESULT f_stat (const TCHAR* path, FILINFO* fno);
FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask);
FRESULT f_utime (const TCHAR* path, const FILINFO* fno);
FRESULT f_chdir (const TCHAR* path);
FRESULT f_chdrive (const TCHAR* path);
FRESULT f_getcwd (TCHAR* buff, UINT len);
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs);
FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn);
FRESULT f_setlabel (const TCHAR* label);
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf);
FRESULT f_expand (FIL* fp, FSIZE_t offset, FSIZE_t fsz, int opt);
FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt);
FRESULT f_mkfs (const TCHAR* path, const MKFS_PARM* opt, void* work, UINT len);
FRESULT f_fdisk (BYTE pdrv, const DWORD szt[], void* work);
FRESULT f_setcp (WORD cp);
int f_putc (TCHAR c, FIL* fp);
int f_puts (const TCHAR* str, FIL* cp);
int f_printf (FIL* fp, const TCHAR* str, ...);
TCHAR* f_gets (TCHAR* buff, int len, FIL* fp);
void f_clean (const TCHAR* path);
void f_settimestatus (UINT status);
FRESULT f_fcheckfat (DIR_FILE* dir_info);
FRESULT f_getclustinfo (FIL* fp, DWORD* fclust, DWORD* fcount);
FRESULT f_checkopenlock(int index);
FRESULT sync_fs (FATFS* fs);
FRESULT sync_window(FATFS *fs);
FRESULT move_window (FATFS* fs, QWORD sector);
FRESULT fat_count_free_entries(DWORD *nclst, FATFS *fs);
void get_fileinfo (DIR* dp, FILINFO* fno);
DWORD get_fat (FFOBJID *obj, DWORD clst);
FRESULT put_fat(FATFS *fs, DWORD clst, DWORD val);
FRESULT mount_volume (const TCHAR **path, FATFS **rfs, BYTE mode);
QWORD clst2sect (FATFS* fs, DWORD clst );
DWORD ld_clust(FATFS *fs, const BYTE *dir);
void st_clust(FATFS *fs, BYTE *dir, DWORD cl);
DWORD ld_dword (const BYTE *ptr);
WORD ld_word (const BYTE *ptr);
void st_dword (BYTE *ptr, DWORD val);
void st_word (BYTE *ptr, WORD val);
FRESULT create_name (DIR *dp, const TCHAR **path);
int lock_fs (FATFS *fs);
UINT check_fs(FATFS *fs, QWORD sect);
UINT inc_lock(DIR* dp, int acc);
void unlock_fs (FATFS *fs, FRESULT res);
FRESULT dir_sdi (DIR *dp, DWORD ofs);
FRESULT dir_find(DIR *dp);
FRESULT dir_read(DIR *dp, int vol);
#ifndef __LITEOS_M__
FRESULT dir_read_massive(DIR *dp, int vol);
#endif
FRESULT dir_remove(DIR *dp);
FRESULT dir_next(DIR *dp, int stretch);
DWORD dir_ofs(DIR* dp);
FRESULT dir_register(DIR *dp);
DWORD create_chain (FFOBJID* obj, DWORD clst);
FRESULT remove_chain (FFOBJID* obj, DWORD clst, DWORD pclst);
void mem_set (void* dst, int val, UINT cnt);
void mem_cpy (void* dst, const void* src, UINT cnt);
int fatfs_get_vol (FATFS *fat);
FRESULT set_volumn_label(FATFS *fs, const TCHAR *label);
#define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize))
#define f_error(fp) ((fp)->err)
#define f_tell(fp) ((fp)->fptr)
#define f_size(fp) ((fp)->obj.objsize)
#define f_rewind(fp) f_lseek((fp), 0)
#define f_rewinddir(dp) f_readdir((dp), 0)
#define f_rmdir(path) f_unlink(path)
#define f_unmount(path) f_mount(0, path, 0)
#if !FF_FS_READONLY && !FF_FS_NORTC
DWORD get_fattime (void);
#endif
#if FF_USE_LFN >= 1
WCHAR ff_oem2uni (WCHAR oem, WORD cp);
WCHAR ff_uni2oem (DWORD uni, WORD cp);
DWORD ff_wtoupper (DWORD uni);
#endif
void* ff_memalloc (UINT msize);
void ff_memfree (void* mblock);
#ifndef __LITEOS_M__
int ff_strnlen(const void *str, size_t maxlen);
#endif
#if FF_FS_REENTRANT
int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj);
int ff_req_grant (FF_SYNC_t* sobj);
void ff_rel_grant (FF_SYNC_t* sobj);
int ff_del_syncobj (FF_SYNC_t* sobj);
#endif
#define FA_READ 0x01
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00
#define FA_CREATE_NEW 0x04
#define FA_CREATE_ALWAYS 0x08
#define FA_OPEN_ALWAYS 0x10
#define FA_OPEN_APPEND 0x30
#define CREATE_LINKMAP ((FSIZE_t)0 - 1)
#define FM_FAT 0x01
#define FM_FAT32 0x02
#define FM_ANY 0x07
#define FM_SFD 0x08
#define SYSTEM_TIME_ENABLE 0x01
#define SYSTEM_TIME_DISABLE 0x00
#define FS_FAT12 1
#define FS_FAT16 2
#define FS_FAT32 3
#define AM_RDO 0x01
#define AM_HID 0x02
#define AM_SYS 0x04
#define AM_DIR 0x10
#define AM_ARC 0x20
#define AM_LNK 0x80
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
#define FS_PARENT 0x00
#define FS_CHILD 0x01
#define FS_VIRENABLE 0x01
#define FS_VIRDISABLE 0x00
#define PARENTFS(fs) ((FATFS*)((fs)->parent_fs))
#define CHILDFS(fs, i) ((FATFS*)(*((fs)->child_fs + (i))))
#endif
#ifdef LOSCFG_FS_FAT_VIRTUAL_PARTITION
#define VR_ITEMSIZE 0x20
#define VR_GLOBAL 0x00
#define VR_PartitionCnt 0x00
#define VR_PartitionFSType 0x01
#define VR_PartitionStSec 0x02
#define VR_PartitionCtSec 0x06
#define VR_PartitionClstSz 0x0A
#define VR_PartitionCtClst 0x0C
#define VR_PARTITION 0x20
#define VR_Available 0x00
#define VR_StartClust 0x01
#define VR_CountClust 0x05
#define VR_Entry 0x10
#define VR_VertifyString 0x1FC
#endif
#ifdef __cplusplus
}
#endif
#endif