?? ch375hf6.h
字號:
UINT32 mReserved;
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 {
UINT8 mSectorCount;
UINT8 mActualCount;
UINT8 mLbaCount;
UINT8 mRemainCount;
UINT32 mLbaStart; /* 起始LBA */
PUINT8X mDataBuffer; /* 緩沖區 */
} ReadB; /* CMD_ReadBlock, 直接讀物理扇區 */
struct {
UINT8 mSectorCount;
UINT8 mActualCount;
UINT8 mLbaCount;
UINT8 mAllocCount;
UINT32 mLbaStart; /* 起始LBA */
PUINT8X mDataBuffer; /* 緩沖區 */
} WriteB; /* CMD_WriteBlock, 直接寫物理扇區 */
/* *********************************************************************************************** */
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則恢復單個U盤的變量,為0x80則恢復多個U盤的變量,其它值則備份/保存變量 */
UINT8 mReserved[3];
PUINT8X mBuffer; /* 輸入參數: 指向子程序庫的變量的備份緩沖區,長度不小于80個字節 */
} SaveVariable; /* CMD_SaveVariable, 備份/保存/恢復子程序庫的變量 */
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協議的命令, 如果有數據傳輸那么數據在pDISK_BASE_BUF中 */
} CMD_PARAM;
typedef CMD_PARAM idata CMD_PARAM_I;
typedef CMD_PARAM data *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 EN_SAVE_VARIABLE 1
#define EXT_BLK_INTERFACE 1
#define EN_SEC_SIZE_AUTO 1
#ifndef LIB_CFG_DISK_IO
#define LIB_CFG_DISK_IO 1 /* 默認情況下,磁盤讀寫的數據的復制方式為"單DPTR復制" */
#endif
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO 1 /* 默認情況下,文件讀寫的數據的復制方式為"單DPTR復制" */
#endif
#ifndef LIB_CFG_UPD_SIZE
#define LIB_CFG_UPD_SIZE 0 /* 默認情況下,在添加數據后文件長度的更新方式為"不更新" */
#endif
#ifndef LIB_CFG_NO_DLY
#define LIB_CFG_NO_DLY 0 /* 默認情況下,在寫操作結束后的延時方式為"寫后延時" */
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN 0 /* 默認情況下,CH375的INT#引腳連接方式為"查詢方式" */
#endif
#ifndef DISK_BASE_BUF_LEN
#define DISK_BASE_BUF_LEN 512 /* 默認的磁盤數據緩沖區大小為512字節,建議選擇為2048甚至4096以支持某些大扇區的U盤,為0則禁止在.H文件中定義緩沖區并由應用程序在pDISK_BASE_BUF中指定 */
#endif
#define LIB_CFG_VALUE ( ( LIB_CFG_INT_EN << 7 ) | ( LIB_CFG_NO_DLY << 5 ) | ( LIB_CFG_UPD_SIZE << 4 ) | ( LIB_CFG_FILE_IO << 2 ) | LIB_CFG_DISK_IO ) /* CH375程序庫配置值 */
#ifndef DISK_BASE_BUF_ADDR
/*#define DISK_BASE_BUF_ADDR 0*/ /* 如果未定義磁盤讀寫的緩沖區地址,那么假定磁盤讀寫的緩沖區從地址0開始 */
#endif
/* 子程序庫中提供的變量 */
extern UINT8DV CH375IntStatus; /* CH375操作的中斷狀態 */
extern UINT8DV CH375DiskStatus; /* 磁盤及文件狀態 */
extern UINT8D CH375LibConfig; /* CH375程序庫配置,下行說明 */
/* 位7: CH375的INT#引腳連接方式: 0查詢方式,1中斷方式 */
/* 位6: 該位為1且CH375Version2為1則芯片為CH375B */
/* 位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, 每傳輸一個字節需要8.5個機器周期, 速度較快, 適用于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并處理
*/
extern UINT8D CH375vDiskFat; /* 邏輯盤的FAT標志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8D CH375vSecPerClus; /* 邏輯盤的每簇扇區數 */
extern UINT32D CH375vStartCluster; /* 當前文件或者目錄的起始簇號 */
extern UINT32D CH375vFileSize; /* 當前文件的長度 */
extern UINT32D CH375vCurrentOffset; /* 當前文件指針,當前讀寫位置的字節偏移 */
/* 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 */
typedef FAT_DIR_INFO xdata *P_FAT_DIR_INFO;
extern BOOL1 CH375Version2; /* 芯片版本:0-CH375,1-CH375A/B */
extern UINT32X CH375vDataStart; /* 邏輯盤的數據區域的起始LBA */
extern UINT32D CH375vFdtLba; /* 當前FDT所在的LBA地址 */
extern UINT16D CH375vFdtOffset; /* 當前FDT在扇區內的偏移地址 */
extern UINT32X CH375vDiskRoot; /* 對于FAT16盤為根目錄占用扇區數,對于FAT32盤為根目錄起始簇號 */
#ifdef EN_SEC_SIZE_AUTO
extern UINT16X CH375vSectorSize; /* 磁盤的扇區大小 */
#else
#define CH375vSectorSize 512 /* 磁盤的扇區大小 */
#endif
extern PUINT8X data pDISK_BASE_BUF; /* 指向外部RAM的磁盤數據緩沖區,緩沖區長度不小于CH375vSectorSize,由應用程序初始化 */
extern UINT8 CH375ReadBlock( void ); /* 從磁盤讀取多個扇區的數據到外部接口交換區 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375WriteBlock( void ); /* 將外部接口交換區的多個扇區的數據塊寫入磁盤 */
#endif
/* 子程序庫中提供的子程序 */
/* 下述子程序中, 文件操作子程序CH375File*和磁盤查詢子程序CH375DiskQuery都可能會用到磁盤數據緩沖區pDISK_BASE_BUF,
并且有可能在pDISK_BASE_BUF中保存了磁盤信息, 所以必須保證pDISK_BASE_BUF不被用于其它用途,
如果RAM較少, 要將pDISK_BASE_BUF臨時用于其它用途, 那么在臨時用完后必須調用CH375DirtyBuffer清除磁盤緩沖區 */
extern UINT8 CH375GetVer( void ); /* 獲取當前子程序庫的版本號 */
extern void CH375Reset( void ); /* 復位CH375 */
extern UINT8 CH375Init( void ); /* 初始化CH375 */
extern UINT8 CH375DiskConnect( void ); /* 檢查磁盤是否連接 */
extern UINT8 CH375DiskReady( void ); /* 查詢磁盤是否準備好 */
extern void CH375DirtyBuffer( void ); /* 清除磁盤緩沖區 */
extern UINT8 CH375FileOpen( void ); /* 打開文件或者枚舉文件 */
extern UINT8 CH375FileClose( void ); /* 關閉當前文件 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375FileErase( void ); /* 刪除文件并關閉 */
extern UINT8 CH375FileCreate( void ); /* 新建文件并打開,如果文件已經存在則先刪除后再新建 */
#endif
extern UINT8 CH375FileModify( void ); /* 查詢或者修改當前文件的信息 */
extern UINT8 CH375FileLocate( void ); /* 移動當前文件指針 */
extern UINT8 CH375FileReadX( void ); /* 從當前文件讀取數據到指定緩沖區 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375FileWriteX( void ); /* 向當前文件寫入指定緩沖區的數據 */
#endif
#ifdef EN_BYTE_ACCESS
extern UINT8 CH375ByteLocate( void ); /* 以字節為單位移動當前文件指針 */
extern UINT8 CH375ByteRead( void ); /* 以字節為單位從當前位置讀取數據塊 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375ByteWrite( void ); /* 以字節為單位向當前位置寫入數據塊 */
#endif
#endif
extern UINT8 CH375DiskSize( void ); /* 查詢磁盤容量 */
extern UINT8 CH375DiskQuery( void ); /* 查詢磁盤信息 */
#ifdef EN_SAVE_VARIABLE
extern void CH375SaveVariable( void ); /* 備份/保存/恢復子程序庫的變量,用于子程序庫在多個CH375芯片之間進行切換 */
#endif
extern UINT8 CH375BulkOnlyCmd( void ); /* 執行基于BulkOnly協議的命令 */
extern UINT8 CH375sDiskReady( void ); /* 查詢磁盤是否準備好,支持CH375S */
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -