`micro::bit v2 Embedded Discovery Book`

The published text of this book is at for your perusing pleasure.

Discover the world of microcontrollers through Rust! This book provides an introduction to microcontrollers and how to use Rust with them.

Book Versions

This book is the current and best-maintained version of the Rust Embedded Discovery Book. It is intended to be used with the BBC Micro:Bit v2 (MB2) development circuit board.

(There are currently two deprecated older versions of this book. One version is based on the STM F3 Discovery development board. The second version is slightly newer and is based on the BBC Micro:Bit v1 and v2 circuit boards. Unless you are determined to work with older and less-well-supported hardware, and corresponding older and less-well-supported books, we recommend getting an MB2 and using this book instead. The MB2 is available for about US$20 from many online suppliers.)

What Do You Want To Do?

Here's some ways to get started:

Work through this

book with an MB2

Start working on the examples from this repository
You've got questions?

- Have a look at our discussions section on GitHub - Maybe it has already been answered - If not, start a new discussion

You've found an issue?

- Have a look at our issues on GitHub - Maybe there is already a workaround - If not, please open a new one - or even better - a pull request for solving it

You want to talk to a human being directly?

- The general Rust Embedded Matrix chat is good for questions beyond the basics. Please be respectful of the bandwidth of folks there, though: it's a busy place

Have fun and enjoy!

This project is developed and maintained by the [Resources team][team].

Licenses and Attribution

The documentation is licensed under "Creative Commons CC-BY-4.0" and the source code is licensed under licensee's choice of the "Apache License" or the "MIT License".

See the book's Licenses and Attribution section for license details.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.

Code of Conduct

Contribution to this crate is organized under the terms of the [Rust Code of Conduct][CoC], the maintainer of this crate, the [Resources team][team], promises to intervene to uphold that code of conduct.

[CoC]: CODEOFCONDUCT.md [team]: https://github.com/rust-embedded/wg#the-resources-team