docs.rs failed to build microbit-common-0.15.1
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

microbit

microbit contains everything required getting started using Rust to create firmwares for the fabulous BBC micro:bit microcontroller board. This little board has everything and a kitchen sink built-in, even a capable debugging interface.

Getting started

All you need to start programming this device is:

A BBC micro:bit board
A computer (macOS and Linux work perfectly, Windows tested as well)
A bit of open source software

Know your version

The micro:bit comes in different versions. There is a separate crate for each major board version. See the table below to identify which crate you need to use.

Crate	Board version	Board image	Docs	crates.io	target
`microbit`	V1				`thumbv6m-none-eabi`
`microbit-v2`	V2				`thumbv7em-none-eabihf`

Install dependencies

The examples make use of some of the fantastic tooling from the knurling and probe-rs projects. In order to run the examples you need to install probe-rs and flip-link.

> cargo install probe-rs-tools flip-link

Run an example

The first thing to try is one of the examples in this repository. Plug in your micro:bit and run one of the commands below.

For micro:bit V1

> cargo run --release --manifest-path ./examples/display-blocking/Cargo.toml --features v1 --target thumbv6m-none-eabi

For micro:bit V2

> cargo run --release --manifest-path ./examples/display-blocking/Cargo.toml --features v2 --target thumbv7em-none-eabihf

You should see a lot of build output, the orange LED on the back of the micro:bit should flash quickly, and a message should appear on the LED display.

Congratulations! You've flashed your first Rust program onto your micro:bit!

License

0-clause BSD license.