struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤(pán)符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名...,結(jié)束符00H], 其中盤(pán)符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Create;							/* CMD_FileCreate, 新建文件并打開(kāi),如果文件已經(jīng)存在則先刪除后再新建 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤(pán)符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名...,結(jié)束符00H], 其中盤(pán)符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Erase;							/* CMD_FileErase, 刪除文件并關(guān)閉 */
	struct {
		UINT32	mFileSize;				/* 輸入?yún)?shù): 新的文件長(zhǎng)度,為0FFFFFFFFH則不修改, 返回: 原長(zhǎng)度 */
		UINT16	mFileDate;				/* 輸入?yún)?shù): 新的文件日期,為0FFFFH則不修改, 返回: 原日期 */
		UINT16	mFileTime;				/* 輸入?yún)?shù): 新的文件時(shí)間,為0FFFFH則不修改, 返回: 原時(shí)間 */
		UINT8	mFileAttr;				/* 輸入?yún)?shù): 新的文件屬性,為0FFH則不修改, 返回: 原屬性 */
	} Modify;							/* CMD_FileQuery, 查詢當(dāng)前文件的信息; CMD_FileModify, 查詢或者修改當(dāng)前文件的信息 */
	struct {
		UINT32	mSectorOffset;			/* 輸入?yún)?shù): 扇區(qū)偏移,0則移動(dòng)到文件頭,0FFFFFFFFH則移動(dòng)到文件尾, 返回: 當(dāng)前文件指針對(duì)應(yīng)的絕對(duì)線性扇區(qū)號(hào), 0FFFFFFFFH則已到文件尾 */
	} Locate;							/* CMD_FileLocate, 移動(dòng)當(dāng)前文件指針 */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 讀取扇區(qū)數(shù), 返回: 實(shí)際讀取扇區(qū)數(shù) */
	} Read;								/* CMD_FileRead, 從當(dāng)前文件讀取數(shù)據(jù) */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 寫(xiě)入扇區(qū)數(shù), 返回: 實(shí)際寫(xiě)入扇區(qū)數(shù) */
	} Write;							/* CMD_FileWrite, 向當(dāng)前文件寫(xiě)入數(shù)據(jù) */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 讀取扇區(qū)數(shù), 返回: 實(shí)際讀取扇區(qū)數(shù) */
		UINT8	mReserved[7];
		PUINT8	mDataBuffer;			/* 輸入?yún)?shù): 緩沖區(qū)起始地址, 返回: 緩沖區(qū)當(dāng)前地址 */
	} ReadX;							/* CMD_FileReadX, 從當(dāng)前文件讀取數(shù)據(jù)到指定緩沖區(qū) */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 寫(xiě)入扇區(qū)數(shù), 返回: 實(shí)際寫(xiě)入扇區(qū)數(shù) */
		UINT8	mReserved[7];
		PUINT8	mDataBuffer;			/* 輸入?yún)?shù): 緩沖區(qū)起始地址, 返回: 緩沖區(qū)當(dāng)前地址 */
	} WriteX;							/* CMD_FileWriteX, 向當(dāng)前文件寫(xiě)入指定緩沖區(qū)的數(shù)據(jù) */
	struct {
		UINT32	mDiskSizeSec;			/* 返回: 整個(gè)物理磁盤(pán)的總扇區(qū)數(shù) */
	} DiskSize;							/* CMD_DiskSize, 查詢磁盤(pán)容量 */
	struct {
		UINT32	mByteOffset;			/* 輸入?yún)?shù): 以字節(jié)為單位的偏移量, 以字節(jié)為單位的文件指針, 返回: 當(dāng)前文件指針對(duì)應(yīng)的絕對(duì)線性扇區(qū)號(hào), 0FFFFFFFFH則已到文件尾 */
	} ByteLocate;						/* CMD_ByteLocate, 以字節(jié)為單位移動(dòng)當(dāng)前文件指針 */
	struct {
		UINT8	mByteCount;				/* 輸入?yún)?shù): 準(zhǔn)備讀取的字節(jié)數(shù),不得大于MAX_BYTE_IO, 返回: 實(shí)際讀出的字節(jié)數(shù) */
		UINT8	mByteBuffer[ MAX_BYTE_IO ];	/* 返回: 讀出的數(shù)據(jù)塊 */
	} ByteRead;							/* CMD_ByteRead, 以字節(jié)為單位從當(dāng)前文件讀取數(shù)據(jù)塊 */
	struct {
		UINT8	mByteCount;				/* 輸入?yún)?shù): 準(zhǔn)備寫(xiě)入的字節(jié)數(shù),不得大于MAX_BYTE_IO, 返回: 實(shí)際寫(xiě)入的字節(jié)數(shù) */
		UINT8	mByteBuffer[ MAX_BYTE_IO ];	/* 輸入?yún)?shù): 準(zhǔn)備寫(xiě)入的數(shù)據(jù)塊 */
	} ByteWrite;						/* CMD_ByteWrite, 以字節(jié)為單位向當(dāng)前文件寫(xiě)入數(shù)據(jù)塊 */
	struct {
		UINT8	mSaveVariable;			/* 輸入?yún)?shù): 為0則恢復(fù)變量,非0值則備份/保存變量 */
		UINT8	mReserved[3];
		PUINT8	mBuffer;				/* 輸入?yún)?shù): 指向子程序庫(kù)的變量的備份緩沖區(qū),長(zhǎng)度不小于80個(gè)字節(jié) */
	} SaveVariable;						/* CMD_SaveVariable, 備份/保存/恢復(fù)子程序庫(kù)的變量 */
	union {
		struct {
			UINT32	mCBW_Sig;
			UINT32	mCBW_Tag;
			UINT8	mCBW_DataLen;		/* 輸入: 數(shù)據(jù)傳輸長(zhǎng)度,有效值是0到255 */
			UINT8	mCBW_DataLen1;
			UINT8	mCBW_DataLen2;
			UINT8	mCBW_DataLen3;
			UINT8	mCBW_Flag;			/* 輸入: 傳輸方向等標(biāo)志 */
			UINT8	mCBW_LUN;
			UINT8	mCBW_CB_Len;		/* 輸入: 命令塊的長(zhǎng)度,有效值是1到16 */
			UINT8	mCBW_CB_Buf[6];		/* 輸入: 命令塊,該緩沖區(qū)最多為16個(gè)字節(jié) */
		} mCBW;							/* BulkOnly協(xié)議的命令塊, 輸入CBW結(jié)構(gòu) */
		struct {
			UINT32	mCSW_Sig;
			UINT32	mCSW_Tag;
			UINT32	mCSW_Residue;		/* 返回: 剩余數(shù)據(jù)長(zhǎng)度 */
			UINT8	mCSW_Status;		/* 返回: 命令執(zhí)行結(jié)果狀態(tài) */
			UINT8	mReserved;
		} mCSW;							/* BulkOnly協(xié)議的命令狀態(tài)塊, 輸出CSW結(jié)構(gòu) */
	} BOC;								/* CMD_BulkOnlyCmd, 執(zhí)行基于BulkOnly協(xié)議的命令, 如果有數(shù)據(jù)傳輸那么數(shù)據(jù)在DISK_BASE_BUF中 */
} CMD_PARAM;

