终极指南：如何用Rust在STM32上实现外设访问与HAL应用开发

【免费下载链接】awesome-embedded-rust Curated list of resources for Embedded and Low-level development in the Rust programming language 项目地址: https://gitcode.com/gh_mirrors/aw/awesome-embedded-rust

awesome-embedded-rust是一个精选的资源列表，专注于Rust编程语言在嵌入式和底层开发中的应用。本文将详细介绍如何在STM32微控制器上使用Rust进行外设访问和HAL应用开发，帮助新手快速入门嵌入式Rust开发。

为什么选择Rust进行STM32开发？

Rust语言以其内存安全、零成本抽象和高性能等特性，在嵌入式开发领域越来越受欢迎。对于STM32微控制器开发，Rust提供了丰富的生态系统和工具链，能够帮助开发者更安全、高效地进行嵌入式系统开发。

STM32外设访问的两种方式

直接寄存器操作

直接寄存器操作是最底层的外设访问方式，需要开发者熟悉STM32的寄存器映射和操作方式。在Rust中，可以通过Peripheral Access Crates (PACs)来实现直接寄存器访问。

例如，对于STM32F4系列微控制器，可以使用stm32f4 crate：

use stm32f4::stm32f407;

let peripherals = stm32f407::Peripherals::take().unwrap();
let gpioa = &peripherals.GPIOA;

// 配置PA5为输出模式
gpioa.moder.modify(|_, w| w.moder5().output());

// 设置PA5为高电平
gpioa.bsrr.write(|w| w.bs5().set_bit());

使用HAL库

硬件抽象层（HAL）库提供了更高级别的API，简化了外设的使用。awesome-embedded-rust项目中提供了多个STM32系列的HAL实现，如stm32f4xx-hal。

使用HAL库控制LED闪烁的示例：

use stm32f4xx_hal::{prelude::*, stm32};
use embedded_hal::digital::v2::OutputPin;

let dp = stm32::Peripherals::take().unwrap();
let rcc = dp.RCC.constrain();
let clocks = rcc.cfgr.sysclk(168.mhz()).freeze();

let gpioa = dp.GPIOA.split();
let mut led = gpioa.pa5.into_push_pull_output();

loop {
    led.set_high().unwrap();
    hal::delay::Delay::new(&clocks).delay_ms(1000u32);
    led.set_low().unwrap();
    hal::delay::Delay::new(&clocks).delay_ms(1000u32);
}

快速开始：STM32开发环境搭建

安装必要工具

1. 安装Rust工具链：

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

2. 添加目标架构支持：

rustup target add thumbv7em-none-eabihf

3. 安装辅助工具：

cargo install cargo-flash cargo-embed

获取项目代码

git clone https://gitcode.com/gh_mirrors/aw/awesome-embedded-rust

STM32 HAL库详解

常用外设模块

1. GPIO：通用输入输出端口
2. UART：通用异步收发器
3. SPI：串行外设接口
4. I2C：集成电路总线
5. ADC：模数转换器
6. DAC：数模转换器
7. TIM：定时器

UART通信示例

use stm32f4xx_hal::{prelude::*, stm32, serial};
use embedded_hal::serial::Write;

let dp = stm32::Peripherals::take().unwrap();
let rcc = dp.RCC.constrain();
let clocks = rcc.cfgr.sysclk(168.mhz()).freeze();

let gpioa = dp.GPIOA.split();
let tx = gpioa.pa2.into_alternate_af7();
let rx = gpioa.pa3.into_alternate_af7();

let mut serial = serial::Serial::usart2(
    dp.USART2,
    (tx, rx),
    serial::config::Config::default()
        .baudrate(115200.bps())
        .wordlength_8()
        .parity_none()
        .stopbits(serial::config::StopBits::STOP1),
    clocks,
)
.unwrap();

serial.write(b"Hello, STM32!\r\n").unwrap();

实际项目示例：环境监测节点

项目概述

本项目将使用STM32F407开发板，通过I2C接口连接BME280传感器，采集温湿度和气压数据，并通过UART发送到上位机。

硬件准备

• STM32F407开发板
• BME280传感器模块
• USB转TTL模块

软件实现

1. 添加依赖到Cargo.toml：

[dependencies]
stm32f4xx-hal = "0.14"
bme280 = "0.5"
embedded-hal = "0.2"

2. 主程序代码：

use stm32f4xx_hal::{prelude::*, stm32, i2c, serial};
use bme280::Bme280;
use embedded_hal::blocking::i2c::Read;

fn main() {
    let dp = stm32::Peripherals::take().unwrap();
    let rcc = dp.RCC.constrain();
    let clocks = rcc.cfgr.sysclk(168.mhz()).freeze();

    // 配置I2C
    let gpiob = dp.GPIOB.split();
    let scl = gpiob.pb8.into_alternate_af4().set_open_drain();
    let sda = gpiob.pb9.into_alternate_af4().set_open_drain();
    let i2c = i2c::I2c::i2c1(dp.I2C1, (scl, sda), 400.khz(), clocks);

    // 初始化BME280传感器
    let mut bme280 = Bme280::new_primary(i2c);
    bme280.init().unwrap();

    // 配置UART
    let gpioa = dp.GPIOA.split();
    let tx = gpioa.pa2.into_alternate_af7();
    let rx = gpioa.pa3.into_alternate_af7();
    let mut serial = serial::Serial::usart2(
        dp.USART2,
        (tx, rx),
        serial::config::Config::default()
            .baudrate(115200.bps()),
        clocks,
    )
    .unwrap();

    loop {
        // 读取传感器数据
        let measurements = bme280.measure().unwrap();
        
        // 发送数据到上位机
        let data = format!(
            "Temp: {:.2} C, Humidity: {:.2} %, Pressure: {:.2} hPa\r\n",
            measurements.temperature, measurements.humidity, measurements.pressure
        );
        serial.write(data.as_bytes()).unwrap();
        
        // 延时1秒
        hal::delay::Delay::new(&clocks).delay_ms(1000u32);
    }
}

调试与测试

使用OpenOCD进行调试

openocd -f interface/stlink-v2.cfg -f target/stm32f4x.cfg

使用cargo-embed进行烧录和调试

cargo embed --example blinky

进阶技巧与最佳实践

1. 代码优化：使用#[inline(always)]和#[no_mangle]等属性优化代码
2. 中断处理：使用RTIC框架实现高效的中断驱动编程
3. 低功耗设计：合理配置STM32的低功耗模式
4. 错误处理：使用Result类型和unwrap()/expect()进行错误处理
5. 文档生成：使用cargo doc生成项目文档

总结

通过awesome-embedded-rust项目，我们可以看到Rust在STM32开发中的强大潜力。从直接寄存器操作到高级HAL库，Rust提供了灵活而安全的开发方式。无论是新手还是有经验的开发者，都可以通过这个项目快速入门并掌握嵌入式Rust开发技能。

希望本文能够帮助你开始使用Rust进行STM32开发之旅。如有任何问题，欢迎加入社区讨论，与其他开发者交流经验和技巧。

【免费下载链接】awesome-embedded-rust Curated list of resources for Embedded and Low-level development in the Rust programming language 项目地址: https://gitcode.com/gh_mirrors/aw/awesome-embedded-rust