UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤(pán)符,冒號(hào),斜杠,目錄名或者文件名及擴(kuò)展名(含通配符*)...,枚舉序號(hào)], 其中盤(pán)符和冒號(hào)可以省略, 例如"C:\DIR1.EXT\DIR2\FILE*",00H */
	} Enumer;							/* CMD_FileEnumer, 枚舉文件,返回文件名 */
	struct {
		UINT8	mUpdateLen;				/* 輸入?yún)?shù): 是否允許更新長(zhǎng)度: 0禁止,1允許 */
	} Close;							/* CMD_FileClose, 關(guān)閉當(dā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 */
	} 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;
		UINT8	mLbaCount;
		UINT8	mReserved5[5];
		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;
		UINT8	mLbaCount;
		UINT8	mReserved5[5];
		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ù)單個(gè)U盤(pán)的變量,為0x80則恢復(fù)多個(gè)U盤(pán)的變量,其它值則備份/保存變量 */
		UINT8	mReserved[3];
		PUINT8	mBuffer;				/* 輸入?yún)?shù): 指向子程序庫(kù)的變量的備份緩沖區(qū),長(zhǎng)度不小于80個(gè)字節(jié) */
	} SaveVariable;						/* CMD_SaveVariable, 備份/保存/恢復(fù)子程序庫(kù)的變量 */
} CMD_PARAM;

typedef CMD_PARAM CMD_PARAM_I;
typedef CMD_PARAM *P_CMD_PARAM;

/* SCSI命令碼 */
#define SPC_CMD_INQUIRY			0x12
#define SPC_CMD_READ_CAPACITY	0x25
#define SPC_CMD_READ10			0x28
#define SPC_CMD_WRITE10			0x2A
#define SPC_CMD_TEST_READY		0x00
#define SPC_CMD_REQUEST_SENSE	0x03
#define SPC_CMD_MODESENSE6		0x1A
#define SPC_CMD_MODESENSE10		0x5A
#define SPC_CMD_START_STOP		0x1B