typedef CMD_PARAM CMD_PARAM_I;
typedef CMD_PARAM *P_CMD_PARAM;

/* FILE: CH375HF?.C */

#define EN_DISK_WRITE			1
#define EN_DISK_FAT12			1
#define EN_DISK_FAT32			1
#define EN_BYTE_ACCESS			1
#define EN_SAVE_VARIABLE		1
#define EXT_BLK_INTERFACE		1

#ifndef LIB_CFG_DISK_IO
#define LIB_CFG_DISK_IO			1		/* 默認(rèn)情況下,磁盤(pán)讀寫(xiě)的數(shù)據(jù)的復(fù)制方式 */
#endif
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO			1		/* 默認(rèn)情況下,文件讀寫(xiě)的數(shù)據(jù)的復(fù)制方式為"內(nèi)部復(fù)制" */
#endif
#ifndef LIB_CFG_UPD_SIZE
#define LIB_CFG_UPD_SIZE		0		/* 默認(rèn)情況下,在添加數(shù)據(jù)后文件長(zhǎng)度的更新方式為"不更新" */
#endif
#ifndef LIB_CFG_NO_DLY
#define LIB_CFG_NO_DLY			0		/* 默認(rèn)情況下,在寫(xiě)操作結(jié)束后的延時(shí)方式為"寫(xiě)后延時(shí)" */
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN			0		/* 默認(rèn)情況下,CH375的INT#引腳連接方式為"查詢方式" */
#endif

