ff.c File Reference

#include "ff.h"
#include "disk/diskio.h"

Include dependency graph for ff.c:

Macros
#define	ENTER_FF(fs)   { if (!lock_fs(fs)) return FR_TIMEOUT; }
#define	LEAVE_FF(fs, res)   { unlock_fs(fs, res); return res; }
#define	ABORT(fs, res)   { fp->err = (BYTE)(res); LEAVE_FF(fs, res); }
#define	SS(fs)   ((UINT)_MAX_SS) /* Fixed sector size */
#define	_DF1S   0
#define	_EXCVT
#define	IsUpper(c)   (((c)>='A')&&((c)<='Z'))
#define	IsLower(c)   (((c)>='a')&&((c)<='z'))
#define	IsDigit(c)   (((c)>='0')&&((c)<='9'))
#define	IsDBCS1(c)   0
#define	IsDBCS2(c)   0
#define	NS   11 /* Index of name status byte in fn[] */
#define	NS_LOSS   0x01 /* Out of 8.3 format */
#define	NS_LFN   0x02 /* Force to create LFN entry */
#define	NS_LAST   0x04 /* Last segment */
#define	NS_BODY   0x08 /* Lower case flag (body) */
#define	NS_EXT   0x10 /* Lower case flag (ext) */
#define	NS_DOT   0x20 /* Dot entry */
#define	MIN_FAT16   4086U /* Minimum number of clusters for FAT16 */
#define	MIN_FAT32   65526U /* Minimum number of clusters for FAT32 */
#define	BS_jmpBoot   0 /* Jump instruction (3) */
#define	BS_OEMName   3 /* OEM name (8) */
#define	BPB_BytsPerSec   11 /* Sector size [byte] (2) */
#define	BPB_SecPerClus   13 /* Cluster size [sector] (1) */
#define	BPB_RsvdSecCnt   14 /* Size of reserved area [sector] (2) */
#define	BPB_NumFATs   16 /* Number of FAT copies (1) */
#define	BPB_RootEntCnt   17 /* Number of root directory entries for FAT12/16 (2) */
#define	BPB_TotSec16   19 /* Volume size [sector] (2) */
#define	BPB_Media   21 /* Media descriptor (1) */
#define	BPB_FATSz16   22 /* FAT size [sector] (2) */
#define	BPB_SecPerTrk   24 /* Track size [sector] (2) */
#define	BPB_NumHeads   26 /* Number of heads (2) */
#define	BPB_HiddSec   28 /* Number of special hidden sectors (4) */
#define	BPB_TotSec32   32 /* Volume size [sector] (4) */
#define	BS_DrvNum   36 /* Physical drive number (2) */
#define	BS_BootSig   38 /* Extended boot signature (1) */
#define	BS_VolID   39 /* Volume serial number (4) */
#define	BS_VolLab   43 /* Volume label (8) */
#define	BS_FilSysType   54 /* File system type (1) */
#define	BPB_FATSz32   36 /* FAT size [sector] (4) */
#define	BPB_ExtFlags   40 /* Extended flags (2) */
#define	BPB_FSVer   42 /* File system version (2) */
#define	BPB_RootClus   44 /* Root directory first cluster (4) */
#define	BPB_FSInfo   48 /* Offset of FSINFO sector (2) */
#define	BPB_BkBootSec   50 /* Offset of backup boot sector (2) */
#define	BS_DrvNum32   64 /* Physical drive number (2) */
#define	BS_BootSig32   66 /* Extended boot signature (1) */
#define	BS_VolID32   67 /* Volume serial number (4) */
#define	BS_VolLab32   71 /* Volume label (8) */
#define	BS_FilSysType32   82 /* File system type (1) */
#define	FSI_LeadSig   0 /* FSI: Leading signature (4) */
#define	FSI_StrucSig   484 /* FSI: Structure signature (4) */
#define	FSI_Free_Count   488 /* FSI: Number of free clusters (4) */
#define	FSI_Nxt_Free   492 /* FSI: Last allocated cluster (4) */
#define	MBR_Table   446 /* MBR: Partition table offset (2) */
#define	SZ_PTE   16 /* MBR: Size of a partition table entry */
#define	BS_55AA   510 /* Signature word (2) */
#define	DIR_Name   0 /* Short file name (11) */
#define	DIR_Attr   11 /* Attribute (1) */
#define	DIR_NTres   12 /* NT flag (1) */
#define	DIR_CrtTimeTenth   13 /* Created time sub-second (1) */
#define	DIR_CrtTime   14 /* Created time (2) */
#define	DIR_CrtDate   16 /* Created date (2) */
#define	DIR_LstAccDate   18 /* Last accessed date (2) */
#define	DIR_FstClusHI   20 /* Higher 16-bit of first cluster (2) */
#define	DIR_WrtTime   22 /* Modified time (2) */
#define	DIR_WrtDate   24 /* Modified date (2) */
#define	DIR_FstClusLO   26 /* Lower 16-bit of first cluster (2) */
#define	DIR_FileSize   28 /* File size (4) */
#define	LDIR_Ord   0 /* LFN entry order and LLE flag (1) */
#define	LDIR_Attr   11 /* LFN attribute (1) */
#define	LDIR_Type   12 /* LFN type (1) */
#define	LDIR_Chksum   13 /* Sum of corresponding SFN entry */
#define	LDIR_FstClusLO   26 /* Filled by zero (0) */
#define	SZ_DIR   32 /* Size of a directory entry */
#define	LLE   0x40 /* Last long entry flag in LDIR_Ord */
#define	DDE   0xE5 /* Deleted directory entry mark in DIR_Name[0] */
#define	NDDE   0x05 /* Replacement of the character collides with DDE */
#define	DEF_NAMEBUF   BYTE sfn[12]; WCHAR lbuf[_MAX_LFN+1]
#define	INIT_BUF(dobj)   { (dobj).fn = sfn; (dobj).lfn = lbuf; }
#define	FREE_BUF()
#define	N_ROOTDIR   512 /* Number of root directory entries for FAT12/16 */
#define	N_FATS   1 /* Number of FAT copies (1 or 2) */

