ch375hfb.h

mega128+VS1003做的mp3的程序 可以用WINAVR编译

#define LIB_CFG_DISK_IO			1		/* 默认情况下,磁盘读写的数据的复制方式 */
#ifndef LIB_CFG_FILE_IO
#define LIB_CFG_FILE_IO			1		/* 默认情况下,文件读写的数据的复制方式为"内部复制" */
#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

#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 )	/* CH375程序库配置值 */

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

/* 如果CH375的INT#引脚连接到单片机的中断输入引脚并且准备使用中断方式,那么LIB_CFG_INT_EN定义为1,否则定义为0由单片机查询INT#引脚 */
/* 在CH375子程序读写文件数据时,CH375的程序库提供两种优化速度的方式,在LIB_CFG_FILE_IO中定义:
   方式0:"外部子程序", 只适用于文件读写时的数据复制(只用于CH375FileReadX和CH375FileWriteX两个子程序),
                       是指由子程序xWriteToExtBuf和xReadFromExtBuf进行数据复制,这两个子程序是在应用程序中定义的,由CH375的程序库调用,
   方式1:"内部复制", 程序内置的常规数据复制方式
   对于文件数据读写,也就是应用程序调用CH375FileReadX和CH375FileWriteX子程序时:
     在方式0下,由应用程序在xWriteToExtBuf和xReadFromExtBuf子程序中自行管理缓冲区,设定缓冲区初值等,
     在方式1下,应用程序每次调用CH375FileReadX和CH375FileWriteX时,CH375的程序库都会从指定缓冲区的起始地址开始读写数据,
     例如: 某文件长度为1K(占用2个扇区), 如果调用CH375FileReadX时读1K(指定mCmdParam.Read.mSectorCount为2), 那么1K数据全读到指定缓冲区中,
           如果缓冲区较小只有0.5K, 那么分两次读取, 第一次调用CH375FileReadX时读0.5K, 处理完这0.5K数据后再调用CH375FileReadX读下一个0.5K并处理
*/
extern UINT8	CH375vDiskFat;			/* 逻辑盘的FAT标志:1=FAT12,2=FAT16,3=FAT32 */
extern UINT8	CH375vSecPerClus;		/* 逻辑盘的每簇扇区数 */
extern UINT32	CH375vStartCluster;		/* 当前文件或者目录的起始簇号 */
extern UINT32	CH375vFileSize;			/* 当前文件的长度 */
extern UINT32	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 *P_FAT_DIR_INFO;

extern BOOL1	CH375Version2;			/* 芯片版本:0-CH375,1-CH375A */
extern UINT32	CH375vDataStart;		/* 逻辑盘的数据区域的起始LBA */
extern UINT32	CH375vFdtLba;			/* 当前FDT所在的LBA地址 */
extern UINT16	CH375vFdtOffset;		/* 当前FDT在扇区内的偏移地址 */
#ifdef EN_DISK_FAT32
extern UINT32	CH375vDiskRoot;			/* 对于FAT16盘为根目录占用扇区数,对于FAT32盘为根目录起始簇号 */
#else
extern UINT8	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	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
extern UINT8	CH375BulkOnlyCmd( void );	/* 执行基于BulkOnly协议的命令 */
extern UINT8	CH375DiskReady( void );		/* 查询磁盘是否准备好 */
extern UINT8	CH375DiskConnect( void );	/* 检查磁盘是否连接 */

/* 该头文件可以为CH375子程序库分配必要的I/O及内存资源,并产生必要的与硬件有关的目标代码,
   如果该文件是被工程项目的多个源程序包含作为头文件,那么应该只允许一个头文件分配资源和产生代码,
   除此之外的头文件应该被事先定义CH375HF_NO_CODE,从而禁止该头文件产生重复的目标代码,例如:
#define		CH375HF_NO_CODE		1
#include	CH375HF?.H
*/
#ifdef CH375HF_NO_CODE

extern CMD_PARAM_I mCmdParam;				/* 命令参数 */
extern UINT8  DISK_BASE_BUF[512];			/* 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度 */
#ifdef FILE_DATA_BUF_LEN
extern UINT8  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

