Quick Guide

npm package

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

npm install @microbit/microbit-universal-hex
Copy

Usage

To create a Universal Hex from two Intel Hex strings, use createUniversalHex.

See the Universal Hex Creator demo (source).

import {
  createUniversalHex,
  microbitBoardId,
} from '@microbit/microbit-universal-hex';

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

To separate a Universal Hex into its Intel Hex strings, use separateUniversalHex.

See the Universal Hex Splitter demo (source).

import {
  isUniversalHex,
  separateUniversalHex,
} from '@microbit/microbit-universal-hex';

if (isUniversalHex(intelHexStr)) {
  for (const { boardId, hex } of separateUniversalHex(intelHexStr)) {
    console.log(boardId);
    console.log(hex);
  }
}
Copy