?? ch375hfj.h
字號:
#define LIB_CFG_UPD_SIZE 0 /* 默認(rèn)情況下,在添加數(shù)據(jù)后文件長度的更新方式為"不更新" */
#endif
#ifndef LIB_CFG_NO_DLY
#define LIB_CFG_NO_DLY 0 /* 默認(rèn)情況下,在寫操作結(jié)束后的延時方式為"寫后延時" */
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN 0 /* 默認(rèn)情況下,CH375的INT#引腳連接方式為"查詢方式" */
#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 0x0200*/ /* 如果未定義磁盤讀寫的緩沖區(qū)地址,那么假定磁盤讀寫的緩沖區(qū)從RAM的起始地址0200H開始 */
#endif
/* 子程序庫中提供的變量 */
extern UINT8V CH375IntStatus; /* CH375操作的中斷狀態(tài) */
extern UINT8V CH375DiskStatus; /* 磁盤及文件狀態(tài) */
extern UINT8 CH375LibConfig; /* CH375程序庫配置,下行說明 */
/* 位7: CH375的INT#引腳連接方式: 0查詢方式,1中斷方式 */
/* 位5: 在寫操作結(jié)束后是否延時: 0寫后延時,1不延時 */
/* 位4: 在添加數(shù)據(jù)后是否自動更新文件長度: 0不更新,1自動更新 */
/* 位3位2: 針對文件讀寫的多扇區(qū)數(shù)據(jù)的復(fù)制方式: 00外部子程序, 01,10,11內(nèi)部復(fù)制 */
/* 位1位0: 針對磁盤讀寫的單扇區(qū)數(shù)據(jù)的復(fù)制方式: 總是內(nèi)部復(fù)制 */
/* 如果CH375的INT#引腳連接到單片機的中斷輸入引腳并且準(zhǔn)備使用中斷方式,那么LIB_CFG_INT_EN定義為1,否則定義為0由單片機查詢INT#引腳 */
/* 在CH375子程序讀寫文件數(shù)據(jù)時,CH375的程序庫提供兩種優(yōu)化速度的方式,在LIB_CFG_FILE_IO中定義:
方式0:"外部子程序", 只適用于文件讀寫時的數(shù)據(jù)復(fù)制(只用于CH375FileReadX和CH375FileWriteX兩個子程序),
是指由子程序xWriteToExtBuf和xReadFromExtBuf進行數(shù)據(jù)復(fù)制,這兩個子程序是在應(yīng)用程序中定義的,由CH375的程序庫調(diào)用,
方式1:"內(nèi)部復(fù)制", 程序內(nèi)置的常規(guī)數(shù)據(jù)復(fù)制方式
對于文件數(shù)據(jù)讀寫,也就是應(yīng)用程序調(diào)用CH375FileReadX和CH375FileWriteX子程序時:
在方式0下,由應(yīng)用程序在xWriteToExtBuf和xReadFromExtBuf子程序中自行管理緩沖區(qū),設(shè)定緩沖區(qū)初值等,
在方式1下,應(yīng)用程序每次調(diào)用CH375FileReadX和CH375FileWriteX時,CH375的程序庫都會從指定緩沖區(qū)的起始地址開始讀寫數(shù)據(jù),
例如: 某文件長度為1K(占用2個扇區(qū)), 如果調(diào)用CH375FileReadX時讀1K(指定mCmdParam.Read.mSectorCount為2), 那么1K數(shù)據(jù)全讀到指定緩沖區(qū)中,
如果緩沖區(qū)較小只有0.5K, 那么分兩次讀取, 第一次調(diào)用CH375FileReadX時讀0.5K, 處理完這0.5K數(shù)據(jù)后再調(diào)用CH375FileReadX讀下一個0.5K并處理
*/
extern UINT8 CH375vDiskFat; /* 邏輯盤的FAT標(biāo)志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8 CH375vSecPerClus; /* 邏輯盤的每簇扇區(qū)數(shù) */
extern UINT32 CH375vStartCluster; /* 當(dāng)前文件或者目錄的起始簇號 */
extern UINT32 CH375vFileSize; /* 當(dāng)前文件的長度 */
extern UINT32 CH375vCurrentOffset; /* 當(dāng)前文件指針,當(dāng)前讀寫位置的字節(jié)偏移 */
#ifdef EN_CH375LIB_MORE
/* 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;
extern BOOL1 CH375Version2; /* 芯片版本:0-CH375,1-CH375A */
extern UINT32 CH375vDataStart; /* 邏輯盤的數(shù)據(jù)區(qū)域的起始LBA */
extern UINT32 CH375vFdtLba; /* 當(dāng)前FDT所在的LBA地址 */
extern UINT16 CH375vFdtOffset; /* 當(dāng)前FDT在扇區(qū)內(nèi)的偏移地址 */
#ifdef EN_DISK_FAT32
extern UINT32 CH375vDiskRoot; /* 對于FAT16盤為根目錄占用扇區(qū)數(shù),對于FAT32盤為根目錄起始簇號 */
#else
extern UINT8 CH375vDiskRoot; /* 對于FAT16盤為根目錄占用扇區(qū)數(shù) */
#endif
extern UINT8 CH375ReadBlock( void ); /* 從磁盤讀取多個扇區(qū)的數(shù)據(jù)到外部接口交換區(qū) */
#ifdef EN_DISK_WRITE
extern UINT8 CH375WriteBlock( void ); /* 將外部接口交換區(qū)的多個扇區(qū)的數(shù)據(jù)塊寫入磁盤 */
#endif
#endif
/* 子程序庫中提供的子程序 */
/* 下述子程序中, 文件操作子程序CH375File*和磁盤查詢子程序CH375DiskQuery都可能會用到磁盤數(shù)據(jù)緩沖區(qū)DISK_BASE_BUF,
并且有可能在DISK_BASE_BUF中保存了磁盤信息, 所以必須保證DISK_BASE_BUF不被用于其它用途,
如果RAM較少, 要將DISK_BASE_BUF臨時用于其它用途, 那么在臨時用完后必須調(diào)用CH375DirtyBuffer清除磁盤緩沖區(qū) */
extern UINT8 CH375GetVer( void ); /* 獲取當(dāng)前子程序庫的版本號 */
extern void CH375Reset( void ); /* 復(fù)位CH375 */
extern UINT8 CH375Init( void ); /* 初始化CH375 */
extern void CH375DirtyBuffer( void ); /* 清除磁盤緩沖區(qū) */
extern UINT8 CH375FileOpen( void ); /* 打開文件或者枚舉文件 */
extern UINT8 CH375FileEnumer( void ); /* 枚舉文件 */
extern UINT8 CH375FileClose( void ); /* 關(guān)閉當(dāng)前文件 */
extern UINT8 CH375FileQuery( void ); /* 查詢當(dāng)前文件的信息 */
extern UINT8 CH375FileModify( void ); /* 查詢或者修改當(dāng)前文件的信息 */
extern UINT8 CH375FileLocate( void ); /* 移動當(dāng)前文件指針 */
extern UINT8 CH375FileReadX( void ); /* 從當(dāng)前文件讀取數(shù)據(jù)到指定緩沖區(qū) */
#ifdef EN_DISK_WRITE
extern UINT8 CH375FileErase( void ); /* 刪除文件并關(guān)閉 */
extern UINT8 CH375FileCreate( void ); /* 新建文件并打開,如果文件已經(jīng)存在則先刪除后再新建 */
extern UINT8 CH375FileWriteX( void ); /* 向當(dāng)前文件寫入指定緩沖區(qū)的數(shù)據(jù) */
extern UINT8 CH375DiskSize( void ); /* 查詢磁盤容量 */
extern UINT8 CH375DiskQuery( void ); /* 查詢磁盤信息 */
#endif
#ifdef EN_BYTE_ACCESS
extern UINT8 CH375ByteLocate( void ); /* 以字節(jié)為單位移動當(dāng)前文件指針 */
extern UINT8 CH375ByteRead( void ); /* 以字節(jié)為單位從當(dāng)前位置讀取數(shù)據(jù)塊 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375ByteWrite( void ); /* 以字節(jié)為單位向當(dāng)前位置寫入數(shù)據(jù)塊 */
#endif
#endif
extern UINT8 CH375BulkOnlyCmd( void ); /* 執(zhí)行基于BulkOnly協(xié)議的命令 */
extern UINT8 CH375DiskReady( void ); /* 查詢磁盤是否準(zhǔn)備好 */
extern UINT8 CH375DiskConnect( void ); /* 檢查磁盤是否連接 */
/* 該頭文件可以為CH375子程序庫分配必要的I/O及內(nèi)存資源,并產(chǎn)生必要的與硬件有關(guān)的目標(biāo)代碼,
如果該文件是被工程項目的多個源程序包含作為頭文件,那么應(yīng)該只允許一個頭文件分配資源和產(chǎn)生代碼,
除此之外的頭文件應(yīng)該被事先定義CH375HF_NO_CODE,從而禁止該頭文件產(chǎn)生重復(fù)的目標(biāo)代碼,例如:
#define CH375HF_NO_CODE 1
#include CH375HF?.H
*/
#ifdef CH375HF_NO_CODE
extern CMD_PARAM_I mCmdParam; /* 命令參數(shù) */
extern UINT8 DISK_BASE_BUF[512]; /* 外部RAM的磁盤數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度為一個扇區(qū)的長度 */
#ifdef FILE_DATA_BUF_LEN
extern UINT8 FILE_DATA_BUF[ FILE_DATA_BUF_LEN ]; /* 外部RAM的文件數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度不小于一次讀寫的數(shù)據(jù)長度 */
extern UINT8 CH375FileRead( void ); /* 從當(dāng)前文件讀取數(shù)據(jù) */
#ifdef EN_DISK_WRITE
extern UINT8 CH375FileWrite( void ); /* 向當(dāng)前文件寫入數(shù)據(jù) */
#endif
#endif
extern void xQueryInterrupt( void ); /* 外部定義的被CH375程序庫調(diào)用的子程序,查詢CH375中斷并更新中斷狀態(tài) */
extern UINT8 CH375LibInit( void ); /* 初始化CH375程序庫和CH375芯片,操作成功返回0 */
#else
void xWriteCH375Cmd( UINT8 mCmd ); /* 外部定義的被CH375程序庫調(diào)用的子程序,向CH375寫命令 */
void xWriteCH375Data( UINT8 mData ); /* 外部定義的被CH375程序庫調(diào)用的子程序,向CH375寫數(shù)據(jù) */
UINT8 xReadCH375Data( void ); /* 外部定義的被CH375程序庫調(diào)用的子程序,從CH375讀數(shù)據(jù) */
CMD_PARAM_I mCmdParam; /* 命令參數(shù) */
#ifdef DISK_BASE_BUF_ADDR
__no_init UINT8 DISK_BASE_BUF[512] @ DISK_BASE_BUF_ADDR; /* 外部RAM的磁盤數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度為一個扇區(qū)的長度 */
#else
UINT8 DISK_BASE_BUF[512]; /* 外部RAM的磁盤數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度為一個扇區(qū)的長度,起始地址必須為偶地址 */
#endif
#ifdef FILE_DATA_BUF_LEN
#ifdef FILE_DATA_BUF_ADDR
__no_init UINT8 FILE_DATA_BUF[ FILE_DATA_BUF_LEN ] @ FILE_DATA_BUF_ADDR; /* 外部RAM的文件數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度不小于一次讀寫的數(shù)據(jù)長度 */
#else
UINT8 FILE_DATA_BUF[ FILE_DATA_BUF_LEN ]; /* 外部RAM的文件數(shù)據(jù)緩沖區(qū),緩沖區(qū)長度不小于一次讀寫的數(shù)據(jù)長度,起始地址建議為偶地址 */
#endif
UINT8 CH375FileRead( void ) /* 從當(dāng)前文件讀取數(shù)據(jù) */
{
mCmdParam.ReadX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數(shù)據(jù)緩沖區(qū) */
return( CH375FileReadX( ) );
}
#ifdef EN_DISK_WRITE
UINT8 CH375FileWrite( void ) /* 向當(dāng)前文件寫入數(shù)據(jù) */
{
mCmdParam.WriteX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數(shù)據(jù)緩沖區(qū) */
return( CH375FileWriteX( ) );
}
#endif
#endif
/* 以下程序可以根據(jù)需要修改 */
#ifndef NO_DEFAULT_CH375_INT /* 在應(yīng)用程序中定義NO_DEFAULT_CH375_INT可以禁止默認(rèn)的中斷處理程序,然后用自行編寫的程序代替它 */
#if LIB_CFG_INT_EN == 0 /* CH375的INT#引腳連接方式為"查詢方式" */
void xQueryInterrupt( void ) /* 查詢CH375中斷并更新中斷狀態(tài) */
{
while ( CH375_INT_WIRE ); /* 如果CH375的中斷引腳輸出高電平則等待 */
CH375IntStatus = 3;
xWriteCH375Cmd( CMD_GET_STATUS ); /* 獲取當(dāng)前中斷狀態(tài) */
while ( -- CH375IntStatus ); /* 操作無意義,用于至少延時2uS */
CH375IntStatus = xReadCH375Data( ); /* 獲取中斷狀態(tài) */
if ( CH375IntStatus == USB_INT_DISCONNECT ) CH375DiskStatus = DISK_DISCONNECT; /* 檢測到USB設(shè)備斷開事件 */
else if ( CH375IntStatus == USB_INT_CONNECT ) CH375DiskStatus = DISK_CONNECT; /* 檢測到USB設(shè)備連接事件 */
}
#else /* LIB_CFG_INT_EN != 0, CH375的INT#引腳連接方式為"中斷方式" */
void xQueryInterrupt( void ) /* 查詢中斷狀態(tài),等待硬件中斷 */
{
while ( CH375IntStatus == 0 ); /* 子程序庫調(diào)用該子程序之前CH375IntStatus=0,硬件中斷后,由中斷服務(wù)程序置為非0的實際中斷狀態(tài)后返回 */
}
#pragma vector = CH375_INT_VECTOR
__interrupt void CH375Interrupt( void ) /* CH375中斷服務(wù)程序,由CH375的INT#的低電平或者下降沿觸發(fā)單片機中斷 */
{
CH375IntStatus = 3;
xWriteCH375Cmd( CMD_GET_STATUS ); /* 獲取中斷狀態(tài)并取消中斷請求 */
while ( -- CH375IntStatus ); /* 操作無意義,用于至少延時2uS */
CH375IntStatus = xReadCH375Data( ); /* 獲取中斷狀態(tài) */
if ( CH375IntStatus == USB_INT_DISCONNECT ) CH375DiskStatus = DISK_DISCONNECT; /* 檢測到USB設(shè)備斷開事件 */
else if ( CH375IntStatus == USB_INT_CONNECT ) CH375DiskStatus = DISK_CONNECT; /* 檢測到USB設(shè)備連接事件 */
}
#endif
#endif
#if LIB_CFG_FILE_IO == 0 /* 文件讀寫的數(shù)據(jù)的復(fù)制方式為"外部子程序" */
#ifdef LIB_CFG_FILE_IO_DEFAULT /* 如果應(yīng)用程序中定義該值則使用默認(rèn)"外部子程序",否則應(yīng)該自行編寫程序代替 */
unsigned char *current_buffer; /* 保存文件數(shù)據(jù)讀寫時的緩沖區(qū)的當(dāng)前指針,由應(yīng)用程序在調(diào)用CH375FileReadX和CH375FileWriteX子程序前設(shè)置初值 */
void xWriteToExtBuf( UINT8 mLength ) /* 該子程序由CH375的子程序庫調(diào)用,用于從CH375讀取文件數(shù)據(jù)到外部緩沖區(qū),被CH375FileReadX調(diào)用 */
{
/* if ( (UINT16)current_buffer + mLength >= (UINT16)&FILE_DATA_BUF + sizeof( FILE_DATA_BUF ) ) return;*/ /* 防止緩沖區(qū)溢出 */
if ( mLength ) {
do { /* 根據(jù)長度讀取數(shù)據(jù),實際上長度總是CH375_MAX_DATA_LEN,也就是64 */
*current_buffer = xReadCH375Data( ); /* 讀出數(shù)據(jù)并保存,可以用這種方式將文件數(shù)據(jù)保存到單片機的各種串行存儲器中 */
current_buffer ++;
} while ( -- mLength );
} /* 復(fù)制上述數(shù)據(jù)的總時間不得超過2mS */
else { /* 重試,恢復(fù)緩沖區(qū)起址,如果將文件數(shù)據(jù)讀寫的緩沖區(qū)的當(dāng)前指針放在mCmdParam.ReadX.mDataBuffer中則會被自動恢復(fù),無需下面的兩行程序 */
current_buffer += (UINT16)mCmdParam.ReadX.mDataBuffer; /* mDataBuffer中為負(fù)值 */
mCmdParam.ReadX.mDataBuffer = 0; /* 為了支持重試,在調(diào)用CH375FileReadX之前也應(yīng)該清0 */
}
}
#ifdef EN_DISK_WRITE
void xReadFromExtBuf( UINT8 mLength ) /* 該子程序由CH375的子程序庫調(diào)用,用于從外部緩沖區(qū)讀取文件數(shù)據(jù)到CH375,被CH375FileWriteX調(diào)用 */
{
if ( mLength ) {
do { /* 根據(jù)長度寫入數(shù)據(jù),實際上長度總是CH375_MAX_DATA_LEN,也就是64 */
xWriteCH375Data( *current_buffer ); /* 將數(shù)據(jù)寫入,可以用這種方式從單片機的各種串行存儲器中取出文件數(shù)據(jù) */
current_buffer ++;
} while ( -- mLength );
} /* 復(fù)制上述數(shù)據(jù)的總時間不得超過2mS */
else { /* 重試,恢復(fù)緩沖區(qū)起址,如果將文件數(shù)據(jù)讀寫的緩沖區(qū)的當(dāng)前指針放在mCmdParam.WriteX.mDataBuffer中則會被自動恢復(fù),無需下面的兩行程序 */
current_buffer += (UINT16)mCmdParam.WriteX.mDataBuffer; /* mDataBuffer中為負(fù)值 */
mCmdParam.WriteX.mDataBuffer = 0; /* 為了支持重試,在調(diào)用CH375FileWriteX之前也應(yīng)該清0 */
}
}
#endif
#endif
#else /* LIB_CFG_FILE_IO != 0,文件讀寫的數(shù)據(jù)的復(fù)制方式不是"外部子程序" */
void xWriteToExtBuf( UINT8 mLength ) /* 不會調(diào)用該子程序 */
{
mLength --; /* 該操作無意義,只是避免出現(xiàn)警告信息 */
}
#ifdef EN_DISK_WRITE
void xReadFromExtBuf( UINT8 mLength ) /* 不會調(diào)用該子程序 */
{
mLength --; /* 該操作無意義,只是避免出現(xiàn)警告信息 */
}
#endif
#endif
UINT8 CH375LibInit( void ) /* 初始化CH375程序庫和CH375芯片,操作成功返回0 */
{
CH375LibConfig = LIB_CFG_VALUE; /* CH375程序庫配置值 */
DISK_BASE_BUF[0] = 0; /* 該操作無意義,只是為了防止編譯器優(yōu)化時不產(chǎn)生DISK_BASE_BUF緩沖區(qū) */
if ( CH375GetVer( ) < CH375_LIB_VER ) return( 0xFF ); /* 獲取當(dāng)前子程序庫的版本號,版本太低則返回錯誤 */
return( CH375Init( ) ); /* 初始化CH375 */
}
#endif
#ifdef __cplusplus
}
#endif
#endif
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -