Hsu.Formats.Converters.Firmware 2026.7.13

Hsu.Formats.Converters.Firmware

Firmware format converters for the Hsu.Formats library.

Supported Conversions

Features

• AOT-compatible (IsAotCompatible=true on net8.0+)
• All converters implement IFormatConverter<TSource, TTarget>
• Preserves Intel HEX start-linear-address metadata where the target format can represent it
• Preserves S-record/MOT address-width intent where the target family supports it
• Keeps segment boundaries intact instead of collapsing adjacent regions during conversion
• Covers common firmware normalization paths between text, binary, and executable-image inputs

Quick Start

Convert S19 to Intel HEX

using Hsu.Formats.S19;
using Hsu.Formats.Hex;
using Hsu.Formats.Converters.Firmware;

var s19 = (S19Model)new S19Parser().Parse(File.OpenRead("firmware.s19"));
HexModel hex = new S19ToHexConverter().Convert(s19);

using var writer = new StreamWriter("firmware.hex");
new HexWriter().Write(hex, writer);

Convert HEX to raw binary

using Hsu.Formats.Hex;
using Hsu.Formats.Bin;
using Hsu.Formats.Converters.Firmware;

var hex = (HexModel)new HexParser().Parse(File.OpenRead("firmware.hex"));
BinModel bin = new HexToBinConverter().Convert(hex);

using var stream = File.Create("firmware.bin");
new BinWriter(fillByte: 0xFF).Write(bin, stream);

Convert ELF to S19

using Hsu.Formats.Elf;
using Hsu.Formats.S19;
using Hsu.Formats.Converters.Firmware;

var elf = (ElfModel)new ElfParser().Parse(File.OpenRead("firmware.elf"));
S19Model s19 = new ElfToS19Converter().Convert(elf);

using var writer = new StreamWriter("firmware.s19");
new S19Writer(s19.AddressBytes ?? s19.InferAddressBytes()).Write(s19, writer);

Convert HEX to MOT preserving address-width metadata

using Hsu.Formats.Hex;
using Hsu.Formats.Mot;
using Hsu.Formats.Converters.Firmware;

var hex = (HexModel)new HexParser().Parse(File.OpenRead("firmware.hex"));
MotModel mot = new HexToMotConverter().Convert(hex);

using var writer = new StreamWriter("firmware.mot");
new MotWriter(mot.AddressBytes ?? mot.InferAddressBytes()).Write(mot, writer);

Notes

• Conversion behavior is model-oriented: converters operate on parsed memory-image models, not directly on file text.
• Some metadata is target-family specific; when a destination format lacks a direct representation, only the model fields supported by that format are carried through.
• For application-level export profile and validation guidance, see the project repository documentation.