?? ch375hf6.h
字號:
/* 該頭文件可以為CH375子程序庫分配必要的I/O及內存資源,并產生必要的與硬件有關的目標代碼,
如果該文件是被工程項目的多個源程序包含作為頭文件,那么應該只允許一個頭文件分配資源和產生代碼,
除此之外的頭文件應該被事先定義CH375HF_NO_CODE,從而禁止該頭文件產生重復的目標代碼,例如:
#define CH375HF_NO_CODE 1
#include CH375HF?.H
*/
#ifdef CH375HF_NO_CODE
extern CMD_PARAM_I mCmdParam; /* 命令參數 */
extern UINT8XV CH375_CMD_PORT; /* CH375命令端口的I/O地址 */
extern UINT8XV CH375_DAT_PORT; /* CH375數據端口的I/O地址 */
#if DISK_BASE_BUF_LEN
extern UINT8X DISK_BASE_BUF[ DISK_BASE_BUF_LEN ]; /* 外部RAM的磁盤數據緩沖區,緩沖區長度為一個扇區的長度 */
#endif
#ifdef FILE_DATA_BUF_LEN
extern UINT8X FILE_DATA_BUF[ FILE_DATA_BUF_LEN ]; /* 外部RAM的文件數據緩沖區,緩沖區長度不小于一次讀寫的數據長度 */
extern UINT8 CH375FileRead( void ); /* 從當前文件讀取數據 */
#ifdef EN_DISK_WRITE
extern UINT8 CH375FileWrite( void ); /* 向當前文件寫入數據 */
#endif
#endif
#ifndef NO_DEFAULT_CH375_F_ENUM
extern UINT8 CH375FileEnumer( void ); /* 枚舉文件 */
#endif
#ifndef NO_DEFAULT_CH375_F_QUERY
extern UINT8 CH375FileQuery( void ); /* 查詢當前文件的信息 */
#endif
extern void xQueryInterrupt( void ); /* 外部定義的被CH375程序庫調用的子程序,查詢CH375中斷并更新中斷狀態 */
extern void xDelay100uS( void ); /* 外部定義的被CH375程序庫調用的子程序,延時100uS */
#ifdef EN_DISK_WRITE
extern void xDelayAfterWrite( void ); /* 外部定義的被CH375程序庫調用的子程序,寫操作后延時 */
#endif
extern void xFileNameEnumer( void ); /* 外部定義的被CH375程序庫調用的子程序,文件名枚舉回調子程序 */
extern UINT8 CH375LibInit( void ); /* 初始化CH375程序庫和CH375芯片,操作成功返回0 */
#else
CMD_PARAM_I mCmdParam; /* 命令參數 */
UINT8XV CH375_CMD_PORT _at_ CH375_CMD_PORT_ADDR; /* CH375命令端口的I/O地址 */
UINT8XV CH375_DAT_PORT _at_ CH375_DAT_PORT_ADDR; /* CH375數據端口的I/O地址 */
#if DISK_BASE_BUF_LEN
#ifdef DISK_BASE_BUF_ADDR
UINT8X DISK_BASE_BUF[ DISK_BASE_BUF_LEN ] _at_ DISK_BASE_BUF_ADDR; /* 外部RAM的磁盤數據緩沖區,緩沖區長度為一個扇區的長度 */
#else
UINT8X DISK_BASE_BUF[ DISK_BASE_BUF_LEN ]; /* 外部RAM的磁盤數據緩沖區,緩沖區長度為一個扇區的長度 */
#endif
#endif
#ifdef FILE_DATA_BUF_LEN
#ifdef FILE_DATA_BUF_ADDR
UINT8X FILE_DATA_BUF[ FILE_DATA_BUF_LEN ] _at_ FILE_DATA_BUF_ADDR; /* 外部RAM的文件數據緩沖區,緩沖區長度不小于一次讀寫的數據長度 */
#else
UINT8X FILE_DATA_BUF[ FILE_DATA_BUF_LEN ]; /* 外部RAM的文件數據緩沖區,緩沖區長度不小于一次讀寫的數據長度 */
#endif
UINT8 CH375FileRead( void ) /* 從當前文件讀取數據 */
{
mCmdParam.ReadX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數據緩沖區 */
return( CH375FileReadX( ) );
}
#ifdef EN_DISK_WRITE
UINT8 CH375FileWrite( void ) /* 向當前文件寫入數據 */
{
mCmdParam.WriteX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數據緩沖區 */
return( CH375FileWriteX( ) );
}
#endif
#endif
/* 以下程序可以根據需要修改 */
#ifndef NO_DEFAULT_CH375_F_ENUM /* 在應用程序中定義NO_DEFAULT_CH375_F_ENUM可以禁止默認的枚舉文件程序,然后用自行編寫的程序代替它 */
UINT8 CH375FileEnumer( void ) /* 枚舉文件 */
{
UINT8 status;
status = CH375FileOpen( );
if ( status == ERR_FOUND_NAME ) status = ERR_SUCCESS; /* 操作成功 */
return( status );
}
#endif
#ifndef NO_DEFAULT_CH375_F_QUERY /* 在應用程序中定義NO_DEFAULT_CH375_F_QUERY可以禁止默認的查詢當前文件的信息程序,然后用自行編寫的程序代替它 */
UINT8 CH375FileQuery( void ) /* 查詢當前文件的信息 */
{
PUINT8I buf;
UINT8 count;
buf = (PUINT8I)( & mCmdParam.Modify.mFileSize );
for ( count = sizeof( mCmdParam.Modify ); count != 0; count -- ) {
*buf = 0xFF; /* 輸入參數全部無效,僅查詢不修改 */
buf ++;
}
return( CH375FileModify( ) );
}
#endif
#ifndef NO_DEFAULT_CH375_INT /* 在應用程序中定義NO_DEFAULT_CH375_INT可以禁止默認的中斷處理程序,然后用自行編寫的程序代替它 */
#if LIB_CFG_INT_EN == 0 /* CH375的INT#引腳連接方式為"查詢方式" */
void xQueryInterrupt( void ) /* 查詢CH375中斷并更新中斷狀態 */
{
#ifdef CH375_INT_WIRE /* 查詢中斷引腳 */
while ( CH375_INT_WIRE ); /* 如果CH375的中斷引腳輸出高電平則等待 */
#else /* 對于CH375B芯片還可以查詢命令端口的位7 */
while ( CH375_CMD_PORT & 0x80 ); /* 查詢CH375B的命令端口的位7為1說明中斷引腳輸出高電平則等待 */
#endif
CH375_CMD_PORT = CMD_GET_STATUS; /* 獲取當前中斷狀態 */
CH375IntStatus &= 0x80; if ( CH375IntStatus ) CH375IntStatus = 0; /* 操作無意義,用于至少延時2uS */
CH375IntStatus = CH375_DAT_PORT; /* 獲取中斷狀態 */
if ( CH375IntStatus == USB_INT_DISCONNECT ) CH375DiskStatus = DISK_DISCONNECT; /* 檢測到USB設備斷開事件 */
else if ( CH375IntStatus == USB_INT_CONNECT ) CH375DiskStatus = DISK_CONNECT; /* 檢測到USB設備連接事件 */
}
#else /* LIB_CFG_INT_EN != 0, CH375的INT#引腳連接方式為"中斷方式" */
void xQueryInterrupt( void ) /* 查詢中斷狀態,等待硬件中斷 */
{
while ( CH375IntStatus == 0 ); /* 子程序庫調用該子程序之前CH375IntStatus=0,硬件中斷后,由中斷服務程序置為非0的實際中斷狀態后返回 */
}
void CH375Interrupt( void ) interrupt CH375_INT_NO using 1 /* CH375中斷服務程序,使用寄存器組1,由CH375的INT#的低電平或者下降沿觸發單片機中斷 */
{
CH375_CMD_PORT = CMD_GET_STATUS; /* 獲取中斷狀態并取消中斷請求 */
CH375IntStatus &= 0x80; if ( CH375IntStatus ) CH375IntStatus = 0; /* 操作無意義,用于至少延時2uS */
CH375IntStatus = CH375_DAT_PORT; /* 獲取中斷狀態 */
if ( CH375IntStatus == USB_INT_DISCONNECT ) CH375DiskStatus = DISK_DISCONNECT; /* 檢測到USB設備斷開事件 */
else if ( CH375IntStatus == USB_INT_CONNECT ) CH375DiskStatus = DISK_CONNECT; /* 檢測到USB設備連接事件 */
#ifdef CLEAR_INT_MARK
CLEAR_INT_MARK( ); /* 某些單片機需要由軟件清除中斷標志 */
#endif
}
#endif
#endif
#ifndef NO_DEFAULT_DELAY_100US /* 在應用程序中定義NO_DEFAULT_DELAY_100US可以禁止默認的延時100uS子程序,然后用自行編寫的程序代替它 */
void xDelay100uS( void ) /* 延時100uS */
{
UINT8 count;
for ( count = 150; count != 0; count -- ); /* 延時100uS,2x333nS@36MHz&12T */
}
#endif
#ifdef EN_DISK_WRITE
#ifndef NO_DEFAULT_DELAY_WRITE /* 在應用程序中定義NO_DEFAULT_DELAY_WRITE可以禁止默認的寫操作后延時程序,然后用自行編寫的程序代替它 */
void xDelayAfterWrite( void ) /* 寫操作后延時 */
{
UINT8 count;
for ( count = 250; count != 0; count -- ); /* 延時200uS左右 */
}
#endif
#endif
#ifndef NO_DEFAULT_FILE_ENUMER /* 在應用程序中定義NO_DEFAULT_FILE_ENUMER可以禁止默認的文件名枚舉回調程序,然后用自行編寫的程序代替它 */
void xFileNameEnumer( void ) /* 文件名枚舉回調子程序 */
{
/* 如果指定枚舉序號CH375vFileSize為0xFFFFFFFF后調用FileOpen，那么每搜索到一個文件FileOpen都會調用本回調程序，
回調程序xFileNameEnumer返回后，FileOpen遞減CH375vFileSize并繼續枚舉直到搜索不到文件或者目錄。建議做法是，
在調用FileOpen之前定義一個全局變量為0，當FileOpen回調本程序后，本程序由CH375vFdtOffset得到結構FAT_DIR_INFO，
分析結構中的DIR_Attr以及DIR_Name判斷是否為所需文件名或者目錄名，記錄相關信息，并將全局變量計數增量，
當FileOpen返回后，判斷返回值如果是ERR_MISS_FILE或ERR_FOUND_NAME都視為操作成功，全局變量為搜索到的有效文件數。
如果在本回調程序xFileNameEnumer中將CH375vFileSize置為1，那么可以通知FileOpen提前結束搜索。以下是回調程序例子 */
#if 0
#ifdef FILE_DATA_BUF_LEN
UINT8 i;
UINT16 FileCount;
P_FAT_DIR_INFO pFileDir;
PUINT8X NameBuf;
pFileDir = (P_FAT_DIR_INFO)( pDISK_BASE_BUF + CH375vFdtOffset ); /* 當前FDT的起始地址 */
FileCount = (UINT16)( 0xFFFFFFFF - CH375vFileSize ); /* 當前文件名的枚舉序號,CH375vFileSize初值是0xFFFFFFFF,找到文件名后遞減 */
if ( FileCount < FILE_DATA_BUF_LEN / 12 ) { /* 檢查緩沖區是否足夠存放,假定每個文件名需占用12個字節存放 */
NameBuf = & FILE_DATA_BUF[ FileCount * 12 ]; /* 計算保存當前文件名的緩沖區地址 */
for ( i = 0; i < 11; i ++ ) NameBuf[ i ] = pFileDir -> DIR_Name[ i ]; /* 復制文件名,長度為11個字符,未處理空格 */
if ( pFileDir -> DIR_Attr & ATTR_DIRECTORY ) NameBuf[ i ] = 1; /* 判斷是目錄名 */
NameBuf[ i ] = 0; /* 文件名結束符 */
}
#endif
#endif
}
#endif
#ifdef EXT_BLK_INTERFACE
#if LIB_CFG_FILE_IO == 0 /* 文件讀寫的數據的復制方式為"外部子程序" */
#ifdef LIB_CFG_FILE_IO_DEFAULT /* 如果應用程序中定義該值則使用默認"外部子程序",否則應該自行編寫程序代替 */
unsigned char xdata *current_buffer; /* 保存文件數據讀寫時的緩沖區的當前指針,由應用程序在調用CH375FileReadX和CH375FileWriteX子程序前設置初值 */
void xWriteToExtBuf( UINT8 mLength ) /* 該子程序由CH375的子程序庫調用,用于從CH375讀取文件數據到外部緩沖區,被CH375FileReadX調用 */
{
/* if ( (UINT16)current_buffer + mLength >= (UINT16)&FILE_DATA_BUF + sizeof( FILE_DATA_BUF ) ) return;*/ /* 防止緩沖區溢出 */
if ( mLength ) {
do { /* 根據長度讀取數據,實際上長度總是CH375_MAX_DATA_LEN,也就是64 */
*current_buffer = CH375_DAT_PORT; /* 讀出數據并保存,可以用這種方式將文件數據保存到單片機的各種串行存儲器中 */
current_buffer ++;
} while ( -- mLength );
} /* 復制上述數據的總時間不得超過2mS */
else { /* 重試,恢復緩沖區起址,如果將文件數據讀寫的緩沖區的當前指針放在mCmdParam.ReadX.mDataBuffer中則會被自動恢復,無需下面的兩行程序 */
current_buffer += (UINT16)mCmdParam.ReadX.mDataBuffer; /* mDataBuffer中為負值 */
mCmdParam.ReadX.mDataBuffer = 0; /* 為了支持重試,在調用CH375FileReadX之前也應該清0 */
}
}
#ifdef EN_DISK_WRITE
void xReadFromExtBuf( UINT8 mLength ) /* 該子程序由CH375的子程序庫調用,用于從外部緩沖區讀取文件數據到CH375,被CH375FileWriteX調用 */
{
if ( mLength ) {
do { /* 根據長度寫入數據,實際上長度總是CH375_MAX_DATA_LEN,也就是64 */
CH375_DAT_PORT = *current_buffer; /* 將數據寫入,可以用這種方式從單片機的各種串行存儲器中取出文件數據 */
current_buffer ++;
} while ( -- mLength );
} /* 復制上述數據的總時間不得超過2mS */
else { /* 重試,恢復緩沖區起址,如果將文件數據讀寫的緩沖區的當前指針放在mCmdParam.WriteX.mDataBuffer中則會被自動恢復,無需下面的兩行程序 */
current_buffer += (UINT16)mCmdParam.WriteX.mDataBuffer; /* mDataBuffer中為負值 */
mCmdParam.WriteX.mDataBuffer = 0; /* 為了支持重試,在調用CH375FileWriteX之前也應該清0 */
}
}
#endif
#endif
#else /* LIB_CFG_FILE_IO != 0,文件讀寫的數據的復制方式不是"外部子程序" */
#ifdef FILE_DATA_BUF_LEN
void xWriteToExtBuf( UINT8 mLength ) /* 不會調用該子程序 */
{
mLength --; /* 該操作無意義,只是避免出現警告信息 */
}
#ifdef EN_DISK_WRITE
void xReadFromExtBuf( UINT8 mLength ) /* 不會調用該子程序 */
{
mLength --; /* 該操作無意義,只是避免出現警告信息 */
}
#endif
#endif
#endif
#endif
UINT8 CH375LibInit( void ) /* 初始化CH375程序庫和CH375芯片,操作成功返回0 */
{
if ( SP > 0xF0 ) return( 0xFC ); /* 單片機的堆棧空間不夠,CH375子程序庫最多可能有7級子程序,查詢方式最多需要14字節的堆棧空間,建議提供余量 */
CH375LibConfig = LIB_CFG_VALUE; /* CH375程序庫配置值 */
if ( CH375GetVer( ) < CH375_LIB_VER ) return( 0xFF ); /* 獲取當前子程序庫的版本號,版本太低則返回錯誤 */
#if DISK_BASE_BUF_LEN
pDISK_BASE_BUF = & DISK_BASE_BUF[0]; /* 指向外部RAM的磁盤數據緩沖區 */
#endif
return( CH375Init( ) ); /* 初始化CH375 */
}
#endif
#ifdef __cplusplus
}
#endif
#endif
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -