Rust SPI显示接口库display-interface-spi的使用，高效驱动SPI显示屏的嵌入式开发工具

SPI接口用于显示接口

这个Rust crate包含了一个通用的SPI实现，用于通过任何实现了embedded-hal/embedded-hal-async SpiDevice trait的SPI驱动程序来实现显示器数据/命令接口。

许可证

可选择以下任一许可证使用：

• Apache License, Version 2.0
• MIT license

贡献

除非您明确声明，否则任何有意提交包含在作品中的贡献，如Apache-2.0许可证中所定义，都应按照上述双重许可，不附加任何额外条款或条件。

安装

在项目目录中运行以下Cargo命令：

cargo add display-interface-spi

或在Cargo.toml中添加以下行：

display-interface-spi = "0.5.0"

完整示例代码

use display_interface_spi::SPIInterface;
use embedded_hal::spi::SpiDevice;
use embedded_hal::digital::v2::OutputPin;

// 假设有以下类型定义
struct MySpi;  // 实现SpiDevice trait的SPI设备
struct MyDcPin; // 实现OutputPin的数据/命令控制引脚
struct MyCsPin; // 实现OutputPin的芯片选择引脚

// 创建SPI接口
let spi = MySpi;
let dc = MyDcPin;
let cs = MyCsPin;

// 初始化SPI显示接口
let interface = SPIInterface::new(spi, dc, cs);

// 现在可以使用interface与显示设备通信
// 例如发送命令或数据到显示器

// 更完整的示例，使用embedded-hal traits

use embedded_hal::spi::MODE_0;
use embedded_hal::blocking::spi::Transfer;
use embedded_hal::digital::v2::OutputPin;
use display_interface_spi::SPIInterface;

// 定义SPI总线实现
struct MySPIBus {
    // 实际的SPI实现细节
}

impl Transfer<u8> for MySPIBus {
    type Error = MySPIError;
    
    fn transfer<'w>(&mut self, words: &'w mut [u8]) -> Result<&'w [u8], MySPIError> {
        // 实现SPI传输逻辑
        Ok(words)
    }
}

// 定义引脚实现
struct MyPin {
    // 实际的GPIO实现细节
}

impl OutputPin for MyPin {
    type Error = MyPinError;
    
    fn set_low(&mut self) -> Result<(), MyPinError> {
        // 实现设置低电平逻辑
        Ok(())
    }
    
    fn set_high(&mut self) -> Result<(), MyPinError> {
        // 实现设置高电平逻辑
        Ok(())
    }
}

fn main() {
    // 初始化SPI总线
    let spi_bus = MySPIBus { /* 初始化参数 */ };
    
    // 初始化数据/命令和片选引脚
    let dc_pin = MyPin { /* 初始化参数 */ };
    let cs_pin = MyPin { /* 初始化参数 */ };
    
    // 创建SPI显示接口
    let display_interface = SPIInterface::new(spi_bus, dc_pin, cs_pin);
    
    // 现在可以使用display_interface与SPI显示器通信
    // 例如:
    // display_interface.send_commands(&[0x01, 0x02])?;
    // display_interface.send_data(&[0x03, 0x04])?;
}

更完整的实际应用示例

//! 使用display-interface-spi驱动ST7789 SPI显示屏的完整示例

use embedded_hal::spi::{SpiDevice, MODE_0};
use embedded_hal::digital::v2::OutputPin;
use display_interface_spi::SPIInterface;
use st7789::{ST7789, Orientation};

// 定义错误类型
#[derive(Debug)]
enum DisplayError {
    SPIError,
    PinError,
}

// 假设我们有一个具体的SPI实现
struct HardwareSPI {
    // 实际的硬件SPI实现
}

impl SpiDevice for HardwareSPI {
    type Error = DisplayError;
    
    fn transaction(&mut self, operations: &mut [Operation<'_, u8>]) -> Result<(), Self::Error> {
        // 实现SPI事务处理
        Ok(())
    }
}

// 假设我们有一个具体的GPIO实现
struct HardwarePin {
    // 实际的GPIO实现
}

impl OutputPin for HardwarePin {
    type Error = DisplayError;
    
    fn set_low(&mut self) -> Result<(), Self::Error> {
        // 设置引脚为低电平
        Ok(())
    }
    
    fn set_high(&mut self) -> Result<(), Self::Error> {
        // 设置引脚为高电平
        Ok(())
    }
}

fn main() -> Result<(), DisplayError> {
    // 初始化硬件SPI
    let spi = HardwareSPI {};
    
    // 初始化数据/命令控制引脚
    let dc = HardwarePin {};
    
    // 初始化复位引脚（可选）
    let rst = HardwarePin {};
    
    // 初始化片选引脚（可选）
    let cs = HardwarePin {};
    
    // 创建SPI显示接口
    let display_interface = SPIInterface::new(spi, dc, cs);
    
    // 创建ST7789显示器驱动
    let mut display = ST7789::new(
        display_interface,
        rst,
        240,  // 宽度
        320,  // 高度
    );
    
    // 初始化显示器
    display.init()?;
    
    // 设置显示方向
    display.set_orientation(Orientation::Portrait)?;
    
    // 清屏为红色
    display.clear(Rgb565::RED)?;
    
    // 绘制一些内容
    // ...
    
    Ok(())
}