引言

欢迎阅读The Embedded Rust Book:一本介绍如何在裸机(比如，微处理器)上使用Rust编程语言的书籍。

Embedded Rust 是为谁准备的

Embedded Rust是为了那些即想要进行嵌入式编程，又想要使用Rust语言所提供的高级语言概念和安全保障的人们而准备的(也可以看 Who Rust Is For)

范围

这本书的目的是：

  • 让开发者快速上手Rust嵌入式开发，比如，如何设置一个开发环境。
  • 分享那些关于使用Rust进行嵌入式开发的，现存的，最好的实践经验，比如，如何最大程度上地利用好Rust语言的特性去写更正确的嵌入式软件
  • 某种程度下作为工具书，比如，如何在一个项目里将C和Rust混合在一起使用

虽然尽可能地尝试让这本书可以用于大多数场景，但是为了使读者和作者更容易理解，在所有的示例中这本书都使用了ARM Cortex-M架构。然而，这本书并不需要读者熟悉这个架构，书中会在需要时对这个架构的特定细节进行解释。

这本书是为谁准备的

这本书适合那些有一些嵌入式背景或者有Rust背景的人，然而我相信每一个对Rust嵌入式编程好奇的人都能从这本书中得到某些收获。对于那些先前没有任何经验的人，我们建议你读一下“要求和预备知识”部分。从其它资料中获取、补充缺失的知识，这样能提高你的阅读体验。你可以看看“其它资源”部分，以找到你感兴趣的那些主题的资源。

要求和预备知识

  • 你可以轻松地使用Rust编程语言，且在一个桌面环境上写过，运行过，调试过Rust应用。你也应该要熟悉2018 edition的术语，因为这本书是面向Rust 2018的。

  • 你可以轻松地使用其它语言，比如C，C++或者Ada，开发和调试嵌入式系统，且熟悉如下的概念：

  • 交叉编译

  • 存储映射的外设（Memory Mapped Peripherals）
  • 中断
  • I2C，SPI，串口等等常见接口

其它资源

如果你不熟悉上面提到的东西或者你对这本书中提到的某个特定主题感兴趣，你也许能从这些资源中找到有用的信息。

Topic Resource Description
Rust Rust Book 如果你还不能轻松地使用Rust，我们强烈地建议读这本书。
Rust, Embedded Discovery Book 如果你从来没有做过嵌入式编程，这本书可能是个更好的开始。
Rust, Embedded Embedded Rust Bookshelf 这里你能找到许多Rust’s Embedded Working Group提供的额外资源。
Rust, Embedded Embedonomicon 在Rust中进行嵌入式编程的细节。
Rust, Embedded embedded FAQ 关于嵌入式环境下的Rust会遇到的常见问题。
Interrupts Interrupt -
Memory-mapped IO/Peripherals Memory-mapped I/O -
SPI, UART, RS232, USB, I2C, TTL Stack Exchange about SPI, UART, and other interfaces -

翻译

这本书是已经被一些慷慨的志愿者们翻译了。如果你想要将你的翻译列在这里，请打开一个PR去添加它。

如何使用这本书

这本书通常假设你是前后阅读的。之后的章节是建立在先前的章节中提到的概念之上的，先前章节可能不会深入一个主题的细节，因为在随后的章节将会再次重温这个主题。 在大多数示例中这本书将使用STM32F3DISCOVERY开发板。这个板子是基于ARM Cortex-M架构的，且基本功能与大多数基于这个架构的CPUs功能相似。微处理器的外设和其它实现细节在不同的厂家之间是不同的，甚至来自同一个厂家，不同处理器系列之间也是不同的。 因此我们建议购买STM32F3DISCOVERY开发板来尝试这本书中的例子。

贡献

这本书的工作主要在这个仓库里管理，且主要由resouces team开发。

如果你按着这本书的操作遇到了什么麻烦，或者这本书的一些部分不够清楚，或者很难进行下去，那这本书就是有个bug，这个bug应该被报道给这本书的the issue tracker 。

修改拼写错误和添加新内容的Pull requests非常欢迎！

二次使用这个材料

这本书根据以下许可证发布:

总之：如果你想在你的工作中使用我们的文档或者图片，你需要：

  • 提供合适的授信 (i.e. 在你的幻灯片中提到本书，提供相关页面的连接)
  • 提供CC-BY-SA v4.0的许可证的链接
  • 指出你是否改变了材料的内容，在同一个许可证下，可以对材料进行任何改变

也请告诉我这本书对你是否有帮助！