fatif.h

SD卡FAT文件系统

/**
 * @file $RCSfile: fatIF.h,v $
 *
 * Copyright (c) 2006 XXXXX INC., All Rights Reserved
 *
 * @author	YongJian Guo <XXX@XXX>
 *
 * @version $Revision: 1.2.0.00 $
 * @date	$Date: 2006/10/13 06:46:18 $
 * @update	$Date: 2007/01/24 14:06:17 $
 * $Header: $
**/
#ifndef __FATIF_H__
#define __FATIF_H__

typedef  void* FHANDLE;		/* file handle */

/* file mode */
#define	FIF_READ			0x01
#define	FIF_OPEN_EXISTING	0x00
#define	FIF_WRITE			0x02
#define	FIF_CREATE_ALWAYS	0x08	/* 僼傽僀儖偑懚嵼偡傞偲丂嶍彍偟偰丄怴偟偄僼傽僀儖傪怴婯偡傞丅  */
#define	FIF_OPEN_ALWAYS		0x10	/* 僼傽僀儖偑懚嵼偡傞偲丂怴偟偄僼傽僀儖傪怴婯偟側偄丅  */
#define	FIF_WRITEN			0x20
#define	FIF_DIRTY			0x40
#define	FIF_ERROR			0x80

#define FSEEK_BEGIN			0
#define FSEEK_CUR			1
#define FSEEK_END			2

#define FFS_FAT12	1
#define FFS_FAT16	2
#define FFS_FAT32	3

/* success return file handle,errer return NULL:see geterrcode() */
/* Open or create a file */
FHANDLE ff_open (const sint8* filename, uint8 mode);	

/* success return read length,errer return value not valid: see geterrcode() */
/* Read file */
uint16	ff_read (FHANDLE fh, void* buf, uint16 size);

/* success return 0,errer return errer code */
/* Close file */
uint16  ff_close (FHANDLE fh);

/* success return 0,errer return errer code */
/* Seek file pointer */
uint16  ff_lseek (FHANDLE fh, uint32 offset);

/* success return 0,errer return errer code */
/* get file pointer pos */
uint16  ff_getcurpos (FHANDLE fh, uint32* offset);

/* success return number of free clusters,errer return value not valid :see geterrcode() */
/* Get number of free clusters */
uint32	ff_getfreecluters (void);

/* success return 0,errer return errer code */
/* Force initialized the file system */
uint16	ff_initdrv (void);

/* success return write length,errer return value not valid: see geterrcode() */
/* Write file */
uint16  ff_write (FHANDLE fh, const void* buf, uint16 size);

/* success return 0,errer return errer code */
/* Flush cached data of a writing file */
uint16	ff_flush (FHANDLE fh);

/* success return 0,errer return errer code */
/* Delete a file or directory */
uint16  ff_delete (const sint8* pathname);

/* success return 0,errer return errer code */
/* Create a directory */
uint16	ff_createdir (const sint8* pathname);

/* success return 0,errer return errer code */
/* Change file attriburte */
uint16  ff_changemod (const sint8* pathname, uint8 value, uint8 mask);

/* success return 0,errer return errer code */
/* Rename a file or directory */
uint16  ff_rename (const sint8* oldname, const sint8* newname);

uint32  ff_getfilesize(FHANDLE fp);

/* get last errer code */
uint16  ff_geterrcode(void);

/* check file system  */
uint16  ff_getfilesystem(void);

/* format sd */
uint16  ff_formatfat16(void);

#endif