开发环境搭建
概述
使用 Rust SDK 编译和烧录只需要 Rust 工具链。链接使用 Rust 自带的 rust-lld,固件打包与串口烧录由 SDK 中的
ameba-flash crate 实现。
工具 |
来源 |
用途 |
|---|---|---|
Rust 工具链 |
Rust 官方 |
编译 Rust 代码、链接 ELF 固件 |
|
Rust SDK |
命令行 cargo runner,将 ELF 打包为 |
安装 Rust 工具链
$ 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
安装 MSYS2:
winget install MSYS2.MSYS2
打开开始菜单中的 MSYS2 MSYS,执行:
$ pacman -Syu
$ pacman -S --needed mingw-w64-x86_64-gcc
如果未设置环境变量,需要打开系统属性 → 高级 → 环境变量,在用户 Path 中新增 C:\msys64\mingw64\bin。
安装 rustup,在 PowerShell 中执行:
Invoke-WebRequest https://win.rustup.rs/x86_64 -OutFile "$env:TEMP\rustup-init.exe"
& "$env:TEMP\rustup-init.exe" -y --default-host x86_64-pc-windows-gnu --default-toolchain none --profile minimal
安装完成后重开一个新的 PowerShell 窗口。
备注
中国大陆用户可设置以下链接后再安装:
$env:RUSTUP_DIST_SERVER = "https://mirrors.tuna.tsinghua.edu.cn/rustup"
$env:RUSTUP_UPDATE_ROOT = "https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup"
Windows 上也可将上述两项加入系统环境变量,永久生效。
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain none --profile minimal
$ source ~/.cargo/env
备注
中国大陆用户可设置以下链接后再安装:
$ 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 根目录执行:
$ cd <workdir>/rust
$ rustc --version
cd <workdir>/rust
rustc --version
$ 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。
验证安装
$ 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
> rustup show active-toolchain
stable-x86_64-pc-windows-gnu (overridden by '.../rust/rust-toolchain.toml')
> rustup target list --installed | findstr thumbv8m
thumbv8m.main-none-eabi
thumbv8m.main-none-eabihf
> where.exe x86_64-w64-mingw32-gcc
C:\msys64\mingw64\bin\x86_64-w64-mingw32-gcc.exe
$ rustup show active-toolchain
stable-aarch64-apple-darwin (overridden by '.../rust/rust-toolchain.toml')
$ rustup target list --installed | grep thumbv8m.main-none-eabi
thumbv8m.main-none-eabi
thumbv8m.main-none-eabihf