Functions
DWORD	clust2sect (FATFS *fs, DWORD clst)
DWORD	get_fat (FATFS *fs, DWORD clst)
FRESULT	put_fat (FATFS *fs, DWORD clst, DWORD val)
FRESULT	f_mount (FATFS *fs, const TCHAR *path, BYTE opt)
FRESULT	f_open (FIL *fp, const TCHAR *path, BYTE mode)
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_sync (FIL *fp)
FRESULT	f_close (FIL *fp)
FRESULT	f_lseek (FIL *fp, DWORD ofs)
FRESULT	f_opendir (DIR *dp, const TCHAR *path)
FRESULT	f_closedir (DIR *dp)
FRESULT	f_readdir (DIR *dp, FILINFO *fno)
FRESULT	f_stat (const TCHAR *path, FILINFO *fno)
FRESULT	f_getfree (const TCHAR *path, DWORD *nclst, FATFS **fatfs)
FRESULT	f_truncate (FIL *fp)
FRESULT	f_unlink (const TCHAR *path)
FRESULT	f_mkdir (const TCHAR *path)
FRESULT	f_chmod (const TCHAR *path, BYTE value, BYTE mask)
FRESULT	f_utime (const TCHAR *path, const FILINFO *fno)
FRESULT	f_rename (const TCHAR *path_old, const TCHAR *path_new)
FRESULT	f_mkfs (const TCHAR *path, BYTE sfd, UINT au)

Macro Definition Documentation

#define _DF1S   0

#define _EXCVT

Value:

{0x80,0x9A,0x90,0x41,0x8E,0x41,0x8F,0x80,0x45,0x45,0x45,0x49,0x49,0x49,0x8E,0x8F,0x90,0x92,0x92,0x4F,0x99,0x4F,0x55,0x55,0x59,0x99,0x9A,0x9B,0x9C,0x9D,0x9E,0x9F, \
                0x41,0x49,0x4F,0x55,0xA5,0xA5,0xA6,0xA7,0xA8,0xA9,0xAA,0xAB,0xAC,0x21,0xAE,0xAF,0xB0,0xB1,0xB2,0xB3,0xB4,0xB5,0xB6,0xB7,0xB8,0xB9,0xBA,0xBB,0xBC,0xBD,0xBE,0xBF, \
                0xC0,0xC1,0xC2,0xC3,0xC4,0xC5,0xC6,0xC7,0xC8,0xC9,0xCA,0xCB,0xCC,0xCD,0xCE,0xCF,0xD0,0xD1,0xD2,0xD3,0xD4,0xD5,0xD6,0xD7,0xD8,0xD9,0xDA,0xDB,0xDC,0xDD,0xDE,0xDF, \
                0xE0,0xE1,0xE2,0xE3,0xE4,0xE5,0xE6,0xE7,0xE8,0xE9,0xEA,0xEB,0xEC,0xED,0xEE,0xEF,0xF0,0xF1,0xF2,0xF3,0xF4,0xF5,0xF6,0xF7,0xF8,0xF9,0xFA,0xFB,0xFC,0xFD,0xFE,0xFF}

