开发环境搭建

概述

使用 Rust SDK 编译和烧录只需要 Rust 工具链。链接使用 Rust 自带的 rust-lld,固件打包与串口烧录由 SDK 中的 ameba-flash crate 实现。

工具

来源

用途

Rust 工具链

Rust 官方

编译 Rust 代码、链接 ELF 固件

ameba-flash (可选)

Rust SDK

命令行 cargo runner,将 ELF 打包为 app.bin、通过串口烧录并打开串口监视。仅在示例目录或 ameba-generate 生成的项目中使用 cargo run 时需要;cargo xtask 以库的形式调用同一份代码,无需单独安装

安装 Rust 工具链

Linux / WSL:
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none --profile minimal
$ source ~/.cargo/env

source ~/.cargo/env 只对当前 shell 生效。之后新打开的 shell 中如果提示 cargo 找不到命令,请重新执行该命令,或将 ~/.cargo/bin 加入 PATH。

备注

中国大陆用户可设置以下链接后再安装:

$ export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
$ export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup

安装 stable 工具链

rust-toolchain.toml 在仓库根目录中定义了所需的 stable 版本及交叉编译 target,进入仓库目录后首次运行 rustc 时 rustup 会自动完成安装。

进入 Rust SDK 根目录执行:

Linux / WSL:
$ cd <workdir>/rust
$ rustc --version

首次执行会自动下载安装(约需数分钟)。

安装 ameba-flash(可选)

在 Rust SDK 目录下执行一次即可安装 ameba-flash,它烧录所用的 Bootloader、Wi-Fi 核固件和 Flash Loader 均已内嵌在可执行文件中:

$ cd <workdir>/rust
$ cargo install --path ameba-flash --locked

请确认 ~/.cargo/bin (Windows 上为 %USERPROFILE%\.cargo\bin )已加入 PATH。

备注

在 Rust SDK 目录内执行 cargo install 时,受 rust-toolchain.toml 影响,可能会打印 warning: default toolchain implicitly overridden with ...。安装仍会成功;如需消除该警告,可改用 cargo +stable install --path ameba-flash --locked。重复安装会覆盖已安装的 ameba-flash。

验证安装

Linux / WSL:
$ rustup show active-toolchain
stable-x86_64-unknown-linux-gnu (overridden by '.../rust/rust-toolchain.toml')

$ rustup target list --installed | grep thumbv8m.main-none-eabi
thumbv8m.main-none-eabi
thumbv8m.main-none-eabihf