?? ch374hfa.h
字號:
*/
#ifdef CH374HF_NO_CODE
extern UINT8XV CH374_IDX_PORT; /* CH374索引端口的I/O地址 */
extern UINT8XV CH374_DAT_PORT; /* CH374數據端口的I/O地址 */
extern CMD_PARAM_I mCmdParam; /* 命令參數 */
extern BULK_ONLY_CMD_X mBOC; /* BO協議的命令包 */
#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 CH374FileRead( void ); /* 從當前文件讀取數據 */
#ifdef EN_DISK_WRITE
extern UINT8 CH374FileWrite( void ); /* 向當前文件寫入數據 */
#endif
#endif
#ifndef NO_DEFAULT_CH374_F_ENUM
extern UINT8 CH374FileEnumer( void ); /* 枚舉文件 */
#endif
#ifndef NO_DEFAULT_CH374_F_QUERY
extern UINT8 CH374FileQuery( void ); /* 查詢當前文件的信息 */
#endif
#ifndef NO_DEFAULT_CH374_RESET
extern void CH374Reset( void ); /* 復位CH374 */
#endif
extern void xQueryInterrupt( void ); /* 外部定義的被CH374程序庫調用的子程序,查詢CH374中斷 */
#ifdef EN_DISK_WRITE
extern void xDelayAfterWrite( void ); /* 外部定義的被CH374程序庫調用的子程序,寫操作后延時 */
#endif
extern void xFileNameEnumer( void ); /* 外部定義的被CH374程序庫調用的子程序,文件名枚舉回調子程序 */
extern UINT8 CH374LibInit( void ); /* 初始化CH374程序庫和CH374芯片,操作成功返回0 */
#else
UINT8XV CH374_IDX_PORT _at_ CH374_IDX_PORT_ADDR; /* CH374索引端口的I/O地址 */
UINT8XV CH374_DAT_PORT _at_ CH374_DAT_PORT_ADDR; /* CH374數據端口的I/O地址 */
CMD_PARAM_I mCmdParam; /* 命令參數 */
BULK_ONLY_CMD_X mBOC; /* BO協議的命令包 */
#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 CH374FileRead( void ) /* 從當前文件讀取數據 */
{
mCmdParam.ReadX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數據緩沖區 */
return( CH374FileReadX( ) );
}
#ifdef EN_DISK_WRITE
UINT8 CH374FileWrite( void ) /* 向當前文件寫入數據 */
{
mCmdParam.WriteX.mDataBuffer = &FILE_DATA_BUF[0]; /* 指向文件數據緩沖區 */
return( CH374FileWriteX( ) );
}
#endif
#endif
/* 以下程序可以根據需要修改 */
#ifndef NO_DEFAULT_CH374_IO /* 在應用程序中定義NO_DEFAULT_CH374_IO可以禁止默認的CH374接口程序,然后用自行編寫的程序代替它 */
#define CH374_WRITE_INDEX( c ) { CH374_IDX_PORT = ( c ); } /* 寫索引地址 */
#define CH374_WRITE_DATA( c ) { CH374_DAT_PORT = ( c ); } /* 寫數據且地址增量 */
#define CH374_READ_DATA( ) ( CH374_DAT_PORT ) /* 讀數據且地址增量 */
#define CH374_READ_DATA0( ) ( CH374_IDX_PORT ) /* 讀數據且地址不增量 */
#endif
#ifndef NO_DEFAULT_CH374_F_ENUM /* 在應用程序中定義NO_DEFAULT_CH374_F_ENUM可以禁止默認的枚舉文件程序,然后用自行編寫的程序代替它 */
UINT8 CH374FileEnumer( void ) /* 枚舉文件 */
{
UINT8 status;
status = CH374FileOpen( );
if ( status == ERR_FOUND_NAME ) status = ERR_SUCCESS; /* 操作成功 */
return( status );
}
#endif
#ifndef NO_DEFAULT_CH374_F_QUERY /* 在應用程序中定義NO_DEFAULT_CH374_F_QUERY可以禁止默認的查詢當前文件的信息程序,然后用自行編寫的程序代替它 */
UINT8 CH374FileQuery( void ) /* 查詢當前文件的信息 */
{
PUINT8X buf;
UINT8 count;
buf = (PUINT8X)( & mCmdParam.Modify.mFileSize );
for ( count = sizeof( mCmdParam.Modify ); count != 0; count -- ) {
*buf = 0xFF; /* 輸入參數全部無效,僅查詢不修改 */
buf ++;
}
return( CH374FileModify( ) );
}
#endif
#ifndef NO_DEFAULT_CH374_RESET /* 在應用程序中定義NO_DEFAULT_CH374_RESET可以禁止默認的CH374復位程序,然后用自行編寫的程序代替它 */
void CH374Reset( void ) /* 復位CH374 */
{
CH374_WRITE_REGISTER( REG_SYS_CTRL, CH374_READ_REGISTER( REG_SYS_CTRL ) | BIT_CTRL_RESET_NOW ); /* 芯片軟件復位控制 */
CH374_WRITE_REGISTER( REG_SYS_CTRL, CH374_READ_REGISTER( REG_SYS_CTRL ) & (UINT8)( ~ BIT_CTRL_RESET_NOW ) ); /* 結束復位 */
CH374DelaymS( 10 ); /* 延時10毫秒 */
}
#endif
#ifndef NO_DEFAULT_CH374_INT /* 在應用程序中定義NO_DEFAULT_CH374_INT可以禁止默認的中斷處理程序,然后用自行編寫的程序代替它 */
#if LIB_CFG_INT_EN == 0 /* CH374的INT#引腳連接方式為"查詢方式" */
void xQueryInterrupt( void ) /* 查詢CH374中斷 */
{
#ifdef CH374_INT_WIRE /* 連接了CH374的中斷引腳 */
while ( CH374_INT_WIRE ); /* 如果CH374的中斷引腳輸出高電平則等待 */
#else /* 未連接CH374的中斷引腳 */
while ( ( CH374_READ_REGISTER( REG_INTER_FLAG ) & ( BIT_IF_DEV_DETECT | BIT_IF_TRANSFER ) ) == 0 ); /* 查詢中斷標志寄存器 */
#endif
}
#else /* LIB_CFG_INT_EN != 0, CH374的INT#引腳連接方式為"中斷方式" */
void xQueryInterrupt( void ) /* 查詢中斷狀態,等待硬件中斷 */
{
while ( CH374IntStatus == 0 ); /* 子程序庫調用該子程序之前CH374IntStatus=0,硬件中斷后,由中斷服務程序置為非0的實際中斷狀態后返回 */
}
void CH374Interrupt( void ) interrupt CH374_INT_NO using 1 /* CH374中斷服務程序,使用寄存器組1,由CH374的INT#的低電平或者下降沿觸發單片機中斷 */
{
CH374IntStatus = 1; /* 已接收到CH374中斷則置標志 */
#ifdef CLEAR_INT_MARK
CLEAR_INT_MARK( ); /* 某些單片機需要由軟件清除中斷標志 */
#endif
}
#endif
#endif
#ifdef EN_DISK_WRITE
#ifndef NO_DEFAULT_DELAY_WRITE /* 在應用程序中定義NO_DEFAULT_DELAY_WRITE可以禁止默認的寫操作后延時程序,然后用自行編寫的程序代替它 */
void xDelayAfterWrite( void ) /* 寫操作后延時 */
{
#if LIB_CFG_NO_DLY == 0 /* 寫后延時 */
UINT8 count;
for ( count = 250; count != 0; count -- ); /* 延時200uS左右,2x333nS@36MHz&12T */
#endif
}
#endif
#endif
#ifndef NO_DEFAULT_FILE_ENUMER /* 在應用程序中定義NO_DEFAULT_FILE_ENUMER可以禁止默認的文件名枚舉回調程序,然后用自行編寫的程序代替它 */
void xFileNameEnumer( void ) /* 文件名枚舉回調子程序 */
{
/* 如果指定枚舉序號CH374vFileSize為0xFFFFFFFF后調用FileOpen，那么每搜索到一個文件FileOpen都會調用本回調程序，
回調程序xFileNameEnumer返回后，FileOpen遞減CH374vFileSize并繼續枚舉直到搜索不到文件或者目錄。建議做法是，
在調用FileOpen之前定義一個全局變量為0，當FileOpen回調本程序后，本程序由CH374vFdtOffset得到結構FAT_DIR_INFO，
分析結構中的DIR_Attr以及DIR_Name判斷是否為所需文件名或者目錄名，記錄相關信息，并將全局變量計數增量，
當FileOpen返回后，判斷返回值如果是ERR_MISS_FILE或ERR_FOUND_NAME都視為操作成功，全局變量為搜索到的有效文件數。
如果在本回調程序xFileNameEnumer中將CH374vFileSize置為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 + CH374vFdtOffset ); /* 當前FDT的起始地址 */
FileCount = (UINT16)( 0xFFFFFFFF - CH374vFileSize ); /* 當前文件名的枚舉序號,CH374vFileSize初值是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_SEC_INTERFACE
UINT8 xDiskSectorAccess( PUINT32X mLba, UINT8 mMode ) /* 該子程序由CH374的子程序庫調用,用于以扇區為單位存取磁盤 */
{
#if 0
UINT8 SectCnt;
UINT8 OpCmd;
UINT32 StartLba;
PUINT8X DataBuf;
StartLba = *mLba; /* 將讀寫的起始扇區號 */
switch ( mMode ) {
case 0: /* 讀一個扇區到pDISK_BASE_BUF */
SectCnt = 1;
DataBuf = pDISK_BASE_BUF;
OpCmd = CMD_READ_SECTOR;
/* 如果操作失敗必須調用CH374DirtyBuffer( ) */
break;
case 1: /* 從pDISK_BASE_BUF寫一個扇區 */
SectCnt = 1;
DataBuf = pDISK_BASE_BUF;
OpCmd = CMD_WRITE_SECTOR;
/* 如果操作失敗必須調用CH374DirtyBuffer( ) */
break;
case 2: /* 讀mCmdParam.ReadX.mLbaCount個扇區到mCmdParam.ReadX.mDataBuffer */
SectCnt = mCmdParam.ReadX.mLbaCount;
DataBuf = mCmdParam.ReadX.mDataBuffer;
OpCmd = CMD_READ_SECTOR;
/* 必須更新mCmdParam.ReadX.mDataBuffer(累計緩沖區地址)和CH374vCurrentOffset(累計文件指針)和mCmdParam.ReadX.mSectorCount(累計扇區數) */
break;
case 3: /* 從mCmdParam.WriteX.mDataBuffer寫mCmdParam.WriteX.mLbaCount個扇區 */
SectCnt = mCmdParam.WriteX.mLbaCount;
DataBuf = mCmdParam.WriteX.mDataBuffer;
OpCmd = CMD_WRITE_SECTOR;
/* 必須更新mCmdParam.WriteX.mDataBuffer(累計緩沖區地址)和CH374vCurrentOffset(累計文件指針)和mCmdParam.WriteX.mSectorCount(累計扇區數) */
break;
default:
return( ERR_CH374_ERROR ); /* 未知操作 */
}
/* 以扇區為單位進行讀寫操作,起始扇區號為StartLba,扇區數為SectCnt,緩沖區為DataBuf */
#else
mLba++;
mMode++;
#endif
return( ERR_SUCCESS );
}
#endif
UINT8 CH374LibInit( void ) /* 初始化CH374程序庫和CH374芯片,操作成功返回0 */
{
if ( SP > 0xEE ) return( 0xFC ); /* 單片機的堆棧空間不夠,CH374子程序庫最多可能有7級子程序,查詢方式最多需要14字節的堆棧空間,建議提供余量 */
if ( CH374GetVer( ) < CH374_LIB_VER ) return( 0xFF ); /* 獲取當前子程序庫的版本號,版本太低則返回錯誤 */
#if DISK_BASE_BUF_LEN
pDISK_BASE_BUF = & DISK_BASE_BUF[0]; /* 指向外部RAM的磁盤數據緩沖區 */
#endif
return( CH374Init( ) ); /* 初始化CH374 */
}
#endif
#ifdef __cplusplus
}
#endif
#endif
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -