microbit-universal-hex

Quick Guide

npm package

You can integrate this library in your project using the npm package:

npm install @microbit/microbit-universal-hex

Usage

To create a Universal Hex from two Intel Hex strings, use {@link createUniversalHex}.

Implementation for Universal Hex Creator demo can be found in webtool.html file.

import * as microbitUh from '@microbit/microbit-universal-hex';

const universalHex = microbitUh.createUniversalHex([
  {
    hex: intelHexStringV1,
    boardId: microbitUh.microbitBoardId.V1,
  },
  {
    hex: intelHexStringV2,
    boardId: microbitUh.microbitBoardId.V2,
  },
]);

To separate a Universal Hex into its Intel Hex strings, use {@link separateUniversalHex}.

Implementation example for Universal Hex Separator demo can be found in the seperate.html file.

import * as microbitUh from '@microbit/microbit-universal-hex';

if (microbitUh.isUniversalHex(intelHexStr)) {
  const separatedBinaries = microbitUh.separateUniversalHex(intelHexStr);
  separatedBinaries.forEach(function (hexObj) {
    console.log(hexObj.boardId);
    console.log(hexObj.hex);
  });
}

See Universal Hex Splitter demo for example.