Remarks

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

The SSD1331 is a display controller used to drive 16bpp (RGB565) color OLED displays over SPI. These displays are commonly found with a resolution of 96x64.

Code Example

MicroGraphics graphics;

public override Task Initialize()
{
    Resolver.Log.Info("Initializing ...");

    var config = new SpiClockConfiguration(new Meadow.Units.Frequency(12000, Meadow.Units.Frequency.UnitType.Kilohertz),
        SpiClockConfiguration.Mode.Mode0);
    var spiBus = Device.CreateSpiBus(Device.Pins.SCK, Device.Pins.MOSI, Device.Pins.MISO, config);

    Resolver.Log.Info("Create display driver instance");

    var display = new St7796s
    (
        spiBus: spiBus,
        resetPin: Device.Pins.D00,
        chipSelectPin: Device.Pins.D02,
        dcPin: Device.Pins.D01,
        width: 320, height: 480
    );

    graphics = new MicroGraphics(display);
    graphics.CurrentFont = new Font8x8();

    return base.Initialize();
}

public override Task Run()
{
    graphics.Clear();

    graphics.DrawTriangle(10, 10, 50, 50, 10, 50, Meadow.Foundation.Color.Red);
    graphics.DrawRectangle(20, 15, 40, 20, Meadow.Foundation.Color.Yellow, false);
    graphics.DrawText(5, 5, "Meadow F7");

    graphics.Show();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

To wire a Ssd1331 to your Meadow board, connect the following:

Ssd1331	Meadow Pin
LED-	3V3
LED+	GND
MOSI	MOSI
SCK	SCK
RESET	D15
A0	D14
CS	D13
VCC	3V3
GND	GND

It should look like the following diagram:

Characteristic	Locus
Inheritance	System.Object TftSpiBase > Ssd1331
Implements	IGraphicsDisplay
Inherited Members	TftSpiBase.ColorMode TftSpiBase.Rotation TftSpiBase.Width TftSpiBase.Height TftSpiBase.PixelBuffer TftSpiBase.dataCommandPort TftSpiBase.resetPort TftSpiBase.chipSelectPort TftSpiBase.spiDisplay TftSpiBase.imageBuffer TftSpiBase.readBuffer TftSpiBase.Data TftSpiBase.Command TftSpiBase.IsColorTypeSupported(ColorMode) TftSpiBase.CreateBuffer(ColorMode, Int32, Int32) TftSpiBase.Clear(Boolean) TftSpiBase.Fill(Color, Boolean) TftSpiBase.WriteBuffer(Int32, Int32, IPixelBuffer) TftSpiBase.DrawPixel(Int32, Int32, Boolean) TftSpiBase.DrawPixel(Int32, Int32, Color) TftSpiBase.DrawPixel(Int32, Int32, Byte, Byte, Byte) TftSpiBase.InvertPixel(Int32, Int32) TftSpiBase.Fill(Int32, Int32, Int32, Int32, Color) TftSpiBase.Show() TftSpiBase.Show(Int32, Int32, Int32, Int32) TftSpiBase.Write(Byte) TftSpiBase.Write(Byte[]) TftSpiBase.DelayMs(Int32) TftSpiBase.SendCommand(TftSpiBase.Register) TftSpiBase.SendCommand(TftSpiBase.LcdCommand) TftSpiBase.SendCommand(Byte) TftSpiBase.SendData(Int32) TftSpiBase.SendData(Byte) TftSpiBase.SendData(Byte[]) TftSpiBase.Clear(Color)
Namespace	Meadow.Foundation.Displays
Assembly	TftSpi.dll

Syntax

public class Ssd1331 : TftSpiBase, IGraphicsDisplay

Constructors

Ssd1331(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, Int32, Int32)

Create a new Ssd1331 color display object

Declaration

public Ssd1331(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, int width = 96, int height = 64)

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
System.Int32	width	Width of display in pixels
System.Int32	height	Height of display in pixels

Ssd1331(ISpiBus, IPin, IPin, IPin, Int32, Int32)

Create a new Ssd1331 color display object

Declaration

public Ssd1331(ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, int width = 96, int height = 64)

Parameters

Type	Name	Description
ISpiBus	spiBus	SPI bus connected to display
IPin	chipSelectPin	Chip select pin
IPin	dcPin	Data command pin
IPin	resetPin	Reset pin
System.Int32	width	Width of display in pixels
System.Int32	height	Height of display in pixels

Properties

DefautColorMode

The default display color mode

Declaration

public override ColorMode DefautColorMode { get; }

Property Value

Type	Description
ColorMode

Overrides

TftSpiBase.DefautColorMode

SupportedColorModes

The color modes supported by the display

Declaration

public override ColorMode SupportedColorModes { get; }

Property Value

Type	Description
ColorMode

Overrides

TftSpiBase.SupportedColorModes

Methods

Initialize()

Initalize the display

Declaration

protected override void Initialize()

Overrides

TftSpiBase.Initialize()

SetAddressWindow(Int32, Int32, Int32, Int32)

Set addrees window for display updates

Declaration

protected override void SetAddressWindow(int x0, int y0, int x1, int y1)

Parameters

Type	Name	Description
System.Int32	x0	X start in pixels
System.Int32	y0	Y start in pixels
System.Int32	x1	X end in pixels
System.Int32	y1	Y end in pixels

Overrides

TftSpiBase.SetAddressWindow(Int32, Int32, Int32, Int32)