api32.h

ISP1362 Fat32 coldfire523x

#ifndef __APIF32_H
#define __APIF32_H

#include "Fat32.h"

/********************************** 文件及目录特征信息 ***********************************/
typedef struct _SDATE
{
	uint8  year;             /*从1980年开始的年数*/
	uint8  month;
	uint8  day;
}DATE;

typedef struct _STIME
{
	uint8  hour;
	uint8  min;
	uint8  sec;
	uint8  milsec;
}TIME;

typedef struct _SFILE_ENTRY_INFO
{
	uint32  FileSizeInByte;
  	DATE    CreateDate; /*建立日期*/
  	TIME    CreateTime; /*建立时间*/
	uint8   FileName[12];
	
}SFILE_ENTRY_INFO;

#ifdef __cplusplus
extern "C" 
{
#endif

uint8 str2Name(uint8 * nam, uint8 * str);
/**********************************函数声明**********************************************/
void pNameMake(uint8 *nam,uint8 *FileName);
   
/****************************************函数定义*****************************************/
/******************************************************************************************
** 函数：  uint8 CreateFile32(uint8 *pName, uint8 Mode, uint8 *RiliShizhong);
** 功能：  创建(打开文件)
** 参数：  pName ---- 文件名
**         Mode  ---- 打开文件方式: r-打开文件；c-新建一个文件；a-追加记录
**   	     RiliShizhong     ---- 最近一次写文件的时间
** 返回值：TRUE表示成功，FALSE失败
*/
extern uint8 CreateFile32(uint8 *pName, uint8 Mode, uint8 *RiliShizhong);

/******************************************************************************************
** 函数：  uint8 WriteFile32(uint32 writeLength,uint8 *pBuffer) ；
** 功能：  往文件里写数据
** 参数：  writeLength ---- pBuffer数据长度
**   	   pBuffer     ---- 要写入的数据，一次最多写入1024字节的数据
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
extern uint8 WriteFile32(uint32 ,uint8 *, uint8 *);

/******************************************************************************************
** 函数：  uint8 ReadFile32(uint32 readLength,uint8 *pBuffer);
** 功能：  从文件中读数据
** 参数：  readLength ---- pBuffer数据长度
**   	   pBuffer    ---- 要读出的数据，一次最多读出1024字节的数据
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
extern uint32 ReadFile32ReadFile32(uint32 pointer, uint32 readLength, uint8 *pBuffer, uint8 Mode);

/***************************************************************
** 函数：uint8 SetFilePointer32(uint32 pointer)
** 功能：设置已打开文件指针，即指定读写文件的位置。
** 参数：pointer ---- 要设置的文件指针，以字节计数
** 返回值：TRUE表示成功，FALSE失败
****************************************************************/
extern uint8 SetFilePointer32(uint32);

/******************************************************************************************
** 函数：  uint8 RemoveFile32(uint8 *str)
** 功能：  删除文件
** 参数：  str  ----  目录名，长度最大为11
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
uint8 RemoveFile32(uint8 *);

/******************************************************************************************
** 函数：  uint8 CreateDir32(uint8 *pName)；
** 功能：  建立目录
** 参数：  pName  ----  目录名，长度最大为11
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
extern uint8 CreateDir32(uint8 *, uint8 *);

/*********************************************************************************************
** 函数：  uint8 GetDirInfo32(uint8 *str,struct FILEINFO * DirInfo)
** 功能：  检查所指目录是否存在,若存在，则获取该目录的特征
** 参数：  str  ------  目录名字符串。长度最大为12，包括文件名（最长8）、点号及扩展名（最长3）
**         DirInfo  --  文件特征结构体
** 返回值：TRUE表示文件存在，FALSE文件不存在
*********************************************************************************************
uint8 GetDirInfo32(uint8 *,struct FILEINFO *); */

/******************************************************************************************
** 函数：  uint8 DownDir32(uint8 *pName)；
** 功能：  进入目录
** 参数：  pName  ----  目录名，长度最大为11
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
uint8 DownDir32(uint8 *);

/******************************************************************************************
** 函数：  uint8 UpDir32(void)；
** 功能：  回到上层目录
** 参数：  无
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
uint8 UpDir32(void);

/******************************************************************************************
** 函数：  uint8 UpRootDir32(void);
** 功能：  回到根目录
** 参数：  无
** 返回值：TRUE表示成功，FALSE失败
*******************************************************************************************/
uint8 UpRootDir32(void);

/******************************************************************************************
** 函数：  uint32 GetFreeCapacity32(void)
** 功能：  获得U盘的剩余空间（以字节为单位）。
** 参数：  无
** 返回值：字节数
*******************************************************************************************/
extern uint32 GetFreeCapacity32(void);

extern uint32 OpenFile32(uint8 *str);


#ifdef __cplusplus
}
#endif

#endif