Rust OLED显示驱动库ssd1306的使用，支持I2C和SPI接口的SSD1306显示屏控制

以下是使用ssd1306库控制SSD1306 OLED显示屏的完整示例代码，支持I2C接口：

#![no_std]
#![no_main]

use cortex_m_rt::{entry, exception, ExceptionFrame};
use embedded_graphics::{
    image::{Image, ImageRaw},
    pixelcolor::BinaryColor,
    prelude::*,
};
use panic_halt as _;
use ssd1306::{prelude::*, I2CDisplayInterface, Ssd1306};
use stm32f1xx_hal::{
    i2c::{BlockingI2c, DutyCycle, Mode},
    prelude::*,
    stm32,
};

#[entry]
fn main() -> ! {
    let dp = stm32::Peripherals::take().unwrap();

    let mut flash = dp.FLASH.constrain();
    let mut rcc = dp.RCC.constrain();

    let clocks = rcc.cfgr.freeze(&mut flash.acr);

    let mut afio = dp.AFIO.constrain(&mut rcc.apb2);

    let mut gpiob = dp.GPIOB.split(&mut rcc.apb2);

    let scl = gpiob.pb8.into_alternate_open_drain(&mut gpiob.crh);
    let sda = gpiob.pb9.into_alternate_open_drain(&mut gpiob.crh);

    let i2c = BlockingI2c::i2c1(
        dp.I2C1,
        (scl, sda),
        &mut afio.mapr,
        Mode::Fast {
            frequency: 400_000.hz(),
            duty_cycle: DutyCycle::Ratio2to1,
        },
        clocks,
        &mut rcc.apb1,
        1000,
        10,
        1000,
        1000,
    );

    let interface = I2CDisplayInterface::new(i2c);
    let mut display = Ssd1306::new(interface, DisplaySize128x64, DisplayRotation::Rotate0)
        .into_buffered_graphics_mode();
    display.init().unwrap();

    let raw: ImageRaw<BinaryColor> = ImageRaw::new(include_bytes!("./rust.raw"), 64);

    let im = Image::new(&raw, Point::new(32, 0));

    im.draw(&mut display).unwrap();

    display.flush().unwrap();

    loop {}
}

#[exception]
fn HardFault(ef: &ExceptionFrame) -> ! {
    panic!("{:#?}", ef);
}

使用说明

1. 首先需要添加ssd1306库到你的Cargo.toml中：

   ssd1306 = "0.10.0"
   

2. 示例代码展示了如何通过I2C接口控制SSD1306 OLED显示屏：

   • 初始化I2C接口
   • 创建显示接口
   • 初始化显示屏
   • 显示图像

3. 代码中使用了一个名为"rust.raw"的图像文件，你需要准备自己的图像文件或修改代码显示其他内容。

SPI接口示例

以下是使用SPI接口控制SSD1306 OLED显示屏的示例代码：

#![no_std]
#![no_main]

use cortex_m_rt::{entry, exception, ExceptionFrame};
use embedded_graphics::{
    mono_font::{ascii::FONT_6X10, MonoText},
    pixelcolor::BinaryColor,
    prelude::*,
    text::Text,
};
use panic_halt as _;
use ssd1306::{prelude::*, Ssd1306};
use stm32f1xx_hal::{
    gpio::gpiob::{PB13, PB14, PB15},
    gpio::{Alternate, Output, PushPull},
    pac,
    prelude::*,
    spi::{Mode, Phase, Polarity, Spi},
};

#[entry]
fn main() -> ! {
    let dp = pac::Peripherals::take().unwrap();
    let cp = cortex_m::Peripherals::take().unwrap();

    let mut flash = dp.FLASH.constrain();
    let mut rcc = dp.RCC.constrain();

    let clocks = rcc.cfgr.freeze(&mut flash.acr);

    let mut gpiob = dp.GPIOB.split(&mut rcc.apb2);

    // SPI1 pins
    let sck = gpiob.pb13.into_alternate_push_pull(&mut gpiob.crh);
    let miso = gpiob.pb14;
    let mosi = gpiob.pb15.into_alternate_push_pull(&mut gpiob.crh);

    // Chip Select pin
    let cs = gpiob.pb12.into_push_pull_output(&mut gpiob.crh);
    
    // Data/Command pin
    let dc = gpiob.pb1.into_push_pull_output(&mut gpiob.crl);
    
    // Reset pin
    let res = gpiob.pb0.into_push_pull_output(&mut gpiob.crl);

    let spi_mode = Mode {
        polarity: Polarity::IdleLow,
        phase: Phase::CaptureOnFirstTransition,
    };

    let spi = Spi::spi1(
        dp.SPI1,
        (sck, miso, mosi),
        spi_mode,
        8.mhz(),
        clocks,
        &mut rcc.apb2,
    );

    let interface = display_interface_spi::SPIInterface::new(spi, dc, cs);
    let mut display = Ssd1306::new(interface, DisplaySize128x64, DisplayRotation::Rotate0)
        .into_buffered_graphics_mode();
    
    display.init().unwrap();
    display.clear();

    let text = "Hello, Rust!";
    Text::new(text, Point::new(0, 16), MonoTextStyle::new(&FONT_6X10, BinaryColor::On))
        .draw(&mut display)
        .unwrap();

    display.flush().unwrap();

    loop {}
}

#[exception]
fn HardFault(ef: &ExceptionFrame) -> ! {
    panic!("{:#?}", ef);
}

主要特性

• 支持I2C和SPI(4线)接口
• 提供图形绘制功能
• 支持文本显示
• 支持图像显示
• 支持多种显示尺寸和旋转方向

许可证

该库采用以下许可证之一：

• Apache License, Version 2.0
• MIT license

你可以选择其中任意一种许可证使用该库。