ch375hf(4).h

USB 1.1 U Device for CH375 & USB 2.0 for CH375A 读写usb超精简的程序

//-------------------------------------------------------------------------------------------------
// 
#define EN_DISK_WRITE			1
#define EN_DISK_FAT12			1
//#define EN_DISK_FAT32			1 	    // 使用CH375HF6.LIB时请启用该常量定义 
#define EN_BYTE_ACCESS			1

#ifndef LIB_CFG_DISK_IO
#define LIB_CFG_DISK_IO			1		// 默认情况下,磁盘读写的数据的复制方式为"单DPTR复制" 
#endif
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO			1		// 默认情况下,文件读写的数据的复制方式为"单DPTR复制" 
#endif
#ifndef LIB_CFG_UPD_SIZE
#define LIB_CFG_UPD_SIZE		0		// 默认情况下,在添加数据后文件长度的更新方式为"不更新" 
#endif
#ifndef LIB_CFG_NO_DLY
#define LIB_CFG_NO_DLY			0		// 默认情况下,在写操作结束后的延时方式为"写后延时" 
#endif
#ifndef LIB_CFG_INT_EN
#define LIB_CFG_INT_EN			0		// 默认情况下,CH375的INT#引脚连接方式为"查询方式" 
#endif
// CH375程序库配置值 
#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 )	

#ifndef DISK_BASE_BUF_ADDR
//#define DISK_BASE_BUF_ADDR		0		// 如果未定义磁盘读写的缓冲区地址,那么假定磁盘读写的缓冲区从地址0开始 
#endif

//-------------------------------------------------------------------------------------------------
// 子程序库中提供的变量 
//-------------------------------------------------------------------------------------------------
// 
extern UINT8V	CH375IntStatus;			// CH375操作的中断状态 
extern UINT8V	CH375DiskStatus;		// 磁盘及文件状态 
extern UINT8D	CH375LibConfig;			// CH375程序库配置,下行说明 
// 位7: CH375的INT#引脚连接方式: 0查询方式,1中断方式 
// 位5: 在写操作结束后是否延时: 0写后延时,1不延时 
// 位4: 在添加数据后是否自动更新文件长度: 0不更新,1自动更新 
// 位3位2: 针对文件读写的多扇区数据的复制方式: 00外部子程序, 01单DPTR复制, 10双DPTR复制, 11单DPTR和P2+R0复制 
// 位1位0: 针对磁盘读写的单扇区数据的复制方式: 00单DPTR复制, 01单DPTR复制, 10双DPTR复制, 11单DPTR和P2+R0复制 

// 如果CH375的INT#引脚连接到单片机的中断输入引脚并且准备使用中断方式,那么LIB_CFG_INT_EN定义为1,否则定义为0由单片机查询INT#引脚 
// 由于MCS51单片机复制外部RAM中的数据时比较慢,所以CH375的程序库提供几种优化速度的方式,在LIB_CFG_FILE_IO和LIB_CFG_DISK_IO中定义:
// 方式0:"外部子程序", 只适用于文件读写时的数据复制(只用于CH375FileReadX和CH375FileWriteX两个子程序),LIB_CFG_DISK_IO不支持方式0,
//                     是指由子程序xWriteToExtBuf和xReadFromExtBuf进行数据复制,这两个子程序是在应用程序中定义的,由CH375的程序库调用,
// 方式1:"单DPTR复制", 最常规的数据复制方式, 使用一个DPTR来回切换, 每传输一个字节需要16个机器周期, 速度最慢, 适用于所有MCS51单片机,
// 方式2:"双DPTR复制", 针对特定硬件的数据复制方式, 使用两个DPTR, 每传输一个字节需要10个机器周期, 速度较快, 适用于ATMEL/PHILIPS/SST等具有双DPTR的单片机,
// 方式3:"单DPTR和P2+R0复制", 用P2+R0指向CH375的I/O端口并且用DPTR指向外部RAM进行数据复制, 每传输一个字节需要6.25个机器周期, 速度最快,
//                     适用于所有标准的MCS51单片机, 但是某些单片机在启用内置的外部RAM时会关闭P2+R0的功能, 所以可能不适用,
// 对于文件数据读写,也就是应用程序调用CH375FileReadX和CH375FileWriteX子程序时:
//   在方式0下,由应用程序在xWriteToExtBuf和xReadFromExtBuf子程序中自行管理缓冲区,设定缓冲区初值等,
//   在方式1,2,3下,应用程序每次调用CH375FileReadX和CH375FileWriteX时,CH375的程序库都会从指定缓冲区的起始地址开始读写数据,
//   例如: 某文件长度为1K(占用2个扇区), 如果调用CH375FileReadX时读1K(指定mCmdParam.Read.mSectorCount为2), 那么1K数据全读到指定缓冲区中,
//         如果缓冲区较小只有0.5K, 那么分两次读取, 第一次调用CH375FileReadX时读0.5K, 处理完这0.5K数据后再调用CH375FileReadX读下一个0.5K并处理

extern UINT8D	CH375vDiskFat;			// 逻辑盘的FAT标志:1=FAT12,2=FAT16,3=FAT32 
extern UINT8D	CH375vSecPerClus;		// 逻辑盘的每簇扇区数 
extern UINT32D	CH375vStartCluster;		// 当前文件或者目录的起始簇号 
extern UINT32D	CH375vFileSize;			// 当前文件的长度 
extern UINT32D	CH375vCurrentOffset;	// 当前文件指针,当前读写位置的字节偏移 

