#endif
#ifndef MAX_BYTE_IO
#define MAX_BYTE_IO		( MAX_PATH_LEN - 1 )	/* 以字節(jié)為單位單次讀寫文件時(shí)的最大長度,超過該長度可以分多次讀寫 */
#endif

/* 外部命令參數(shù) */
typedef union _CMD_PARAM {
	struct {
		UINT8	mBuffer[ MAX_PATH_LEN ];
	} Other;
	struct {
		UINT32	mReserved;
		UINT32	mTotalSector;			/* 返回: 當(dāng)前邏輯盤的總扇區(qū)數(shù) */
		UINT32	mFreeSector;			/* 返回: 當(dāng)前邏輯盤的剩余扇區(qū)數(shù) */
		UINT8	mDiskFat;				/* 返回: 當(dāng)前邏輯盤的FAT類型 */
	} Query;							/* CMD_DiskQuery, 查詢磁盤信息 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名...,結(jié)束符00H], 其中盤符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Open;								/* CMD_FileOpen, 打開文件 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名(含通配符*)...,枚舉序號(hào)], 其中盤符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILE*",00H */
	} Enumer;							/* CMD_FileEnumer, 枚舉文件,返回文件名 */
	struct {
		UINT8	mUpdateLen;				/* 輸入?yún)?shù): 是否允許更新長度: 0禁止,1允許 */
	} Close;							/* CMD_FileClose, 關(guān)閉當(dāng)前文件 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名...,結(jié)束符00H], 其中盤符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Create;							/* CMD_FileCreate, 新建文件并打開,如果文件已經(jīng)存在則先刪除后再新建 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名...,結(jié)束符00H], 其中盤符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Erase;							/* CMD_FileErase, 刪除文件并關(guān)閉 */
	struct {
		UINT32	mFileSize;				/* 輸入?yún)?shù): 新的文件長度,為0FFFFFFFFH則不修改, 返回: 原長度 */
		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ù): 寫入扇區(qū)數(shù), 返回: 實(shí)際寫入扇區(qū)數(shù) */
	} Write;							/* CMD_FileWrite, 向當(dāng)前文件寫入數(shù)據(jù) */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 讀取扇區(qū)數(shù), 返回: 實(shí)際讀取扇區(qū)數(shù) */
		UINT8	mReserved[7];
		PUINT8X	mDataBuffer;			/* 輸入?yún)?shù): 緩沖區(qū)起始地址, 返回: 緩沖區(qū)當(dāng)前地址 */
	} ReadX;							/* CMD_FileReadX, 從當(dāng)前文件讀取數(shù)據(jù)到指定緩沖區(qū) */
	struct {
		UINT8	mSectorCount;			/* 輸入?yún)?shù): 寫入扇區(qū)數(shù), 返回: 實(shí)際寫入扇區(qū)數(shù) */
		UINT8	mReserved[7];
		PUINT8X	mDataBuffer;			/* 輸入?yún)?shù): 緩沖區(qū)起始地址, 返回: 緩沖區(qū)當(dāng)前地址 */
	} WriteX;							/* CMD_FileWriteX, 向當(dāng)前文件寫入指定緩沖區(qū)的數(shù)據(jù) */
	struct {
		UINT32	mDiskSizeSec;			/* 返回: 整個(gè)物理磁盤的總扇區(qū)數(shù) */
	} DiskSize;							/* CMD_DiskSize, 查詢磁盤容量 */
	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)備寫入的字節(jié)數(shù),不得大于MAX_BYTE_IO, 返回: 實(shí)際寫入的字節(jié)數(shù) */
		UINT8	mByteBuffer[ MAX_BYTE_IO ];	/* 輸入?yún)?shù): 準(zhǔn)備寫入的數(shù)據(jù)塊 */
	} ByteWrite;						/* CMD_ByteWrite, 以字節(jié)為單位向當(dāng)前文件寫入數(shù)據(jù)塊 */
	struct {
		UINT8	mSaveVariable;			/* 輸入?yún)?shù): 為0則恢復(fù)單個(gè)U盤的變量,為0x80則恢復(fù)多個(gè)U盤的變量,其它值則備份/保存變量 */
		UINT8	mReserved[3];
		PUINT8X	mBuffer;				/* 輸入?yún)?shù): 指向子程序庫的變量的備份緩沖區(qū),長度不小于80個(gè)字節(jié) */
	} SaveVariable;						/* CMD_SaveVariable, 備份/保存/恢復(fù)子程序庫的變量 */
	union {
		struct {
			UINT32	mCBW_Sig;
			UINT32	mCBW_Tag;
			UINT8	mCBW_DataLen;		/* 輸入: 數(shù)據(jù)傳輸長度,有效值是0到255 */
			UINT8	mCBW_DataLen1;
			UINT8	mCBW_DataLen2;
			UINT8	mCBW_DataLen3;
			UINT8	mCBW_Flag;			/* 輸入: 傳輸方向等標(biāo)志 */
			UINT8	mCBW_LUN;
			UINT8	mCBW_CB_Len;		/* 輸入: 命令塊的長度,有效值是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ù)長度 */
			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ù)在pDISK_BASE_BUF中 */
} CMD_PARAM;

