Hex、Bin、Motorola S文件轉(zhuǎn)化的開(kāi)源庫(kù)介紹和使用
概述
BIN2HS是支持Intel Hex、Motorola S格式與bin鏡像格式之間進(jìn)行轉(zhuǎn)換。其支持文件信息快速查看、分段數(shù)據(jù)處理。
鏡像文件格式
嵌入式系統(tǒng)中各種系統(tǒng)鏡像常用已下幾種文件格式來(lái)保存:
-
hex格式:包含地址信息,由多行紀(jì)錄條目組成的文本格式文件,每行都由校驗(yàn)和來(lái)保證數(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文件的記錄行都由:字符開(kāi)始,之后為字節(jié)數(shù)量、起始地址和數(shù)據(jù)組成的16進(jìn)制字符串。 [:] [字節(jié)數(shù):1字節(jié)] [起始地址:2字節(jié)] [數(shù)據(jù)] [校驗(yàn)字段:1字節(jié)]
示例: :104000005829002049AE0008DD4F0008DF4F0008A6
-
: 每個(gè)記錄行都由:開(kāi)頭
-
10 記錄行包含的數(shù)據(jù)字節(jié)數(shù)(不包括起始地址和校驗(yàn)字段)
-
4000 當(dāng)前記錄的起始地址
-
00 記錄類型,00-數(shù)據(jù)記錄,01-記錄結(jié)束,04-擴(kuò)展線性記錄
-
5829-0008 記錄行中包含的0x10長(zhǎng)度的數(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記錄(已下簡(jiǎn)稱S格式)與hex記錄相似。也是由16進(jìn)制字符組成的記錄行構(gòu)成。每個(gè)記錄由S字符作為開(kāi)始。
示例: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)
對(duì)象
//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; //寫(xiě)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記錄對(duì)象。
-
調(diào)用IHex_InitRecordData初始化記錄對(duì)象
-
對(duì)于每個(gè)hex記錄字符串行,都調(diào)用IHex_GetNextHeadInfo函數(shù)來(lái)解析字符串,直到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來(lái)初始化記錄對(duì)象
-
對(duì)于每個(gè)hex記錄行,都調(diào)用IHex_GetNextBindata函數(shù)來(lái)解析記錄行,直到IHexRecord中解析的記錄類型為IHEX_TYPE_ENDFILE為止。
-
當(dāng)記錄類型為IHEX_TYPE_DATARECORD時(shí),保存對(duì)象內(nèi)的轉(zhuǎn)換數(shù)據(jù)
轉(zhuǎn)換bin到hex:
-
聲明
IHexWriteDescribe,并對(duì)各個(gè)成員進(jìn)行賦值
-
調(diào)用IHex_InitWriteDesc來(lái)初始化記錄對(duì)象
-
循環(huán)調(diào)用IHex_GetNextHexlinestr,并將得到的記錄字符串保存到需要的位置,知道其返回為0為止
Srecord
srecerd對(duì)象的使用方法與hex類似,請(qǐng)參考hex的使用方法。
庫(kù)開(kāi)源BIN2HS地址:
https://gitee.com/git-lib/BIN2HS
免責(zé)聲明:本文素材來(lái)源網(wǎng)絡(luò),版權(quán)歸原作者所有。如涉及作品版權(quán)問(wèn)題,請(qǐng)與我聯(lián)系刪除。
------------ END ------------