硬件准备

    • STM32开发板*1
    • 烧录器*1
      • 推荐使用ST-Link
    • LED*1
      • 若有板载LED，则无需准备
    • 杜邦线若干

    硬件接线

    PeriSTM32
    LEDPC0
    ST-Link SWDIOSWDIO/PA13
    ST-Link SWCLKSWCLk/PA14
    ST-Link GNDGND
    ST-Link 3V33V3

    电路部分，如上表即可，不涉及其他外设，这样简单接线就可以工作，但是更推荐的做法是，使用Type-C/USB给板子5V供电，5V直流通过LDO或者DC/DC转为3V3后再给相应外设板子供电，这样会更稳定，若是部分外设需要5V供电，但系统里并未接入5V直流，则会导致外设无响应，或工作不正常，这是需要注意的一个点。

    创建工程

    一般来说，可以直接使用一些别人写好的工具来创建模板（在crates.io上可以找到），类似esp-generate这样的工具，但是，由于rust+embassy一直都很活跃，使用别人的模板，难以保证体验最新特性，所以，介绍一下如何从cargo new xxx开始一个嵌入式rust的工程。

    创建空白工程

    1. 创建一个空白工程

    打开终端，输入：

    cargo new stm32_blinky

    注意：工程名最好是snake_case。

    1. 使用vscode打开所创建的工程

    工程目录如下图所示，标准的hello world工程。

    移植embassy

    参考embassy仓库的工程进行工程移植，点击跳转embassy stm32f4 examples

    在自己的工程根目录里创建两个目录，并且新建文件

    .config/config.toml
.vscode/settings.json

    将以下图中内容，复制到.cargo/config.toml里 

    [target.'cfg(all(target_arch = "arm", target_os = "none"))']
# replace STM32F407VETx with your chip as listed in `probe-rs chip list`
runner = "probe-rs run --chip STM32F407VETx"

[build]
target = "thumbv7em-none-eabihf"

[env]
DEFMT_LOG = "trace"

    注意：以上内容并不是照抄，需要按照自己的开发板具体型号来适配芯片名称（--chip xxx），还有编译器（target = "xxx"）。

    具体做法是：

    先看自己的开发板是什么型号，例如，我手里的是STM32F407VET6，这个型号在购买开发板的时候可以看到，也可以在芯片上直接读到，由于不确定配置文件里的芯片名称格式，所以需要使用probe-rs提供的命令来查看支持的芯片还有格式书写。

    1. 在终端里输入
    probe-rs chip list

    可以看到，支持的芯片很多，但由于显示的问题，只显示了部分芯片型号。

    所以需要进行筛选，确定具体的型号。

    注意，以下命令需要在git bash里进行，若是linux/mac则无需注意。

    1. 在终端里输入
    probe-rs chip list | grep STM32F4

    可以看到，已经筛选出了F4系列的芯片，进一步缩小范围。

    1. 在终端里输入
    probe-rs chip list | grep STM32F407

    可以看到，所列出的芯片型号中，STM32F407VE与我手里的STM32F407VET6就十分接近，那就选这个STM32F407VE填到.cargo/config.toml文件中--chip xxx的位置。

    当然，也可以使用

    probe-rs chip list | grep STM32* > chip.txt

    将STM32系列的芯片型号，保存到一个chip.txt的文件里，再去手动查找。

    1. 在.vscode/settings.json里粘贴以下内容
    {
    "rust-analyzer.check.allTargets": false
}

    使用rust做嵌入式开发时，需要no-std，使用以上配置文件，就可以屏蔽报错。

    1. 复制embassy examples里的build.rs到自己的工程里
    fn main() {
    println!("cargo:rustc-link-arg-bins=--nmagic");
    println!("cargo:rustc-link-arg-bins=-Tlink.x");
    println!("cargo:rustc-link-arg-bins=-Tdefmt.x");
}
    1. 复制必要的依赖配置到根目录里的Cargo.toml文件里
    [package]
