📄 ch374hfb.h

📁 CH374 USB-HOST文件系统单片机子程序库
💻 H
📖 第 1 页 / 共 4 页
字号:
上一页 1 2 34
#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

UINT8	CH374_READ_REGISTER( UINT8 mAddr );					/* 外部定义的被CH374程序库调用的子程序,从指定寄存器读取数据 */
void	CH374_WRITE_REGISTER( UINT8 mAddr, UINT8 mData );	/* 外部定义的被CH374程序库调用的子程序,向指定寄存器写入数据 */
void	CH374_READ_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8 mBuf );	/* 外部定义的被CH374程序库调用的子程序,从指定起始地址读出数据块 */
void	CH374_WRITE_BLOCK( UINT8 mAddr, UINT8 mLen, PUINT8 mBuf );	/* 外部定义的被CH374程序库调用的子程序,向指定起始地址写入数据块 */
PUINT8	CH374_READ_BLOCK64( UINT8 mAddr, PUINT8 mBuf );	/* 外部定义的被CH374程序库调用的子程序,从双缓冲区读出64字节的数据块,返回当前地址 */
#ifdef EN_DISK_WRITE
PUINT8	CH374_WRITE_BLOCK64( UINT8 mAddr, PUINT8 mBuf );	/* 外部定义的被CH374程序库调用的子程序,向双缓冲区写入64字节的数据块,返回当前地址 */
#endif
void	CH374_WRITE_BLOCK_C( UINT8 mLen, PUINT8 mBuf );	/* 外部定义的被CH374程序库调用的子程序,向RAM_HOST_TRAN写入常量型数据块 */

CMD_PARAM_I mCmdParam;					/* 命令参数 */
BULK_ONLY_CMD_X mBOC;					/* BO协议的命令包 */
#if DISK_BASE_BUF_LEN
#ifdef DISK_BASE_BUF_ADDR
UINT8  DISK_BASE_BUF[ DISK_BASE_BUF_LEN ];	/* 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度,起始地址必须为2字节边界地址 */
#else
UINT8  DISK_BASE_BUF[ DISK_BASE_BUF_LEN ];	/* 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度,起始地址必须为2字节边界地址 */
#endif
#endif
#ifdef FILE_DATA_BUF_LEN
#ifdef FILE_DATA_BUF_ADDR
UINT8  FILE_DATA_BUF[ FILE_DATA_BUF_LEN ];	/* 外部RAM的文件数据缓冲区,缓冲区长度不小于一次读写的数据长度,起始地址必须为2字节边界地址 */
#else
UINT8  FILE_DATA_BUF[ FILE_DATA_BUF_LEN ];	/* 外部RAM的文件数据缓冲区,缓冲区长度不小于一次读写的数据长度,起始地址必须为2字节边界地址 */
#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_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 )			/* 查询当前文件的信息 */
{
	PUINT8	buf;
	UINT8	count;
	buf = (PUINT8)( & 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的实际中断状态后返回 */
}
#ifndef CH374_INT_NO
#define CH374_INT_NO		2
#endif
#pragma interrupt_handler CH374Interrupt:CH374_INT_NO
void	CH374Interrupt( void )	/* 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					/* 写后延时 */
	UINT16	count;
	for ( count = 650; count != 0; count -- );  /* 延时200uS左右,6x50nS@20MHz */
#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;
	PUINT8			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( PUINT32 mLba, UINT8 mMode )	/* 该子程序由CH374的子程序库调用,用于以扇区为单位存取磁盘 */
{
#if 0
	UINT8	SectCnt;
	UINT8	OpCmd;
	UINT32	StartLba;
	PUINT8	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 ( 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
上一页 1 2 34
💿 文件大小 1365 K
👤 上传用户 managerliu123
📂 所属分类单片机开发
🏷️ 相关标签

#USB-HOST #374 #CH #文件系统
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -