?? ch375hfj.h
字號:
/* USB_INT_RET_ACK 0x001X0010B */ /* 錯誤:對于IN事務返回ACK */
/* USB_INT_RET_NAK 0x001X1010B */ /* 錯誤:返回NAK */
/* USB_INT_RET_STALL 0x001X1110B */ /* 錯誤:返回STALL */
/* USB_INT_RET_DATA0 0x001X0011B */ /* 錯誤:對于OUT/SETUP事務返回DATA0 */
/* USB_INT_RET_DATA1 0x001X1011B */ /* 錯誤:對于OUT/SETUP事務返回DATA1 */
/* USB_INT_RET_TOUT 0x001XXX00B */ /* 錯誤:返回超時 */
/* USB_INT_RET_TOGX 0x0010X011B */ /* 錯誤:對于IN事務返回數據不同步 */
/* USB_INT_RET_PID 0x001XXXXXB */ /* 錯誤:未定義 */
/* 以下狀態代碼1XH用于USB主機方式的操作狀態代碼, 僅CH375/CH375A支持 */
#define USB_INT_SUCCESS 0x14 /* USB事務或者傳輸操作成功 */
#define USB_INT_CONNECT 0x15 /* 檢測到USB設備連接事件 */
#define USB_INT_DISCONNECT 0x16 /* 檢測到USB設備斷開事件 */
#define USB_INT_BUF_OVER 0x17 /* USB控制傳輸的數據太多, 緩沖區溢出 */
#define USB_INT_DISK_READ 0x1D /* USB存儲器讀數據塊, 請求數據讀出 */
#define USB_INT_DISK_WRITE 0x1E /* USB存儲器寫數據塊, 請求數據寫入 */
#define USB_INT_DISK_ERR 0x1F /* USB存儲器操作失敗 */
/* ********************************************************************************************************************* */
/* 常用USB定義 */
/* USB的包標識PID, 主機方式可能用到 */
#define DEF_USB_PID_NULL 0x00 /* 保留PID, 未定義 */
#define DEF_USB_PID_SOF 0x05
#define DEF_USB_PID_SETUP 0x0D
#define DEF_USB_PID_IN 0x09
#define DEF_USB_PID_OUT 0x01
#define DEF_USB_PID_ACK 0x02
#define DEF_USB_PID_NAK 0x0A
#define DEF_USB_PID_STALL 0x0E
#define DEF_USB_PID_DATA0 0x03
#define DEF_USB_PID_DATA1 0x0B
#define DEF_USB_PID_PRE 0x0C
/* USB請求類型, 外置固件模式可能用到 */
#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 /* 設備類請求 */
#define DEF_USB_REQ_VENDOR 0x40 /* 廠商請求 */
#define DEF_USB_REQ_RESERVE 0x60 /* 保留請求 */
/* USB標準設備請求, RequestType的位6位5=00(Standard), 外置固件模式可能用到 */
#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
/* ********************************************************************************************************************* */
/* FILE: CH375HF.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 UINT8V
typedef unsigned char volatile UINT8V;
#endif
/* 錯誤碼 */
#define ERR_SUCCESS 0x00 /* 操作成功 */
#define ERR_CH375_ERROR 0x81 /* CH375硬件錯誤,可能需要復位CH375 */
#define ERR_DISK_DISCON 0x82 /* 磁盤尚未連接,可能磁盤已經斷開 */
#define ERR_STATUS_ERR 0x83 /* 磁盤狀態錯誤,可能正在連接或者斷開磁盤 */
#define ERR_MBR_ERROR 0x91 /* 磁盤的主引導記錄無效,可能磁盤尚未分區或者尚未格式化 */
#define ERR_TYPE_ERROR 0x92 /* 磁盤分區類型不支持,只支持FAT12/FAT16/BigDOS/FAT32,需要由磁盤管理工具重新分區 */
#define ERR_BPB_ERROR 0xA1 /* 磁盤尚未格式化,或者參數錯誤,需要由WINDOWS采用默認參數重新格式化 */
#define ERR_TOO_LARGE 0xA2 /* 磁盤非正常格式化并且容量大于4GB,或者容量大于250GB,需要由WINDOWS采用默認參數重新格式化 */
#define ERR_FAT_ERROR 0xA3 /* 磁盤的文件系統不支持,只支持FAT12/FAT16/FAT32,需要由WINDOWS采用默認參數重新格式化 */
#define ERR_DISK_FULL 0xB1 /* 磁盤文件太滿,剩余空間太少或者已經沒有,需要磁盤整理 */
#define ERR_FDT_OVER 0xB2 /* 目錄內文件太多,沒有空閑的目錄項,FAT12/FAT16根目錄下的文件數應該少于500個,需要磁盤整理 */
#define ERR_MISS_DIR 0xB3 /* 指定路徑的某個子目錄沒有找到,可能是目錄名稱錯誤 */
#define ERR_FILE_CLOSE 0xB4 /* 文件已經關閉,如果需要使用,應該重新打開文件 */
#define ERR_OPEN_DIR 0x41 /* 指定路徑的目錄被打開 */
#define ERR_MISS_FILE 0x42 /* 指定路徑的文件沒有找到,可能是文件名稱錯誤 */
#define ERR_FOUND_NAME 0x43 /* 搜索到與通配符相匹配的文件名,文件名及其完整路徑在命令緩沖區中,如果需要使用,應該打開該文件 */
/* 代碼2XH-3XH用于USB主機方式的通訊失敗代碼,由CH375返回 */
/* 代碼1XH用于USB主機方式的操作狀態代碼,由CH375返回 */
#define ERR_USB_CONNECT 0x15 /* 檢測到USB設備連接事件,磁盤已經連接 */
#define ERR_USB_DISCON 0x16 /* 檢測到USB設備斷開事件,磁盤已經斷開 */
#define ERR_USB_DISK_ERR 0x1F /* USB存儲器操作失敗,在初始化時可能是USB存儲器不支持,在讀寫操作中可能是磁盤損壞或者已經斷開 */
/* 磁盤及文件狀態 */
#define DISK_UNKNOWN 0x00 /* 尚未初始化,未知狀態 */
#define DISK_DISCONNECT 0x01 /* 磁盤沒有連接或者已經斷開 */
#define DISK_CONNECT 0x02 /* 磁盤已經連接,但是尚未初始化或者無法識別該磁盤 */
#define DISK_MOUNTED 0x03 /* 磁盤已經初始化成功,但是尚未分析文件系統或者文件系統不支持 */
#define DISK_READY 0x10 /* 已經分析磁盤的文件系統并且能夠支持 */
#define DISK_OPEN_ROOT 0x12 /* 已經打開根目錄,扇區模式,只能以扇區為單位讀寫目錄的內容,使用后必須關閉,注意FAT12/FAT16根目錄是固定長度 */
#define DISK_OPEN_DIR 0x13 /* 已經打開子目錄,扇區模式,只能以扇區為單位讀寫目錄的內容 */
#define DISK_OPEN_FILE 0x14 /* 已經打開文件,扇區模式,可以以扇區為單位進行數據讀寫 */
#define DISK_OPEN_FILE_B 0x15 /* 已經打開文件,字節模式,可以以字節為單位進行數據讀寫 */
/* FAT類型標志 */
#define DISK_FS_UNKNOWN 0 /* 未知的文件系統 */
#define DISK_FAT12 1 /* FAT12文件系統 */
#define DISK_FAT16 2 /* FAT16文件系統 */
#define DISK_FAT32 3 /* FAT32文件系統 */
/* 文件屬性 */
#define ATTR_READ_ONLY 0x01 /* 文件為只讀屬性 */
#define ATTR_HIDDEN 0x02 /* 文件為隱含屬性 */
#define ATTR_SYSTEM 0x04 /* 文件為系統屬性 */
#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 */
/* 只 隱 系 卷 目 存 未定義 */
/* 讀 藏 統 標 錄 檔 */
/* 文件時間 UINT16 */
/* Time = (Hour<<11) + (Minute<<5) + (Second>>1) */
#define MAKE_FILE_TIME( h, m, s ) ( (h<<11) + (m<<5) + (s>>1) ) /* 生成指定時分秒的文件時間數據 */
/* 文件日期 UINT16 */
/* Date = ((Year-1980)<<9) + (Month<<5) + Day */
#define MAKE_FILE_DATE( y, m, d ) ( ((y-1980)<<9) + (m<<5) + d ) /* 生成指定年月日的文件日期數據 */
/* 文件名 */
#define PATH_WILDCARD_CHAR 0x2A /* 路徑名的通配符 '*' */
#define PATH_SEPAR_CHAR1 0x5C /* 路徑名的分隔符 '\' */
#define PATH_SEPAR_CHAR2 0x2F /* 路徑名的分隔符 '/' */
#ifndef MAX_PATH_LEN
#define MAX_PATH_LEN 30 /* 最大路徑長度,含所有斜杠分隔符和小數點間隔符以及路徑結束符00H */
#endif
#ifndef MAX_BYTE_IO
#define MAX_BYTE_IO ( MAX_PATH_LEN - 1 ) /* 以字節為單位單次讀寫文件時的最大長度,超過該長度可以分多次讀寫 */
#endif
/* 外部命令參數 */
typedef union _CMD_PARAM {
struct {
UINT8 mBuffer[ MAX_PATH_LEN ];
} Other;
struct {
UINT32 mDiskSizeSec; /* 返回: 整個物理磁盤的總扇區數 */
UINT32 mTotalSector; /* 返回: 當前邏輯盤的總扇區數 */
UINT32 mFreeSector; /* 返回: 當前邏輯盤的剩余扇區數 */
UINT8 mDiskFat; /* 返回: 當前邏輯盤的FAT類型 */
} Query; /* CMD_DiskQuery, 查詢磁盤信息 */
struct {
UINT8 mPathName[ MAX_PATH_LEN ]; /* 輸入參數: 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名...,結束符00H], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
} Open; /* CMD_FileOpen, 打開文件 */
struct {
UINT8 mPathName[ MAX_PATH_LEN ]; /* 輸入參數: 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名(含通配符*)...,枚舉序號], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILE*",00H */
} Enumer; /* CMD_FileEnumer, 枚舉文件,返回文件名 */
struct {
UINT8 mUpdateLen; /* 輸入參數: 是否允許更新長度: 0禁止,1允許 */
} Close; /* CMD_FileClose, 關閉當前文件 */
struct {
UINT8 mPathName[ MAX_PATH_LEN ]; /* 輸入參數: 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名...,結束符00H], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
} Create; /* CMD_FileCreate, 新建文件并打開,如果文件已經存在則先刪除后再新建 */
struct {
UINT8 mPathName[ MAX_PATH_LEN ]; /* 輸入參數: 路徑: [盤符,冒號,斜杠,目錄名或者文件名及擴展名...,結束符00H], 其中盤符和冒號可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
} Erase; /* CMD_FileErase, 刪除文件并關閉 */
struct {
UINT32 mFileSize; /* 輸入參數: 新的文件長度,為0FFFFFFFFH則不修改, 返回: 原長度 */
UINT16 mFileDate; /* 輸入參數: 新的文件日期,為0FFFFH則不修改, 返回: 原日期 */
UINT16 mFileTime; /* 輸入參數: 新的文件時間,為0FFFFH則不修改, 返回: 原時間 */
UINT8 mFileAttr; /* 輸入參數: 新的文件屬性,為0FFH則不修改, 返回: 原屬性 */
} Modify; /* CMD_FileQuery, 查詢當前文件的信息; CMD_FileModify, 查詢或者修改當前文件的信息 */
struct {
UINT32 mSectorOffset; /* 輸入參數: 扇區偏移,0則移動到文件頭,0FFFFFFFFH則移動到文件尾, 返回: 當前文件指針對應的絕對線性扇區號, 0FFFFFFFFH則已到文件尾 */
} Locate; /* CMD_FileLocate, 移動當前文件指針 */
struct {
UINT8 mSectorCount; /* 輸入參數: 讀取扇區數, 返回: 實際讀取扇區數 */
} Read; /* CMD_FileRead, 從當前文件讀取數據 */
struct {
UINT8 mSectorCount; /* 輸入參數: 寫入扇區數, 返回: 實際寫入扇區數 */
} Write; /* CMD_FileWrite, 向當前文件寫入數據 */
struct {
UINT8 mSectorCount; /* 輸入參數: 讀取扇區數, 返回: 實際讀取扇區數 */
UINT8 mReserved[7];
PUINT8 mDataBuffer; /* 輸入參數: 緩沖區起始地址, 返回: 緩沖區當前地址 */
} ReadX; /* CMD_FileReadX, 從當前文件讀取數據到指定緩沖區 */
struct {
UINT8 mSectorCount; /* 輸入參數: 寫入扇區數, 返回: 實際寫入扇區數 */
UINT8 mReserved[7];
PUINT8 mDataBuffer; /* 輸入參數: 緩沖區起始地址, 返回: 緩沖區當前地址 */
} WriteX; /* CMD_FileWriteX, 向當前文件寫入指定緩沖區的數據 */
struct {
UINT32 mDiskSizeSec; /* 返回: 整個物理磁盤的總扇區數 */
} DiskSize; /* CMD_DiskSize, 查詢磁盤容量 */
struct {
UINT32 mByteOffset; /* 輸入參數: 以字節為單位的偏移量, 以字節為單位的文件指針, 返回: 當前文件指針對應的絕對線性扇區號, 0FFFFFFFFH則已到文件尾 */
} ByteLocate; /* CMD_ByteLocate, 以字節為單位移動當前文件指針 */
struct {
UINT8 mByteCount; /* 輸入參數: 準備讀取的字節數,不得大于MAX_BYTE_IO, 返回: 實際讀出的字節數 */
UINT8 mByteBuffer[ MAX_BYTE_IO ]; /* 返回: 讀出的數據塊 */
} ByteRead; /* CMD_ByteRead, 以字節為單位從當前文件讀取數據塊 */
struct {
UINT8 mByteCount; /* 輸入參數: 準備寫入的字節數,不得大于MAX_BYTE_IO, 返回: 實際寫入的字節數 */
UINT8 mByteBuffer[ MAX_BYTE_IO ]; /* 輸入參數: 準備寫入的數據塊 */
} ByteWrite; /* CMD_ByteWrite, 以字節為單位向當前文件寫入數據塊 */
union {
struct {
UINT32 mCBW_Sig;
UINT32 mCBW_Tag;
UINT8 mCBW_DataLen; /* 輸入: 數據傳輸長度,有效值是0到255 */
UINT8 mCBW_DataLen1;
UINT8 mCBW_DataLen2;
UINT8 mCBW_DataLen3;
UINT8 mCBW_Flag; /* 輸入: 傳輸方向等標志 */
UINT8 mCBW_LUN;
UINT8 mCBW_CB_Len; /* 輸入: 命令塊的長度,有效值是1到16 */
UINT8 mCBW_CB_Buf[6]; /* 輸入: 命令塊,該緩沖區最多為16個字節 */
} mCBW; /* BulkOnly協議的命令塊, 輸入CBW結構 */
struct {
UINT32 mCSW_Sig;
UINT32 mCSW_Tag;
UINT32 mCSW_Residue; /* 返回: 剩余數據長度 */
UINT8 mCSW_Status; /* 返回: 命令執行結果狀態 */
UINT8 mReserved;
} mCSW; /* BulkOnly協議的命令狀態塊, 輸出CSW結構 */
} BOC; /* CMD_BulkOnlyCmd, 執行基于BulkOnly協議的命令, 如果有數據傳輸那么數據在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 LIB_CFG_DISK_IO 1 /* 默認情況下,磁盤讀寫的數據的復制方式 */
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO 1 /* 默認情況下,文件讀寫的數據的復制方式為"內部復制" */
#endif
#ifndef LIB_CFG_UPD_SIZE
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -