基础版本
This commit is contained in:
bathfire
@@ -0,0 +1,170 @@
|
||||
/****************************** (C) COPYRIGHT 2011 YQDZ **************************
|
||||
* 文 件 名 : FILE_SYS.H
|
||||
* 作 者 : 亿全电子
|
||||
* FAE现场应用工程师 QQ:1027413631
|
||||
* 7*24小时技术支持电话:15366066738
|
||||
* http://shop57138657.taobao.com/
|
||||
* 版 本 : V1.0
|
||||
* 日 期 : 2011/08/29
|
||||
* 描 述 : CH376芯片 文件系统层 V1.0
|
||||
* 提供文件系统常用子程序,提供命令打包.
|
||||
* 不使用的子程序可以注释掉,从而节约单片机的程序ROM空间和数据
|
||||
* RAM空间.
|
||||
* 这里的子程序是通过括号中的变量传递参数,如果参数较多,为了节
|
||||
* 约RAM,也可以参考CH375子程序库改成通过同一全局变量/联合结构
|
||||
* CH376_CMD_DATA传递.
|
||||
*********************************************************************************/
|
||||
/* name 参数是指短文件名, 可以包括根目录符, 但不含有路径分隔符, 总长度不超过1+8+1+3+1字节 */
|
||||
/* PathName 参数是指全路径的短文件名, 包括根目录符、多级子目录及路径分隔符、文件名/目录名 */
|
||||
/* LongName 参数是指长文件名, 以UNICODE小端顺序编码, 以两个0字节结束, 使用长文件名子程序必须先定义全局缓冲区GlobalBuf, 长度不小于64字节, 可以与其它子程序共用 */
|
||||
|
||||
/* 定义 NO_DEFAULT_CH376_INT 用于禁止默认的Wait376Interrupt子程序,禁止后,应用程序必须自行定义一个同名子程序 */
|
||||
/* 定义 DEF_INT_TIMEOUT 用于设置默认的Wait376Interrupt子程序中的等待中断的超时时间/循环计数值, 0则不检查超时而一直等待 */
|
||||
/* 定义 EN_DIR_CREATE 用于提供新建多级子目录的子程序,默认是不提供 */
|
||||
/* 定义 EN_DISK_QUERY 用于提供磁盘容量查询和剩余空间查询的子程序,默认提供 */
|
||||
/* 定义 EN_SECTOR_ACCESS 用于提供以扇区为单位读写文件的子程序,默认是不提供 */
|
||||
/* 定义 EN_LONG_NAME 用于提供支持长文件名的子程序,默认是不提供 */
|
||||
|
||||
#ifndef __FILE_SYS_H__
|
||||
#define __FILE_SYS_H__
|
||||
|
||||
#define ERR_USB_UNKNOWN 0xFA /* 未知错误,不应该发生的情况,需检查硬件或者程序错误 */
|
||||
|
||||
#define STRUCT_OFFSET( s, m ) ( (u8)( & ((s *)0) -> m ) ) /* 定义获取结构成员相对偏移地址的宏 */
|
||||
#ifdef EN_LONG_NAME
|
||||
#ifndef LONG_NAME_BUF_LEN
|
||||
#define LONG_NAME_BUF_LEN ( LONG_NAME_PER_DIR * 20 ) /* 自行定义的长文件名缓冲区长度,最小值为LONG_NAME_PER_DIR*1 */
|
||||
#endif
|
||||
#endif
|
||||
|
||||
|
||||
#define CH376_EN GPIO_SetBits(GPIOB,GPIO_Pin_12);
|
||||
#define CH376_DIS GPIO_ResetBits(GPIOB,GPIO_Pin_12);GPIO_SetBits(GPIOD,GPIO_Pin_12);
|
||||
|
||||
#define CH376_INT GPIO_ReadInputDataBit(GPIOB,GPIO_Pin_11)
|
||||
void CH376_PORT_INIT( void ); /* CH376通讯接口初始化 */
|
||||
void xEndCH376Cmd( void ); /* 结束SPI命令 */
|
||||
void xWriteCH376Cmd( u8 mCmd ); /* 向CH376写命令 */
|
||||
void xWriteCH376Data( u8 mData ); /* 向CH376写数据 */
|
||||
u8 xReadCH376Data( void ); /* 从CH376读数据 */
|
||||
u8 Query376Interrupt( void ); /* 查询CH376中断(INT#引脚为低电平) */
|
||||
u8 mInitCH376Host( void ); /* 初始化CH376 */
|
||||
|
||||
u8 SPIx_ReadWriteByte(u8 TxData);//SPI总线读写一个字节
|
||||
|
||||
u8 CH376ReadBlock( u8* buf ); /* 从当前主机端点的接收缓冲区读取数据块,返回长度 */
|
||||
|
||||
u8 CH376WriteReqBlock( u8 * buf ); /* 向内部指定缓冲区写入请求的数据块,返回长度 */
|
||||
|
||||
void CH376WriteHostBlock( u8 * buf, u8 len ); /* 向USB主机端点的发送缓冲区写入数据块 */
|
||||
|
||||
void CH376WriteOfsBlock( u8 * buf, u8 ofs, u8 len ); /* 向内部缓冲区指定偏移地址写入数据块 */
|
||||
|
||||
void CH376SetFileName( u8 * name ); /* 设置将要操作的文件的文件名 */
|
||||
|
||||
u32 CH376Read32bitDat( void ); /* 从CH376芯片读取32位的数据并结束命令 */
|
||||
|
||||
u8 CH376ReadVar8( u8 var ); /* 读CH376芯片内部的8位变量 */
|
||||
|
||||
void CH376WriteVar8( u8 var, u8 dat ); /* 写CH376芯片内部的8位变量 */
|
||||
|
||||
u32 CH376ReadVar32( u8 var ); /* 读CH376芯片内部的32位变量 */
|
||||
|
||||
void CH376WriteVar32( u8 var, u32 dat ); /* 写CH376芯片内部的32位变量 */
|
||||
|
||||
void CH376EndDirInfo( void ); /* 在调用CH376DirInfoRead获取FAT_DIR_INFO结构之后应该通知CH376结束 */
|
||||
|
||||
u32 CH376GetFileSize( void ); /* 读取当前文件长度 */
|
||||
|
||||
u8 CH376GetDiskStatus( void ); /* 获取磁盘和文件系统的工作状态 */
|
||||
|
||||
u8 CH376GetIntStatus( void ); /* 获取中断状态并取消中断请求 */
|
||||
|
||||
#ifndef NO_DEFAULT_CH376_INT
|
||||
u8 Wait376Interrupt( void ); /* 等待CH376中断(INT#低电平)，返回中断状态码, 超时则返回ERR_USB_UNKNOWN */
|
||||
#endif
|
||||
|
||||
u8 CH376SendCmdWaitInt( u8 mCmd ); /* 发出命令码后,等待中断 */
|
||||
|
||||
u8 CH376SendCmdDatWaitInt( u8 mCmd, u8 mDat ); /* 发出命令码和一字节数据后,等待中断 */
|
||||
|
||||
u8 CH376DiskReqSense( void ); /* 检查USB存储器错误 */
|
||||
|
||||
u8 CH376DiskConnect( void ); /* 检查U盘是否连接,不支持SD卡 */
|
||||
|
||||
u8 CH376DiskMount( void ); /* 初始化磁盘并测试磁盘是否就绪 */
|
||||
|
||||
u8 CH376FileOpen( u8 * name ); /* 在根目录或者当前目录下打开文件或者目录(文件夹) */
|
||||
|
||||
u8 CH376FileCreate( u8 * name ); /* 在根目录或者当前目录下新建文件,如果文件已经存在那么先删除 */
|
||||
|
||||
u8 CH376DirCreate( u8 * name ); /* 在根目录下新建目录(文件夹)并打开,如果目录已经存在那么直接打开 */
|
||||
|
||||
u8 CH376SeparatePath( u8 * path ); /* 从路径中分离出最后一级文件名或者目录(文件夹)名,返回最后一级文件名或者目录名的字节偏移 */
|
||||
|
||||
u8 CH376FileOpenDir( u8 * PathName, u8 StopName ); /* 打开多级目录下的文件或者目录的上级目录,支持多级目录路径,支持路径分隔符,路径长度不超过255个字符 */
|
||||
/* StopName 指向最后一级文件名或者目录名 */
|
||||
|
||||
u8 CH376FileOpenPath( u8 * PathName ); /* 打开多级目录下的文件或者目录(文件夹),支持多级目录路径,支持路径分隔符,路径长度不超过255个字符 */
|
||||
|
||||
u8 CH376FileCreatePath( u8 * PathName ); /* 新建多级目录下的文件,支持多级目录路径,支持路径分隔符,路径长度不超过255个字符 */
|
||||
|
||||
#ifdef EN_DIR_CREATE
|
||||
u8 CH376DirCreatePath( u8 * PathName ); /* 新建多级目录下的目录(文件夹)并打开,支持多级目录路径,支持路径分隔符,路径长度不超过255个字符 */
|
||||
#endif
|
||||
|
||||
u8 CH376FileErase( u8 * PathName ); /* 删除文件,如果已经打开则直接删除,否则对于文件会先打开再删除,支持多级目录路径 */
|
||||
|
||||
u8 CH376FileClose( u8 UpdateSz ); /* 关闭当前已经打开的文件或者目录(文件夹) */
|
||||
|
||||
u8 CH376DirInfoRead( void ); /* 读取当前文件的目录信息 */
|
||||
|
||||
u8 CH376DirInfoSave( void ); /* 保存文件的目录信息 */
|
||||
|
||||
u8 CH376ByteLocate( u32 offset ); /* 以字节为单位移动当前文件指针 */
|
||||
|
||||
u8 CH376ByteRead( u8 * buf, UINT16 ReqCount, PUINT16 RealCount ); /* 以字节为单位从当前位置读取数据块 */
|
||||
|
||||
u8 CH376ByteWrite( u8 * buf, UINT16 ReqCount, PUINT16 RealCount ); /* 以字节为单位向当前位置写入数据块 */
|
||||
|
||||
u8 CH376DiskCapacity( u32 * DiskCap ); /* 查询磁盘物理容量,扇区数 */
|
||||
|
||||
u8 CH376DiskQuery( u32 * DiskFre ); /* 查询磁盘剩余空间信息,扇区数 */
|
||||
|
||||
u8 CH376SecLocate( u32 offset ); /* 以扇区为单位移动当前文件指针 */
|
||||
|
||||
#ifdef EN_SECTOR_ACCESS
|
||||
|
||||
u8 CH376DiskReadSec( u8 * buf, u32 iLbaStart, u8 iSectorCount ); /* 从U盘读取多个扇区的数据块到缓冲区,不支持SD卡 */
|
||||
|
||||
u8 CH376DiskWriteSec( u8 * buf, u32 iLbaStart, u8 iSectorCount ); /* 将缓冲区中的多个扇区的数据块写入U盘,不支持SD卡 */
|
||||
|
||||
u8 CH376SecRead( u8 * buf, u8 ReqCount, u8 * RealCount ); /* 以扇区为单位从当前位置读取数据块,不支持SD卡 */
|
||||
|
||||
u8 CH376SecWrite( u8 * buf, u8 ReqCount, u8 * RealCount ); /* 以扇区为单位在当前位置写入数据块,不支持SD卡 */
|
||||
|
||||
#endif
|
||||
|
||||
#ifdef EN_LONG_NAME
|
||||
|
||||
u8 CH376LongNameWrite( u8 * buf, UINT16 ReqCount ); /* 长文件名专用的字节写子程序 */
|
||||
|
||||
u8 CH376CheckNameSum( u8 * DirName ); /* 计算长文件名的短文件名检验和,输入为无小数点分隔符的固定11字节格式 */
|
||||
|
||||
u8 CH376LocateInUpDir( u8 * PathName ); /* 在上级目录(文件夹)中移动文件指针到当前文件目录信息所在的扇区 */
|
||||
/* 另外,顺便将当前文件目录信息所在的扇区的前一个扇区的LBA地址写入CH376内部VAR_FAT_DIR_LBA变量(为了方便收集长文件名时向前搜索,否则要多移动一次) */
|
||||
/* 使用了全局缓冲区GlobalBuf的前12个字节 */
|
||||
|
||||
u8 CH376GetLongName( u8 * PathName, u8 * LongName ); /* 由短文件名或者目录(文件夹)名获得相应的长文件名 */
|
||||
/* 需要输入短文件名的完整路径PathName,需要提供缓冲区接收长文件名LongName(以UNICODE小端编码,以双0结束) */
|
||||
/* 使用了全局缓冲区GlobalBuf的前34个字节,sizeof(GlobalBuf)>=sizeof(FAT_DIR_INFO)+2 */
|
||||
|
||||
u8 CH376CreateLongName( u8 * PathName, u8 * LongName ); /* 新建具有长文件名的文件,关闭文件后返回,LongName输入路径必须在RAM中 */
|
||||
/* 需要输入短文件名的完整路径PathName(请事先参考FAT规范由长文件名自行产生),需要输入以UNICODE小端编码的以双0结束的长文件名LongName */
|
||||
/* 使用了全局缓冲区GlobalBuf的前64个字节,sizeof(GlobalBuf)>=sizeof(FAT_DIR_INFO)*2 */
|
||||
|
||||
#endif
|
||||
|
||||
#endif
|
||||
|
||||
|
||||
Reference in New Issue
Block a user