Remarks

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

The IL91874 is a tri-color display controller for ePaper displays. Data is sent to the controller via SPI and supports partial screen updates.

The IL91874 is commonly paired with a 2.7" 264x176 three color ePaper display.

Sample projects available on GitHub

Code Example

MicroGraphics graphics;

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

    var display = new Il91874(
        spiBus: Device.CreateSpiBus(),
        chipSelectPin: Device.Pins.A04,
        dcPin: Device.Pins.A03,
        resetPin: Device.Pins.A02,
        busyPin: Device.Pins.A01,
        width: 176,
        height: 264);

    graphics = new MicroGraphics(display);

    return Task.CompletedTask;
}

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

    graphics.Clear();

    graphics.DrawRectangle(10, 40, 120, 60, Color.Black, true);
    graphics.DrawRectangle(20, 80, 120, 90, Color.Red, true);

    graphics.CurrentFont = new Font12x16();
    graphics.DrawText(2, 20, "Meadow F7", Color.Black);
    graphics.DrawText(30, 50, "Color", Color.Red);
    graphics.DrawText(50, 90, "Black", Color.Black);
    graphics.DrawText(50, 120, "White", Color.White);

    graphics.Show();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

To control a IL91874 from Meadow, connect the following:

IL91874	Meadow Pin
BUSY	D15
RST	D14
DC	D13
CS	D12
CLK	SCK
DIN	MOSI
GND	GND
VCC	3V3

If your display does not include any of the above pins, they can be omitted. Pass NULL into the constructor for the missing pin(s).

Characteristic	Locus
Inheritance	System.Object EPaperBase EPaperTriColorBase > Il91874 > Epd2in7b
Implements	IGraphicsDisplay
Inherited Members	EPaperTriColorBase.EnabledColor EPaperTriColorBase.DisabledColor EPaperTriColorBase.ColorMode EPaperTriColorBase.SupportedColorModes EPaperTriColorBase.imageBuffer EPaperTriColorBase.Width EPaperTriColorBase.Height EPaperTriColorBase.PixelBuffer EPaperTriColorBase.CreateBuffer(Int32, Int32) EPaperTriColorBase.Clear(Boolean) EPaperTriColorBase.Fill(Color, Boolean) EPaperTriColorBase.Fill(Int32, Int32, Int32, Int32, Color) EPaperTriColorBase.Clear(Boolean, Boolean) EPaperTriColorBase.DrawPixel(Int32, Int32, Boolean) EPaperTriColorBase.DrawBlackPixel(Int32, Int32, Boolean) EPaperTriColorBase.InvertPixel(Int32, Int32) EPaperTriColorBase.DrawColoredPixel(Int32, Int32, Boolean) EPaperTriColorBase.DrawPixel(Int32, Int32, Color) EPaperTriColorBase.WriteBuffer(Int32, Int32, IPixelBuffer) EPaperTriColorBase.SendCommand(EPaperTriColorBase.Command) EPaperBase.commandBuffer EPaperBase.dataCommandPort EPaperBase.resetPort EPaperBase.chipSelectPort EPaperBase.busyPort EPaperBase.spiPeripheral EPaperBase.DataState EPaperBase.CommandState EPaperBase.Write(Byte) EPaperBase.Reset() EPaperBase.DelayMs(Int32) EPaperBase.SendCommand(Byte) EPaperBase.SendData(Int32) EPaperBase.SendData(Byte) EPaperBase.SendData(Byte[]) EPaperBase.WaitUntilIdle()
Namespace	Meadow.Foundation.Displays
Assembly	EPaper.dll

Syntax

public class Il91874 : EPaperTriColorBase, IGraphicsDisplay

Constructors

Il91874(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, IDigitalInputPort, Int32, Int32)

Create a new Il91874 ePaper display object

Declaration

public Il91874(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, IDigitalInputPort busyPort, 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
IDigitalInputPort	busyPort	Busy input port
System.Int32	width	Width of display in pixels
System.Int32	height	Height of display in pixels

Il91874(ISpiBus, IPin, IPin, IPin, IPin, Int32, Int32)

Create a new Il91874 object

Declaration

public Il91874(ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, IPin busyPin, int width = 176, int height = 264)

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

Properties

IsBlackInverted

Does the display invert data for black pixels

Declaration

protected override bool IsBlackInverted { get; }

Property Value

Type	Description
System.Boolean

Overrides

EPaperTriColorBase.IsBlackInverted

IsColorInverted

Does the display invert data for color pixels

Declaration

protected override bool IsColorInverted { get; }

Property Value

Type	Description
System.Boolean

Overrides

EPaperTriColorBase.IsColorInverted

Methods

ClearFrame()

Declaration

public void ClearFrame()

DisplayFrame()

Declaration

public void DisplayFrame()

Initialize()

Initalize the display

Declaration

protected override void Initialize()

Overrides

EPaperTriColorBase.Initialize()

Show()

Update the display from the offscreen buffer

Declaration

public override void Show()

Overrides

EPaperTriColorBase.Show()

Show(Int32, Int32, Int32, Int32)

Update a region of the display from the offscreen buffer

Declaration

public override 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

Overrides

EPaperTriColorBase.Show(Int32, Int32, Int32, Int32)

Sleep()

Declaration

public void Sleep()