/* 以下狀態(tài)代碼1XH用于USB主機方式的操作狀態(tài)代碼, 可以自行定義任意值，下面的定義僅為了兼容CH375 */
#ifndef	USB_INT_SUCCESS
#define	USB_INT_SUCCESS		0x14			/* USB事務(wù)或者傳輸操作成功 */
#define	USB_INT_CONNECT		0x15			/* 檢測到USB設(shè)備連接事件 */
#define	USB_INT_DISCONNECT	0x16			/* 檢測到USB設(shè)備斷開事件 */
#define	USB_INT_BUF_OVER	0x17			/* USB控制傳輸?shù)臄?shù)據(jù)太多, 緩沖區(qū)溢出 */
#define	USB_INT_DISK_ERR	0x1F			/* USB存儲器操作失敗 */
#endif
#ifndef	USB_INT_CONNECT_LS
#define	USB_INT_CONNECT_LS	0x13			/* 檢測到低速USB設(shè)備連接事件 */
#endif

/* ********************************************************************************************************************* */
/* 常用USB結(jié)構(gòu)和相關(guān)常量 */

/* USB請求類型 */
#ifndef	DEF_USB_REQ_TYPE
#define	DEF_USB_REQ_READ		0x80			/* 控制讀操作 */
#define	DEF_USB_REQ_WRITE		0x00			/* 控制寫操作 */
#define	DEF_USB_REQ_TYPE		0x60			/* 控制請求類型 */
#define	DEF_USB_REQ_STAND		0x00			/* 標準請求 */
#define	DEF_USB_REQ_CLASS		0x20			/* 設(shè)備類請求 */
#define	DEF_USB_REQ_VENDOR		0x40			/* 廠商請求 */
#define	DEF_USB_REQ_RESERVE		0x60			/* 保留請求 */
#endif

/* USB標準設(shè)備請求, RequestType的位6位5=00(Standard) */
#ifndef	DEF_USB_GET_DESCR
#define	DEF_USB_CLR_FEATURE		0x01
#define	DEF_USB_SET_FEATURE		0x03
#define	DEF_USB_GET_STATUS		0x00
#define	DEF_USB_SET_ADDRESS		0x05
#define	DEF_USB_GET_DESCR		0x06
#define	DEF_USB_SET_DESCR		0x07
#define	DEF_USB_GET_CONFIG		0x08
#define	DEF_USB_SET_CONFIG		0x09
#define	DEF_USB_GET_INTERF		0x0A
#define	DEF_USB_SET_INTERF		0x0B
#define	DEF_USB_SYNC_FRAME		0x0C
#endif

/* 描述符類型 */
#ifndef	USB_DEVICE_DESCR_TYPE
#define	USB_DEVICE_DESCR_TYPE		0x01
#define	USB_CONFIG_DESCR_TYPE		0x02
#define	USB_STRING_DESCR_TYPE		0x03
#define	USB_INTERF_DESCR_TYPE		0x04
#define	USB_ENDP_DESCR_TYPE			0x05
#define	USB_POWER_DESCR_TYPE		0x06
#define	USB_HID_DESCR_TYPE			0x21
#define	USB_REPORT_DESCR_TYPE		0x22
#define	USB_PHYSIC_DESCR_TYPE		0x23
#endif

/* 端點類型和屬性 */
#ifndef	USB_ENDP_TYPE_MASK
#define USB_ENDP_DIR_MASK			0x80
#define USB_ENDP_TYPE_MASK			0x03
#define USB_ENDP_TYPE_CTRL			0x00
#define USB_ENDP_TYPE_ISOCH			0x01
#define USB_ENDP_TYPE_BULK			0x02
#define	USB_ENDP_TYPE_INTER			0x03
#endif

/* 設(shè)備類別 */
#ifndef	USB_DEV_CLASS_HUB
#define	USB_DEV_CLASS_RESERVED		0x00
#define	USB_DEV_CLASS_AUDIO			0x01
#define	USB_DEV_CLASS_COMMUNIC		0x02
#define	USB_DEV_CLASS_HUMAN_IF		0x03
#define	USB_DEV_CLASS_MONITOR		0x04
#define	USB_DEV_CLASS_PHYSIC_IF		0x05
#define	USB_DEV_CLASS_POWER			0x06
#define	USB_DEV_CLASS_PRINTER		0x07
#define	USB_DEV_CLASS_STORAGE		0x08
#define	USB_DEV_CLASS_HUB			0x09
#define	USB_DEV_CLASS_VEN_SPEC		0xFF
#endif

#define	DEFAULT_ENDP0_SIZE	8				/* 默認的端點0最大包長度 */

/* ********************************************************************************************************************* */

/* FILE: CH374HF.H */

typedef unsigned char                BOOL1;

#ifndef UINT8
typedef unsigned char                UINT8;
#endif
#ifndef UINT16
typedef unsigned short               UINT16;
#endif
#ifndef UINT32
typedef unsigned long                UINT32;
#endif
#ifndef PUINT8
typedef unsigned char               *PUINT8;
#endif
#ifndef PUINT16
typedef unsigned short              *PUINT16;
#endif
#ifndef PUINT32
typedef unsigned long               *PUINT32;
#endif
#ifndef PUINT8C
typedef const unsigned char         *PUINT8C;
#endif
#ifndef UINT8V
typedef unsigned char volatile       UINT8V;
#endif