#define ABORT	(		fs,
			res
	)		{ fp->err = (BYTE)(res); LEAVE_FF(fs, res); }

#define BPB_BkBootSec   50 /* Offset of backup boot sector (2) */

#define BPB_BytsPerSec   11 /* Sector size [byte] (2) */

#define BPB_ExtFlags   40 /* Extended flags (2) */

#define BPB_FATSz16   22 /* FAT size [sector] (2) */

#define BPB_FATSz32   36 /* FAT size [sector] (4) */

#define BPB_FSInfo   48 /* Offset of FSINFO sector (2) */

#define BPB_FSVer   42 /* File system version (2) */

#define BPB_HiddSec   28 /* Number of special hidden sectors (4) */

#define BPB_Media   21 /* Media descriptor (1) */

#define BPB_NumFATs   16 /* Number of FAT copies (1) */

#define BPB_NumHeads   26 /* Number of heads (2) */

#define BPB_RootClus   44 /* Root directory first cluster (4) */

#define BPB_RootEntCnt   17 /* Number of root directory entries for FAT12/16 (2) */

#define BPB_RsvdSecCnt   14 /* Size of reserved area [sector] (2) */

#define BPB_SecPerClus   13 /* Cluster size [sector] (1) */

#define BPB_SecPerTrk   24 /* Track size [sector] (2) */

#define BPB_TotSec16   19 /* Volume size [sector] (2) */

#define BPB_TotSec32   32 /* Volume size [sector] (4) */

#define BS_55AA   510 /* Signature word (2) */

#define BS_BootSig   38 /* Extended boot signature (1) */

#define BS_BootSig32   66 /* Extended boot signature (1) */

#define BS_DrvNum   36 /* Physical drive number (2) */

#define BS_DrvNum32   64 /* Physical drive number (2) */

#define BS_FilSysType   54 /* File system type (1) */

#define BS_FilSysType32   82 /* File system type (1) */

#define BS_jmpBoot   0 /* Jump instruction (3) */

#define BS_OEMName   3 /* OEM name (8) */

#define BS_VolID   39 /* Volume serial number (4) */

#define BS_VolID32   67 /* Volume serial number (4) */

#define BS_VolLab   43 /* Volume label (8) */

#define BS_VolLab32   71 /* Volume label (8) */

#define DDE   0xE5 /* Deleted directory entry mark in DIR_Name[0] */

#define DEF_NAMEBUF   BYTE sfn[12]; WCHAR lbuf[_MAX_LFN+1]

#define DIR_Attr   11 /* Attribute (1) */

#define DIR_CrtDate   16 /* Created date (2) */

#define DIR_CrtTime   14 /* Created time (2) */

#define DIR_CrtTimeTenth   13 /* Created time sub-second (1) */

#define DIR_FileSize   28 /* File size (4) */

#define DIR_FstClusHI   20 /* Higher 16-bit of first cluster (2) */

#define DIR_FstClusLO   26 /* Lower 16-bit of first cluster (2) */

#define DIR_LstAccDate   18 /* Last accessed date (2) */

#define DIR_Name   0 /* Short file name (11) */

#define DIR_NTres   12 /* NT flag (1) */

#define DIR_WrtDate   24 /* Modified date (2) */

#define DIR_WrtTime   22 /* Modified time (2) */

#define ENTER_FF

(

fs

)

{ if (!lock_fs(fs)) return FR_TIMEOUT; }

#define FREE_BUF

(

)

#define FSI_Free_Count   488 /* FSI: Number of free clusters (4) */

#define FSI_LeadSig   0 /* FSI: Leading signature (4) */

