calliope-mini

Crates.iocalliope-mini
lib.rscalliope-mini
created_at2024-03-30 17:34:57.559857
updated_at2024-03-30 17:34:57.559857
downloads0
descriptionBoard support crate for the Calliope mini
homepagehttps://gitlab.com/alaarmann/calliope-mini
repositoryhttps://gitlab.com/alaarmann/calliope-mini
max_upload_size
id1191221

documentation

README

# calliope-mini _calliope-mini_ contains everything required getting started using Rust to create firmwares for the [Calliope mini](https://www.calliope.cc) 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](https://github.com/nrf-rs/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 - using the crate you _need_ to specify the version of the Calliope mini by activating the corresponding feature, e.g. `v1` ## Calliope mini version For determining the version of your board see the [product page](https://calliope.cc/en/calliope-mini/tech-facts). ## 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`](https://github.com/knurling-rs/flip-link#installation) and [`cargo-embed`](https://probe.rs/docs/tools/cargo-embed/#installation). ```bash > cargo install flip-link cargo-embed ``` #### Nix Start a Nix shell in the project's base directory ```bash > nix-shell ``` ### Run an example The first thing to try is one of the [examples](./examples) in this repository. Plug in your Calliope mini and run one of the commands below. _For Calliope mini V1_ ```bash > 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](LICENSE)
Commit count: 280

cargo fmt