The Rust on ESP Book 简体中文版

工具链安装

Rust 安装

确保你已经安装了 Rust。如果没有，请参阅 rustup 网站上的说明。

Warning

使用基于 Unix 的系统时，通过系统的包管理器（例如 brew、apt、dnf 等）安装 Rust 可能导致各种问题和兼容性冲突，因此最好使用 rustup。

使用 Windows 时，请确保你已安装下面列出的 ABI 之一。有关更多详细信息，请参阅 The rustup book 中的 Windows 章节。

• MSVC：推荐的 ABI，包含在 rustup 的默认依赖项列表中。使用此 ABI 可以与 Visual Studio 生成的软件实现互操作。

  如果不确定该选哪个，就使用它。

• GNU：GCC 工具链使用的 ABI。你可以自行安装它，以便与使用 MinGW/MSYS2 工具链构建的软件实现互操作。

另请参阅其他安装方案。

RISC-V 设备

要为基于 RISC-V 架构的乐鑫芯片构建 Rust 应用程序（如果不确定设备采用哪种架构，请参阅硬件概览），请执行以下步骤：

1. 安装适当的工具链以及 rust-src 组件：

   • 既可以使用 stable，也可以使用 nightly：

     rustup toolchain install stable --component rust-src
     

     或

     rustup toolchain install nightly --component rust-src
     

   Note

   rustfmt、clippy 和 rust-analyzer 等其他组件并非必需，但强烈推荐安装。

2. 安装目标：

   rustup target add riscv32imc-unknown-none-elf # For ESP32-C2 and ESP32-C3
   rustup target add riscv32imac-unknown-none-elf # For ESP32-C6 and ESP32-H2
   

   这些目标目前属于 Tier 2。注意 Rust 中不同的 riscv32 目标包含了不同的 RISC-V 扩展。

如果你_不打算_使用 ESP32、ESP32-S2 或 ESP32-S3，工具链安装就已经完成，可以跳到工具安装章节。

Xtensa 设备

如硬件概览所述，ESP32、ESP32-S2 和 ESP32-S3 采用 Xtensa 架构。如果要为这些芯片开发，目前需要使用 Rust 编译器的分支版本。

espup 是一款工具，用于简化为这些目标开发 Rust 应用程序所需的工具链安装和维护过程。

1. 安装 espup：

   cargo install espup --locked
   

   也可以直接下载预编译好的发行二进制文件，或使用 cargo-binstall。
2. 运行以下命令，为所有受支持的乐鑫目标安装全部必需的工具链：

   espup install
   

3. 在 Unix 系统上配置环境变量：请参阅 espup README 中介绍的不同方法。Windows 用户无需进行其他操作。

espup 安装了什么

为了启用对乐鑫目标的支持，espup 安装了以下工具：

• 乐鑫 Rust 分支，支持乐鑫目标。
• stable 工具链，支持 RISC-V 目标。
• LLVM 分支，支持 Xtensa 目标。
• GCC 工具链，用于链接最终的二进制文件。

分支编译器能与标准 Rust 编译器共存，允许在一个系统上同时安装两者。可以使用任意一种 override 方法来调用分支编译器。