microbit-universal-hex

micro:bit Universal Hex

microbit-universal-hex logo

Introduction

Create Universal Hex files for the micro:bit.

This is the documentation for the micro:bit Universal Hex library.

Here you will find the available public API to convert Intel Hex strings into Universal Hex strings and vice-versa.

Getting started

Read the Quick guide.

Universal Hex format

The micro:bit Universal Hex format is a superset of the Intel Hex file format designed to be able to include data for multiple targets into a single file. A Universal Hex file can contain the binary data for multiple micro:bit board versions. This allows the creation of a hex file that will work on micro:bit V1 and V2.

Detailed information of the Universal Hex format can be found in the specification.

This TypeScript/JavaScript library can be used to create a micro:bit Universal Hex from two or more micro:bit Intel Hex files.

Web tool

This Universal Hex Creator web tool can generate a Universal Hex from two Intel Hex files (one for micro:bit V1 and another for micro:bit V2).

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

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

License

This documentation, as well as the rest of the source files located in the https://github.com/microbit-foundation/microbit-universal-hex repository, is released under the MIT open source license.

SPDX-License-Identifier: MIT