Embassy-rs项目中使用STM32 OCTOSPI内存映射模式的技术解析

背景介绍

在嵌入式开发中，STM32系列微控制器的OCTOSPI外设提供了一种高效的外部存储器接口方式。embassy-rs作为Rust语言下的嵌入式异步运行时框架，为STM32提供了良好的硬件抽象层支持。本文将深入探讨如何在embassy-rs项目中正确配置和使用OCTOSPI的内存映射模式。

OCTOSPI内存映射模式原理

OCTOSPI（Octal SPI）是STM32系列中的一种高速串行外设接口，支持八线SPI通信。内存映射模式是该接口的一个重要特性，它允许将外部SPI闪存或RAM设备映射到处理器的地址空间中（通常是0x90000000开始的区域），使得开发者可以像访问普通内存一样直接读写外部存储设备。

实现步骤详解

1. 硬件初始化

首先需要正确配置STM32的时钟系统，特别是为OCTOSPI提供适当的时钟源：

let mut hal_config = embassy_stm32::Config::default();
hal_config.rcc.pll1 = Some(Pll {
    source: embassy_stm32::rcc::PllSource::HSE,
    prediv: embassy_stm32::rcc::PllPreDiv::DIV2,
    mul: embassy_stm32::rcc::PllMul::MUL40,
    divp: Some(PllDiv::DIV2),
    divq: Some(PllDiv::DIV2),
    divr: Some(PllDiv::DIV2),
});
hal_config.rcc.mux.octospi1sel = Octospisel::PLL1_Q;

2. OCTOSPI外设基本配置

使用embassy-stm32提供的API进行基础配置：

let mut config = ospi::Config::default();
config.memory_type = MemoryType::Micron;
config.device_size = MemorySize::_64MiB;
config.clock_prescaler = 20; // 200MHz输入时钟，分频至10MHz
let mut ospi_dev = ospi::Ospi::new_blocking_quadspi(
    p.OCTOSPI1,
    p.PF10, p.PF8, p.PF9, p.PF7, p.PF6, p.PB6,
    config
);

3. 启用内存映射模式

目前embassy-rs尚未提供直接的内存映射模式API，需要通过底层寄存器操作实现：

const OSPI_BASE: *mut () = (0x1001400 + 0x06000000 + 0x40000000) as *mut ();
const OCTOSPI1_DEV: Octospi = unsafe { Octospi::from_ptr(OSPI_BASE) };

// 等待OCTOSPI空闲
while OCTOSPI1_DEV.sr().read().busy() {
    info!("等待OCTOSPI空闲");
}

// 配置通信参数
OCTOSPI1_DEV.ccr().modify(|r| {
    r.set_isize(SizeInBits::_8BIT);    // 指令长度8位
    r.set_adsize(SizeInBits::_24BIT);  // 地址长度24位
    r.set_admode(PhaseMode::FOURLINES);// 四线地址模式
    r.set_imode(PhaseMode::FOURLINES); // 四线指令模式
    r.set_dmode(PhaseMode::FOURLINES); // 四线数据模式
});

// 启用内存映射模式
OCTOSPI1_DEV.cr().modify(|r| {
    r.set_fmode(FunctionalMode::MEMORYMAPPED);
    r.set_dmaen(false);
    r.set_en(true);
});

// 设置等待周期
OCTOSPI1_DEV.tcr().modify(|r| {
    r.set_dcyc(6);
});

4. 访问映射内存

配置完成后，可以直接通过指针访问映射的内存区域：

const OCTOSPI1_BASE: *mut u8 = 0x9000_0000 as *mut u8;

// 创建安全的内存切片
let sram_mem: &mut [_] = unsafe {
    core::slice::from_raw_parts_mut(OCTOSPI1_BASE, 0x80_0000)
};

// 读取内存数据
let val = unsafe { *(OCTOSPI1_BASE.wrapping_add(0x10)) };
info!("读取值: {:02x}", val);

技术要点分析

1. 时钟配置：OCTOSPI的工作时钟需要根据外部设备的要求合理配置，过高或过低的时钟频率都会导致通信失败。

2. 通信模式：内存映射模式下需要正确配置指令、地址和数据的总线宽度，以及使用的信号线数量（单线、双线或四线）。

3. 等待周期：根据外部存储器的特性表设置适当的等待周期(dcyc)，确保数据稳定。

4. 内存安全：Rust要求对原始指针操作必须使用unsafe块，开发者需要自行确保内存访问的安全性。

未来改进方向

虽然目前需要通过直接操作寄存器来实现内存映射模式，但可以考虑以下改进：

1. 在embassy-stm32中增加高级API封装内存映射模式配置
2. 提供更安全的内存访问接口
3. 增加对更多OCTOSPI特性的支持

总结

通过本文介绍的方法，开发者可以在embassy-rs项目中成功启用STM32的OCTOSPI内存映射模式。这种技术极大简化了对外部存储设备的访问，使得嵌入式系统能够更高效地利用外部存储资源。虽然目前需要一些底层操作，但理解这些原理对于深入掌握嵌入式开发非常有帮助。