/* 錯誤碼 */
#define ERR_SUCCESS				0x00	/* 操作成功 */
#define ERR_CH374_ERROR			0x81	/* CH374硬件錯誤,可能需要復(fù)位CH374 */
#define ERR_DISK_DISCON			0x82	/* 磁盤尚未連接,可能磁盤已經(jīng)斷開 */
#define ERR_STATUS_ERR			0x83	/* 磁盤狀態(tài)錯誤,可能正在連接或者斷開磁盤 */
#define ERR_HUB_PORT_FREE		0x84	/* USB-HUB已經(jīng)連接但是HUB端口尚未連接磁盤,可能磁盤已經(jīng)斷開 */
#define ERR_MBR_ERROR			0x91	/* 磁盤的主引導記錄無效,可能磁盤尚未分區(qū)或者尚未格式化 */
#define ERR_TYPE_ERROR			0x92	/* 磁盤分區(qū)類型不支持,只支持FAT12/FAT16/BigDOS/FAT32,需要由磁盤管理工具重新分區(qū) */
#define ERR_BPB_ERROR			0xA1	/* 磁盤尚未格式化,或者參數(shù)錯誤,需要由WINDOWS采用默認參數(shù)重新格式化 */
#define ERR_TOO_LARGE			0xA2	/* 磁盤非正常格式化并且容量大于4GB,或者容量大于250GB,需要由WINDOWS采用默認參數(shù)重新格式化 */
#define ERR_FAT_ERROR			0xA3	/* 磁盤的文件系統(tǒng)不支持,只支持FAT12/FAT16/FAT32,需要由WINDOWS采用默認參數(shù)重新格式化 */
#define ERR_DISK_FULL			0xB1	/* 磁盤文件太滿,剩余空間太少或者已經(jīng)沒有,需要磁盤整理 */
#define ERR_FDT_OVER			0xB2	/* 目錄內(nèi)文件太多,沒有空閑的目錄項,FAT12/FAT16根目錄下的文件數(shù)應(yīng)該少于500個,需要磁盤整理 */
#define ERR_MISS_DIR			0xB3	/* 指定路徑的某個子目錄沒有找到,可能是目錄名稱錯誤 */
#define ERR_FILE_CLOSE			0xB4	/* 文件已經(jīng)關(guān)閉,如果需要使用,應(yīng)該重新打開文件 */
#define ERR_OPEN_DIR			0x41	/* 指定路徑的目錄被打開 */
#define ERR_MISS_FILE			0x42	/* 指定路徑的文件沒有找到,可能是文件名稱錯誤 */
#define ERR_FOUND_NAME			0x43	/* 搜索到與通配符相匹配的文件名,文件名及其完整路徑在命令緩沖區(qū)中,如果需要使用,應(yīng)該打開該文件 */
/* 代碼2XH-3XH用于USB主機方式的通訊失敗代碼,由CH374子程序模仿CH375的返回 */
/* 代碼1XH用于USB主機方式的操作狀態(tài)代碼,由CH374子程序模仿CH375的返回 */
#define	ERR_USB_CONNECT_LS		0x13	/* 檢測到低速USB設(shè)備連接事件 */
#define	ERR_USB_CONNECT			0x15	/* 檢測到USB設(shè)備連接事件,磁盤已經(jīng)連接 */
#define	ERR_USB_DISCON			0x16	/* 檢測到USB設(shè)備斷開事件,磁盤已經(jīng)斷開 */
#define	ERR_USB_DISK_ERR		0x1F	/* USB存儲器操作失敗,在初始化時可能是USB存儲器不支持,在讀寫操作中可能是磁盤損壞或者已經(jīng)斷開 */
/* 以下狀態(tài)代碼為特殊事件中斷 */
#define	USB_INT_USB_SUSPEND		0x05	/* USB總線掛起事件 */
#define	USB_INT_WAKE_UP			0x06	/* 從睡眠中被喚醒事件 */

/* 磁盤及文件狀態(tài) */
#define DISK_UNKNOWN			0x00	/* 尚未初始化,未知狀態(tài) */
#define DISK_DISCONNECT			0x01	/* 磁盤沒有連接或者已經(jīng)斷開 */
#define DISK_CONNECT			0x02	/* 磁盤已經(jīng)連接,但是尚未初始化或者無法識別該磁盤 */
#define DISK_MOUNTED			0x03	/* 磁盤已經(jīng)初始化成功,但是尚未分析文件系統(tǒng)或者文件系統(tǒng)不支持 */
#define DISK_READY				0x10	/* 已經(jīng)分析磁盤的文件系統(tǒng)并且能夠支持 */
#define DISK_OPEN_ROOT			0x12	/* 已經(jīng)打開根目錄,扇區(qū)模式,只能以扇區(qū)為單位讀寫目錄的內(nèi)容,使用后必須關(guān)閉,注意FAT12/FAT16根目錄是固定長度 */
#define DISK_OPEN_DIR			0x13	/* 已經(jīng)打開子目錄,扇區(qū)模式,只能以扇區(qū)為單位讀寫目錄的內(nèi)容 */
#define DISK_OPEN_FILE			0x14	/* 已經(jīng)打開文件,扇區(qū)模式,可以以扇區(qū)為單位進行數(shù)據(jù)讀寫 */
#define DISK_OPEN_FILE_B		0x15	/* 已經(jīng)打開文件,字節(jié)模式,可以以字節(jié)為單位進行數(shù)據(jù)讀寫 */

