支持Hex、Bin、Motorola S文件的開源庫使用

本文為大家分享一個(gè)支持Hex、Bin、Motorola S文件鏡像格式之間進(jìn)行轉(zhuǎn)換的庫：BIN2HS。

概述

BIN2HS是支持Intel Hex、Motorola S格式與bin鏡像格式之間進(jìn)行轉(zhuǎn)換。其支持文件信息快速查看、分段數(shù)據(jù)處理。

鏡像文件格式

嵌入式系統(tǒng)中各種系統(tǒng)鏡像常用已下幾種文件格式來保存：

hex格式：包含地址信息，由多行紀(jì)錄條目組成的文本格式文件，每行都由校驗(yàn)和來保證數(shù)據(jù)完整性。

srecord格式：為motorola常用的鏡像格式，與hex類似，也是由多個(gè)記錄條目組成的文本格式文件

bin格式：二進(jìn)制鏡像格式，不包含任何地址信息，也不包含校驗(yàn)和數(shù)據(jù)。只是數(shù)據(jù)的二進(jìn)制集合。

文件

IntelHex.c：包括hex解析及與bin文件相互轉(zhuǎn)換的核心函數(shù)

IntelHex.h：包括hex文件相關(guān)的各種類型定義與函數(shù)原型

Srecord.c：包括srecord解析及與bin文件相互轉(zhuǎn)換的核心函數(shù)

Srecord.h：包括srecord文件相關(guān)的各種類型定義與函數(shù)原型

binstr_conv.c：數(shù)據(jù)與字符串的相互轉(zhuǎn)換支持

hex記錄

hex文件的記錄行都由：字符開始，之后為字節(jié)數(shù)量、起始地址和數(shù)據(jù)組成的16進(jìn)制字符串。 ［：］ ［字節(jié)數(shù)：1字節(jié)］ ［起始地址：2字節(jié)］ ［數(shù)據(jù)］ ［校驗(yàn)字段：1字節(jié)］

示例： ：104000005829002049AE0008DD4F0008DF4F0008A6

： 每個(gè)記錄行都由：開頭

10 記錄行包含的數(shù)據(jù)字節(jié)數(shù)（不包括起始地址和校驗(yàn)字段）

4000 當(dāng)前記錄的起始地址

00 記錄類型，00-數(shù)據(jù)記錄，01-記錄結(jié)束，04-擴(kuò)展線性記錄

5829-0008 記錄行中包含的0x10長度的數(shù)據(jù)記錄

A6 校驗(yàn)和為：之后所有數(shù)據(jù)字段的代數(shù)和的補(bǔ)碼（所有數(shù)據(jù)累加和為0）

每條hex記錄有1字節(jié)數(shù)據(jù)用以表示當(dāng)前記錄條目的類型：

00 數(shù)據(jù)記錄，表示當(dāng)前記錄行內(nèi)包含實(shí)際的映像數(shù)據(jù)

01 記錄結(jié)束，為hex的最后一個(gè)條目，其他字段都為0

02 擴(kuò)展段地址，數(shù)據(jù)項(xiàng)包含2字節(jié)擴(kuò)展地址字段，左移4位作為偏移地址

03 起始段地址，保存到8086 CS:IP中的地址

04 擴(kuò)展線性地址， 數(shù)據(jù)項(xiàng)包含2字節(jié)擴(kuò)展地址字段，左移16位作為偏移地址

05 起始線性地址，保存到8086 CS:IP中的地址

srecord記錄

srecord記錄（已下簡稱S格式）與hex記錄相似。也是由16進(jìn)制字符組成的記錄行構(gòu)成。每個(gè)記錄由S字符作為開始。

示例：S1137AF00A0A0D0000000000000000000000000061

S 記錄起始標(biāo)志

1 記錄類型，1-16位地址的數(shù)據(jù)記錄

13 當(dāng)前記錄的字節(jié)數(shù)，位起始地址字段+數(shù)據(jù)+校驗(yàn)和

7AF0 當(dāng)前記錄起始地址

0A0A-0000 記錄中包含的數(shù)據(jù)字段

61 校驗(yàn)和字段，為字節(jié)數(shù)、起始地址和數(shù)據(jù)字段累加和的反碼（所有數(shù)據(jù)累加和為0xff）

對象

//HEX記錄結(jié)構(gòu)

typedef struct eHexRecord

{

uint8_t count; /* 數(shù)據(jù)字節(jié)數(shù) */

uint16_t rcdAddr; /* 當(dāng)前記錄數(shù)據(jù)起始地址 */

HexRecordType type; /* 當(dāng)前記錄類型 */

uint32_t fileAddr; /* 文件地址=當(dāng)前記錄地址+擴(kuò)展地址 */

uint32_t extAddr; /* 用于保存記錄中的擴(kuò)展地址 */

uint8_t *pbuff; /* 轉(zhuǎn)換數(shù)據(jù)緩存內(nèi)存指針 */

uint32_t minAddr; /* 記錄中最小地址 */

uint32_t maxAddr; /* 記錄中最大地址 */

}IHexRecord;

//寫HEX描述結(jié)構(gòu)體

typedef struct eHexWirteInfo

{

uint8_t* pbuff; /* bin內(nèi)存區(qū) */

uint32_t size; /* bin文件大小 */

uint32_t startAddr; /* bin起始偏移地址 */

uint16_t linewidth; /* 每行數(shù)據(jù)字節(jié)數(shù)量 */

uint32_t offset; /* 當(dāng)前索引 */

}IHexWriteDescribe;

使用方法

獲取hex文件信息：

聲明IHexRecordhex記錄對象。

調(diào)用IHex_InitRecordData初始化記錄對象

對于每個(gè)hex記錄字符串行，都調(diào)用IHex_GetNextHeadInfo函數(shù)來解析字符串，直到IHexRecord中解析的記錄類型為IHEX_TYPE_ENDFILE為止。

由IHexRecord結(jié)構(gòu)體可得到hex文件的最小數(shù)據(jù)地址和最大數(shù)據(jù)地址

轉(zhuǎn)換hex數(shù)據(jù)到bin：

聲明IHexRecord，并聲明一個(gè)數(shù)據(jù)轉(zhuǎn)換的內(nèi)存緩沖區(qū)，其最大緩沖區(qū)大小為IHEX_MAX_BINDATA_NUM

調(diào)用IHex_InitRecordData來初始化記錄對象

對于每個(gè)hex記錄行，都調(diào)用IHex_GetNextBindata函數(shù)來解析記錄行，直到IHexRecord中解析的記錄類型為IHEX_TYPE_ENDFILE為止。

當(dāng)記錄類型為IHEX_TYPE_DATARECORD時(shí)，保存對象內(nèi)的轉(zhuǎn)換數(shù)據(jù)

轉(zhuǎn)換bin到hex：

聲明IHexWriteDescribe，并對各個(gè)成員進(jìn)行賦值

調(diào)用IHex_InitWriteDesc來初始化記錄對象

循環(huán)調(diào)用IHex_GetNextHexlinestr，并將得到的記錄字符串保存到需要的位置，知道其返回為0為止

Srecord

srecerd對象的使用方法與hex類似，請參考hex的使用方法。

責(zé)任編輯：haq