oled_async 0.2.1

Driver for various OLED display controllers. e.g. SH110x SSD130X works with embedded-graphics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

//! SH1108 display variants and specifics

use crate::display::DisplayVariant;
use display_interface::{AsyncWriteOnlyDataCommand, DisplayError};

use crate::command::{Command, VcomhLevel};

/// Generic 64x160 with SH1108 controller
#[derive(Debug, Clone, Copy)]
pub struct Sh1108_64_160 {}

impl DisplayVariant for Sh1108_64_160 {
    const WIDTH: u8 = 64;
    const HEIGHT: u8 = 160;
    const COLUMN_OFFSET: u8 = 48;
    const LARGE_PAGE_ADDRESS: bool = true;

    async fn init_column_mode<DI>(
        iface: &mut DI,
        //display_rotation: DisplayRotation,
    ) -> Result<(), DisplayError>
    where
        DI: AsyncWriteOnlyDataCommand,
    {
        init_column_mode_common(iface, Self::dimensions(), 0).await?;
        Command::DisplayOffset(0).send(iface).await?;
        Command::ComPinConfig(true).send(iface).await?;

        Ok(())
    }
}

/// Generic 96x160 with SH1108 controller
#[derive(Debug, Clone, Copy)]
pub struct Sh1108_96_160 {}

impl DisplayVariant for Sh1108_96_160 {
    const WIDTH: u8 = 96;
    const HEIGHT: u8 = 160;
    const COLUMN_OFFSET: u8 = 32;
    const LARGE_PAGE_ADDRESS: bool = true;

    async fn init_column_mode<DI>(
        iface: &mut DI,
        //display_rotation: DisplayRotation,
    ) -> Result<(), DisplayError>
    where
        DI: AsyncWriteOnlyDataCommand,
    {
        init_column_mode_common(iface, Self::dimensions(), 1).await?;
        Command::DisplayOffset(0).send(iface).await?;
        Command::ComPinConfig(true).send(iface).await?;

        Ok(())
    }
}
/// Generic 128x160 with SH1108 controller
#[derive(Debug, Clone, Copy)]
pub struct Sh1108_128_160 {}

impl DisplayVariant for Sh1108_128_160 {
    const WIDTH: u8 = 128;
    const HEIGHT: u8 = 160;
    const COLUMN_OFFSET: u8 = 16;
    const LARGE_PAGE_ADDRESS: bool = true;

    async fn init_column_mode<DI>(
        iface: &mut DI,
        //display_rotation: DisplayRotation,
    ) -> Result<(), DisplayError>
    where
        DI: AsyncWriteOnlyDataCommand,
    {
        init_column_mode_common(iface, Self::dimensions(), 2).await?;
        Command::DisplayOffset(0).send(iface).await?;
        Command::ComPinConfig(true).send(iface).await?;

        Ok(())
    }
}

/// Generic 160x160 with SH1108 controller
#[derive(Debug, Clone, Copy)]
pub struct Sh1108_160_160 {}

impl DisplayVariant for Sh1108_160_160 {
    const WIDTH: u8 = 160;
    const HEIGHT: u8 = 160;
    const COLUMN_OFFSET: u8 = 0;
    const LARGE_PAGE_ADDRESS: bool = true;

    async fn init_column_mode<DI>(
        iface: &mut DI,
        //display_rotation: DisplayRotation,
    ) -> Result<(), DisplayError>
    where
        DI: AsyncWriteOnlyDataCommand,
    {
        init_column_mode_common(iface, Self::dimensions(), 3).await?;
        Command::DisplayOffset(0).send(iface).await?;
        Command::ComPinConfig(true).send(iface).await?;

        Ok(())
    }
}

/// Initialise the display in column mode (i.e. a byte walks down a column of 8 pixels) with
/// column 0 on the left and column _(display_width - 1)_ on the right.
pub async fn init_column_mode_common<DI>(
    iface: &mut DI,
    dimensions: (u8, u8),
    resolution: u8,
) -> Result<(), DisplayError>
where
    DI: AsyncWriteOnlyDataCommand,
{
    //iface.init().await?;
    // TODO: Break up into nice bits so display modes can pick whathever they need
    let (_, display_height) = dimensions;

    Command::DisplayOn(false).send(iface).await?;
    Command::DisplayClockDiv(0x6, 0x0).send(iface).await?;
    Command::DisplayResolution(resolution).send(iface).await?;
    Command::PreChargePeriod(0x8, 0x2).send(iface).await?;
    Command::DisplayOn(true).send(iface).await?;

    Command::Multiplex(display_height - 1).send(iface).await?;

    Command::StartLine(0).send(iface).await?;
    // TODO: Ability to turn charge pump on/off
    // Display must be off when performing this command
    Command::ChargePump(true).send(iface).await?;

    Command::Contrast(0x80).send(iface).await?;
    Command::PreChargePeriod(0x1, 0xF).send(iface).await?;
    Command::VcomhDeselect(VcomhLevel::Auto).send(iface).await?;
    Command::AllOn(false).send(iface).await?;
    Command::Invert(false).send(iface).await?;
    Command::DisplayOn(true).send(iface).await?;

    Ok(())
}