📄 ch375hfa.inc
字号:
USB_INT_DISK_READ EQU 1DH ;USB存储器读数据块, 请求数据读出
USB_INT_DISK_WRITE EQU 1EH ;USB存储器写数据块, 请求数据写入
USB_INT_DISK_ERR EQU 1FH ;USB存储器操作失败
; *********************************************************************************************************************
; 返回的操作状态码 */
; 以下是中断状态码,适用于CH375IntStatus
; 以下是事件通知状态码,检测到当前U盘已经连接或者已经断开,可以作为最终状态码 */
ERR_USB_CONNECT EQU 015H ; 检测到USB设备连接事件,磁盘已经连接 */
ERR_USB_DISCON EQU 016H ; 检测到USB设备断开事件,磁盘已经断开 */
; 以下是阶段性的状态码,用于请求数据交换,不是最终的操作状态 */
;USB_INT_DISK_READ EQU 01DH ; USB存储器读数据块,只用于CMD_FileRead命令,请求数据读出 */
;USB_INT_DISK_WRITE EQU 01EH ; USB存储器写数据块,只用于CMD_FileWrite命令,请求数据写入 */
ERR_USB_DISK_ERR EQU 01FH ; USB存储器操作失败,在初始化时可能是USB存储器不支持,在读写操作中可能是磁盘损坏或者已经断开 */
; 最终状态码 */
ERR_SUCCESS EQU 000H ; 操作成功 */
ERR_CH375_ERROR EQU 081H ; CH375硬件错误,可能需要复位CH375 */
ERR_DISK_DISCON EQU 082H ; 检测到USB设备连接事件,磁盘已经断开,或者磁盘尚未连接 */
ERR_STATUS_ERR EQU 083H ; 磁盘状态错误,可能正在连接或者断开磁盘 */
ERR_MBR_ERROR EQU 091H ; 磁盘的主引导记录无效,可能磁盘尚未分区或者尚未格式化 */
ERR_TYPE_ERROR EQU 092H ; 磁盘分区类型不支持,只支持FAT12/FAT16/BigDOS/FAT32,需要由磁盘管理工具重新分区 */
ERR_BPB_ERROR EQU 0A1H ; 磁盘尚未格式化,或者参数错误,需要由WINDOWS采用默认参数重新格式化 */
ERR_TOO_LARGE EQU 0A2H ; 磁盘非正常格式化并且容量大于4GB,或者容量大于250GB,需要由WINDOWS采用默认参数重新格式化 */
ERR_FAT_ERROR EQU 0A3H ; 磁盘的文件系统不支持,只支持FAT12/FAT16/FAT32,需要由WINDOWS采用默认参数重新格式化 */
ERR_DISK_FULL EQU 0B1H ; 磁盘文件太满,剩余空间太少或者已经没有,需要磁盘整理 */
ERR_FDT_OVER EQU 0B2H ; 目录内文件太多,没有空闲的目录项,FAT12/FAT16根目录下的文件数应该少于500个,需要磁盘整理 */
ERR_MISS_DIR EQU 0B3H ; 指定路径的某个子目录没有找到,可能是目录名称错误 */
ERR_FILE_CLOSE EQU 0B4H ; 文件已经关闭,如果需要使用,应该重新打开文件 */
ERR_OPEN_DIR EQU 041H ; 指定路径的目录被打开 */
ERR_MISS_FILE EQU 042H ; 指定路径的文件没有找到,可能是文件名称错误 */
ERR_FOUND_NAME EQU 043H ; 搜索到与通配符相匹配的文件名,文件名及其完整路径在命令缓冲区中,如果需要使用,应该打开该文件 */
; 其余错误代码未定义 */
; ********************************************************************************************************************* */
; 磁盘及文件状态,适用于CH375DiskStatus */
DISK_UNKNOWN EQU 000H ; 尚未初始化,未知状态 */
DISK_DISCONNECT EQU 001H ; 磁盘没有连接或者已经断开 */
DISK_CONNECT EQU 002H ; 磁盘已经连接,但是尚未初始化或者无法识别该磁盘 */
DISK_MOUNTED EQU 003H ; 磁盘已经初始化成功,但是尚未分析文件系统或者文件系统不支持 */
DISK_READY EQU 010H ; 已经分析磁盘的文件系统并且能够支持 */
DISK_OPEN_ROOT EQU 012H ; 已经打开根目录,扇区模式,只能以扇区为单位读写目录的内容,使用后必须关闭,注意FAT12/FAT16根目录是固定长度 */
DISK_OPEN_DIR EQU 013H ; 已经打开子目录,扇区模式,只能以扇区为单位读写目录的内容 */
DISK_OPEN_FILE EQU 014H ; 已经打开文件,扇区模式,可以以扇区为单位进行数据读写 */
DISK_OPEN_FILE_B EQU 015H ; 已经打开文件,字节模式,可以以字节为单位进行数据读写 */
; ********************************************************************************************************************* */
; FAT类型标志,适用于CMD_PARAM.Query.mDiskFat */
DISK_FS_UNKNOWN EQU 0 ; 未知的文件系统 */
DISK_FAT12 EQU 1 ; FAT12文件系统 */
DISK_FAT16 EQU 2 ; FAT16文件系统 */
DISK_FAT32 EQU 3 ; FAT32文件系统 */
; ********************************************************************************************************************* */
; 文件属性,适用于CMD_PARAM.Modify.mFileAttr */
ATTR_READ_ONLY EQU 001H ; 文件为只读属性 */
ATTR_HIDDEN EQU 002H ; 文件为隐含属性 */
ATTR_SYSTEM EQU 004H ; 文件为系统属性 */
ATTR_VOLUME_ID EQU 008H ; 卷标 */
ATTR_DIRECTORY EQU 010H ; 子目录 */
ATTR_ARCHIVE EQU 020H ; 文件为存档属性 */
;ATTR_LONG_NAME ( ATTR_READ_ONLY | ATTR_HIDDEN | ATTR_SYSTEM | ATTR_VOLUME_ID )
; 文件属性 unsigned char */
; bit0 bit1 bit2 bit3 bit4 bit5 bit6 bit7 */
; 只 隐 系 卷 目 存 未定义 */
; 读 藏 统 标 录 档 */
; 文件时间 unsigned short,适用于CMD_PARAM.Modify.mFileTime */
; Time = (Hour<<11) + (Minute<<5) + (Second>>1) */
; 文件日期 unsigned short,适用于CMD_PARAM.Modify.mFileDate */
; Date = ((Year-1980)<<9) + (Month<<5) + Day */
; ********************************************************************************************************************* */
; 文件名,适用于CMD_PARAM.?.mPathName */
PATH_WILDCARD_CHAR EQU 02AH ; 路径名的通配符 '*' */
PATH_SEPAR_CHAR1 EQU 05CH ; 路径名的分隔符 '\' */
PATH_SEPAR_CHAR2 EQU 02FH ; 路径名的分隔符 '/' */
#ifndef MAX_PATH_LEN
MAX_PATH_LEN EQU 30 ; 最大路径长度,含所有斜杠分隔符和小数点间隔符以及路径结束符00H */
#endif
#ifndef MAX_BYTE_IO
MAX_BYTE_IO EQU ( MAX_PATH_LEN - 1 ) ; 以字节为单位单次读写文件时的最大长度,超过该长度可以分多次读写 */
#endif
; 外部命令参数结构, 用于在调用CH375程序库中的子程序时提供参数
;typedef union _CMD_PARAM {
; struct {
; UINT8 mBuffer[ MAX_PATH_LEN ];
; } Other;
; struct {
; UINT32 mDiskSizeSec; /* 返回: 整个物理磁盘的总扇区数 */
; UINT32 mTotalSector; /* 返回: 当前逻辑盘的总扇区数 */
; UINT32 mFreeSector; /* 返回: 当前逻辑盘的剩余扇区数 */
; UINT8 mDiskFat; /* 返回: 当前逻辑盘的FAT类型 */
; } Query; /* CMD_DiskQuery, 查询磁盘信息 */
; struct {
; UINT8 mPathName[ MAX_PATH_LEN ]; /* 输入参数: 路径: [盘符,冒号,斜杠,目录名或者文件名及扩展名...,结束符00H], 其中盘符和冒号可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
; } Open; /* CMD_FileOpen, 打开文件 */
; struct {
; UINT8 mPathName[ MAX_PATH_LEN ]; /* 输入参数: 路径: [盘符,冒号,斜杠,目录名或者文件名及扩展名(含通配符*)...,枚举序号], 其中盘符和冒号可以省略, 例如"C:\DIR1.EXT\DIR2\FILE*",00H */
; } Enumer; /* CMD_FileEnumer, 枚举文件,返回文件名 */
; struct {
; UINT8 mUpdateLen; /* 输入参数: 是否允许更新长度: 0禁止,1允许 */
; } Close; /* CMD_FileClose, 关闭当前文件 */
; struct {
; UINT8 mPathName[ MAX_PATH_LEN ]; /* 输入参数: 路径: [盘符,冒号,斜杠,目录名或者文件名及扩展名...,结束符00H], 其中盘符和冒号可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
; } Create; /* CMD_FileCreate, 新建文件并打开,如果文件已经存在则先删除后再新建 */
; struct {
; UINT8 mPathName[ MAX_PATH_LEN ]; /* 输入参数: 路径: [盘符,冒号,斜杠,目录名或者文件名及扩展名...,结束符00H], 其中盘符和冒号可以省略, 例如"C:\DIR1.EXT\DIR2\FILENAME.EXT",00H */
; } Erase; /* CMD_FileErase, 删除文件并关闭 */
; struct {
; UINT32 mFileSize; /* 输入参数: 新的文件长度,为0FFFFFFFFH则不修改, 返回: 原长度 */
; UINT16 mFileDate; /* 输入参数: 新的文件日期,为0FFFFH则不修改, 返回: 原日期 */
; UINT16 mFileTime; /* 输入参数: 新的文件时间,为0FFFFH则不修改, 返回: 原时间 */
; UINT8 mFileAttr; /* 输入参数: 新的文件属性,为0FFH则不修改, 返回: 原属性 */
; } Modify; /* CMD_FileQuery, 查询当前文件的信息; CMD_FileModify, 查询或者修改当前文件的信息 */
; struct {
; UINT32 mSectorOffset; /* 输入参数: 扇区偏移,0则移动到文件头,0FFFFFFFFH则移动到文件尾, 返回: 当前文件指针对应的绝对线性扇区号, 0FFFFFFFFH则已到文件尾 */
; } Locate; /* CMD_FileLocate, 移动当前文件指针 */
; struct {
; UINT8 mSectorCount; /* 输入参数: 读取扇区数, 返回: 实际读取扇区数 */
; } Read; /* CMD_FileRead, 从当前文件读取数据 */
; struct {
; UINT8 mSectorCount; /* 输入参数: 写入扇区数, 返回: 实际写入扇区数 */
; } Write; /* CMD_FileWrite, 向当前文件写入数据 */
; struct {
; UINT8 mSectorCount; /* 输入参数: 读取扇区数, 返回: 实际读取扇区数 */
; UINT8 mReserved[7];
; PUINT8X mDataBuffer; /* 输入参数: 缓冲区起始地址, 返回: 缓冲区当前地址 */
; } ReadX; /* CMD_FileReadX, 从当前文件读取数据到指定缓冲区 */
; struct {
; UINT8 mSectorCount; /* 输入参数: 写入扇区数, 返回: 实际写入扇区数 */
; UINT8 mReserved[7];
; PUINT8X mDataBuffer; /* 输入参数: 缓冲区起始地址, 返回: 缓冲区当前地址 */
; } WriteX; /* CMD_FileWriteX, 向当前文件写入指定缓冲区的数据 */
; struct {
; UINT32 mDiskSizeSec; /* 返回: 整个物理磁盘的总扇区数 */
; } DiskSize; /* CMD_DiskSize, 查询磁盘容量 */
; struct {
; UINT32 mByteOffset; /* 输入参数: 以字节为单位的偏移量, 以字节为单位的文件指针, 返回: 当前文件指针对应的绝对线性扇区号, 0FFFFFFFFH则已到文件尾 */
; } ByteLocate; /* CMD_ByteLocate, 以字节为单位移动当前文件指针 */
; struct {
; UINT8 mByteCount; /* 输入参数: 准备读取的字节数,不得大于MAX_BYTE_IO, 返回: 实际读出的字节数 */
; UINT8 mByteBuffer[ MAX_BYTE_IO ]; /* 返回: 读出的数据块 */
; } ByteRead; /* CMD_ByteRead, 以字节为单位从当前文件读取数据块 */
; struct {
; UINT8 mByteCount; /* 输入参数: 准备写入的字节数,不得大于MAX_BYTE_IO, 返回: 实际写入的字节数 */
; UINT8 mByteBuffer[ MAX_BYTE_IO ]; /* 输入参数: 准备写入的数据块 */
; } ByteWrite; /* CMD_ByteWrite, 以字节为单位向当前文件写入数据块 */
; union {
; struct {
; UINT32 mCBW_Sig;
; UINT32 mCBW_Tag;
; UINT8 mCBW_DataLen; /* 输入: 数据传输长度,有效值是0到255 */
; UINT8 mCBW_DataLen1;
; UINT8 mCBW_DataLen2;
; UINT8 mCBW_DataLen3;
; UINT8 mCBW_Flag; /* 输入: 传输方向等标志 */
; UINT8 mCBW_LUN;
; UINT8 mCBW_CB_Len; /* 输入: 命令块的长度,有效值是1到16 */
; UINT8 mCBW_CB_Buf[6]; /* 输入: 命令块,该缓冲区最多为16个字节 */
; } mCBW; /* BulkOnly协议的命令块, 输入CBW结构 */
; struct {
; UINT32 mCSW_Sig;
; UINT32 mCSW_Tag;
; UINT32 mCSW_Residue; /* 返回: 剩余数据长度 */
; UINT8 mCSW_Status; /* 返回: 命令执行结果状态 */
; UINT8 mReserved;
; } mCSW; /* BulkOnly协议的命令状态块, 输出CSW结构 */
; } BOC; /* CMD_BulkOnlyCmd, 执行基于BulkOnly协议的命令, 如果有数据传输那么数据在DISK_BASE_BUF中 */
;} CMD_PARAM;
#define EN_DISK_WRITE 1
#define EN_DISK_FAT12 1
#define EN_DISK_FAT32 1
#define EN_BYTE_ACCESS 1
; ********************************************************************************************************************* */
; 段定义
CH375LIB_CODE SEGMENT CODE
CH375LIB_IDATA SEGMENT XDATA
; ********************************************************************************************************************* */
; 子程序库中提供的变量 */
EXTRN XDATA (CH375IntStatus) ;CH375操作的中断状态
EXTRN XDATA (CH375DiskStatus) ;磁盘及文件状态
EXTRN XDATA (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并处理
EXTRN XDATA (CH375vDiskFat) ;逻辑盘的FAT标志:1=FAT12,2=FAT16,3=FAT32
EXTRN XDATA (CH375vSecPerClus) ;逻辑盘的每簇扇区数
EXTRN XDATA (CH375vStartCluster) ;当前文件或者目录的起始簇号,UINT32
EXTRN XDATA (CH375vFileSize) ;当前文件的长度,UINT32
EXTRN XDATA (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 */
EXTRN XDATA (CH375Version2) ;芯片版本:0-CH375,1-CH375A
EXTRN XDATA (CH375vDataStart) ;逻辑盘的数据区域的起始LBA,UINT32
EXTRN XDATA (CH375vFdtLba) ;当前FDT所在的LBA地址,UINT32
EXTRN XDATA (CH375vFdtOffset) ;当前FDT在扇区内的偏移地址,UINT16
#ifdef EN_DISK_FAT32
EXTRN XDATA (CH375vDiskRoot) ;对于FAT16盘为根目录占用扇区数,对于FAT32盘为根目录起始簇号,UINT32
#else
EXTRN XDATA (CH375vDiskRoot) ;对于FAT16盘为根目录占用扇区数
#endif
EXTRN CODE (CH375ReadBlock) ; 从磁盘读取多个扇区的数据到外部接口交换区 */
#ifdef EN_DISK_WRITE
EXTRN CODE (CH375WriteBlock) ; 将外部接口交换区的多个扇区的数据块写入磁盘 */
#endif
#endif#ifndef LIB_CFG_VALUE
#define LIB_CFG_VALUE 05H ; CH375程序库配置值 */
#endif
; ********************************************************************************************************************* */
; 子程序库中提供的子程序, 操作完成后返回状态码在R7中 */
; 下述子程序中, 文件操作子程序CH375File*和磁盘查询子程序CH375DiskQuery都可能会用到磁盘数据缓冲区DISK_BASE_BUF,
; 并且有可能在DISK_BASE_BUF中保存了磁盘信息, 所以必须保证DISK_BASE_BUF不被用于其它用途,
; 如果RAM较少, 要将DISK_BASE_BUF临时用于其它用途, 那么在临时用完后必须调用CH375DirtyBuffer清除磁盘缓冲区 */
EXTRN CODE (CH375GetVer) ; 获取当前子程序库的版本号 */
EXTRN CODE (CH375Reset) ; 复位CH375 */
EXTRN CODE (CH375Init) ; 初始化CH375 */
EXTRN CODE (CH375DirtyBuffer) ; 清除磁盘缓冲区 */
EXTRN CODE (CH375FileOpen) ; 打开文件或者枚举文件 */
EXTRN CODE (CH375FileEnumer) ; 枚举文件 */
EXTRN CODE (CH375FileClose) ; 关闭当前文件 */
EXTRN CODE (CH375FileQuery) ; 查询当前文件的信息 */
EXTRN CODE (CH375FileModify) ; 查询或者修改当前文件的信息 */
EXTRN CODE (CH375FileLocate) ; 移动当前文件指针 */
EXTRN CODE (CH375FileReadX) ; 从当前文件读取数据到指定缓冲区 */
#ifdef EN_DISK_WRITE
EXTRN CODE (CH375FileErase) ; 删除文件并关闭 */
EXTRN CODE (CH375FileCreate) ; 新建文件并打开,如果文件已经存在则先删除后再新建 */
EXTRN CODE (CH375FileWriteX) ; 向当前文件写入指定缓冲区的数据 */
EXTRN CODE (CH375DiskSize) ; 查询磁盘容量 */
EXTRN CODE (CH375DiskQuery) ; 查询磁盘信息 */
#endif
#ifdef EN_BYTE_ACCESS
EXTRN CODE (CH375ByteLocate) ; 以字节为单位移动当前文件指针 */
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -