CH376命令和系统子程序.doc

8.4. 快速应用参考步骤请参考例子程序调用已经将多个命令打包后的子程序以下步骤使用原始命令码，仅供参考8.4.1. 初始化，进行任何一项文件操作之前的必要步骤① CMD_SET_USB_MODE 命令，进入USB-HOST 工作方式或者SD 卡主机工作方式（模式3）② 等待U 盘或者SD 卡连接，U 盘可以由CH376 自动检测并产生中断通知，或者由单片机向CH376 发出CMD_DISK_CONNECT 命令定期查询，SD 卡必须由单片机自行检测③ CMD_DISK_MOUNT 命令，初始化U 盘或者SD 卡，并测试磁盘是否就绪，失败后可以重试最多5 次④ 上述步骤只需执行一次，除非U 盘或者SD 卡断开后重新连接，那么必须回到步骤②8.4.2. 顺序读文件① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件② 多次CMD_BYTE_READ 命令+CMD_RD_USB_DATA0 命令+CMD_BYTE_RD_GO 命令，读取数据③ CMD_FILE_CLOSE 命令，关闭文件，可选操作8.4.3. 顺序改写文件（覆盖原数据，超过原文件长度后转变为追加数据）① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件② 多次CMD_BYTE_WRITE 命令+CMD_WR_REQ_DATA 命令+CMD_BYTE_WR_GO 命令，写入数据③ CMD_FILE_CLOSE 命令，参数是1，关闭文件并允许自动更新文件长度8.4.4. 向已有文件追加数据CH376 手册（一） ２４① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件② CMD_BYTE_LOCATE 命令，参数是0FFFFFFFFH，移动文件指针到文件末尾③ 多次CMD_BYTE_WRITE 命令+CMD_WR_REQ_DATA 命令+CMD_BYTE_WR_GO 命令，写入数据④ CMD_FILE_CLOSE 命令，参数是1，关闭文件并允许自动更新文件长度8.4.5. 新建文件并写入数据① CMD_SET_FILE_NAME 命令+CMD_FILE_CREATE 命令，新建文件② 多次CMD_BYTE_WRITE 命令+CMD_WR_REQ_DATA 命令+CMD_BYTE_WR_GO 命令，写入数据③ CMD_FILE_CLOSE 命令，参数是1，关闭文件并允许自动更新文件长度8.4.6. 先读文件再改写文件① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件② 多次CMD_BYTE_READ 命令+CMD_RD_USB_DATA0 命令+CMD_BYTE_RD_GO 命令，读取数据③ CMD_BYTE_LOCATE 命令，参数是0，移动文件指针到文件头部④ 多次CMD_BYTE_WRITE 命令+CMD_WR_REQ_DATA 命令+CMD_BYTE_WR_GO 命令，写入数据⑤ CMD_FILE_CLOSE 命令，参数是1，关闭文件并允许自动更新文件长度8.4.7. 如果文件已经存在则追加数据，如果文件不存在则新建文件再写入数据① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件，如果返回ERR_MISS_FILE 说明文件不存在，那么转步骤③② CMD_BYTE_LOCATE 命令，参数是0FFFFFFFFH，移动文件指针到文件末尾，然后转步骤④③ CMD_FILE_CREATE 命令，新建文件④ 多次CMD_BYTE_WRITE 命令+CMD_WR_REQ_DATA 命令+CMD_BYTE_WR_GO 命令，写入数据⑤ CMD_FILE_CLOSE 命令，参数是1，关闭文件并允许自动更新文件长度8.4.8. 修改文件名、文件日期/时间、文件长度等文件目录信息，请参考有关EXAM10 例子中的说明① CMD_SET_FILE_NAME 命令+CMD_FILE_OPEN 命令，打开文件② CMD_DIR_INFO_READ 命令，参数是0FFH，将文件目录信息读入内存③ 用CMD_RD_USB_DATA0 命令读出原文件目录信息④ CMD_DIR_INFO_READ 命令，参数是0FFH，将文件目录信息读入内存⑤ 用CMD_WR_OFS_DATA 命令写入新的文件目录信息⑥ CMD_DIR_INFO_SAVE 命令，保存文件目录信息⑦ CMD_FILE_CLOSE 命令，参数是0，关闭文件并禁止自动更新文件长度，可选操作8.4.9. 创建子目录（文件夹），请参考有关EXAM9 例子中的说明① CMD_SET_FILE_NAME 命令+CMD_DIR_CREATE 命令，新建子目录（文件夹）② CMD_FILE_CLOSE 命令，参数是0，关闭文件并禁止自动更新文件长度8.4.10. 处理小写文件名和长文件名，请参考有关EXAM11 例子中的说明8.4.11. 搜索和枚举文件名，全盘枚举所有文件，请参考有关EXAM13 例子中的说明8.4.12. 主从切换，与计算机通讯，读写U 盘或者SD 卡文件，请参考有关EXAM0 例子中的说明8.5. USB设备应用请参考 CH372 芯片的手册 CH372DS1.PDF 及其应用资料。

