SuperAPI AI 工具集

embedded-rust

编程与开发

查看项目

更新于 10-25 05:42

技能介绍

用途

该技能用于在 Rust 中编写面向 Cortex-M 或 RISC-V 的 no_std 固件。当固件项目需要搭建或修复时,会用到它,包括 #![no_std] #![no_main] 布局、cortex-m-rt 启动、probe-rs 烧录与日志流、defmt 日志、RTIC 应用以及 panic handler 选择。资料明确说明,该技能不用于处理 no_std 库的约束问题。

主要能力

  • 根据内核与是否带 FPU 选择并安装目标三元组,例如 Cortex-M4F/M7F 使用 thumbv7em-none-eabihf,RISC-V RV32IMAC 使用 riscv32imac-unknown-none-elf。
  • 编写 Cargo.toml 与 .cargo/config.toml,配置构建目标、probe-rs runner、链接参数与 release 配置。
  • 编写 memory.x,声明 FLASH 与 RAM 的起始地址和大小,由 cortex-m-rt 生成的 link.x 引用。
  • 编写最小编译程序,使用 cortex_m_rt::entry、defmt 的 info! 宏,并以 use defmt_rtt as _;、use panic_probe as _; 链接 RTT 传输与 panic handler。
  • 使用 probe-rs 烧录、复位并打印 RTT 与 defmt 输出;probe-rs attach 可在不复位、不烧录的情况下连接。
  • 使用 defmt 日志,包括 #[derive(Format)]、info!/warn!/error!、defmt::assert_eq!;默认传输为 defmt-rtt,RTT 不可用时可用 defmt-semihosting。
  • 使用 RTIC 2 编写中断驱动并发:binds 任务绑定硬件中断,shared 资源加锁,编译期证明无数据竞争;也可选用 Embassy(embassy-executor)异步方案,但每个二进制只选一个执行器。
  • 选择唯一 panic handler:panic-halt、panic-probe、panic-semihosting 或 panic-reset。

使用方式

按资料给出的步骤:先确定 MCU 型号与 probe-rs chip 名称(probe-rs chip list 可列出)、内核与 FPU、Flash/RAM 参数、并发模型以及是否有调试探针;然后安装目标三元组,编写配置文件与程序,最后用 cargo run --release 构建、烧录并流式输出 defmt 日志。资料给出的 probe-rs 安装命令为:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.sh | sh

完成标准与故障排查

完成标准为:cargo build --release 生成目标三元组的 ELF,cargo run --release 烧录并输出 defmt 日志,且只链接一个 panic handler。资料还列出常见问题及方向:找不到 core crate 需安装目标;memory.x 相关链接错误需放置或指定搜索路径;panic handler 重复需只保留一个;无 defmt 输出需保证重建重烧且链接 defmt-rtt;probe-rs 找不到探针需检查 USB 权限或 udev 规则;启动 HardFault 需核对 memory.x 与目标三元组。

限制

资料未说明该技能的收费、价格或额外平台支持情况,暂未提供。所有操作限于用户指定目录内的可回滚本地文件写入;烧录会写入板载 Flash。