Remarks

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

Code Example

MicroGraphics graphics;

public override Task Initialize()
{
    Console.WriteLine("Initializing...");

    var sT7565 = new St7565
    (
        device: Device,
        spiBus: Device.CreateSpiBus(),
        chipSelectPin: Device.Pins.D02,
        dcPin: Device.Pins.D00,
        resetPin: Device.Pins.D01,
        width: 128,
        height: 64
    );

    graphics = new MicroGraphics(sT7565);
    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, true);
    graphics.DrawText(5, 5, "ST7565");
    graphics.Show();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

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

ST7565	Meadow Pin
LEDA	GND
GND	GND
VCC	3V3
SDA	MOSI
SCL	SCK
A0	D00
RST	D01
CS	D02

Characteristic	Locus
Inheritance	System.Object > St7565
Implements	IGraphicsDisplay
Namespace	Meadow.Foundation.Displays
Assembly	St7565.dll

Syntax

public class St7565 : object, IGraphicsDisplay

Constructors

St7565(IMeadowDevice, ISpiBus, IPin, IPin, IPin, Int32, Int32)

Create a new ST7565 object

Declaration

public St7565(IMeadowDevice device, ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, int width = 128, int height = 64)

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

St7565(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, Int32, Int32)

Create a new St7565 display object

Declaration

public St7565(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, int width = 128, 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

Properties

ColorMode

The display color mode - 1 bit per pixel monochrome

Declaration

public ColorType ColorMode { get; }

Property Value

Type	Description
ColorType

Height

The display height in pixels

Declaration

public int Height { get; }

Property Value

Type	Description
System.Int32

PixelBuffer

The buffer the holds the pixel data for the display

Declaration

public IPixelBuffer PixelBuffer { get; }

Property Value

Type	Description
IPixelBuffer

Width

The display width in pixels

Declaration

public int Width { get; }

Property Value

Type	Description
System.Int32

Methods

Clear(Boolean)

Clear the display buffer

Declaration

public void Clear(bool updateDisplay = false)

Parameters

Type	Name	Description
System.Boolean	updateDisplay	Immediately update the display when true

DrawPixel(Int32, Int32, Color)

Draw pixel at a location

Declaration

public void DrawPixel(int x, int y, Color color)

Parameters

Type	Name	Description
System.Int32	x	Abscissa of the pixel to the set / reset
System.Int32	y	Ordinate of the pixel to the set / reset
Color	color	Any color = turn on pixel, black = turn off pixel

DrawPixel(Int32, Int32, Boolean)

Draw pixel at a location

Declaration

public void DrawPixel(int x, int y, bool enabled)

Parameters

Type	Name	Description
System.Int32	x	Abscissa of the pixel to the set / reset
System.Int32	y	Ordinate of the pixel to the set / reset
System.Boolean	enabled	True = turn on pixel, false = turn off pixel

Fill(Color, Boolean)

Fill display buffer with a color

Declaration

public void Fill(Color clearColor, bool updateDisplay = false)

Parameters

Type	Name	Description
Color	clearColor	The fill color
System.Boolean	updateDisplay	If true, update display

Fill(Int32, Int32, Int32, Int32, Color)

Fill with a color

Declaration

public void Fill(int x, int y, int width, int height, Color color)

Parameters

Type	Name	Description
System.Int32	x	X start position in pixels
System.Int32	y	Y start position in pixels
System.Int32	width	Width in pixels
System.Int32	height	Height in pixels
Color	color	The fill color

InvertDisplay(Boolean)

Invert the entire display (true) or return to normal mode (false).

Declaration

public void InvertDisplay(bool cmd)

Parameters

Type	Name	Description
System.Boolean	cmd

InvertPixel(Int32, Int32)

Invert a pixel at a location

Declaration

public void InvertPixel(int x, int y)

Parameters

Type	Name	Description
System.Int32	x	Abscissa of the pixel to the set / reset
System.Int32	y	Ordinate of the pixel to the set / reset

PowerSaveMode()

Set display into power saving mode

Declaration

public void PowerSaveMode()

SetContrast(Byte)

Set the display contrast

Declaration

public void SetContrast(byte contrast)

Parameters

Type	Name	Description
System.Byte	contrast	The contrast value (0-63)

Show()

Send the internal pixel buffer to display

Declaration

public void Show()

Show(Int32, Int32, Int32, Int32)

Update a region of the display from the offscreen buffer

Declaration

public void Show(int left, int top, int right, int bottom)

Parameters

Type	Name	Description
System.Int32	left	Left bounds in pixels
System.Int32	top	Top bounds in pixels
System.Int32	right	Right bounds in pixels
System.Int32	bottom	Bottom bounds in pixels

StartScrolling(St7565.ScrollDirection)

Start the display scrollling in the specified direction.

Declaration

public void StartScrolling(St7565.ScrollDirection direction)

Parameters

Type	Name	Description
St7565.ScrollDirection	direction	Direction that the display should scroll

StartScrolling(St7565.ScrollDirection, Byte, Byte)

Start the display scrolling

Declaration

public void StartScrolling(St7565.ScrollDirection direction, byte startPage, byte endPage)

Parameters

Type	Name	Description
St7565.ScrollDirection	direction	Direction that the display should scroll
System.Byte	startPage	Start page for the scroll
System.Byte	endPage	End oage for the scroll

Remarks

In most cases setting startPage to 0x00 and endPage to 0xff will achieve an acceptable scrolling effect

StopScrolling()

Turn off scrolling

Declaration

public void StopScrolling()

Remarks

Datasheet states that scrolling must be turned off before changing the scroll direction in order to prevent RAM corruption

WriteBuffer(Int32, Int32, IPixelBuffer)

Write a buffer to the display offscreen buffer

Declaration

public void WriteBuffer(int x, int y, IPixelBuffer displayBuffer)

Parameters

Type	Name	Description
System.Int32	x	The x position in pixels to write the buffer
System.Int32	y	The y position in pixels to write the buffer
IPixelBuffer	displayBuffer	The buffer to write