CH376 芯片 文件系统层 V1.0* 提供文件系统常用子程序,提供命令打包.不使用的子程序可以注释掉,从而节约单片机的程序 ROM 空间和数据 RAM 空间./* name 参数是指短文件名, 可以包括根目录符, 但不含有路径分隔符, 总长度不超过1+8+1+3+1 字节 *//* Path Name 参数是指全路径的短文件名 , 包括根目录符、多级子目录及路径分隔符、文件名/目录名 *//* Long Name 参数是指长文件名 , 以 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 __CH376_FS_H__#define __CH376_FS_H__#include"PARA.H"#define STRUCT_OFFSET( s, m ) ( (UINT8)( & ((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#endifUINT8 CH376ReadBlock( PUINT8 buf ); /* 从当前主机端点的接收缓冲区读取数据块,返回长度 */UINT8 CH376WriteReqBlock( PUINT8 buf ); /* 向内部指定缓冲区写入请求的数据块,返回长度 */void CH376WriteHostBlock( PUINT8 buf, UINT8 len ); /* 向 USB 主机端点的发送缓冲区写入数据块 */void CH376WriteOfsBlock( PUINT8 buf, UINT8 ofs, UINT8 len ); /* 向内部缓冲区指定偏移地址写入数据块 */void CH376SetFileName( PUINT8 name ); /* 设置将要操作的文件的文件名 */UINT32 CH376Read32bitDat( void ); /* 从 CH376 芯片读取 32 位的数据并结束命*/UINT8 CH376ReadVar8( UINT8 var ); /* 读 CH376 芯片内部的 8 位变量 */void CH376WriteVar8( UINT8 var, UINT8 dat ); /* 写 CH376 芯片内部的 8 位变量 */UINT32 CH376ReadVar32( UINT8 var ); /* 读 CH376 芯片内部的 32 位变量 */void CH376WriteVar32( UINT8 var, UINT32 dat );/* 写 CH376 芯片内部的 32 位变量 */void CH376EndDirInfo( void ); /* 在调用 CH376DirInfoRead 获取 FAT_DIR_INFO 结构之后应该通知 CH376 结束 */UINT32 CH376GetFileSize( void ); /* 读取当前文件长度 */UINT8 CH376GetDiskStatus( void ); /* 获取磁盘和文件系统的工作状态 */UINT8 CH376GetIntStatus( void ); /* 获取中断状态并取消中断请求 */#ifndef NO_DEFAULT_CH376_INTUINT8 Wait376Interrupt( void ); /* 等待 CH376 中断(INT#低电平)，返回中断状态码, 超时则返回 ERR_USB_UNKNOWN */#endifUINT8 CH376SendCmdWaitInt( UINT8 mCmd ); /* 发出命令码后,等待中断 */UINT8 CH376SendCmdDatWaitInt( UINT8 mCmd, UINT8 mDat ); /* 发出命令码和一字节数据后,等待中断 */UINT8 CH376DiskReqSense( void ); /* 检查 USB 存储器错误 */UINT8 CH376DiskConnect(void); /* 检查 U 盘是否连接,不支持 SD 卡 */UINT8 CH376DiskMount(void); /* 初始化磁盘并测试磁盘是否就绪 */UINT8 CH376FileOpen(PUINT8 name); 。