Repository files navigation

The published text of this book is athttps://docs.rust-embedded.org/discovery-mb2 for yourperusing pleasure.

Discover the world of microcontrollers throughRust! This book provides anintroduction to microcontrollers and how to use Rust withthem.

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

(There are currently twodeprecated older versions of thisbook.Oneversionis based on theSTM F3Discoverydevelopment board. Thesecondversionis slightly newer and is based on theBBC Micro:Bitv1and v2 circuit boards. Unless you are determined to workwith older and less-well-supported hardware, andcorresponding older and less-well-supported books, werecommend getting an MB2 and using this book instead. TheMB2 is available for about US$20 from many onlinesuppliers.)

Here's some ways to get started:

• Work throughthisbook withan MB2
• Start working on the examples from this repository
• You've got questions?
  • Have a look at ourdiscussions section onGitHub
  • Maybe it has already been answered
  • If not, start a new discussion
• You've found an issue?
  • Have a look at ourissues onGitHub
  • Maybe there is already a workaround
  • If not, please open a new one - or even better - apullrequest for solvingit
• You want to talk to a human being directly?
  • The general RustEmbedded Matrixchatis good for questions beyond the basics. Please berespectful of the bandwidth of folks there, though:it's a busy place

Have fun and enjoy!

This project is developed and maintained by theResources team.

The documentation is licensed under "Creative CommonsCC-BY-4.0" and the source code is licensed under licensee'schoice of the "Apache License" or the "MIT License".

See the book'sLicenses andAttributionsection for license details.

Unless you explicitly state otherwise, any contributionintentionally submitted for inclusion in the work by you, asdefined in the Apache-2.0 license, shall be licensed asabove, without any additional terms or conditions.

Contribution to this crate is organized under the terms oftheRust Code of Conduct, the maintainer of thiscrate, theResources team, promises to intervene touphold that code of conduct.

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

Note that these translations are of the older versionsreferenced above, and may not be monitored for accuracy orcurrency.

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