Rust嵌入式开发工具链：Embassy框架环境配置全攻略

【免费下载链接】embassy Modern embedded framework, using Rust and async. 项目地址: https://gitcode.com/gh_mirrors/em/embassy

你还在为嵌入式开发环境配置繁琐而头疼吗？硬件兼容性、工具链版本、编译参数总是让你抓狂？本文将带你一站式搞定Embassy框架的环境搭建，从工具链安装到示例运行，全程无坑指南让你30分钟上手Rust嵌入式开发！读完你将获得：

• 掌握跨平台工具链安装技巧
• 学会配置多厂商硬件支持
• 快速运行第一个异步嵌入式程序
• 规避90%的常见配置错误

工具链安装：从0到1搭建开发环境

现在嵌入式开发不再需要手动管理复杂的工具链版本，Rust的rustup工具能帮我们一键搞定。先看看Embassy对工具链的具体要求，打开rust-toolchain.toml可以发现，项目需要Rust 1.90+ 和特定的目标架构支持。

安装Rust工具链

# 安装rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 安装项目指定版本
rustup toolchain install 1.90
rustup default 1.90

# 安装目标架构
rustup target add $(cat rust-toolchain.toml | grep target | awk -F ' = ' '{print $2}')

注意：国内用户可使用USTC镜像加速rustup:

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

平台配置深度解析

不同硬件平台需要对应的编译目标和配置，以nRF52840为例，其配置文件(examples/nrf52840/.cargo/config.toml)揭示了三个关键设置：

1. 目标架构：根据芯片型号选择，如nRF52840使用thumbv7em-none-eabi
2. 调试配置：通过DEFMT_LOG控制日志级别
3. 烧录工具：使用probe-rs作为调试和下载工具

其他平台配置示例：

• STM32系列：thumbv7em-none-eabihf（带硬件浮点）
• RP2040：thumbv6m-none-eabi

项目初始化与依赖管理

创建 Embassy 项目

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/em/embassy.git
cd embassy

# 创建工作目录
mkdir my-embassy-project && cd my-embassy-project

# 初始化Cargo项目
cargo init

配置文件详解

创建.cargo/config.toml文件，参考nRF52840配置设置：

[target.'cfg(all(target_arch = "arm", target_os = "none"))']
runner = "probe-rs run --chip nRF52840_xxAA"  # 根据芯片型号修改

[build]
target = "thumbv7em-none-eabi"  # 匹配rust-toolchain.toml中的设置

[env]
DEFMT_LOG = "info"  # 日志级别：error/warn/info/debug/trace

添加依赖

在Cargo.toml中添加核心依赖：

[dependencies]
embassy-executor = { version = "0.1.0", path = "../embassy-executor" }
embassy-time = { version = "0.1.0", path = "../embassy-time" }
embassy-nrf = { version = "0.1.0", path = "../embassy-nrf", features = ["nrf52840", "time-driver-rtc1"] }
defmt = "0.3"
defmt-rtt = "0.4"

实战：编译与运行第一个示例

以nRF52840开发板为例，完整流程如下：

硬件准备

• nRF52840 DK开发板
• USB数据线连接电脑
• 安装J-Link驱动或probe-rs支持

编译与烧录

# 进入示例目录
cd examples/nrf52840

# 编译项目
cargo build

# 烧录并运行
cargo run --bin blinky

常见问题：若提示"probe-rs: command not found"，执行cargo install probe-rs-cli安装工具

调试输出

配置文件中启用的DEFMT_LOG会通过SWD接口输出日志，使用defmt-viewer查看：

# 安装查看工具
cargo install defmt-viewer

# 实时查看日志
defmt-logger

多平台适配指南

硬件平台	目标架构	配置示例
nRF52840	thumbv7em-none-eabi	nrf52840配置
STM32F4	thumbv7em-none-eabihf	stm32配置
RP2040	thumbv6m-none-eabi	rp配置

常见问题解决

编译错误：目标架构不支持

error: target 'thumbv7em-none-eabi' not found

解决：安装对应目标架构

rustup target add thumbv7em-none-eabi

调试器无法连接

1. 检查probe-rs版本：probe-rs --version
2. 验证芯片型号：probe-rs chip list | grep nRF52840
3. 权限问题（Linux）：

sudo udevadm control --reload-rules && sudo udevadm trigger

进阶资源

• 官方文档：docs/index.adoc
• 示例代码：examples/目录包含各平台演示
• API参考：通过cargo doc --open生成本地文档
• 调试指南：embassy-usb-logger组件使用

总结与后续学习路径

通过本文配置，你已掌握：

1. Rust嵌入式工具链的安装与管理
2. Embassy项目的核心配置文件设置
3. 跨平台编译与调试环境搭建
4. 基础示例的编译与烧录流程

下一步推荐学习：

