Skip to content

alaarmann/calliope-mini

 
 

Repository files navigation

calliope-mini

calliope-mini contains everything required getting started using Rust to create firmwares for the Calliope mini microcontroller board. This little board has a lot built-in, even a capable debugging interface.

Important notes

  • this project is currently under active development, APIs are expected to change.
  • it is a fork of microbit, a Board Support Package (BSB) for the BBC micro:bit
  • currently supported is Calliope mini V1 exclusively, support for V2 and V3 is planned

Getting started

All you need to start programming this device is:

  • A Calliope mini board
  • A computer: Linux is tested
  • A bit of open source software

Install dependencies

On Linux you have the options to use cargo install or nix-shell.

Cargo install

In order to run the examples you need to install flip-link and cargo-embed.

> cargo install flip-link cargo-embed

Nix

Start a Nix shell in the project's base directory

> nix-shell

Run an example

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

For Calliope mini V1

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

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 Calliope mini!

License

MIT

About

A Rust crate for Calliope mini development

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 98.5%
  • Other 1.5%