Remarks

Ssd1306
Status
Source code	GitHub
Datasheet(s)	GitHub
NuGet package

The SSD1306 is a display controller used to control small, low resolution, single color OLED displays. OLED displays generate their own light - no backlight is included or required.

SDD1306 displays can be found supporting both I2C and SPI and come in resolutions of 32x128, 64x128, 16x96 and 64x96.

You may find mutlicolor variants, however, the color is achieved by placing one or more color filter over the single color display.

Purchasing

There are a number of breakout board available using these displays. This driver has been tested with the following:

• Diymall 0.96" 128x64 pixel OLED Display
• HALJIA 0.91 128x32 pixel OLED Display

Board are also available from Adafruit.

Code Example

MicroGraphics graphics;
Ssd1306 display;

public override Task Initialize()
{
    //CreateSpiDisplay();
    CreateI2CDisplay();

    graphics = new MicroGraphics(display);

    return base.Initialize();
}

void CreateSpiDisplay()
{
    Console.WriteLine("Create Display with SPI...");

    display = new Ssd1306
    (
        device: Device,
        spiBus: Device.CreateSpiBus(),
        chipSelectPin: Device.Pins.D02,
        dcPin: Device.Pins.D01,
        resetPin: Device.Pins.D00,
        displayType: Ssd1306.DisplayType.OLED128x64
    );
}

void CreateI2CDisplay()
{
    Console.WriteLine("Create Display with I2C...");

    display = new Ssd1306
    (
        i2cBus: Device.CreateI2cBus(Meadow.Hardware.I2cBusSpeed.FastPlus),
        address: 60,
        displayType: Ssd1306.DisplayType.OLED128x32
    );
}

public override Task Run()
{
    graphics.Clear();
    graphics.CurrentFont = new Font8x12();
    graphics.DrawText(0, 0, "Meadow F7", Meadow.Foundation.Color.White);
    graphics.DrawRectangle(5, 14, 30, 10, true);

    graphics.Show();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

To wire a Ssd1306 to your Meadow board using I2C, connect the following:

Ssd1306	Meadow Pin
GND	GND
VCC	3V3
SCL	D08 (SCL Pin)
SDA	D07 (SDA Pin)

The OLED displays are available with a SPI or I2C interfaces. Wiring for the I2C interface is as follows:

Characteristic	Locus
Inheritance	System.Object Ssd130xBase > Ssd1306 > Ssd1309
Implements	IGraphicsDisplay
Inherited Members	Ssd130xBase.ColorMode Ssd130xBase.Width Ssd130xBase.Height Ssd130xBase.PixelBuffer Ssd130xBase.spiPeripheral Ssd130xBase.dataCommandPort Ssd130xBase.resetPort Ssd130xBase.chipSelectPort Ssd130xBase.connectionType Ssd130xBase.Data Ssd130xBase.Command Ssd130xBase.PAGE_SIZE Ssd130xBase.i2cPeripheral Ssd130xBase.imageBuffer Ssd130xBase.readBuffer Ssd130xBase.commandBuffer Ssd130xBase.pageBuffer Ssd130xBase.showPreamble Ssd130xBase.InvertDisplay Ssd130xBase.Contrast Ssd130xBase.Sleep Ssd130xBase.displayType Ssd130xBase.SendCommands(Span<Byte>) Ssd130xBase.Show() Ssd130xBase.Show(Int32, Int32, Int32, Int32) Ssd130xBase.Clear(Boolean) Ssd130xBase.DrawPixel(Int32, Int32, Color) Ssd130xBase.DrawPixel(Int32, Int32, Boolean) Ssd130xBase.InvertPixel(Int32, Int32) Ssd130xBase.StartScrolling(Ssd130xBase.ScrollDirection) Ssd130xBase.StartScrolling(Ssd130xBase.ScrollDirection, Byte, Byte) Ssd130xBase.StopScrolling() Ssd130xBase.Fill(Color, Boolean) Ssd130xBase.Fill(Int32, Int32, Int32, Int32, Color) Ssd130xBase.WriteBuffer(Int32, Int32, IPixelBuffer) Ssd130xBase.Oled128x64SetupSequence Ssd130xBase.Oled128x32SetupSequence Ssd130xBase.Oled72x40SetupSequence Ssd130xBase.Oled96x16SetupSequence Ssd130xBase.Oled64x48SetupSequence
Namespace	Meadow.Foundation.Displays
Assembly	Ssd130x.dll

Syntax

public class Ssd1306 : Ssd130xBase, IGraphicsDisplay

Constructors

Ssd1306(II2cBus, Byte, Ssd130xBase.DisplayType)

Create a new SSD1306 object using the default parameters for

Declaration

public Ssd1306(II2cBus i2cBus, byte address = null, Ssd130xBase.DisplayType displayType = Ssd130xBase.DisplayType.OLED128x64)

Parameters

Type	Name	Description
II2cBus	i2cBus	I2cBus connected to display
System.Byte	address	Address of the bus on the I2C display.
Ssd130xBase.DisplayType	displayType	Type of SSD1306 display (default = 128x64 pixel display).

Ssd1306(IMeadowDevice, ISpiBus, IPin, IPin, IPin, Ssd130xBase.DisplayType)

Create a new SSD1306 object

Declaration

public Ssd1306(IMeadowDevice device, ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, Ssd130xBase.DisplayType displayType = Ssd130xBase.DisplayType.OLED128x64)

Parameters

Type	Name	Description
IMeadowDevice	device	Meadow device
ISpiBus	spiBus	SPI bus connected to display
IPin	chipSelectPin	Chip select pin
IPin	dcPin	Data command pin
IPin	resetPin	Reset pin
Ssd130xBase.DisplayType	displayType	Type of SSD1306 display (default = 128x64 pixel display)

Ssd1306(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, Ssd130xBase.DisplayType)

Create a new Ssd1306 display object

Declaration

public Ssd1306(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, Ssd130xBase.DisplayType displayType = Ssd130xBase.DisplayType.OLED128x64)

Parameters

Type	Name	Description
ISpiBus	spiBus	SPI bus connected to display
IDigitalOutputPort	chipSelectPort	Chip select output port
IDigitalOutputPort	dataCommandPort	Data command output port
IDigitalOutputPort	resetPort	Reset output port
Ssd130xBase.DisplayType	displayType	Type of SSD1306 display (default = 128x64 pixel display)