📚 课程目录第2章认识STM32与HAL库

认识STM32与HAL库：从芯片到Rust生态

好，咱们正式开始第二讲。这一章我打算带你看看STM32到底是个什么来头，以及我们常说的HAL到底在解决什么问题。最后，我会把Rust这边的嵌入式HAL生态给你捋一遍。

说实话，我最早接触STM32还是用标准外设库的时候。那时候写个GPIO翻转都要翻半天手册。后来HAL库出来了，确实省了不少事。但真正让我觉得“嗯，这路子对了”的，还是Rust的embedded-hal这套设计。

STM32系列芯片概览

STM32是ST公司基于ARM Cortex-M内核做的一系列微控制器。你想想看，从低功耗的L0系列到高性能的H7系列，覆盖了几乎所有的嵌入式应用场景。

我个人习惯把STM32按内核分成几个梯队：

系列	内核	典型主频	适合场景
STM32F0/F1	Cortex-M0/M3	48-72 MHz	简单控制、传感器采集
STM32F4	Cortex-M4F	84-180 MHz	中等算力、DSP、浮点运算
STM32F7/H7	Cortex-M7	216-480 MHz	高性能、图形界面、AI推理
STM32L0/L4	Cortex-M0+/M4	32-80 MHz	低功耗、电池供电设备
STM32G0/G4	Cortex-M0+/M4F	64-170 MHz	性价比、电机控制

咱们这门课选的是STM32F4系列。为什么？因为F4系列市场保有量大，资料多，而且带FPU（浮点运算单元），跑Rust的嵌入式HAL生态非常成熟。我在项目里用过F407和F429，说实话，只要不是跑Linux级别的应用，F4完全够用。

核心要点：STM32F4系列是Rust嵌入式HAL生态中支持最完善、社区最活跃的芯片家族之一。选它做入门，踩坑少、资料多、社区能问。

什么是HAL（硬件抽象层）

HAL，全称Hardware Abstraction Layer。说白了，就是给你包一层接口，让你不用直接操作寄存器。

你想想看，如果没有HAL，你要点亮一个LED，得这么干：

// 直接操作寄存器（C语言风格）
GPIOA->BSRR = GPIO_PIN_5;
// 或者Rust风格
const GPIOA_BASE: usize = 0x40020000;
let bsrr = (GPIOA_BASE + 0x18) as *mut u32;
unsafe { bsrr.write_volatile(1 << 5); }

有了HAL之后呢？

// Rust embedded-hal风格
let mut led = gpioa.pa5.into_push_pull_output();
led.set_high().unwrap();

看到了吗？代码可读性完全不一样。而且最关键的是——可移植性。你今天用STM32F4，明天换GD32或者nRF52，只要底层实现了embedded-hal的trait，上层代码几乎不用改。

我在一个项目中吃过这个亏。当时用C标准库写了一套传感器驱动，后来换芯片，所有寄存器地址都得重写，折腾了两周。如果用Rust的embedded-hal，换个芯片换个crate就完事了。

我的建议：刚开始学Rust嵌入式，不要一上来就操作寄存器。先用HAL把业务逻辑跑通，等你对芯片外设熟悉了，再去看寄存器级别的实现。这样效率最高。

Rust嵌入式HAL生态介绍

Rust的嵌入式生态，核心就三层：

这三层分别对应三个关键的crate：

1. embedded-hal —— 生态的基石

embedded-hal是一个trait集合。它定义了嵌入式开发中最常用的接口：

digital::OutputPin —— 输出引脚，有set_high()和set_low()
digital::InputPin —— 输入引脚，有is_high()和is_low()
blocking::i2c::WriteRead —— I2C读写操作
blocking::spi::Transfer —— SPI数据传输
timer::CountDown —— 定时器延时

这些trait只有方法签名，没有具体实现。就像一份合同，谁想用，谁就得签。

曾经踩过的坑：embedded-hal有多个版本（0.2.x、1.0.x等），不同版本的trait定义有差异。选crate时一定要确认版本兼容性。我有一回把embedded-hal 0.2的驱动硬塞到1.0的项目里，编译报错报了半小时。

2. stm32-rs —— 芯片的“身份证”

stm32-rs是一个社区项目，它把ST官方CMSIS SVD文件自动转换成Rust的PAC（Peripheral Access Crate）。说白了，就是给你生成一套类型安全的寄存器操作API。

举个例子，你想操作GPIOA的MODER寄存器：

// 使用stm32-rs生成的PAC
let dp = pac::Peripherals::take().unwrap();
let gpioa = &dp.GPIOA;
// 设置PA5为输出模式（MODER寄存器bit 10-11）
gpioa.moder.modify(|_, w| w.moder5().output());

每个寄存器、每个位域都有对应的类型安全方法。你不可能写错地址，因为编译器会帮你检查。

3. stm32f4xx-hal —— 真正的“干活”库

stm32f4xx-hal是基于stm32-rs的PAC，实现了embedded-hal所有trait的HAL库。它做了几件重要的事：

时钟配置 —— 帮你算好PLL分频系数，生成目标系统时钟
引脚复用 —— 把GPIO引脚映射到具体外设（比如PA9是USART1_TX）
外设初始化 —— 提供安全的初始化流程，防止误配置
trait实现 —— 把GPIO、I2C、SPI等外设实现为embedded-hal的trait

看一个完整的例子：

use stm32f4xx_hal::{
    prelude::*,
    pac,
    gpio::GpioExt,
    timer::TimerExt,
};

fn main() -> ! {
    // 获取外设实例
    let dp = pac::Peripherals::take().unwrap();
    let cp = pac::CorePeripherals::take().unwrap();
    
    // 配置时钟（168MHz）
    let rcc = dp.RCC.constrain();
    let clocks = rcc.cfgr.sysclk(168.mhz()).freeze();
    
    // 初始化GPIOA
    let gpioa = dp.GPIOA.split();
    let mut led = gpioa.pa5.into_push_pull_output();
    
    // 初始化定时器
    let mut timer = dp.TIM2.timer(1.hz(), clocks);
    
    loop {
        led.set_high().unwrap();
        timer.wait().unwrap();
        led.set_low().unwrap();
        timer.wait().unwrap();
    }
}

这段代码，168MHz主频、GPIO翻转、定时器中断，全有了。而且所有配置都在编译期检查，运行时不会因为配置错误而跑飞。

一句话总结：embedded-hal定标准，stm32-rs管寄存器，stm32f4xx-hal做实现。你只需要写业务逻辑，底层的事交给它们。

其他值得关注的crate

除了上面三个核心crate，还有几个我常用的：

crate名称	作用	我的使用频率
cortex-m-rt	启动代码和中断向量表	每个项目必用
cortex-m-semihosting	通过调试器打印日志	调试阶段常用
panic-halt	panic时死循环	默认配置
nb	非阻塞编程模式	复杂状态机时用
embedded-graphics	2D图形库，支持OLED/LCD	带屏幕的项目必用

嗯，这一章的内容差不多就这些。你只要记住：STM32选F4系列入门最稳，HAL就是帮你省事的抽象层，Rust生态里embedded-hal、stm32-rs、stm32f4xx-hal这三板斧砍下去，大部分项目都能搞定。