#define LIB_CFG_VALUE		( ( LIB_CFG_INT_EN << 7 ) | ( LIB_CFG_NO_DLY << 5 ) | ( LIB_CFG_UPD_SIZE << 4 ) | ( LIB_CFG_FILE_IO << 2 ) | LIB_CFG_DISK_IO )	/* CH375程序庫(kù)配置值 */

/* 子程序庫(kù)中提供的變量 */
extern UINT8V	CH375IntStatus;			/* CH375操作的中斷狀態(tài) */
extern UINT8V	CH375DiskStatus;		/* 磁盤(pán)及文件狀態(tài) */
extern UINT8	CH375LibConfig;			/* CH375程序庫(kù)配置,下行說(shuō)明 */
/* 位7: CH375的INT#引腳連接方式: 0查詢方式,1中斷方式 */
/* 位5: 在寫(xiě)操作結(jié)束后是否延時(shí): 0寫(xiě)后延時(shí),1不延時(shí) */
/* 位4: 在添加數(shù)據(jù)后是否自動(dòng)更新文件長(zhǎng)度: 0不更新,1自動(dòng)更新 */
/* 位3位2: 針對(duì)文件讀寫(xiě)的多扇區(qū)數(shù)據(jù)的復(fù)制方式: 00外部子程序, 01,10,11內(nèi)部復(fù)制 */
/* 位1位0: 針對(duì)磁盤(pán)讀寫(xiě)的單扇區(qū)數(shù)據(jù)的復(fù)制方式: 總是內(nèi)部復(fù)制 */

/* 如果CH375的INT#引腳連接到單片機(jī)的中斷輸入引腳并且準(zhǔn)備使用中斷方式,那么LIB_CFG_INT_EN定義為1,否則定義為0由單片機(jī)查詢INT#引腳 */
/* 在CH375子程序讀寫(xiě)文件數(shù)據(jù)時(shí),CH375的程序庫(kù)提供兩種優(yōu)化速度的方式,在LIB_CFG_FILE_IO中定義:
   方式0:"外部子程序", 只適用于文件讀寫(xiě)時(shí)的數(shù)據(jù)復(fù)制(只用于CH375FileReadX和CH375FileWriteX兩個(gè)子程序),
                       是指由子程序xWriteToExtBuf和xReadFromExtBuf進(jìn)行數(shù)據(jù)復(fù)制,這兩個(gè)子程序是在應(yīng)用程序中定義的,由CH375的程序庫(kù)調(diào)用,
   方式1:"內(nèi)部復(fù)制", 程序內(nèi)置的常規(guī)數(shù)據(jù)復(fù)制方式
   對(duì)于文件數(shù)據(jù)讀寫(xiě),也就是應(yīng)用程序調(diào)用CH375FileReadX和CH375FileWriteX子程序時(shí):
     在方式0下,由應(yīng)用程序在xWriteToExtBuf和xReadFromExtBuf子程序中自行管理緩沖區(qū),設(shè)定緩沖區(qū)初值等,
     在方式1下,應(yīng)用程序每次調(diào)用CH375FileReadX和CH375FileWriteX時(shí),CH375的程序庫(kù)都會(huì)從指定緩沖區(qū)的起始地址開(kāi)始讀寫(xiě)數(shù)據(jù),
     例如: 某文件長(zhǎng)度為1K(占用2個(gè)扇區(qū)), 如果調(diào)用CH375FileReadX時(shí)讀1K(指定mCmdParam.Read.mSectorCount為2), 那么1K數(shù)據(jù)全讀到指定緩沖區(qū)中,
           如果緩沖區(qū)較小只有0.5K, 那么分兩次讀取, 第一次調(diào)用CH375FileReadX時(shí)讀0.5K, 處理完這0.5K數(shù)據(jù)后再調(diào)用CH375FileReadX讀下一個(gè)0.5K并處理
*/
extern UINT8	CH375vDiskFat;			/* 邏輯盤(pán)的FAT標(biāo)志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8	CH375vSecPerClus;		/* 邏輯盤(pán)的每簇扇區(qū)數(shù) */
extern UINT32	CH375vStartCluster;		/* 當(dāng)前文件或者目錄的起始簇號(hào) */
extern UINT32	CH375vFileSize;			/* 當(dāng)前文件的長(zhǎng)度 */
extern UINT32	CH375vCurrentOffset;	/* 當(dāng)前文件指針,當(dāng)前讀寫(xiě)位置的字節(jié)偏移 */

