micro::bit v2 Embedded Discovery Book

Danger Will Robinson! Danger!

You are looking at the sources for a pre-release of this book, not really ready for general use. For now, you probably want to go to https://docs.rust-embedded.org/discovery/microbit unless you are working on this version.

If want to continue, the published text of this book is at https://docs.rust-embedded.org/discovery-mb2 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.

License

The documentation is licensed under

• Creative Commons Attribution 4.0 License (LICENSE-CC-BY or https://creativecommons.org/licenses/by/4.0/legalcode)

And the source code is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

• MIT License (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

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, the maintainer of this crate, the Resources team, promises to intervene to uphold that code of conduct.

Translations

We are extremely grateful to those who have provided translations of this book: more are welcome.

Note that these translations are of the older versions referenced above, and may not be monitored for accuracy or currency.

• Japanese (repository)
• Chinese (repository)
• Portuguese (Brazilian) (repository)