//-------------------------------------------------------------------------------------------------
// 更多有关文件目录项的定义 
//-------------------------------------------------------------------------------------------------
// 
#ifdef EN_CH375LIB_MORE
//-------------------------------------------------------------------------------------------------
// FAT数据区中文件目录信息 
typedef struct _FAT_DIR_INFO 
{
	UINT8	DIR_Name[11];				// 00H,文件名,共11字节,不足处填空格 
	UINT8	DIR_Attr;					// 0BH,文件属性,参考前面的说明 
	UINT8	DIR_NTRes;					// 0CH 
	UINT8	DIR_CrtTimeTenth;			// 0DH,文件创建的时间,以0.1秒单位计数 
	UINT16	DIR_CrtTime;				// 0EH,文件创建的时间 
	UINT16	DIR_CrtDate;				// 10H,文件创建的日期 
	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 xdata *P_FAT_DIR_INFO;

extern BOOL1	CH375Version2;			// 芯片版本:0-CH375,1-CH375A 
extern UINT32D	CH375vDataStart;		// 逻辑盘的数据区域的起始LBA 
extern UINT32I	CH375vFdtLba;			// 当前FDT所在的LBA地址 
extern UINT16D	CH375vFdtOffset;		// 当前FDT在扇区内的偏移地址 
#ifdef EN_DISK_FAT32
extern UINT32I	CH375vDiskRoot;			// 对于FAT32盘为根目录起始簇号 
#else
extern UINT8I	CH375vDiskRoot;			// 对于FAT16盘为根目录占用扇区数 
#endif

extern UINT8	CH375ReadBlock( void );		// 从磁盘读取多个扇区的数据到外部接口交换区 
#ifdef EN_DISK_WRITE
extern UINT8	CH375WriteBlock( void );	// 将外部接口交换区的多个扇区的数据块写入磁盘 
#endif

//-------------------------------------------------------------------------------------------------
#endif

//-------------------------------------------------------------------------------------------------
// 子程序库中提供的子程序 
//-------------------------------------------------------------------------------------------------
// 
// 下述子程序中, 文件操作子程序CH375File*和磁盘查询子程序CH375DiskQuery都可能会用到磁盘数据缓冲区DISK_BASE_BUF,
// 并且有可能在DISK_BASE_BUF中保存了磁盘信息, 所以必须保证DISK_BASE_BUF不被用于其它用途,
// 如果RAM较少, 要将DISK_BASE_BUF临时用于其它用途, 那么在临时用完后必须调用CH375DirtyBuffer清除磁盘缓冲区 
extern UINT8	CH375GetVer( void );		// 获取当前子程序库的版本号 
extern void		CH375Reset( void );			// 复位CH375 
extern UINT8	CH375Init( void );			// 初始化CH375 
extern void		CH375DirtyBuffer( void );	// 清除磁盘缓冲区 

extern UINT8	CH375BulkOnlyCmd( void );	// 执行基于BulkOnly协议的命令 
extern UINT8	CH375DiskReady( void );		// 查询磁盘是否准备好 
extern UINT8	CH375DiskConnect( void );	// 检查磁盘是否连接 

extern UINT8	CH375FileOpen( void );		// 打开文件或者枚举文件 
extern UINT8	CH375FileEnumer( void );	// 枚举文件 
extern UINT8	CH375FileClose( void );		// 关闭当前文件 
extern UINT8	CH375FileQuery( void );		// 查询当前文件的信息 
extern UINT8	CH375FileModify( void );	// 查询或者修改当前文件的信息 
extern UINT8	CH375FileLocate( void );	// 移动当前文件指针 
extern UINT8	CH375FileReadX( void );		// 从当前文件读取数据到指定缓冲区 

//-----------------------------------------------
// 如果支持文件写等操作 
#ifdef EN_DISK_WRITE 
extern UINT8	CH375FileErase( void );		// 删除文件并关闭 
extern UINT8	CH375FileCreate( void );	// 新建文件并打开,如果文件已经存在则先删除后再新建 
extern UINT8	CH375FileWriteX( void );	// 向当前文件写入指定缓冲区的数据 
extern UINT8	CH375DiskSize( void );		// 查询磁盘容量 
extern UINT8	CH375DiskQuery( void );		// 查询磁盘信息 
#endif

//-----------------------------------------------
// 如果支持字节操作 
#ifdef EN_BYTE_ACCESS
extern UINT8	CH375ByteLocate( void );	// 以字节为单位移动当前文件指针 
extern UINT8	CH375ByteRead( void );		// 以字节为单位从当前位置读取数据块 
#ifdef EN_DISK_WRITE
extern UINT8	CH375ByteWrite( void );		// 以字节为单位向当前位置写入数据块 
#endif
#endif

//-------------------------------------------------------------------------------------------------
// 该头文件可以为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地址 
extern UINT8X  DISK_BASE_BUF[512];			// 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度 
#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
extern void xQueryInterrupt( void );		// 外部定义的被CH375程序库调用的子程序,查询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地址 
#ifdef DISK_BASE_BUF_ADDR
UINT8X  DISK_BASE_BUF[512] _at_ DISK_BASE_BUF_ADDR;	// 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度 
#else
UINT8X  DISK_BASE_BUF[512];				    // 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度 
#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

//-------------------------------------------------------------------------------------------------
// 以下程序可以根据需要修改 
//-------------------------------------------------------------------------------------------------
// 

//-------------------------------------------------------------------------------------------------
#endif

#ifdef __cplusplus
}
#endif

//-------------------------------------------------------------------------------------------------
//-------------------------------------------------------------------------------------------------

#endif