1. 项目背景与核心需求
在嵌入式开发中，我们经常需要将Bootloader和应用程序合并成一个完整的固件文件。这个HEX合成脚本就是为了解决这个实际需求而诞生的。想象一下，你刚完成了一个漂亮的嵌入式项目，Bootloader负责底层硬件初始化和安全校验，APP实现业务逻辑，但最后烧录时却要分别操作两次，既麻烦又容易出错。
我最早是在开发一个物联网终端设备时遇到这个问题的。每次OTA升级测试都要手动合并两个HEX文件，不仅效率低下，还出现过几次漏合并导致设备变砖的情况。于是决定写个自动化脚本一劳永逸地解决这个问题。
2. 技术方案选型
2.1 为什么选择Python实现
Python的跨平台特性让这个脚本可以在Windows/Linux/macOS上无缝运行，而且开发效率极高。对比其他方案：
- Shell脚本：处理二进制文件不够灵活
- C语言：开发周期长，过度设计
- MATLAB：依赖商业软件
特别值得一提的是Python的intelhex库，它专门为处理HEX文件格式而生。这个库可以：
- 完美解析Intel HEX格式
- 支持地址偏移量设置
- 自动处理数据记录校验和
- 提供地址空间冲突检测
2.2 HEX文件格式深度解析
Intel HEX格式看似简单实则暗藏玄机。一个典型的记录长这样：
:10010000214601360121470136007EFE09D2190140C2
拆解说明：
:起始符10数据长度（16字节）0100地址偏移00记录类型（数据记录）2146...0140实际数据C2校验和
脚本需要特别处理的关键记录类型：
04扩展线性地址记录（决定高16位地址）05起始线性地址记录（入口地址）01文件结束记录
3. 脚本实现详解
3.1 核心代码结构
python复制import sys
from intelhex import IntelHex
def merge_hex(boot_file, app_file, output_file):
# 初始化HEX对象
boot_hex = IntelHex()
app_hex = IntelHex()
# 加载文件
boot_hex.loadhex(boot_file)
app_hex.loadhex(app_file)
# 地址冲突检测
overlap = boot_hex.overlaps(app_hex)
if overlap:
raise ValueError(f"地址冲突！冲突区域：{overlap}")
# 合并操作
boot_hex.merge(app_hex, overlap='replace')
# 保存输出
boot_hex.write_hex_file(output_file)
3.2 关键参数解析
-
地址对齐配置：
python复制# 设置APP的起始偏移地址（示例为128KB处） app_hex = IntelHex(app_file) app_hex.segment(0x20000) # 128KB偏移这个值必须与你的链接脚本中的
FLASH_APP_ADDR严格一致。 -
校验和自动修复：
python复制# 强制重新计算校验和 boot_hex.write_hex_file(output_file, write_start_addr=False) -
地址空间检测：
python复制# 获取Bootloader占用的最大地址 boot_end = max(boot_hex.addresses()) # 确保APP起始地址大于boot_end if app_start <= boot_end: raise MemoryError("APP地址空间与Bootloader重叠！")
4. 高级功能实现
4.1 自动填充空白区域
很多MCU要求固件必须连续无空洞，这个功能可以自动填充空白区域：
python复制def pad_hex(ih, fill=0xFF, chunk_size=1024):
segments = ih.segments()
for i in range(len(segments)-1):
end = segments[i][1]
start_next = segments[i+1][0]
if start_next > end + 1:
ih.puts(end+1, bytes([fill]*(start_next-end-1)))
4.2 版本信息注入
在合并时自动注入构建信息：
python复制def inject_metadata(ih, version):
metadata = f"VER:{version}|TIME:{int(time.time())}"
# 放在最后64KB的末尾
addr = ih.maxaddr() & 0xFFFF0000 | 0xFF00
ih.puts(addr, metadata.encode('ascii'))
5. 实战注意事项
5.1 地址对齐陷阱
遇到过最隐蔽的bug是STM32H7系列的双Bank Flash情况。解决方案：
python复制# 对于双Bank设备需要特殊处理
if dual_bank:
app1_start = 0x08000000
app2_start = 0x08100000
# 需要分别处理两个区域的合并
5.2 性能优化技巧
处理大文件时（超过1MB的HEX）：
- 使用
mmap加速文件读取 - 禁用
IntelHex的调试输出python复制import logging logging.getLogger('intelhex').setLevel(logging.WARNING)
5.3 异常处理清单
必须捕获的异常类型：
HexMergeError- 地址重叠EOFError- 文件不完整ValueError- 非法HEX格式MemoryError- 地址越界
6. 扩展应用场景
6.1 自动化构建集成
与Makefile集成示例：
makefile复制firmware.hex: boot.hex app.hex
python3 merge_hex.py $^ $@
@echo "Merged size:" $(shell stat -c%s $@)
6.2 批量处理模式
支持通配符批量合并：
python复制for boot_file in glob.glob('boot/*.hex'):
app_file = f'app/{os.path.basename(boot_file)}'
if os.path.exists(app_file):
merge_hex(boot_file, app_file, f'output/{os.path.basename(boot_file)}')
7. 验证与测试方案
7.1 差分验证法
python复制# 合并后验证
merged = IntelHex('merged.hex')
original_boot = IntelHex('boot.hex')
original_app = IntelHex('app.hex')
# 检查Boot区域一致性
for addr in original_boot.addresses():
assert merged[addr] == original_boot[addr]
# 检查APP区域一致性
for addr in original_app.addresses():
assert merged[addr + APP_OFFSET] == original_app[addr]
7.2 烧录验证技巧
-
使用
st-info工具检查烧录结果：bash复制st-flash read firmware.bin 0x8000000 0x100000 cmp firmware.bin merged.bin -
通过CRC校验验证：
python复制import zlib crc32 = zlib.crc32(merged.tobinstr()) print(f"CRC32: {crc32:08X}")
8. 常见问题解决方案
Q1: 合并后文件异常变大
- 原因：存在大量
00填充记录 - 解决：添加
--minimize参数优化输出
Q2: IAP升级失败
- 检查点：
- APP的向量表偏移是否配置正确
- 中断向量地址是否重映射
- 堆栈指针初始化值是否合法
Q3: 如何保留调试信息
python复制# 保留所有原始记录
merged.write_hex_file(keep_empty=True)
9. 性能优化实战
处理100MB+的HEX文件时，内存消耗可能达到1GB。改进方案：
- 流式处理模式：
python复制def stream_merge(boot_path, app_path, output_path):
with open(output_path, 'w') as f_out:
# 先处理boot记录
for line in open(boot_path):
if not line.startswith(':04000005'): # 跳过APP入口地址
f_out.write(line)
# 处理APP记录并修正地址
app_offset = 0x20000
for line in open(app_path):
if line.startswith(':'):
rec = IntelHexRecord(line)
if rec.addrtyp == 0x04: # 扩展地址记录
new_addr = (rec.address << 16) + app_offset
rec = make_extended_record(new_addr)
f_out.write(str(rec))
- 多核并行处理：
python复制from multiprocessing import Pool
def process_chunk(args):
chunk, offset = args
return chunk.process(offset)
with Pool(4) as p:
results = p.map(process_chunk, [(chunk1,0), (chunk2, 0x20000)])
10. 工程化改进建议
- 版本控制集成：
python复制def get_git_version():
import subprocess
try:
tag = subprocess.check_output(['git', 'describe', '--tags']).decode().strip()
return tag
except:
return "unknown"
- ELF文件直读模式：
python复制from elftools.elf.elffile import ELFFile
def get_flash_ranges(elf_path):
with open(elf_path, 'rb') as f:
elf = ELFFile(f)
for seg in elf.iter_segments():
if seg['p_type'] == 'PT_LOAD':
yield (seg['p_vaddr'], seg['p_filesz'])
- 自动化测试框架：
python复制import unittest
class TestHexMerge(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.ref_hex = IntelHex()
cls.ref_hex[0x1000:0x1002] = [0xAA, 0xBB]
def test_merge_basic(self):
h1 = IntelHex()
h1[0x1000] = 0xAA
h2 = IntelHex()
h2[0x1001] = 0xBB
h1.merge(h2)
self.assertEqual(h1.tobinstr(), self.ref_hex.tobinstr())
这个脚本经过多个量产项目的验证，目前已经能够处理包括STM32、GD32、NRF52等多个系列芯片的HEX文件合并需求。最关键的是要确保地址空间配置正确，建议在第一次使用时先用小文件测试验证。