name = "stm32_blinky"
version = "0.1.0"
edition = "2024"

[dependencies]
embassy-stm32 = { version = "0.4.0",  features = ["defmt", "stm32f407ve", "unstable-pac", "memory-x", "time-driver-any", "exti", "chrono"] }
embassy-sync = { version = "0.7.2",  features = ["defmt"] }
embassy-executor = { version = "0.9.0",  features = ["arch-cortex-m", "executor-thread", "executor-interrupt", "defmt"] }
embassy-time = { version = "0.5.0", features = ["defmt", "defmt-timestamp-uptime", "tick-hz-32_768"] }
embassy-usb = { version = "0.5.1",  features = ["defmt" ] }
embassy-net = { version = "0.7.1",  features = ["defmt", "tcp", "dhcpv4", "medium-ethernet", ] }
embassy-net-wiznet = { version = "0.2.1",  features = ["defmt"] }
embassy-futures = { version = "0.1.2"}

defmt = "1.0.1"
defmt-rtt = "1.0.0"

cortex-m = { version = "0.7.6", features = ["inline-asm", "critical-section-single-core"] }
cortex-m-rt = "0.7.0"
embedded-hal = "0.2.6"
embedded-hal-bus = { version = "0.2", features = ["async"] }
embedded-io = { version = "0.6.0" }
embedded-io-async = { version = "0.6.1" }
panic-probe = { version = "1.0.0", features = ["print-defmt"] }
futures-util = { version = "0.3.30", default-features = false }
heapless = { version = "0.8", default-features = false }
critical-section = "1.1"
nb = "1.0.0"
embedded-storage = "0.3.1"
micromath = "2.0.0"
usbd-hid = "0.8.1"
static_cell = "2"
chrono = { version = "^0.4", default-features = false}

[profile.release]
debug = 2

    注意：以上配置，均是来自embassy仓库，只是将path字段删除了，在编译的时候，会自动在线拉取，因为我们并没有将这些库拉取到本地，所以这个字段可以删除，当然也有其他配置的方式，例如指定git，大家感兴趣可以自行去探索。

    大家可以自行对比，进行移植。最简单的方式就是复制上面的配置文件到自己的Cargo.toml文件里，再将embassy-stm32 = { version = "0.4.0", features = ["defmt", "stm32f407ve", "unstable-pac", "memory-x", "time-driver-any", "exti", "chrono"] }这个依赖里的stm32f407ve修改为前文教大家适配的自己的芯片型号即可。

    编写代码点灯

    完成了以上工程创建之后，就可以开始写代码点灯了。当然了，第一次，还是直接复制粘贴，局部调整即可。

    将以下代码，粘贴到main.rs里。

    CV

    #![no_std]
#![no_main]

use defmt::*;
use embassy_executor::Spawner;
use embassy_stm32::gpio::{Level, Output, Speed};
use embassy_time::Timer;
use {defmt_rtt as _, panic_probe as _};

#[embassy_executor::main]
async fn main(_spawner: Spawner) {
    let p = embassy_stm32::init(Default::default());
    info!("Hello World!");

    let mut led = Output::new(p.PC0, Level::High, Speed::Low);

    loop {
        info!("high");
        led.set_high();
        Timer::after_millis(300).await;

        info!("low");
        led.set_low();
        Timer::after_millis(300).await;
    }
}

    只需要将PC0修改为自己板子所连接LED的引脚即可。

    let mut led = Output::new(p.PC0, Level::High, Speed::Low);

    烧录

    确保烧录器、开发板、电脑连接无误，供电正常。

    打开终端，输入

    cargo run --release

    开始编译，可以看到编译进度。

    编译完成后，开始下载，并且会在终端里打印出info函数里的内容。（可以用来做类似串口调试的工具。）

    至此，恭喜你完成了在STM32单片机上，使用RUST语言点灯。

    所有的伟大，源于一个勇敢的开始。😊