?? ch374hfa.h
字號:
/* 只 隱 系 卷 目 存 未定義 */
/* 讀 藏 統 標 錄 檔 */
/* 文件時間 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;
UINT8 mLbaCount;
UINT8 mReserved5[5];
PUINT8X mDataBuffer; /* 輸入參數: 緩沖區起始地址, 返回: 緩沖區當前地址 */
} ReadX; /* CMD_FileReadX, 從當前文件讀取數據到指定緩沖區 */
struct {
UINT8 mSectorCount; /* 輸入參數: 寫入扇區數, 返回: 實際寫入扇區數 */
UINT8 mReserved;
UINT8 mLbaCount;
UINT8 mReserved5[5];
PUINT8X 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, 以字節為單位向當前文件寫入數據塊 */
struct {
UINT8 mSaveVariable; /* 輸入參數: 為0則恢復變量,非0值則備份/保存變量 */
UINT8 mReserved[3];
PUINT8X mBuffer; /* 輸入參數: 指向子程序庫的變量的備份緩沖區,長度不小于80個字節 */
} SaveVariable; /* CMD_SaveVariable, 備份/保存/恢復子程序庫的變量 */
} CMD_PARAM;
typedef CMD_PARAM xdata CMD_PARAM_I;
typedef CMD_PARAM xdata *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; /* 輸入: 數據傳輸長度,有效值是0到65535 */
UINT8 mCBW_DataLen1;
UINT16 mCBW_DataLen2;
UINT8 mCBW_Flag; /* 輸入: 傳輸方向等標志 */
UINT8 mCBW_LUN;
UINT8 mCBW_CB_Len; /* 輸入: 命令塊的長度,有效值是1到16 */
UINT8 mCBW_CB_Buf[10]; /* 輸入: 命令塊,該緩沖區最多為16個字節 */
} mCBW; /* BulkOnly協議的命令塊, 輸入CBW結構 */
struct {
UINT32 mCSW_Sig;
UINT32 mCSW_Tag;
UINT32 mCSW_Residue; /* 返回: 剩余數據長度 */
UINT8 mCSW_Status; /* 返回: 命令執行結果狀態 */
UINT8 mReserved;
} mCSW; /* BulkOnly協議的命令狀態塊, 輸出CSW結構 */
} BULK_ONLY_CMD; /* CMD_BulkOnlyCmd, 執行基于BulkOnly協議的命令, 如果有數據傳輸那么數據在pDISK_BASE_BUF中 */
typedef BULK_ONLY_CMD xdata 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 /* 默認情況下,在寫操作結束后的延時方式為"寫后延時" */
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN 0 /* 默認情況下,CH374的INT#引腳連接方式為"查詢方式" */
#endif
#ifndef DISK_BASE_BUF_LEN
#define DISK_BASE_BUF_LEN 512 /* 默認的磁盤數據緩沖區大小為512字節,建議選擇為2048甚至4096以支持某些大扇區的U盤,為0則禁止在.H文件中定義緩沖區并由應用程序在pDISK_BASE_BUF中指定 */
#endif
/* 子程序庫中提供的變量 */
extern UINT8DV CH374IntStatus; /* CH374操作的中斷狀態 */
extern UINT8XV CH374DiskStatus; /* 磁盤及文件狀態 */
extern UINT8X CH374vDiskFat; /* 邏輯盤的FAT標志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8X CH374vSecPerClus; /* 邏輯盤的每簇扇區數 */
extern UINT32X CH374vStartCluster; /* 當前文件或者目錄的起始簇號 */
extern UINT32X CH374vFileSize; /* 當前文件的長度 */
extern UINT32X CH374vCurrentOffset; /* 當前文件指針,當前讀寫位置的字節偏移 */
extern UINT32X CH374vDiskRoot; /* 對于FAT16盤為根目錄占用扇區數,對于FAT32盤為根目錄起始簇號 */
extern UINT32X CH374vDataStart; /* 邏輯盤的數據區域的起始LBA */
extern UINT32X CH374vFdtLba; /* 當前FDT所在的LBA地址 */
extern UINT16X CH374vFdtOffset; /* 當前FDT在扇區內的偏移地址 */
extern UINT8X CH374vRetryCount; /* 位7為1則NAK無限重試,為0則NAK不重試,位5為1則USB存儲設備的子類為6,為0則子類為非6,位3至位0為出錯重試次數 */
extern BOOL1 CH374vUsbPidIn; /* 當前USB傳輸的PID是否為IN:1=是IN,0=是OUT或者SETUP */
extern UINT8X CH374vDevEndpTog; /* USB存儲設備的端點的數據同步標志:位7對應BIT_HOST_RECV_TOG,位6對應BIT_HOST_TRAN_TOG,位3必須為1,其它位必須為0 */
extern UINT8X CH374vCurrentLun; /* USB存儲設備的當前邏輯單元號 */
extern UINT8X CH374vDiskRetry; /* USB存儲設備讀寫失敗后的重試計數,位7為1則啟用磁盤存取的外部接口 */
#ifdef EN_HUB_DISK
extern UINT8X CH374vHubPortCount; /* HUB上的端口數,為0則沒有HUB */
extern UINT8X CH374vHubPortIndex; /* HUB上的當前操作端口號,位7為0則自動查詢,位1則指定端口號 */
#endif
#ifdef EN_SEC_SIZE_AUTO
extern UINT16X CH374vSectorSize; /* 磁盤的扇區大小 */
#else
#define CH374vSectorSize 512 /* 磁盤的扇區大小 */
#endif
extern PUINT8X xdata pDISK_BASE_BUF; /* 指向外部RAM的磁盤數據緩沖區,緩沖區長度不小于CH374vSectorSize,由應用程序初始化 */
extern UINT8 CH374ReadBlock( void ); /* 從磁盤讀取多個扇區的數據到外部接口交換區 */
#ifdef EN_DISK_WRITE
extern UINT8 CH374WriteBlock( void ); /* 將外部接口交換區的多個扇區的數據塊寫入磁盤 */
#endif
/* 子程序庫中提供的子程序 */
/* 下述子程序中, 文件操作子程序CH374File*和磁盤查詢子程序CH374DiskQuery都可能會用到磁盤數據緩沖區pDISK_BASE_BUF,
并且有可能在pDISK_BASE_BUF中保存了磁盤信息, 所以必須保證pDISK_BASE_BUF不被用于其它用途,
如果RAM較少, 要將pDISK_BASE_BUF臨時用于其它用途, 那么在臨時用完后必須調用CH374DirtyBuffer清除磁盤緩沖區 */
extern UINT8 CH374GetVer( void ); /* 獲取當前子程序庫的版本號 */
extern UINT8 CH374Init( void ); /* 初始化CH374 */
extern void CH374DelaymS( UINT8 iDelay ); /* 延時指定毫秒,不大于255毫秒 */
extern UINT8 CH374DiskConnect( void ); /* 檢查磁盤是否連接并更新磁盤狀態 */
extern UINT8 CH374DiskReady( void ); /* 查詢磁盤是否準備好 */
extern void CH374DirtyBuffer( void ); /* 清除磁盤緩沖區 */
extern UINT8 CH374FileOpen( void ); /* 打開文件或者枚舉文件 */
extern UINT8 CH374FileClose( void ); /* 關閉當前文件 */
#ifdef EN_DISK_WRITE
extern UINT8 CH374FileErase( void ); /* 刪除文件并關閉 */
extern UINT8 CH374FileCreate( void ); /* 新建文件并打開,如果文件已經存在則先刪除后再新建 */
#endif
extern UINT8 CH374FileModify( void ); /* 查詢或者修改當前文件的信息 */
extern UINT8 CH374FileLocate( void ); /* 移動當前文件指針 */
extern UINT8 CH374FileReadX( void ); /* 從當前文件讀取數據到指定緩沖區 */
#ifdef EN_DISK_WRITE
extern UINT8 CH374FileWriteX( void ); /* 向當前文件寫入指定緩沖區的數據 */
#endif
#ifdef EN_BYTE_ACCESS
extern UINT8 CH374ByteLocate( void ); /* 以字節為單位移動當前文件指針 */
extern UINT8 CH374ByteRead( void ); /* 以字節為單位從當前位置讀取數據塊 */
#ifdef EN_DISK_WRITE
extern UINT8 CH374ByteWrite( void ); /* 以字節為單位向當前位置寫入數據塊 */
#endif
#endif
extern UINT8 CH374DiskSize( void ); /* 查詢磁盤容量 */
extern UINT8 CH374DiskQuery( void ); /* 查詢磁盤信息 */
#ifdef EN_SAVE_VARIABLE
extern void CH374SaveVariable( void ); /* 備份/保存/恢復子程序庫的變量,用于子程序庫在多個CH374芯片之間進行切換 */
#endif
extern UINT8 CH374BulkOnlyCmd( void ); /* 執行基于BulkOnly協議的命令 */
extern UINT8 CH374HostTransact( void ); /* 傳輸事務,需預先輸入CH374UsbPidIn,PID令牌+目的端點地址,同步標志,返回同CH375(除USB_INT_SUCCESS為ERR_SUCCESS),NAK及出錯重試 */
extern UINT8 CH374CtrlTransfer( void ); /* 執行控制傳輸,需預先寫入8字節請求碼,收發的數據在pDISK_BASE_BUF緩沖區 */
extern UINT8 CH374_READ_REGISTER( UINT8 mAddr ); /* 從指定寄存器讀取數據 */
extern void CH374_WRITE_REGISTER( UINT8 mAddr, UINT8 mData ); /* 向指定寄存器寫入數據 */
extern void CH374_READ_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8X mBuf ); /* 從指定起始地址讀出數據塊 */
extern void CH374_WRITE_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8X mBuf ); /* 向指定起始地址寫入數據塊 */
extern PUINT8X CH374_READ_BLOCK64( UINT8 mAddr, PUINT8X mBuf ); /* 從雙緩沖區讀出64字節的數據塊,返回當前地址 */
#ifdef EN_DISK_WRITE
extern PUINT8X CH374_WRITE_BLOCK64( UINT8 mAddr, PUINT8X mBuf ); /* 向雙緩沖區寫入64字節的數據塊,返回當前地址 */
#endif
extern void CH374_WRITE_BLOCK_C( UINT8 mLen, PUINT8C mBuf ); /* 向RAM_HOST_TRAN寫入常量型數據塊 */
/* 該頭文件可以為CH374子程序庫分配必要的I/O及內存資源,并產生必要的與硬件有關的目標代碼,
如果該文件是被工程項目的多個源程序包含作為頭文件,那么應該只允許一個頭文件分配資源和產生代碼,
除此之外的頭文件應該被事先定義CH374HF_NO_CODE,從而禁止該頭文件產生重復的目標代碼,例如:
#define CH374HF_NO_CODE 1
#include CH374HF?.H
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -