README

intelhexjs

Intel hex file parser and generator. with a few more perks.. for more info on Intel file format visit: Intel HEX - Wikipedia or INTEL HEX FILE FORMAT

Installation

$ npm i intelhexjs

Features

Load and parse an Intel HEX file to memory chunks
Generate an Intel HEX file from memory chunks
You can even merge or manipulate HEX files by managing those memory chunks (I was too lazy to add that to my code 🙄)
TypeScript defs included (well I tried)
Asynchronous using ES6 Promises

Examples

Loading an Intel HEX File

and spill its guts onto console

const ihex = require('intelhexjs')

ihex.loadIntelHexFile('test1.hex').then(memory => {
    console.log('Chunks: ', memory.sections.length)
    if (memory.startLinearAddress)
        console.log('Start Linear Address: ', memory.startLinearAddress.toString(16))
    if (memory.startSegmentAddress)
        console.log('Start Segment Address: ', memory.startSegmentAddress.toString(16))
    if (memory.sections.length > 0) {
        memory.sections.forEach((sec, i) => {
            console.log('Section #', i, 'Address:', sec.startAddress.toString(16), 'data:', Buffer.from(sec.data))
        })
    }
}).catch(err => {
    console.log('Failed', err)
})

Saving chunks of bytes as Intel HEX File

I won't ask where you are getting those bytes from

const ihex = require('intelhexjs')
const fs = require('fs/promises')

let data1, data2
fs.readFile('part1.bin').then((data) => {
    data1 = data
    return fs.readFile('part2.bin')
}).then((data) => {
    data2 = data
    let mem = new ihex.Memory([
        new ihex.MemorySection(0x08000000, [...data1]),
        new ihex.MemorySection(0x08060000, [...data2]),
    ])
    mem.startLinearAddress = 0x08008879
    return ihex.generateIntelHexFile('test.hex', mem, {
        architecture: 'b32',
        bytesInOneLine: 32,
    })
}).then(() => {
    console.log('Hex file saved.')
}).catch(err => {
    console.log('Failed', err)
})

Documentation

hope baby, hope ...

ToDo

Merge multiple Hex file
Support loading and saving binary files

Usage no npm install needed!