# [Work in Progress] - The Embedded Rust Book

> Documentation on how to use the Rust Programming Language to develop firmware for bare metal (microcontroller) devices

See [this issue] for more details. This is a very early work in progress.

[this issue]: https://github.com/rust-lang-nursery/embedded-wg/issues/56

## Online Copies of this Book

At the moment, there are no official locations where this book is hosted. Instead, see below for instructions to render and use the book locally.

## Using

```
cargo install mdbook
cd books/embedded-rust-book
mdbook serve

# open a web browser, go to http://localhost:3000
```

## License

The Embedded Rust Book (this project) is distributed under the following licenses:

* The code samples and free-standing Cargo projects contained within this book are licensed under the terms of both the [MIT License] and the [Apache License v2.0].
* The written prose contained within this book is licensed under the terms of the Creative Commons [CC-BY-SA v4.0] license.

Copies of the licenses used by this project may also be found here:

* [MIT License Hosted]
* [Apache License v2.0 Hosted]
* [CC-BY-SA v4.0 Hosted]

[MIT License]: ./LICENSE-MIT
[Apache License v2.0]: ./LICENSE-APACHE
[CC-BY-SA v4.0]: ./LICENSE-CC-BY-SA
[MIT License Hosted]: https://opensource.org/licenses/MIT
[Apache License v2.0 Hosted]: http://www.apache.org/licenses/LICENSE-2.0
[CC-BY-SA v4.0 Hosted]: https://creativecommons.org/licenses/by-sa/4.0/legalcode

### 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.