Remarks

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

The ILI9341 is a display controller used to drive color displays over SPI using 12, 16 or 18 bbp. These displays require a backlight. These displays are commonly found with a resolution of 320x240.

The Meadow.Foundation ILI9341 driver currently only supports 16bpp RGB565.

Code Example

MicroGraphics graphics;
Ili9341 display;

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

    var config = new SpiClockConfiguration(new Frequency(12000, 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");

    display = new Ili9341
    (
        spiBus: spiBus,
        chipSelectPin: Device.Pins.D13,
        dcPin: Device.Pins.D14,
        resetPin: Device.Pins.D15,
        width: 240, height: 320
    );

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

    return base.Initialize();
}

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

    graphics.DrawTriangle(10, 30, 50, 50, 10, 50, Meadow.Foundation.Color.Red);
    graphics.DrawRectangle(20, 45, 40, 20, Meadow.Foundation.Color.Yellow, false);
    graphics.DrawCircle(50, 50, 40, Meadow.Foundation.Color.Blue, false);
    graphics.DrawText(5, 5, "Meadow F7", Meadow.Foundation.Color.White);

    graphics.Show();

    DisplayTest();

    return base.Run();
}

Sample project(s) available on GitHub

Wiring Example

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

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

Constructors

Ili9341(ISpiBus, IDigitalOutputPort, IDigitalOutputPort, IDigitalOutputPort, Int32, Int32, ColorMode)

Create a new Ili9341 color display object

Declaration

public Ili9341(ISpiBus spiBus, IDigitalOutputPort chipSelectPort, IDigitalOutputPort dataCommandPort, IDigitalOutputPort resetPort, int width, int height, ColorMode colorMode = default(ColorMode))

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
ColorMode	colorMode	The color mode to use for the display buffer

Ili9341(ISpiBus, IPin, IPin, IPin, Int32, Int32, ColorMode)

Create a new Ili9341 color display object

Declaration

public Ili9341(ISpiBus spiBus, IPin chipSelectPin, IPin dcPin, IPin resetPin, int width, int height, ColorMode colorMode = default(ColorMode))

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
ColorMode	colorMode	The color mode to use for the display buffer

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

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)