#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