Skip to content

rust-embedded/discovery-mb2

micro::bit v2 Embedded Discovery Book

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?
  • 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

And the source code is licensed under either of

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.

About

Rust Discovery Book for BBC micro::bit v2

Resources

License

Apache-2.0 and 2 other licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
CC-BY-4.0
LICENSE-CC-BY
MIT
LICENSE-MIT

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages