micro:bit Universal Hex

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.

Demos

• Universal Hex Creator (source) creates a Universal Hex from two Intel Hex files (one for micro:bit V1 and another for micro:bit V2). It is also available on the micro:bit tech site.
• Universal Hex Splitter (source) splits a Universal Hex into its Intel Hex files.

Related documentation

• micro:bit Universal Hex Specification contains a lot more information about the file data format.

• GitHub contains general documentation for this library.

• The micro:bit Tech Site contains general technical information about the micro:bit.

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