/* FAT類型標志 */
#define DISK_FS_UNKNOWN			0		/* 未知的文件系統(tǒng) */
#define DISK_FAT12				1		/* FAT12文件系統(tǒng) */
#define DISK_FAT16				2		/* FAT16文件系統(tǒng) */
#define DISK_FAT32				3		/* FAT32文件系統(tǒng) */

/* 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)建的時間,以0.1秒單位計數(shù) */
	UINT16	DIR_CrtTime;				/* 0EH,文件創(chuàng)建的時間 */
	UINT16	DIR_CrtDate;				/* 10H,文件創(chuàng)建的日期 */
	UINT16	DIR_LstAccDate;				/* 12H,最近一次存取操作的日期 */
	UINT16	DIR_FstClusHI;				/* 14H */
	UINT16	DIR_WrtTime;				/* 16H,文件修改時間,參考前面的宏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 *P_FAT_DIR_INFO;

/* 文件屬性 */
#define ATTR_READ_ONLY			0x01	/* 文件為只讀屬性 */
#define ATTR_HIDDEN				0x02	/* 文件為隱含屬性 */
#define ATTR_SYSTEM				0x04	/* 文件為系統(tǒng)屬性 */
#define ATTR_VOLUME_ID			0x08	/* 卷標 */
#define ATTR_DIRECTORY			0x10	/* 子目錄 */
#define ATTR_ARCHIVE			0x20	/* 文件為存檔屬性 */
#define ATTR_LONG_NAME			( ATTR_READ_ONLY | ATTR_HIDDEN | ATTR_SYSTEM | ATTR_VOLUME_ID )
/* 文件屬性 UINT8 */
/* bit0 bit1 bit2 bit3 bit4 bit5 bit6 bit7 */
/*  只   隱   系   卷   目   存   未定義   */
/*  讀   藏   統(tǒng)   標   錄   檔            */
/* 文件時間 UINT16 */
/* Time = (Hour<<11) + (Minute<<5) + (Second>>1) */
#define MAKE_FILE_TIME( h, m, s )	( (h<<11) + (m<<5) + (s>>1) )	/* 生成指定時分秒的文件時間數(shù)據(jù) */
/* 文件日期 UINT16 */
/* Date = ((Year-1980)<<9) + (Month<<5) + Day */
#define MAKE_FILE_DATE( y, m, d )	( ((y-1980)<<9) + (m<<5) + d )	/* 生成指定年月日的文件日期數(shù)據(jù) */

/* 文件名 */
#define PATH_WILDCARD_CHAR		0x2A	/* 路徑名的通配符 '*' */
#define PATH_SEPAR_CHAR1		0x5C	/* 路徑名的分隔符 '\' */
#define PATH_SEPAR_CHAR2		0x2F	/* 路徑名的分隔符 '/' */
#ifndef MAX_PATH_LEN
#define MAX_PATH_LEN			30		/* 最大路徑長度,含所有斜杠分隔符和小數(shù)點間隔符以及路徑結(jié)束符00H */
#endif
#ifndef MAX_BYTE_IO
#define MAX_BYTE_IO		( MAX_PATH_LEN - 1 )	/* 以字節(jié)為單位單次讀寫文件時的最大長度,超過該長度可以分多次讀寫 */
#endif

/* 外部命令參數(shù) */
typedef union _CMD_PARAM {
	struct {
		UINT8	mBuffer[ MAX_PATH_LEN ];
	} Other;
	struct {
		UINT32	mDiskSizeSec;			/* 返回: 整個物理磁盤的總扇區(qū)數(shù) */
		UINT32	mTotalSector;			/* 返回: 當前邏輯盤的總扇區(qū)數(shù) */
		UINT32	mFreeSector;			/* 返回: 當前邏輯盤的剩余扇區(qū)數(shù) */
		UINT8	mDiskFat;				/* 返回: 當前邏輯盤的FAT類型 */
	} Query;							/* CMD_DiskQuery, 查詢磁盤信息 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名...,結(jié)束符00H], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
	} Open;								/* CMD_FileOpen, 打開文件 */
	struct {
		UINT8	mPathName[ MAX_PATH_LEN ];	/* 輸入?yún)?shù): 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名(含通配符*)...,枚舉序號], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILE*",00H */
	} Enumer;							/* CMD_FileEnumer, 枚舉文件,返回文件名 */