void xWriteCH375Cmd( UINT8 mCmd );		/* 外部定义的被CH375程序库调用的子程序,向CH375写命令,最小周期为4uS,否则之前之后各延时2uS */
void xWriteCH375Data( UINT8 mData );	/* 外部定义的被CH375程序库调用的子程序,向CH375写数据,最小周期为1.5uS,否则之后延时1.5uS */
UINT8 xReadCH375Data( void );			/* 外部定义的被CH375程序库调用的子程序,从CH375读数据,最小周期为1.5uS,否则之前延时1.5uS */

CMD_PARAM_I mCmdParam;					/* 命令参数 */

UINT8  DISK_BASE_BUF[512];				/* 外部RAM的磁盘数据缓冲区,缓冲区长度为一个扇区的长度,起始地址建议为偶地址 */
#ifdef FILE_DATA_BUF_LEN
UINT8  FILE_DATA_BUF[ FILE_DATA_BUF_LEN ];	/* 外部RAM的文件数据缓冲区,缓冲区长度不小于一次读写的数据长度,起始地址建议为偶地址 */
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_INT			/* 在应用程序中定义NO_DEFAULT_CH375_INT可以禁止默认的中断处理程序,然后用自行编写的程序代替它 */
#if LIB_CFG_INT_EN == 0					/* CH375的INT#引脚连接方式为"查询方式" */
void xQueryInterrupt( void )			/* 查询CH375中断并更新中断状态 */
{
	while ( CH375_INT_WIR );  /* 如果CH375的中断引脚输出高电平则等待 */
	xWriteCH375Cmd( CMD_GET_STATUS );  /* 获取当前中断状态,发出命令后至少延时2uS */
	CH375IntStatus = xReadCH375Data( );  /* 获取中断状态 */
	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的实际中断状态后返回 */
}
#ifndef CH375_INT_NO
#define CH375_INT_NO		2
#endif
#pragma interrupt_handler CH375Interrupt:CH375_INT_NO
void	CH375Interrupt( void )			/* CH375中断服务程序,由CH375的INT#的低电平或者下降沿触发单片机中断 */
{
	xWriteCH375Cmd( CMD_GET_STATUS );  /* 获取中断状态并取消中断请求 */
	CH375IntStatus = xReadCH375Data( );  /* 获取中断状态 */
	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

#if LIB_CFG_FILE_IO == 0				/* 文件读写的数据的复制方式为"外部子程序" */
#ifdef LIB_CFG_FILE_IO_DEFAULT			/* 如果应用程序中定义该值则使用默认"外部子程序",否则应该自行编写程序代替 */
unsigned char *current_buffer;	/* 保存文件数据读写时的缓冲区的当前指针,由应用程序在调用CH375FileReadX和CH375FileWriteX子程序前设置初值 */
void xWriteToExtBuf( UINT8 mLength )	/* 该子程序由CH375的子程序库调用,用于从CH375读取文件数据到外部缓冲区,被CH375FileReadX调用 */
{
/*	if ( (UINT32)current_buffer + mLength >= (UINT32)&FILE_DATA_BUF + sizeof( FILE_DATA_BUF ) ) return;*/  /* 防止缓冲区溢出 */
	if ( mLength ) {
		do {  /* 根据长度读取数据,实际上长度总是CH375_MAX_DATA_LEN,也就是64 */
			*current_buffer = xReadCH375Data( );  /* 读出数据并保存,可以用这种方式将文件数据保存到单片机的各种串行存储器中 */
			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 */
			xWriteCH375Data( *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,文件读写的数据的复制方式不是"外部子程序" */
void xWriteToExtBuf( UINT8 mLength )	/* 不会调用该子程序 */
{
	mLength --;  /* 该操作无意义,只是避免出现警告信息 */
}
#ifdef EN_DISK_WRITE
void xReadFromExtBuf( UINT8 mLength )	/* 不会调用该子程序 */
{
	mLength --;  /* 该操作无意义,只是避免出现警告信息 */
}
#endif
#endif

UINT8	CH375LibInit( void )  /* 初始化CH375程序库和CH375芯片,操作成功返回0 */
{
	CH375LibConfig = LIB_CFG_VALUE;  /* CH375程序库配置值 */
	DISK_BASE_BUF[0] = 0;  /* 该操作无意义,只是为了防止编译器优化时不产生DISK_BASE_BUF缓冲区 */
	if ( CH375GetVer( ) < CH375_LIB_VER ) return( 0xFF );  /* 获取当前子程序库的版本号,版本太低则返回错误 */
	return( CH375Init( ) );  /* 初始化CH375 */
}

#endif

#ifdef __cplusplus
}
#endif

#endif