#define FSI_Nxt_Free   492 /* FSI: Last allocated cluster (4) */

#define FSI_StrucSig   484 /* FSI: Structure signature (4) */

#define INIT_BUF

(

dobj

)

{ (dobj).fn = sfn; (dobj).lfn = lbuf; }

#define IsDBCS1

(

c

)

0

#define IsDBCS2

(

c

)

0

#define IsDigit

(

c

)

(((c)>='0')&&((c)<='9'))

#define IsLower

(

c

)

(((c)>='a')&&((c)<='z'))

#define IsUpper

(

c

)

(((c)>='A')&&((c)<='Z'))

#define LDIR_Attr   11 /* LFN attribute (1) */

#define LDIR_Chksum   13 /* Sum of corresponding SFN entry */

#define LDIR_FstClusLO   26 /* Filled by zero (0) */

#define LDIR_Ord   0 /* LFN entry order and LLE flag (1) */

#define LDIR_Type   12 /* LFN type (1) */

#define LEAVE_FF	(		fs,
			res
	)		{ unlock_fs(fs, res); return res; }

#define LLE   0x40 /* Last long entry flag in LDIR_Ord */

#define MBR_Table   446 /* MBR: Partition table offset (2) */

#define MIN_FAT16   4086U /* Minimum number of clusters for FAT16 */

#define MIN_FAT32   65526U /* Minimum number of clusters for FAT32 */

#define N_FATS   1 /* Number of FAT copies (1 or 2) */

#define N_ROOTDIR   512 /* Number of root directory entries for FAT12/16 */

#define NDDE   0x05 /* Replacement of the character collides with DDE */

#define NS   11 /* Index of name status byte in fn[] */

#define NS_BODY   0x08 /* Lower case flag (body) */

#define NS_DOT   0x20 /* Dot entry */

#define NS_EXT   0x10 /* Lower case flag (ext) */

#define NS_LAST   0x04 /* Last segment */

#define NS_LFN   0x02 /* Force to create LFN entry */

#define NS_LOSS   0x01 /* Out of 8.3 format */

#define SS

(

fs

)

((UINT)_MAX_SS) /* Fixed sector size */

#define SZ_DIR   32 /* Size of a directory entry */

#define SZ_PTE   16 /* MBR: Size of a partition table entry */

Function Documentation

DWORD clust2sect	(	FATFS *	fs,
		DWORD	clst
	)

FRESULT f_chmod	(	const TCHAR *	path,
		BYTE	value,
		BYTE	mask
	)

FRESULT f_close

(

FIL *

fp

)

FRESULT f_closedir

(

DIR *

dp

)

FRESULT f_getfree	(	const TCHAR *	path,
		DWORD *	nclst,
		FATFS **	fatfs
	)

FRESULT f_lseek	(	FIL *	fp,
		DWORD	ofs
	)

FRESULT f_mkdir

(

const TCHAR *

path

)

FRESULT f_mkfs	(	const TCHAR *	path,
		BYTE	sfd,
		UINT	au
	)

FRESULT f_mount	(	FATFS *	fs,
		const TCHAR *	path,
		BYTE	opt
	)

FRESULT f_open	(	FIL *	fp,
		const TCHAR *	path,
		BYTE	mode
	)

FRESULT f_opendir	(	DIR *	dp,
		const TCHAR *	path
	)

FRESULT f_read	(	FIL *	fp,
		void *	buff,
		UINT	btr,
		UINT *	br
	)

FRESULT f_readdir	(	DIR *	dp,
		FILINFO *	fno
	)

FRESULT f_rename	(	const TCHAR *	path_old,
		const TCHAR *	path_new
	)

FRESULT f_stat	(	const TCHAR *	path,
		FILINFO *	fno
	)

FRESULT f_sync

(

FIL *

fp

)

FRESULT f_truncate

(

FIL *

fp

)

FRESULT f_unlink

(

const TCHAR *

path

)

FRESULT f_utime	(	const TCHAR *	path,
		const FILINFO *	fno
	)

FRESULT f_write	(	FIL *	fp,
		const void *	buff,
		UINT	btw,
		UINT *	bw
	)

DWORD get_fat	(	FATFS *	fs,
		DWORD	clst
	)

FRESULT put_fat	(	FATFS *	fs,
		DWORD	clst,
		DWORD	val
	)