Remarks

Ssd1351
Status Status badge: working
Source code GitHub
Datasheet(s) GitHub
NuGet package NuGet Gallery for Meadow.Foundation.Displays.TftSpi

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

Code Example

MicroGraphics graphics;

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

    var spiBus = Device.CreateSpiBus(Ssd1351.DefaultSpiBusSpeed);

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

    graphics = new MicroGraphics(display)
    {
        CurrentFont = new Font8x12(),
        IgnoreOutOfBoundsPixels = true
    };

    return base.Initialize();
}

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

    graphics.DrawCircle(80, 80, 40, Meadow.Foundation.Color.Cyan, false);

    int indent = 0;
    int spacing = 10;
    int y = indent;

    graphics.DrawText(indent, y, "Meadow F7 (SSD1351)");

    graphics.DrawText(indent, y += spacing, "Red", Meadow.Foundation.Color.Red);
    graphics.DrawText(indent, y += spacing, "Purple", Meadow.Foundation.Color.Purple);
    graphics.DrawText(indent, y += spacing, "BlueViolet", Meadow.Foundation.Color.BlueViolet);
    graphics.DrawText(indent, y += spacing, "Blue", Meadow.Foundation.Color.Blue);
    graphics.DrawText(indent, y += spacing, "Cyan", Meadow.Foundation.Color.Cyan);
    graphics.DrawText(indent, y += spacing, "LawnGreen", Meadow.Foundation.Color.LawnGreen);
    graphics.DrawText(indent, y += spacing, "GreenYellow", Meadow.Foundation.Color.GreenYellow);
    graphics.DrawText(indent, y += spacing, "Yellow", Meadow.Foundation.Color.Yellow);
    graphics.DrawText(indent, y += spacing, "Orange", Meadow.Foundation.Color.Orange);
    graphics.DrawText(indent, y += spacing, "Brown", Meadow.Foundation.Color.Brown);

    graphics.Show();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

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

Ssd1351 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 > Ssd1351
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 Ssd1351 : TftSpiBase, IGraphicsDisplay

Constructors

Ssd1351(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, Int32, Int32)

Create a new Ssd1351 color display object

Declaration
public Ssd1351(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, int width, int height)

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

Ssd1351(ISpiBus, IPin, IPin, IPin, Int32, Int32)

Create a new Ssd1351 color display object

Declaration
public Ssd1351(ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, int width, int height)

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

Fields

DefaultSpiBusSpeed

The default SPI bus frequency

Declaration
public static Frequency DefaultSpiBusSpeed

Field Value

Type Description
Frequency

Properties

DefautColorMode

The default display color mode

Declaration
public override ColorMode DefautColorMode { get; }

Property Value

Type Description
ColorMode

Overrides

SupportedColorModes

The color modes supported by the display

Declaration
public override ColorMode SupportedColorModes { get; }

Property Value

Type Description
ColorMode

Overrides

Methods

Initialize()

Initialize the display

Declaration
protected override void Initialize()

Overrides

InvertDisplay(Boolean)

Invert the display

Declaration
public void InvertDisplay(bool invert)

Parameters

Type Name Description
System.Boolean invert

SetAddressWindow(Int32, Int32, Int32, Int32)

Set address window to update

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

Parameters

Type Name Description
System.Int32 x0

Start x position in pixels

System.Int32 y0

End x position in pixels

System.Int32 x1

Start y position in pixels

System.Int32 y1

End y position in pixels

Overrides