/* FAT數(shù)據(jù)區(qū)中文件目錄信息 */
typedef struct _FAT_DIR_INFO {
	UINT8	DIR_Name[11];				/* 00H,文件名,共11字節(jié),不足處填空格 */
	UINT8	DIR_Attr;					/* 0BH,文件屬性,參考前面的說(shuō)明 */
	UINT8	DIR_NTRes;					/* 0CH */
	UINT8	DIR_CrtTimeTenth;			/* 0DH,文件創(chuàng)建的時(shí)間,以0.1秒單位計(jì)數(shù) */
	UINT16	DIR_CrtTime;				/* 0EH,文件創(chuàng)建的時(shí)間 */
	UINT16	DIR_CrtDate;				/* 10H,文件創(chuàng)建的日期 */
	UINT16	DIR_LstAccDate;				/* 12H,最近一次存取操作的日期 */
	UINT16	DIR_FstClusHI;				/* 14H */
	UINT16	DIR_WrtTime;				/* 16H,文件修改時(shí)間,參考前面的宏MAKE_FILE_TIME */
	UINT16	DIR_WrtDate;				/* 18H,文件修改日期,參考前面的宏MAKE_FILE_DATA */
	UINT16	DIR_FstClusLO;				/* 1AH */
	UINT32	DIR_FileSize;				/* 1CH,文件長(zhǎng)度 */
} FAT_DIR_INFO;							/* 20H */
typedef FAT_DIR_INFO *P_FAT_DIR_INFO;

extern BOOL1	CH375Version2;			/* 芯片版本:0-CH375,1-CH375A */
extern UINT32	CH375vDataStart;		/* 邏輯盤(pán)的數(shù)據(jù)區(qū)域的起始LBA */
extern UINT32	CH375vFdtLba;			/* 當(dāng)前FDT所在的LBA地址 */
extern UINT16	CH375vFdtOffset;		/* 當(dāng)前FDT在扇區(qū)內(nèi)的偏移地址 */
extern UINT32	CH375vDiskRoot;			/* 對(duì)于FAT16盤(pán)為根目錄占用扇區(qū)數(shù),對(duì)于FAT32盤(pán)為根目錄起始簇號(hào) */

extern UINT8	CH375ReadBlock( void );		/* 從磁盤(pán)讀取多個(gè)扇區(qū)的數(shù)據(jù)到外部接口交換區(qū) */
#ifdef EN_DISK_WRITE
extern UINT8	CH375WriteBlock( void );	/* 將外部接口交換區(qū)的多個(gè)扇區(qū)的數(shù)據(jù)塊寫(xiě)入磁盤(pán) */
#endif

/* 子程序庫(kù)中提供的子程序 */
/* 下述子程序中, 文件操作子程序CH375File*和磁盤(pán)查詢子程序CH375DiskQuery都可能會(huì)用到磁盤(pán)數(shù)據(jù)緩沖區(qū)DISK_BASE_BUF,
   并且有可能在DISK_BASE_BUF中保存了磁盤(pán)信息, 所以必須保證DISK_BASE_BUF不被用于其它用途,
   如果RAM較少, 要將DISK_BASE_BUF臨時(shí)用于其它用途, 那么在臨時(shí)用完后必須調(diào)用CH375DirtyBuffer清除磁盤(pán)緩沖區(qū) */