/* BOC */
typedef union _BULK_ONLY_CMD {
	struct {
/*		UINT32	mCBW_Sig;*/
/*		UINT32	mCBW_Tag;*/
		UINT8	mCBW_DataLen0;			/* 輸入: 數(shù)據(jù)傳輸長(zhǎng)度,有效值是0到65535 */
		UINT8	mCBW_DataLen1;
		UINT16	mCBW_DataLen2;
		UINT8	mCBW_Flag;				/* 輸入: 傳輸方向等標(biāo)志 */
		UINT8	mCBW_LUN;
		UINT8	mCBW_CB_Len;			/* 輸入: 命令塊的長(zhǎng)度,有效值是1到16 */
		UINT8	mCBW_CB_Buf[10];		/* 輸入: 命令塊,該緩沖區(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) */
} BULK_ONLY_CMD;						/* CMD_BulkOnlyCmd, 執(zhí)行基于BulkOnly協(xié)議的命令, 如果有數(shù)據(jù)傳輸那么數(shù)據(jù)在pDISK_BASE_BUF中 */

typedef BULK_ONLY_CMD BULK_ONLY_CMD_X;

/* FILE: CH374HF?.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 EN_HUB_DISK				1
#define EN_SEC_SIZE_AUTO		1

#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)情況下,CH374的INT#引腳連接方式為"查詢方式" */
#endif
#ifndef DISK_BASE_BUF_LEN
#define DISK_BASE_BUF_LEN		512		/* 默認(rèn)的磁盤(pán)數(shù)據(jù)緩沖區(qū)大小為512字節(jié),建議選擇為2048甚至4096以支持某些大扇區(qū)的U盤(pán),為0則禁止在.H文件中定義緩沖區(qū)并由應(yīng)用程序在pDISK_BASE_BUF中指定 */
#endif

/* 子程序庫(kù)中提供的變量 */
extern UINT8V	CH374IntStatus;			/* CH374操作的中斷狀態(tài) */
extern UINT8V	CH374DiskStatus;		/* 磁盤(pán)及文件狀態(tài) */
extern UINT8	CH374vDiskFat;			/* 邏輯盤(pán)的FAT標(biāo)志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8	CH374vSecPerClus;		/* 邏輯盤(pán)的每簇扇區(qū)數(shù) */
extern UINT32	CH374vStartCluster;		/* 當(dāng)前文件或者目錄的起始簇號(hào) */
extern UINT32	CH374vFileSize;			/* 當(dāng)前文件的長(zhǎng)度 */
extern UINT32	CH374vCurrentOffset;	/* 當(dāng)前文件指針,當(dāng)前讀寫(xiě)位置的字節(jié)偏移 */
extern UINT32	CH374vDiskRoot;			/* 對(duì)于FAT16盤(pán)為根目錄占用扇區(qū)數(shù),對(duì)于FAT32盤(pán)為根目錄起始簇號(hào) */
extern UINT32	CH374vDataStart;		/* 邏輯盤(pán)的數(shù)據(jù)區(qū)域的起始LBA */
extern UINT32	CH374vFdtLba;			/* 當(dāng)前FDT所在的LBA地址 */
extern UINT16	CH374vFdtOffset;		/* 當(dāng)前FDT在扇區(qū)內(nèi)的偏移地址 */
extern UINT8	CH374vRetryCount;		/* 位7為1則NAK無(wú)限重試,為0則NAK不重試,位5為1則USB存儲(chǔ)設(shè)備的子類(lèi)為6,為0則子類(lèi)為非6,位3至位0為出錯(cuò)重試次數(shù) */
extern BOOL1	CH374vUsbPidIn;			/* 當(dāng)前USB傳輸?shù)腜ID是否為IN:1=是IN,0=是OUT或者SETUP */
extern UINT8	CH374vDevEndpTog;		/* USB存儲(chǔ)設(shè)備的端點(diǎn)的數(shù)據(jù)同步標(biāo)志:位7對(duì)應(yīng)BIT_HOST_RECV_TOG,位6對(duì)應(yīng)BIT_HOST_TRAN_TOG,位3必須為1,其它位必須為0 */
extern UINT8	CH374vCurrentLun;		/* USB存儲(chǔ)設(shè)備的當(dāng)前邏輯單元號(hào) */
extern UINT8	CH374vDiskRetry;		/* USB存儲(chǔ)設(shè)備讀寫(xiě)失敗后的重試計(jì)數(shù),位7為1則啟用磁盤(pán)存取的外部接口 */
#ifdef EN_HUB_DISK
extern UINT8	CH374vHubPortCount;		/* HUB上的端口數(shù),為0則沒(méi)有HUB */
extern UINT8	CH374vHubPortIndex;		/* HUB上的當(dāng)前操作端口號(hào),位7為0則自動(dòng)查詢,位1則指定端口號(hào) */
#endif
#ifdef EN_SEC_SIZE_AUTO
extern UINT16	CH374vSectorSize;		/* 磁盤(pán)的扇區(qū)大小 */
#else
#define	CH374vSectorSize	512			/* 磁盤(pán)的扇區(qū)大小 */
#endif
extern PUINT8	pDISK_BASE_BUF;			/* 指向外部RAM的磁盤(pán)數(shù)據(jù)緩沖區(qū),緩沖區(qū)長(zhǎng)度不小于CH374vSectorSize,由應(yīng)用程序初始化 */

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

/* 子程序庫(kù)中提供的子程序 */
/* 下述子程序中, 文件操作子程序CH374File*和磁盤(pán)查詢子程序CH374DiskQuery都可能會(huì)用到磁盤(pán)數(shù)據(jù)緩沖區(qū)pDISK_BASE_BUF,
   并且有可能在pDISK_BASE_BUF中保存了磁盤(pán)信息, 所以必須保證pDISK_BASE_BUF不被用于其它用途,
   如果RAM較少, 要將pDISK_BASE_BUF臨時(shí)用于其它用途, 那么在臨時(shí)用完后必須調(diào)用CH374DirtyBuffer清除磁盤(pán)緩沖區(qū) */
extern UINT8	CH374GetVer( void );		/* 獲取當(dāng)前子程序庫(kù)的版本號(hào) */
extern UINT8	CH374Init( void );			/* 初始化CH374 */
extern void		CH374DelaymS( UINT8 iDelay );	/* 延時(shí)指定毫秒,不大于255毫秒 */
extern UINT8	CH374DiskConnect( void );	/* 檢查磁盤(pán)是否連接并更新磁盤(pán)狀態(tài) */
extern UINT8	CH374DiskReady( void );		/* 查詢磁盤(pán)是否準(zhǔn)備好 */
extern void		CH374DirtyBuffer( void );	/* 清除磁盤(pán)緩沖區(qū) */
extern UINT8	CH374FileOpen( void );		/* 打開(kāi)文件或者枚舉文件 */
extern UINT8	CH374FileClose( void );		/* 關(guān)閉當(dāng)前文件 */
#ifdef EN_DISK_WRITE
extern UINT8	CH374FileErase( void );		/* 刪除文件并關(guān)閉 */
extern UINT8	CH374FileCreate( void );	/* 新建文件并打開(kāi),如果文件已經(jīng)存在則先刪除后再新建 */
#endif
extern UINT8	CH374FileModify( void );	/* 查詢或者修改當(dāng)前文件的信息 */
extern UINT8	CH374FileLocate( void );	/* 移動(dòng)當(dāng)前文件指針 */
extern UINT8	CH374FileReadX( void );		/* 從當(dāng)前文件讀取數(shù)據(jù)到指定緩沖區(qū) */
#ifdef EN_DISK_WRITE
extern UINT8	CH374FileWriteX( void );	/* 向當(dāng)前文件寫(xiě)入指定緩沖區(qū)的數(shù)據(jù) */
#endif
#ifdef EN_BYTE_ACCESS
extern UINT8	CH374ByteLocate( void );	/* 以字節(jié)為單位移動(dòng)當(dāng)前文件指針 */
extern UINT8	CH374ByteRead( void );		/* 以字節(jié)為單位從當(dāng)前位置讀取數(shù)據(jù)塊 */
#ifdef EN_DISK_WRITE
extern UINT8	CH374ByteWrite( void );		/* 以字節(jié)為單位向當(dāng)前位置寫(xiě)入數(shù)據(jù)塊 */
#endif
#endif
extern UINT8	CH374DiskSize( void );		/* 查詢磁盤(pán)容量 */
extern UINT8	CH374DiskQuery( void );		/* 查詢磁盤(pán)信息 */
#ifdef EN_SAVE_VARIABLE
extern void		CH374SaveVariable( void );	/* 備份/保存/恢復(fù)子程序庫(kù)的變量,用于子程序庫(kù)在多個(gè)CH374芯片之間進(jìn)行切換 */
#endif
extern UINT8	CH374BulkOnlyCmd( void );	/* 執(zhí)行基于BulkOnly協(xié)議的命令 */
extern UINT8	CH374HostTransact( void );	/* 傳輸事務(wù),需預(yù)先輸入CH374UsbPidIn,PID令牌+目的端點(diǎn)地址,同步標(biāo)志,返回同CH375(除USB_INT_SUCCESS為ERR_SUCCESS),NAK及出錯(cuò)重試 */
extern UINT8	CH374CtrlTransfer( void );	/* 執(zhí)行控制傳輸,需預(yù)先寫(xiě)入8字節(jié)請(qǐng)求碼,收發(fā)的數(shù)據(jù)在pDISK_BASE_BUF緩沖區(qū) */

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

extern UINT8	CH374_READ_REGISTER( UINT8 mAddr );					/* 從指定寄存器讀取數(shù)據(jù) */
extern void		CH374_WRITE_REGISTER( UINT8 mAddr, UINT8 mData );	/* 向指定寄存器寫(xiě)入數(shù)據(jù) */
extern void		CH374_READ_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8 mBuf );	/* 從指定起始地址讀出數(shù)據(jù)塊 */
extern void		CH374_WRITE_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8 mBuf );	/* 向指定起始地址寫(xiě)入數(shù)據(jù)塊 */
extern PUINT8	CH374_READ_BLOCK64( UINT8 mAddr, PUINT8 mBuf );	/* 從雙緩沖區(qū)讀出64字節(jié)的數(shù)據(jù)塊,返回當(dāng)前地址 */
#ifdef EN_DISK_WRITE
extern PUINT8	CH374_WRITE_BLOCK64( UINT8 mAddr, PUINT8 mBuf );	/* 向雙緩沖區(qū)寫(xiě)入64字節(jié)的數(shù)據(jù)塊,返回當(dāng)前地址 */
#endif
extern void		CH374_WRITE_BLOCK_C( UINT8 mLen, PUINT8C mBuf );	/* 向RAM_HOST_TRAN寫(xiě)入常量型數(shù)據(jù)塊 */

extern CMD_PARAM_I mCmdParam;				/* 命令參數(shù) */
extern BULK_ONLY_CMD_X mBOC;				/* BO協(xié)議的命令包 */
#if DISK_BASE_BUF_LEN
extern UINT8  DISK_BASE_BUF[ DISK_BASE_BUF_LEN ];	/* 外部RAM的磁盤(pán)數(shù)據(jù)緩沖區(qū),緩沖區(qū)長(zhǎng)度為一個(gè)扇區(qū)的長(zhǎng)度,起始地址必須為2字節(jié)邊界地址 */
#endif
#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	CH374FileRead( void );		/* 從當(dāng)前文件讀取數(shù)據(jù) */
#ifdef EN_DISK_WRITE
extern UINT8	CH374FileWrite( void );		/* 向當(dāng)前文件寫(xiě)入數(shù)據(jù) */
#endif
#endif
#ifndef NO_DEFAULT_CH374_F_ENUM
extern UINT8	CH374FileEnumer( void );	/* 枚舉文件 */