• 异步任务管理：embassy-executor
• 外设驱动使用：embassy-nrf/src/gpio.rs
• 低功耗优化：embassy-time定时器使用

希望本文能帮你顺利踏上Rust嵌入式开发之旅！如有问题，欢迎在项目issues中交流。

提示：定期同步官方仓库获取最新更新：

git pull origin main
cargo update
```<|FCResponseEnd|>

# Rust嵌入式开发工具链：Embassy框架环境配置全攻略

你还在为嵌入式开发环境配置繁琐而头疼吗？硬件兼容性、工具链版本、编译参数总是让你抓狂？本文将带你一站式搞定Embassy框架的环境搭建，从工具链安装到示例运行，全程无坑指南让你30分钟上手Rust嵌入式开发！读完你将获得：

• 掌握跨平台工具链安装技巧
• 学会配置多厂商硬件支持
• 快速运行第一个异步嵌入式程序
• 规避90%的常见配置错误

工具链安装：从0到1搭建开发环境

安装Rust工具链

Embassy框架对Rust版本有明确要求，通过项目根目录的rust-toolchain.toml可以看到需要Rust 1.90+ 和特定的目标架构支持。以下是完整的安装步骤：

# 安装rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 安装项目指定版本
rustup toolchain install 1.90
rustup default 1.90

# 安装目标架构
rustup target add thumbv7em-none-eabi

国内用户可使用镜像加速：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

平台支持矩阵

Embassy支持多种嵌入式架构，在rust-toolchain.toml中定义了支持的目标平台，常见硬件对应的目标架构如下：

硬件平台	目标架构	代表芯片
Cortex-M0	thumbv6m-none-eabi	STM32L0xx, nRF51
Cortex-M4	thumbv7em-none-eabi	STM32F4xx, nRF52840
Cortex-M7	thumbv7em-none-eabihf	STM32H7xx
RISC-V	riscv32imac-unknown-none-elf	ESP32-C3

项目配置深度解析

核心配置文件

每个Embassy项目都需要两个关键配置文件：

1. rust-toolchain.toml：定义工具链版本和目标架构
2. .cargo/config.toml：指定编译目标和调试设置

以nRF52840配置为例，关键设置包括：

[target.'cfg(all(target_arch = "arm", target_os = "none"))']
runner = "probe-rs run --chip nRF52840_xxAA"  # 调试器配置
target = "thumbv7em-none-eabi"                # 编译目标
DEFMT_LOG = "trace"                           # 日志级别

调试环境配置

Embassy使用defmt进行高效日志输出，在.cargo/config.toml中设置日志级别：

[env]
DEFMT_LOG = "info"  # 可选: error/warn/info/debug/trace

实战：编译与运行第一个示例

准备工作

• 安装调试工具：cargo install probe-rs-cli defmt-viewer
• 连接开发板（以nRF52840 DK为例）

编译与烧录

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/em/embassy.git
cd embassy/examples/nrf52840

# 编译项目
cargo build

# 烧录并运行
cargo run --bin blinky

观察输出

打开新终端窗口查看日志：

defmt-logger  # 实时显示设备日志

多平台适配指南

不同硬件平台需要调整配置，以下是常见平台的设置要点：

STM32平台

修改.cargo/config.toml：

[build]
target = "thumbv7em-none-eabihf"  # 带硬件浮点

[target.'cfg(all(target_arch = "arm", target_os = "none"))']
runner = "probe-rs run --chip stm32f407vet6"

RP2040平台

[build]
target = "thumbv6m-none-eabi"

[target.'cfg(all(target_arch = "arm", target_os = "none"))']
runner = "probe-rs run --chip rp2040"

常见问题解决

编译错误：目标架构未安装

error: target 'thumbv7em-none-eabi' not found

解决：安装对应目标架构

rustup target add thumbv7em-none-eabi

调试器无法连接

1. 检查权限（Linux）：

sudo udevadm control --reload-rules && sudo udevadm trigger

2. 验证芯片型号：

probe-rs chip list | grep nRF52840  # 替换为你的芯片型号

进阶资源

• 官方文档：docs/index.adoc
• 示例代码库：examples/
• API参考：运行cargo doc --open生成本地文档
• 硬件支持：
  • STM32系列：embassy-stm32
  • nRF系列：embassy-nrf
  • RP系列：embassy-rp

总结与后续学习

通过本文配置，你已掌握Embassy开发的核心流程。下一步推荐学习：

• 异步任务管理：embassy-executor
• 外设驱动使用：embassy-nrf/src/gpio.rs
• 低功耗优化：embassy-time定时器使用

定期同步项目获取更新：

git pull origin main
cargo update

希望本文能帮你顺利踏上Rust嵌入式开发之旅！如有问题，可查阅项目官方文档或提交issue。

【免费下载链接】embassy Modern embedded framework, using Rust and async. 项目地址: https://gitcode.com/gh_mirrors/em/embassy