extern UINT8	CH375GetVer( void );		/* 獲取當(dāng)前子程序庫(kù)的版本號(hào) */
extern void		CH375Reset( void );			/* 復(fù)位CH375 */
extern UINT8	CH375Init( void );			/* 初始化CH375 */
extern UINT8	CH375DiskConnect( void );	/* 檢查磁盤(pán)是否連接 */
extern UINT8	CH375DiskReady( void );		/* 查詢磁盤(pán)是否準(zhǔn)備好 */
extern void		CH375DirtyBuffer( void );	/* 清除磁盤(pán)緩沖區(qū) */
extern UINT8	CH375FileOpen( void );		/* 打開(kāi)文件或者枚舉文件 */
extern UINT8	CH375FileClose( void );		/* 關(guān)閉當(dāng)前文件 */
#ifdef EN_DISK_WRITE
extern UINT8	CH375FileErase( void );		/* 刪除文件并關(guān)閉 */
extern UINT8	CH375FileCreate( void );	/* 新建文件并打開(kāi),如果文件已經(jīng)存在則先刪除后再新建 */
#endif
extern UINT8	CH375FileModify( void );	/* 查詢或者修改當(dāng)前文件的信息 */
extern UINT8	CH375FileLocate( void );	/* 移動(dòng)當(dāng)前文件指針 */
extern UINT8	CH375FileReadX( void );		/* 從當(dāng)前文件讀取數(shù)據(jù)到指定緩沖區(qū) */
#ifdef EN_DISK_WRITE
extern UINT8	CH375FileWriteX( void );	/* 向當(dāng)前文件寫(xiě)入指定緩沖區(qū)的數(shù)據(jù) */
#endif
#ifdef EN_BYTE_ACCESS
extern UINT8	CH375ByteLocate( void );	/* 以字節(jié)為單位移動(dòng)當(dāng)前文件指針 */
extern UINT8	CH375ByteRead( void );		/* 以字節(jié)為單位從當(dāng)前位置讀取數(shù)據(jù)塊 */
#ifdef EN_DISK_WRITE
extern UINT8	CH375ByteWrite( void );		/* 以字節(jié)為單位向當(dāng)前位置寫(xiě)入數(shù)據(jù)塊 */
#endif
#endif
extern UINT8	CH375DiskSize( void );		/* 查詢磁盤(pán)容量 */
extern UINT8	CH375DiskQuery( void );		/* 查詢磁盤(pán)信息 */
#ifdef EN_SAVE_VARIABLE
extern void		CH375SaveVariable( void );	/* 備份/保存/恢復(fù)子程序庫(kù)的變量,用于子程序庫(kù)在多個(gè)CH375芯片之間進(jìn)行切換 */
#endif
extern UINT8	CH375BulkOnlyCmd( void );	/* 執(zhí)行基于BulkOnly協(xié)議的命令 */
extern UINT8	CH375sDiskReady( void );	/* 查詢磁盤(pán)是否準(zhǔn)備好,支持CH375S */

/* 該頭文件可以為CH375子程序庫(kù)分配必要的I/O及內(nèi)存資源,并產(chǎn)生必要的與硬件有關(guān)的目標(biāo)代碼,
   如果該文件是被工程項(xiàng)目的多個(gè)源程序包含作為頭文件,那么應(yīng)該只允許一個(gè)頭文件分配資源和產(chǎn)生代碼,
   除此之外的頭文件應(yīng)該被事先定義CH375HF_NO_CODE,從而禁止該頭文件產(chǎn)生重復(fù)的目標(biāo)代碼,例如:
#define		CH375HF_NO_CODE		1
#include	CH375HF?.H
*/
#ifdef CH375HF_NO_CODE

extern void xWriteCH375Cmd( UINT8 mCmd );	/* 外部定義的被CH375程序庫(kù)調(diào)用的子程序,向CH375寫(xiě)命令,最小周期為4uS,否則之前之后各延時(shí)2uS */
extern void xWriteCH375Data( UINT8 mData );	/* 外部定義的被CH375程序庫(kù)調(diào)用的子程序,向CH375寫(xiě)數(shù)據(jù),最小周期為1.5uS,否則之后延時(shí)1.5uS */
extern UINT8 xReadCH375Data( void );		/* 外部定義的被CH375程序庫(kù)調(diào)用的子程序,從CH375讀數(shù)據(jù),最小周期為1.5uS,否則之前延時(shí)1.5uS */
extern CMD_PARAM_I mCmdParam;				/* 命令參數(shù) */
extern UINT8  DISK_BASE_BUF[512];			/* 外部RAM的磁盤(pán)數(shù)據(jù)緩沖區(qū),緩沖區(qū)長(zhǎng)度為一個(gè)扇區(qū)的長(zhǎng)度 */
#ifdef FILE_DATA_BUF_LEN
extern UINT8  FILE_DATA_BUF[ FILE_DATA_BUF_LEN ];	/* 外部RAM的文件數(shù)據(jù)緩沖區(qū),緩沖區(qū)長(zhǎng)度不小于一次讀寫(xiě)的數(shù)據(jù)長(zhǎng)度 */
extern UINT8	CH375FileRead( void );		/* 從當(dāng)前文件讀取數(shù)據(jù) */
#ifdef EN_DISK_WRITE
extern UINT8	CH375FileWrite( void );		/* 向當(dāng)前文件寫(xiě)入數(shù)據(jù) */
#endif
#endif
#ifndef NO_DEFAULT_CH375_F_ENUM
extern UINT8	CH375FileEnumer( void );	/* 枚舉文件 */