typedef CMD_PARAM idata CMD_PARAM_I;
typedef CMD_PARAM data *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
#define EN_SEC_SIZE_AUTO		1

#ifndef LIB_CFG_DISK_IO
#define LIB_CFG_DISK_IO			1		/* 默認(rèn)情況下,磁盤讀寫的數(shù)據(jù)的復(fù)制方式為"單DPTR復(fù)制" */
#endif
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO			1		/* 默認(rèn)情況下,文件讀寫的數(shù)據(jù)的復(fù)制方式為"單DPTR復(fù)制" */
#endif
#ifndef LIB_CFG_UPD_SIZE
#define LIB_CFG_UPD_SIZE		0		/* 默認(rèn)情況下,在添加數(shù)據(jù)后文件長度的更新方式為"不更新" */
#endif
#ifndef LIB_CFG_NO_DLY
#define LIB_CFG_NO_DLY			0		/* 默認(rèn)情況下,在寫操作結(jié)束后的延時(shí)方式為"寫后延時(shí)" */
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN			0		/* 默認(rèn)情況下,CH375的INT#引腳連接方式為"查詢方式" */
#endif
#ifndef DISK_BASE_BUF_LEN
#define DISK_BASE_BUF_LEN		512		/* 默認(rèn)的磁盤數(shù)據(jù)緩沖區(qū)大小為512字節(jié),建議選擇為2048甚至4096以支持某些大扇區(qū)的U盤,為0則禁止在.H文件中定義緩沖區(qū)并由應(yīng)用程序在pDISK_BASE_BUF中指定 */
#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程序庫配置值 */

#ifndef DISK_BASE_BUF_ADDR
/*#define DISK_BASE_BUF_ADDR		0*/		/* 如果未定義磁盤讀寫的緩沖區(qū)地址,那么假定磁盤讀寫的緩沖區(qū)從地址0開始 */
#endif

/* 子程序庫中提供的變量 */
extern UINT8DV	CH375IntStatus;			/* CH375操作的中斷狀態(tài) */
extern UINT8DV	CH375DiskStatus;		/* 磁盤及文件狀態(tài) */
extern UINT8D	CH375LibConfig;			/* CH375程序庫配置,下行說明 */
/* 位7: CH375的INT#引腳連接方式: 0查詢方式,1中斷方式 */
/* 位6: 該位為1且CH375Version2為1則芯片為CH375B */
/* 位5: 在寫操作結(jié)束后是否延時(shí): 0寫后延時(shí),1不延時(shí) */
/* 位4: 在添加數(shù)據(jù)后是否自動(dòng)更新文件長度: 0不更新,1自動(dòng)更新 */
/* 位3位2: 針對(duì)文件讀寫的多扇區(qū)數(shù)據(jù)的復(fù)制方式: 00單DPTR復(fù)制, 01單DPTR復(fù)制, 10雙DPTR復(fù)制, 11單DPTR和P2+R0復(fù)制 */
/* 位1位0: 針對(duì)磁盤讀寫的單扇區(qū)數(shù)據(jù)的復(fù)制方式: 00單DPTR復(fù)制, 01單DPTR復(fù)制, 10雙DPTR復(fù)制, 11單DPTR和P2+R0復(fù)制 */

