#oled #embedded-hal-driver #i2c-driver #no-std

no-std sh1106

I2C/SPI driver for the SH1106 OLED display controller

15 releases

0.5.0 Aug 30, 2023
0.4.0 Jul 11, 2021
0.3.4 Dec 28, 2020
0.3.3 Jun 9, 2020
0.1.1 Mar 2, 2019

#621 in Embedded development

Download history 4/week @ 2023-11-23 7/week @ 2023-11-30 8/week @ 2023-12-21 69/week @ 2023-12-28 12/week @ 2024-01-04 10/week @ 2024-01-18 12/week @ 2024-01-25 1/week @ 2024-02-08 5/week @ 2024-02-15 27/week @ 2024-02-22 45/week @ 2024-02-29 31/week @ 2024-03-07

108 downloads per month
Used in klaptik

MIT/Apache

4MB
779 lines

SH1106 driver

Build Status Crates.io Docs.rs

SH1106 display module showing the Rust logo

I2C driver for the SH1106 OLED display written in 100% Rust

Documentation

[Examples]

This crate uses probe-run to run the examples. Once set up, it should be as simple as cargo run --example <example name> --release. --release will be required for some examples to reduce FLASH usage.

From examples/text.rs:

#![no_std]
#![no_main]

use cortex_m_rt::{entry, exception, ExceptionFrame};
use embedded_graphics::{
    fonts::{Font6x8, Text},
    pixelcolor::BinaryColor,
    prelude::*,
    style::TextStyle,
};
use panic_semihosting as _;
use sh1106::{prelude::*, Builder};
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: 100.khz().into(),
            duty_cycle: DutyCycle::Ratio2to1,
        },
        clocks,
        &mut rcc.apb1,
        1000,
        10,
        1000,
        1000,
    );

    let mut disp: GraphicsMode<_> = Builder::new().connect_i2c(i2c).into();

    disp.init().unwrap();
    disp.flush().unwrap();

    Text::new("Hello world!", Point::zero())
        .into_styled(TextStyle::new(Font6x8, BinaryColor::On))
        .draw(&mut display)
        .unwrap();

    Text::new("Hello Rust!", Point::new(0, 16))
        .into_styled(TextStyle::new(Font6x8, BinaryColor::On))
        .draw(&mut display)
        .unwrap();

    disp.flush().unwrap();

    loop {}
}

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

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies