ch374hf6.h

CH374EVT.ZIP

extern void		CH374_WRITE_BLOCK_C( UINT8 mLen, PUINT8C mBuf );	/* 向RAM_HOST_TRAN写入常量型数据块 */

/* 该头文件可以为CH374子程序库分配必要的I/O及内存资源,并产生必要的与硬件有关的目标代码,
   如果该文件是被工程项目的多个源程序包含作为头文件,那么应该只允许一个头文件分配资源和产生代码,
   除此之外的头文件应该被事先定义CH374HF_NO_CODE,从而禁止该头文件产生重复的目标代码,例如:
#define		CH374HF_NO_CODE		1
#include	CH374HF?.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 )			/* 查询当前文件的信息 */
{
	PUINT8I	buf;
	UINT8	count;
	buf = (PUINT8I)( & 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( PUINT32I 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