?? ch375hf4.inc
字號:
;USB_INT_DISK_WRITE EQU 01EH ; USB存儲器寫數據塊,只用于CMD_FileWrite命令,請求數據寫入 */
ERR_USB_DISK_ERR EQU 01FH ; USB存儲器操作失敗,在初始化時可能是USB存儲器不支持,在讀寫操作中可能是磁盤損壞或者已經斷開 */
; 最終狀態碼 */
ERR_SUCCESS EQU 000H ; 操作成功 */
ERR_CH375_ERROR EQU 081H ; CH375硬件錯誤,可能需要復位CH375 */
ERR_DISK_DISCON EQU 082H ; 檢測到USB設備連接事件,磁盤已經斷開,或者磁盤尚未連接 */
ERR_STATUS_ERR EQU 083H ; 磁盤狀態錯誤,可能正在連接或者斷開磁盤 */
ERR_MBR_ERROR EQU 091H ; 磁盤的主引導記錄無效,可能磁盤尚未分區或者尚未格式化 */
ERR_TYPE_ERROR EQU 092H ; 磁盤分區類型不支持,只支持FAT12/FAT16/BigDOS/FAT32,需要由磁盤管理工具重新分區 */
ERR_BPB_ERROR EQU 0A1H ; 磁盤尚未格式化,或者參數錯誤,需要由WINDOWS采用默認參數重新格式化 */
ERR_TOO_LARGE EQU 0A2H ; 磁盤非正常格式化并且容量大于4GB,或者容量大于250GB,需要由WINDOWS采用默認參數重新格式化 */
ERR_FAT_ERROR EQU 0A3H ; 磁盤的文件系統不支持,只支持FAT12/FAT16/FAT32,需要由WINDOWS采用默認參數重新格式化 */
ERR_DISK_FULL EQU 0B1H ; 磁盤文件太滿,剩余空間太少或者已經沒有,需要磁盤整理 */
ERR_FDT_OVER EQU 0B2H ; 目錄內文件太多,沒有空閑的目錄項,FAT12/FAT16根目錄下的文件數應該少于500個,需要磁盤整理 */
ERR_MISS_DIR EQU 0B3H ; 指定路徑的某個子目錄沒有找到,可能是目錄名稱錯誤 */
ERR_FILE_CLOSE EQU 0B4H ; 文件已經關閉,如果需要使用,應該重新打開文件 */
ERR_OPEN_DIR EQU 041H ; 指定路徑的目錄被打開 */
ERR_MISS_FILE EQU 042H ; 指定路徑的文件沒有找到,可能是文件名稱錯誤 */
ERR_FOUND_NAME EQU 043H ; 搜索到與通配符相匹配的文件名,文件名及其完整路徑在命令緩沖區中,如果需要使用,應該打開該文件 */
; 其余錯誤代碼未定義 */
; ********************************************************************************************************************* */
; 磁盤及文件狀態,適用于CH375DiskStatus */
DISK_UNKNOWN EQU 000H ; 尚未初始化,未知狀態 */
DISK_DISCONNECT EQU 001H ; 磁盤沒有連接或者已經斷開 */
DISK_CONNECT EQU 002H ; 磁盤已經連接,但是尚未初始化或者無法識別該磁盤 */
DISK_MOUNTED EQU 003H ; 磁盤已經初始化成功,但是尚未分析文件系統或者文件系統不支持 */
DISK_READY EQU 010H ; 已經分析磁盤的文件系統并且能夠支持 */
DISK_OPEN_ROOT EQU 012H ; 已經打開根目錄,扇區模式,只能以扇區為單位讀寫目錄的內容,使用后必須關閉,注意FAT12/FAT16根目錄是固定長度 */
DISK_OPEN_DIR EQU 013H ; 已經打開子目錄,扇區模式,只能以扇區為單位讀寫目錄的內容 */
DISK_OPEN_FILE EQU 014H ; 已經打開文件,扇區模式,可以以扇區為單位進行數據讀寫 */
DISK_OPEN_FILE_B EQU 015H ; 已經打開文件,字節模式,可以以字節為單位進行數據讀寫 */
; ********************************************************************************************************************* */
; FAT類型標志,適用于CMD_PARAM.Query.mDiskFat */
DISK_FS_UNKNOWN EQU 0 ; 未知的文件系統 */
DISK_FAT12 EQU 1 ; FAT12文件系統 */
DISK_FAT16 EQU 2 ; FAT16文件系統 */
DISK_FAT32 EQU 3 ; FAT32文件系統 */
; ********************************************************************************************************************* */
; 文件屬性,適用于CMD_PARAM.Modify.mFileAttr */
ATTR_READ_ONLY EQU 001H ; 文件為只讀屬性 */
ATTR_HIDDEN EQU 002H ; 文件為隱含屬性 */
ATTR_SYSTEM EQU 004H ; 文件為系統屬性 */
ATTR_VOLUME_ID EQU 008H ; 卷標 */
ATTR_DIRECTORY EQU 010H ; 子目錄 */
ATTR_ARCHIVE EQU 020H ; 文件為存檔屬性 */
;ATTR_LONG_NAME ( ATTR_READ_ONLY | ATTR_HIDDEN | ATTR_SYSTEM | ATTR_VOLUME_ID )
; 文件屬性 unsigned char */
; bit0 bit1 bit2 bit3 bit4 bit5 bit6 bit7 */
; 只 隱 系 卷 目 存 未定義 */
; 讀 藏 統 標 錄 檔 */
; 文件時間 unsigned short,適用于CMD_PARAM.Modify.mFileTime */
; Time = (Hour<<11) + (Minute<<5) + (Second>>1) */
; 文件日期 unsigned short,適用于CMD_PARAM.Modify.mFileDate */
; Date = ((Year-1980)<<9) + (Month<<5) + Day */
; ********************************************************************************************************************* */
; 文件名,適用于CMD_PARAM.?.mPathName */
PATH_WILDCARD_CHAR EQU 02AH ; 路徑名的通配符 '*' */
PATH_SEPAR_CHAR1 EQU 05CH ; 路徑名的分隔符 '\' */
PATH_SEPAR_CHAR2 EQU 02FH ; 路徑名的分隔符 '/' */
#ifndef MAX_PATH_LEN
MAX_PATH_LEN EQU 30 ; 最大路徑長度,含所有斜杠分隔符和小數點間隔符以及路徑結束符00H */
#endif
#ifndef MAX_BYTE_IO
MAX_BYTE_IO EQU ( MAX_PATH_LEN - 1 ) ; 以字節為單位單次讀寫文件時的最大長度,超過該長度可以分多次讀寫 */
#endif
; 外部命令參數結構, 用于在調用CH375程序庫中的子程序時提供參數
;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];
; PUINT8X mDataBuffer; /* 輸入參數: 緩沖區起始地址, 返回: 緩沖區當前地址 */
; } ReadX; /* CMD_FileReadX, 從當前文件讀取數據到指定緩沖區 */
; struct {
; UINT8 mSectorCount; /* 輸入參數: 寫入扇區數, 返回: 實際寫入扇區數 */
; UINT8 mReserved[7];
; 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, 以字節為單位向當前文件寫入數據塊 */
; 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;
#define EN_DISK_WRITE 1
#define EN_DISK_FAT12 1
;#define EN_DISK_FAT32 1 ;使用CH375HF6.LIB時請啟用該常量定義
#define EN_BYTE_ACCESS 1
; ********************************************************************************************************************* */
; 段定義
CH375LIB_CODE SEGMENT CODE
CH375LIB_IDATA SEGMENT IDATA
; ********************************************************************************************************************* */
; 子程序庫中提供的變量 */
EXTRN DATA (CH375IntStatus) ;CH375操作的中斷狀態
EXTRN DATA (CH375DiskStatus) ;磁盤及文件狀態
EXTRN DATA (CH375LibConfig) ;CH375程序庫配置,下行說明
; 位7: CH375的INT#引腳連接方式: 0查詢方式,1中斷方式 */
; 位5: 在寫操作結束后是否延時: 0寫后延時,1不延時 */
; 位4: 在添加數據后是否自動更新文件長度: 0不更新,1自動更新 */
; 位3位2: 針對文件讀寫的多扇區數據的復制方式: 00外部子程序, 01單DPTR復制, 10雙DPTR復制, 11單DPTR和P2+R0復制 */
; 位1位0: 針對磁盤讀寫的單扇區數據的復制方式: 00單DPTR復制, 01單DPTR復制, 10雙DPTR復制, 11單DPTR和P2+R0復制 */
; 如果CH375的INT#引腳連接到單片機的中斷輸入引腳并且準備使用中斷方式,那么LIB_CFG_INT_EN定義為1,否則定義為0由單片機查詢INT#引腳 */
; 由于MCS51單片機復制外部RAM中的數據時比較慢,所以CH375的程序庫提供幾種優化速度的方式,在LIB_CFG_FILE_IO和LIB_CFG_DISK_IO中定義:
; 方式0:"外部子程序", 只適用于文件讀寫時的數據復制(只用于CH375FileReadX和CH375FileWriteX兩個子程序),LIB_CFG_DISK_IO不支持方式0,
; 是指由子程序xWriteToExtBuf和xReadFromExtBuf進行數據復制,這兩個子程序是在應用程序中定義的,由CH375的程序庫調用,
; 方式1:"單DPTR復制", 最常規的數據復制方式, 使用一個DPTR來回切換, 每傳輸一個字節需要16個機器周期, 速度最慢, 適用于所有MCS51單片機,
; 方式2:"雙DPTR復制", 針對特定硬件的數據復制方式, 使用兩個DPTR, 每傳輸一個字節需要10個機器周期, 速度較快, 適用于ATMEL/PHILIPS/SST等具有雙DPTR的單片機,
; 方式3:"單DPTR和P2+R0復制", 用P2+R0指向CH375的I/O端口并且用DPTR指向外部RAM進行數據復制, 每傳輸一個字節需要6.25個機器周期, 速度最快,
; 適用于所有標準的MCS51單片機, 但是某些單片機在啟用內置的外部RAM時會關閉P2+R0的功能, 所以可能不適用,
; 對于文件數據讀寫,也就是應用程序調用CH375FileReadX和CH375FileWriteX子程序時:
; 在方式0下,由應用程序在xWriteToExtBuf和xReadFromExtBuf子程序中自行管理緩沖區,設定緩沖區初值等,
; 在方式1,2,3下,應用程序每次調用CH375FileReadX和CH375FileWriteX時,CH375的程序庫都會從指定緩沖區的起始地址開始讀寫數據,
; 例如: 某文件長度為1K(占用2個扇區), 如果調用CH375FileReadX時讀1K(指定mCmdParam.Read.mSectorCount為2), 那么1K數據全讀到指定緩沖區中,
; 如果緩沖區較小只有0.5K, 那么分兩次讀取, 第一次調用CH375FileReadX時讀0.5K, 處理完這0.5K數據后再調用CH375FileReadX讀下一個0.5K并處理
EXTRN DATA (CH375vDiskFat) ;邏輯盤的FAT標志:1=FAT12,2=FAT16,3=FAT32
EXTRN DATA (CH375vSecPerClus) ;邏輯盤的每簇扇區數
EXTRN DATA (CH375vStartCluster) ;當前文件或者目錄的起始簇號,UINT32
EXTRN DATA (CH375vFileSize) ;當前文件的長度,UINT32
EXTRN DATA (CH375vCurrentOffset) ;當前文件指針,當前讀寫位置的字節偏移
#ifdef EN_CH375LIB_MORE
; FAT數據區中文件目錄信息 */
;typedef struct _FAT_DIR_INFO {
; UINT8 DIR_Name[11]; /* 00H,文件名,共11字節,不足處填空格 */
; UINT8 DIR_Attr; /* 0BH,文件屬性,參考前面的說明 */
; UINT8 DIR_NTRes; /* 0CH */
; UINT8 DIR_CrtTimeTenth; /* 0DH,文件創建的時間,以0.1秒單位計數 */
; UINT16 DIR_CrtTime; /* 0EH,文件創建的時間 */
; UINT16 DIR_CrtDate; /* 10H,文件創建的日期 */
; 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 */
EXTRN BIT (CH375Version2) ;芯片版本:0-CH375,1-CH375A
EXTRN DATA (CH375vDataStart) ;邏輯盤的數據區域的起始LBA,UINT32
EXTRN IDATA (CH375vFdtLba) ;當前FDT所在的LBA地址,UINT32
EXTRN DATA (CH375vFdtOffset) ;當前FDT在扇區內的偏移地址,UINT16
#ifdef EN_DISK_FAT32
EXTRN IDATA (CH375vDiskRoot) ;對于FAT16盤為根目錄占用扇區數,對于FAT32盤為根目錄起始簇號,UINT32
#else
EXTRN IDATA (CH375vDiskRoot) ;對于FAT16盤為根目錄占用扇區數
#endif
EXTRN CODE (CH375ReadBlock) ; 從磁盤讀取多個扇區的數據到外部接口交換區 */
#ifdef EN_DISK_WRITE
EXTRN CODE (CH375WriteBlock) ; 將外部接口交換區的多個扇區的數據塊寫入磁盤 */
#endif
#endif
#ifndef LIB_CFG_VALUE
#define LIB_CFG_VALUE 05H ; CH375程序庫配置值 */
#endif
; ********************************************************************************************************************* */
; 子程序庫中提供的子程序, 操作完成后返回狀態碼在R7中 */
; 下述子程序中, 文件操作子程序CH375File*和磁盤查詢子程序CH375DiskQuery都可能會用到磁盤數據緩沖區DISK_BASE_BUF,
; 并且有可能在DISK_BASE_BUF中保存了磁盤信息, 所以必須保證DISK_BASE_BUF不被用于其它用途,
; 如果RAM較少, 要將DISK_BASE_BUF臨時用于其它用途, 那么在臨時用完后必須調用CH375DirtyBuffer清除磁盤緩沖區 */
EXTRN CODE (CH375GetVer) ; 獲取當前子程序庫的版本號 */
EXTRN CODE (CH375Reset) ; 復位CH375 */
EXTRN CODE (CH375Init) ; 初始化CH375 */
EXTRN CODE (CH375DirtyBuffer) ; 清除磁盤緩沖區 */
EXTRN CODE (CH375FileOpen) ; 打開文件或者枚舉文件 */
EXTRN CODE (CH375FileEnumer) ; 枚舉文件 */
EXTRN CODE (CH375FileClose) ; 關閉當前文件 */
EXTRN CODE (CH375FileQuery) ; 查詢當前文件的信息 */
EXTRN CODE (CH375FileModify) ; 查詢或者修改當前文件的信息 */
EXTRN CODE (CH375FileLocate) ; 移動當前文件指針 */
EXTRN CODE (CH375FileReadX) ; 從當前文件讀取數據到指定緩沖區 */
#ifdef EN_DISK_WRITE
EXTRN CODE (CH375FileErase) ; 刪除文件并關閉 */
EXTRN CODE (CH375FileCreate) ; 新建文件并打開,如果文件已經存在則先刪除后再新建 */
EXTRN CODE (CH375FileWriteX) ; 向當前文件寫入指定緩沖區的數據 */
EXTRN CODE (CH375DiskSize) ; 查詢磁盤容量 */
EXTRN CODE (CH375DiskQuery) ; 查詢磁盤信息 */
#endif
#ifdef EN_BYTE_ACCESS
EXTRN CODE (CH375ByteLocate) ; 以字節為單位移動當前文件指針 */
EXTRN CODE (CH375ByteRead) ; 以字節為單位從當前位置讀取數據塊 */
#ifdef EN_DISK_WRITE
EXTRN CODE (CH375ByteWrite) ; 以字節為單位向當前位置寫入數據塊 */
#endif
#endif
EXTRN CODE (CH375BulkOnlyCmd) ; 執行基于BulkOnly協議的命令 */
EXTRN CODE (CH375DiskReady) ; 查詢磁盤是否準備好 */
EXTRN CODE (CH375DiskConnect) ; 檢查磁盤是否連接 */
; 該頭文件可以為CH375子程序庫分配必要的I/O及內存資源,并產生必要的與硬件有關的目標代碼,
; 如果該文件是被工程項目的多個源程序包含作為頭文件,那么應該只允許一個頭文件分配資源和產生代碼,
; 除此之外的頭文件應該被事先定義CH375HF_NO_CODE,從而禁止該頭文件產生重復的目標代碼,例如:
; #define CH375HF_NO_CODE 1
; $include (CH375HF?.INC)
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -