HEX及S19文件解析

HEX,S19文件解析相关函数 更多...

结构体
struct	_HEX_FILE_BLOCK
	文件数据块结构体定义 更多...

类型定义
typedef struct _HEX_FILE_BLOCK	HEX_FILE_BLOCK
	文件数据块结构体定义
typedef struct _HEX_FILE_BLOCK *	PHEX_FILE_BLOCK

函数
int WINAPI	hexfile_load_file (const char *filename, char *fileBuf)
	读取文件内容到数据缓冲区 更多...
int WINAPI	hexfile_convert_s19 (char *fileBuf, int lenFileBuf, HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum, char memType)
	按照S19文件格式解析文件，然后输出文件块数据信息 更多...
int WINAPI	hexfile_convert_ihx (char *fileBuf, int lenFileBuf, HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum, char memType)
	按照HEX文件格式解析文件，然后输出文件块数据信息 更多...
int WINAPI	hexfile_convert_txt (char *fileBuf, int lenFileBuf, HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum, char memType)
	按照TXT文件格式解析文件，然后输出文件块数据信息 更多...
int WINAPI	hexfile_free_data (HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum)
	释放文件块数据 更多...
int WINAPI	hexfile_save_image (const char *filename, HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum, char memType, char fillBytes)
	将文件信息块数据转为连续地址数据文件 更多...
int WINAPI	hexfile_convert_image (char *pOutData, HEX_FILE_BLOCK *pHexFileBlock, int maxBlockNum, char memType, char fillBytes)
	将文件信息块数据转为连续地址数据 更多...

存储类型定义
HEX文件中一个地址单元存储的数据字节数定义
#define	MEMTYPE_UINT8   1
	1个地址单元存储1字节数据
#define	MEMTYPE_UINT16   2
	1个地址单元存储2字节数据
#define	MEMTYPE_UINT32   4
	1个地址单元存储4字节数据

详细描述

HEX,S19文件解析相关函数

函数说明

hexfile_load_file()

int WINAPI hexfile_load_file	(	const char *	filename,
		char *	fileBuf
	)

读取文件内容到数据缓冲区

参数

filename	文件名称，需要包含完整路径，否则在当前程序目录下寻找文件
fileBuf	文件内存存储缓冲区，该缓冲区必须大于文件内容，否则可能会导致缓冲区溢出，程序崩溃

返回

函数执行状态

返回值

>=0	读取到的文件内容大小
<0	函数调用失败

hexfile_convert_s19()

int WINAPI hexfile_convert_s19	(	char *	fileBuf,
		int	lenFileBuf,
		HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum,
		char	memType
	)

按照S19文件格式解析文件，然后输出文件块数据信息

参数

fileBuf	原始文件内容
lenFileBuf	原始文件内容大小
pHexFileBlock	文件信息块数组首地址
maxBlockNum	文件信息块数组大小
memType	数据存储类型

返回

函数执行状态

返回值

>=0	解析到的文件信息块数
<0	函数调用失败

hexfile_convert_ihx()

int WINAPI hexfile_convert_ihx	(	char *	fileBuf,
		int	lenFileBuf,
		HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum,
		char	memType
	)

按照HEX文件格式解析文件，然后输出文件块数据信息

参数

fileBuf	原始文件内容
lenFileBuf	原始文件内容大小
pHexFileBlock	文件信息块数组首地址
maxBlockNum	文件信息块数组大小
memType	数据存储类型

返回

函数执行状态

返回值

>=0	解析到的文件信息块数
<0	函数调用失败

hexfile_convert_txt()

int WINAPI hexfile_convert_txt	(	char *	fileBuf,
		int	lenFileBuf,
		HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum,
		char	memType
	)

按照TXT文件格式解析文件，然后输出文件块数据信息

参数

fileBuf	原始文件内容
lenFileBuf	原始文件内容大小
pHexFileBlock	文件信息块数组首地址
maxBlockNum	文件信息块数组大小
memType	数据存储类型

返回

函数执行状态

返回值

>=0	解析到的文件信息块数
<0	函数调用失败

hexfile_free_data()

int WINAPI hexfile_free_data	(	HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum
	)

释放文件块数据

参数

pHexFileBlock	文件信息块数组首地址
maxBlockNum	解析后有效文件块数

返回

函数执行状态

返回值

=0	解析到的文件信息块数
<0	函数调用失败

hexfile_save_image()

int WINAPI hexfile_save_image	(	const char *	filename,
		HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum,
		char	memType,
		char	fillBytes
	)

将文件信息块数据转为连续地址数据文件

参数

filename	文件输出名称
pHexFileBlock	文件信息块数组首地址
maxBlockNum	解析后有效文件块数
memType	数据存储类型
fillBytes	没有数据的地址空间填充数据

返回

函数执行状态

返回值

=0	解析到的文件信息块数
<0	函数调用失败

hexfile_convert_image()

int WINAPI hexfile_convert_image	(	char *	pOutData,
		HEX_FILE_BLOCK *	pHexFileBlock,
		int	maxBlockNum,
		char	memType,
		char	fillBytes
	)

将文件信息块数据转为连续地址数据

参数

pOutData	连续地址数据输出缓冲区首地址
pHexFileBlock	文件信息块数组首地址
maxBlockNum	解析后有效文件块数
memType	数据存储类型
fillBytes	没有数据的地址空间填充数据

返回

函数执行状态

返回值

=0	解析到的文件信息块数
<0	函数调用失败