ihexsrec - Python package for Intel Hex and Motorola SREC files
A lightweight Python library for reading, writing, and converting between Intel HEX and Motorola S-Record files. It also provides an in-memory representation of binary data (MemoryImage) that can be modified and exported in multiple formats.
Features
- Parse Intel HEX (.hex) and Motorola SREC (.srec) files
- Convert between HEX ↔ SREC
- Modify memory data in-place (insert, delete, overwrite)
- Export to binary (.bin) format
- Preserve and modify entry points (linear or segmented)
- No external dependencies, pure Python 3
- MIT licensed
Installation
pip install ihexsrec
Quick Example
from ihexsrec import IHEXSREC
# Load from an Intel HEX file
doc = IHEXSREC.load("firmware.hex")
# Modify bytes
doc.write(0x1000, b"\x01\x02\x03\x04")
# Convert to SREC and save
doc.save_as_srec("firmware.srec")
# Export a raw binary region
data = doc.to_bin(start=0x1000, end=0x2000)
with open("firmware.bin", "wb") as f:
f.write(data)
API Overview
Core Classes
- MemoryImage: Sparse in-memory representation of addressable bytes
- IntelHexCodec: Intel HEX parser and encoder
- SrecCodec: Motorola SREC parser and encoder
- IHEXSREC: High-level facade providing load/save/convert helpers
Common Methods (IHEXSREC)
| Method | Description |
|---|---|
load(path_or_lines) |
Load Intel HEX or Motorola SREC automatically and return an IHEXSREC instance. |
to_intel_hex(record_size=16) |
Convert the in-memory image to Intel HEX lines. |
to_srec(record_size=16, addr_width=None, header="ihexsrec") |
Convert the in-memory image to Motorola SREC lines. |
save_as_hex(path, record_size=16) |
Save the current image as an Intel HEX file. |
save_as_srec(path, record_size=16, addr_width=None, header="ihexsrec") |
Save the current image as a Motorola SREC file. |
to_bin(start=None, end=None, fill=0xFF) |
Export a raw binary slice of the image as bytes. |
save_as_bin(path, start=None, end=None, fill=0xFF) |
Save the current image (or a region) to a binary file. |
write(addr, data) |
Overwrite bytes starting at a specific address. |
insert(addr, data, shift_entry=False) |
Insert bytes and shift subsequent addresses upward. |
delete(addr, length, shift_entry=False) |
Delete a range of bytes and shift subsequent bytes downward. |
set_entry_linear(addr) |
Set or clear the linear entry point (e.g., 32-bit start address). |
set_entry_segmented(cs, ip) |
Set the segmented entry point (CS:IP pair). |
first_address() |
Return the lowest address present in memory, or None if empty. |
last_address() |
Return the highest address present in memory, or None if empty. |
occupied_ranges() |
Return a list of contiguous occupied address ranges as (start, end_inclusive) tuples. |
gap_ranges(within=None) |
Return a list of address gaps as (start, end_inclusive) tuples, optionally within a given window. |
fill_gaps(fill, within=None) |
Fill all detected gaps with a given one-byte value (e.g. 0xFF). |
move(to, start=None, until=None, overwrite=True, shift_entry=True) |
Move a window of bytes—or the entire image—to a new base address. |
convert(input_lines_or_path, to, **kwargs) |
Convert directly from HEX→SREC or SREC→HEX in one step. |
License
MIT License © 2025 Ioannis D. (devcoons)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ihexsrec-0.1.9.tar.gz
(23.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ihexsrec-0.1.9-py3-none-any.whl
(11.6 kB
view details)
File details
Details for the file ihexsrec-0.1.9.tar.gz.
File metadata
- Download URL: ihexsrec-0.1.9.tar.gz
- Upload date:
- Size: 23.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.24
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b674e2ef8c9eaf05c9acf7d6bae7fc3ab134b637835e0ea35142e30984720d8a
|
|
| MD5 |
75f3b391eafca1b35cca8257e7dd0eca
|
|
| BLAKE2b-256 |
c4afc35675cf044e4b7ca62421bda116ca3b0b29a60399221b5a0bf3b4e07cc5
|
File details
Details for the file ihexsrec-0.1.9-py3-none-any.whl.
File metadata
- Download URL: ihexsrec-0.1.9-py3-none-any.whl
- Upload date:
- Size: 11.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.24
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea7e6e2dde01e98dc49288d340cc9611de321d146d139419af4fe88bf3aec538
|
|
| MD5 |
9878bebab2e2d776fe3b14957cd788d3
|
|
| BLAKE2b-256 |
20de90440ea35c7b64e642211bb110874f05a2ed6aa9643405e82240372ed057
|
