seed-vpm642系统函数库使用说明书.pdf
5函数库变量以及类型定义
文件指针,fat32_file_handle,32位无符号整数。
6函数库函数列表
6.1文件外部操作
文件外部操作包括以下函数。
1、voidSEEDVPM642_init();
描述:SEEDVPM642的初始化程序。
参数:无
返回值:无
2、BoolFat32_install(void)
描述:安装fat32文件系统,读mbr,bootrecords等,取得介质必须参数。
参数:无
返回值:如果成功则返回TRUE,失败则返回FALSE。失败的有可能是:分区1
不存在;文件系统不是fat32;扇区大小不是512字节;MBR或者PBR特征
字不正确;底层扇区读写错误。失败情况下无法使用库函数。
3、BoolFat32_filecreate(Byte*Filename)
描述:创建文件。如果该文件已经存在,则不进行任何操作直接返回FALSE。
参数:文件名,支持长文件名。
返回值:如果成功则返回TRUE,失败则返回FALSE。
4、BoolFat32_filedelete(Byte*Filename)
描述:删除文件。如果该文件不存在,则不进行任何操作直接返回FALSE。
参数:文件名,支持长文件名。
返回值:如果成功则返回TRUE,失败则返回FALSE。
5、BoolFat32_dircreate(Byte*Filename)
描述:在当前下创建子。如果该子存在,则不进行任何操作直接返回
FALSE。
参数:文件名,支持长文件名。
返回值:如果成功则返回TRUE,失败则返回FALSE。
6、BoolFat32_dirreturn()
描述:返回上一级子。如果已经在根下,则仍在根下并返回FALSE。
参数:无。
返回值:如果成功则返回TRUE。
7、BoolFat32_dirroot()
描述:直接返回根。
参数:无。
返回值:如果成功则返回TRUE。
8、BoolFat32_dirdelete(Byte*Filename)
描述:在当前下删除子。如果该子不存在,则不进行任何操作直接返回
FALSE。
参数:文件名,支持长文件名。
返回值:如果成功则返回TRUE,失败则返回FALSE。
6.2文件操作
1、Fat32_filehandleFat32_fileopen(Byte*Filename)
描述:打开一个文件,若文件不存在则创建文件。
参数:文件名,支持长文件名。
返回值:返回一个文件指针。如果返回0则说明打开失败。
详细描述:文件被打开后,文件位置指针将指向文件结尾处。如果直接写将在文件末
尾接着写。如果需要覆盖原有文件,需要使用fat32_file_seek函数将位
置指针指向相应位置。
2、Uint32Fat32_filewrite(Fat32_filehandlefile_handle,Byte*sorce_addr,Uint32
writeCount)
描述:写文件
参数:文件指针
写入数据源的地址
写入数据长度,单位:字节
返回值:实际写入字节数目
详细描述:以字节为单位。必须在执行fat32_file_open函数后执行。从文件位置指
针所指位置开始写。最后文件位置指针位于所写最后一个字节的下一个字
节处。
3、Uint32Fat32_fileread(Fat32_f