/* 如果CH375的INT#引腳連接到單片機(jī)的中斷輸入引腳并且準(zhǔn)備使用中斷方式,那么LIB_CFG_INT_EN定義為1,否則定義為0由單片機(jī)查詢INT#引腳 */
/* 由于MCS51單片機(jī)復(fù)制外部RAM中的數(shù)據(jù)時(shí)比較慢,所以CH375的程序庫提供幾種優(yōu)化速度的方式,在LIB_CFG_FILE_IO和LIB_CFG_DISK_IO中定義:
   方式0:
   方式1:"單DPTR復(fù)制", 最常規(guī)的數(shù)據(jù)復(fù)制方式, 使用一個(gè)DPTR來回切換, 每傳輸一個(gè)字節(jié)需要16個(gè)機(jī)器周期, 速度最慢, 適用于所有MCS51單片機(jī),
   方式2:"雙DPTR復(fù)制", 針對(duì)特定硬件的數(shù)據(jù)復(fù)制方式, 使用兩個(gè)DPTR, 每傳輸一個(gè)字節(jié)需要8.5個(gè)機(jī)器周期, 速度較快, 適用于ATMEL/PHILIPS/SST等具有雙DPTR的單片機(jī),
   方式3:"單DPTR和P2+R0復(fù)制", 用P2+R0指向CH375的I/O端口并且用DPTR指向外部RAM進(jìn)行數(shù)據(jù)復(fù)制, 每傳輸一個(gè)字節(jié)需要6.25個(gè)機(jī)器周期, 速度最快,
                       適用于所有標(biāo)準(zhǔn)的MCS51單片機(jī), 但是某些單片機(jī)在啟用內(nèi)置的外部RAM時(shí)會(huì)關(guān)閉P2+R0的功能, 所以可能不適用,
   對(duì)于文件數(shù)據(jù)讀寫,也就是應(yīng)用程序調(diào)用CH375FileReadX和CH375FileWriteX子程序時(shí):
     在方式1,2,3下,應(yīng)用程序每次調(diào)用CH375FileReadX和CH375FileWriteX時(shí),CH375的程序庫都會(huì)從指定緩沖區(qū)的起始地址開始讀寫數(shù)據(jù),
     例如: 某文件長度為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 UINT8D	CH375vDiskFat;			/* 邏輯盤的FAT標(biāo)志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8D	CH375vSecPerClus;		/* 邏輯盤的每簇扇區(qū)數(shù) */
extern UINT32D	CH375vStartCluster;		/* 當(dāng)前文件或者目錄的起始簇號(hào) */
extern UINT32D	CH375vFileSize;			/* 當(dāng)前文件的長度 */
extern UINT32D	CH375vCurrentOffset;	/* 當(dāng)前文件指針,當(dāng)前讀寫位置的字節(jié)偏移 */

/* FAT數(shù)據(jù)區(qū)中文件目錄信息 */
typedef struct _FAT_DIR_INFO {
	UINT8	DIR_Name[11];				/* 00H,文件名,共11字節(jié),不足處填空格 */
	UINT8	DIR_Attr;					/* 0BH,文件屬性,參考前面的說明 */
	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,文件長度 */
} FAT_DIR_INFO;							/* 20H */
typedef FAT_DIR_INFO xdata *P_FAT_DIR_INFO;

extern BOOL1	CH375Version2;			/* 芯片版本:0-CH375,1-CH375A/B */
extern UINT32X	CH375vDataStart;		/* 邏輯盤的數(shù)據(jù)區(qū)域的起始LBA */
extern UINT32D	CH375vFdtLba;			/* 當(dāng)前FDT所在的LBA地址 */
extern UINT16D	CH375vFdtOffset;		/* 當(dāng)前FDT在扇區(qū)內(nèi)的偏移地址 */
extern UINT32X	CH375vDiskRoot;			/* 對(duì)于FAT16盤為根目錄占用扇區(qū)數(shù),對(duì)于FAT32盤為根目錄起始簇號(hào) */
#ifdef EN_SEC_SIZE_AUTO
extern UINT16X	CH375vSectorSize;		/* 磁盤的扇區(qū)大小 */
#else
#define	CH375vSectorSize	512			/* 磁盤的扇區(qū)大小 */
#endif
extern PUINT8X	data	pDISK_BASE_BUF;		/* 指向外部RAM的磁盤數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度不小于CH375vSectorSize,由應(yīng)用程序初始化 */

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

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

/* 該頭文件可以為CH375子程序庫分配必要的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