简介
欢迎来到嵌入式 Rust 手册：一本关于在“裸机”嵌入式系统（如微控制器）上使用 Rust 编程语言的入门书籍。
谁适合使用嵌入式 Rust
嵌入式 Rust 适合所有希望进行嵌入式编程并利用 Rust 语言提供的更高级别概念和安全保证的人。（另请参阅 谁适合使用 Rust）
范围
本书的目标是
-
让开发人员快速了解嵌入式 Rust 开发。例如，如何设置开发环境。
-
分享当前关于使用 Rust 进行嵌入式开发的最佳实践。例如，如何最好地利用 Rust 语言特性来编写更正确的嵌入式软件。
-
在某些情况下充当食谱。例如，如何在单个项目中混合 C 和 Rust？
本书试图尽可能通用，但为了方便读者和作者，它在所有示例中都使用 ARM Cortex-M 架构。但是，本书并不假设读者熟悉这种特定架构，并在需要时解释特定于该架构的细节。
本书适合谁
本书面向具有一定嵌入式背景或 Rust 背景的人，但我们相信所有对嵌入式 Rust 编程感兴趣的人都能从本书中获得一些东西。对于没有任何先验知识的人，我们建议您阅读“假设和先决条件”部分，并弥补缺少的知识，以便从本书中获得更多收益并改善您的阅读体验。您可以查看“其他资源”部分，查找您可能想了解的主题的资源。
假设和先决条件
- 您熟悉使用 Rust 编程语言，并且已经在桌面环境中编写、运行和调试过 Rust 应用程序。您还应该熟悉 2018 版 的习惯用法，因为本书针对 Rust 2018。
- 您熟悉使用其他语言（如 C、C++ 或 Ada）开发和调试嵌入式系统，并且熟悉以下概念
- 交叉编译
- 内存映射外设
- 中断
- 常见的接口，如 I2C、SPI、串行等。
其他资源
如果您不熟悉上面提到的任何内容，或者如果您想了解更多有关本书中提到的特定主题的信息，您可能会发现以下一些资源很有用。
| 主题 | 资源 | 描述 |
|---|---|---|
| Rust | Rust 手册 | 如果您还不熟悉 Rust，我们强烈建议您阅读本书。 |
| Rust，嵌入式 | 发现书籍 | 如果您从未进行过任何嵌入式编程，这本书可能是更好的起点 |
| Rust，嵌入式 | 嵌入式 Rust 书架 | 在这里，您可以找到 Rust 嵌入式工作组提供的其他资源。 |
| Rust，嵌入式 | Embedonomicon | 使用 Rust 进行嵌入式编程时的细枝末节。 |
| Rust，嵌入式 | 嵌入式常见问题解答 | 关于 Rust 在嵌入式环境中的常见问题解答。 |
| Rust，嵌入式 | 全面 Rust 🦀：裸机 | 关于裸机 Rust 开发的一日课程的教学材料 |
| 中断 | 中断 | - |
| 内存映射 IO/外设 | 内存映射 I/O | - |
| SPI、UART、RS232、USB、I2C、TTL | 关于 SPI、UART 和其他接口的 Stack Exchange | - |
翻译
本书已由热心的志愿者翻译。如果您想将您的翻译列在这里，请打开一个 PR 来添加它。
如何使用本书
本书通常假设您从头到尾阅读。后面的章节建立在前面章节的概念基础上，前面的章节可能不会深入探讨某个主题，而是在后面的章节中重新讨论该主题。
本书将使用来自意法半导体的 STM32F3DISCOVERY 开发板作为本书中大多数示例的参考。该板基于 ARM Cortex-M 架构，虽然基本功能在大多数基于该架构的 CPU 中是相同的，但微控制器的外设和其他实现细节在不同的供应商之间是不同的，甚至在同一供应商的不同微控制器系列之间也是不同的。
因此，我们建议您购买 STM32F3DISCOVERY 开发板，以便按照本书中的示例进行操作。
为本书贡献力量
本书的工作在 这个仓库 中进行协调，主要由 资源团队 开发。
如果您在按照本书中的说明操作时遇到问题，或者发现本书的某些部分不够清晰或难以理解，那么这是一个错误，应该在 本书的错误跟踪器 中报告。
修复错别字和添加新内容的拉取请求非常受欢迎！
重复使用此材料
本书在以下许可下分发
- 本书中包含的代码示例和独立的 Cargo 项目在 MIT 许可 和 Apache 许可 v2.0 的条款下获得许可。
- 本书中包含的文字、图片和图表在 Creative Commons CC-BY-SA v4.0 许可的条款下获得许可。
简而言之：如果您想在您的作品中使用我们的文本或图像，您需要
- 给予适当的署名（即在您的幻灯片上提及本书，并提供指向相关页面的链接）
- 提供指向 CC-BY-SA v4.0 许可的链接
- 说明您是否对材料进行了任何更改，并将对我们材料的任何更改以相同的许可提供
此外，如果您发现本书有用，请告诉我们！