4. 开发环境搭建：Rust嵌入式工具链安装、cargo-generate创建项目、OpenOCD配置

说实话，嵌入式开发的环境搭建，往往是劝退新手的第一道坎。我见过太多人，芯片买回来、板子焊好了，结果卡在工具链上三天没跑起来一个点灯程序。这一章，咱们就把这些坑一个个填平。

我会带着你从头搭一套完整的Rust嵌入式开发环境。包括工具链安装、项目模板生成、调试器配置。每一步我都会告诉你「为什么这么做」，而不是让你死记硬背命令。

4.1 Rust嵌入式工具链安装

先明确一点：我们不是在x86电脑上写Rust跑着玩，是要交叉编译到ARM Cortex-M这类芯片上。所以需要一套交叉编译工具链。

4.1.1 安装rustup与目标架构

如果你还没装Rust，先装rustup。装好了？那直接加目标架构：

rustup target add thumbv7em-none-eabihf

这个目标三元组看着长，拆开看就懂了：

我个人习惯把常用目标写进一个脚本里，换芯片时一键切换。比如STM32F4用thumbv7em-none-eabihf，STM32F0用thumbv6m-none-eabi。别记混了。

4.1.2 安装必要的系统工具

除了Rust工具链，还需要几个底层工具。Linux用户用包管理器装：

# Ubuntu/Debian
sudo apt install gcc-arm-none-eabi binutils-arm-none-eabi openocd

# macOS
brew install arm-none-eabi-gcc openocd

Windows用户呢？我建议用MSYS2或者直接装ARM官方的GCC工具链。嗯，这里要注意：千万别用系统自带的gcc去编译嵌入式代码，那是给x86用的。

我曾经有一次急着演示，忘了切工具链，结果链接器报了一堆莫名其妙的错误。排查了半小时才发现是用了宿主机的gcc。从那以后，我每次编译前都会看一眼链接脚本对不对。

4.2 使用cargo-generate创建项目

手动建项目结构太累了。Rust社区提供了cargo-generate，可以从模板快速生成嵌入式项目骨架。

4.2.1 安装cargo-generate

cargo install cargo-generate

装完就能用。我个人推荐几个常用的模板仓库：

• cortex-m-quickstart：官方模板，最稳
• STM32xxx-hal-template：各家芯片厂商的HAL模板
• embassy-template：异步运行时模板，适合复杂项目

4.2.2 实战：生成一个STM32F4项目

咱们以cortex-m-quickstart为例，生成一个项目：

cargo generate --git https://github.com/rust-embedded/cortex-m-quickstart

它会问你项目名、芯片型号。填好之后，目录结构是这样的：

my_project/
├── .cargo/
│   └── config.toml      # 链接器配置
├── src/
│   └── main.rs          # 入口文件
├── memory.x             # 内存布局
├── Cargo.toml
└── build.rs             # 构建脚本

你想想看，如果没有模板，这些文件你得一个个手敲。尤其是memory.x，里面定义了Flash和RAM的起始地址、大小。写错一个数字，程序就跑飞了。

4.3 OpenOCD配置与调试

OpenOCD是嵌入式调试的瑞士军刀。它负责把GDB的调试命令翻译成JTAG/SWD协议，跟芯片通信。

4.3.1 安装OpenOCD

前面系统工具那一步已经装了。验证一下：

openocd --version

如果版本号出来了，说明装好了。我建议用0.11.0以上版本，对Rust的支持更好。

4.3.2 编写OpenOCD配置文件

OpenOCD需要两个配置文件：一个是调试器（比如ST-Link、J-Link）的配置，一个是目标芯片的配置。以STM32F4 + ST-Link为例：

# stlink.cfg
source [find interface/stlink.cfg]
transport select hla_swd
source [find target/stm32f4x.cfg]

这个文件告诉OpenOCD：用ST-Link调试器，走SWD协议，目标芯片是STM32F4系列。

我个人习惯把配置文件放在项目根目录的openocd/文件夹下。这样每个项目都有自己的调试配置，不会互相干扰。

4.3.3 启动调试会话

先启动OpenOCD：

openocd -f openocd/stlink.cfg

看到Info : Listening on port 3333 for gdb connections就说明成功了。然后另开一个终端，用GDB连接：

gdb-multiarch target/thumbv7em-none-eabihf/debug/my_project
(gdb) target remote :3333
(gdb) load
(gdb) continue

为什么会这样？因为OpenOCD在3333端口开了一个GDB服务器，GDB连上去就能控制芯片了。

4.4 知识体系总览

这一章的内容比较多，我画了一张图帮你理清关系：

4.5 常见问题与避坑

搭建环境时，有几个坑我几乎每次培训都会遇到。列出来，你遇到了直接对照排查：