Unit IPSTFT19

Return to Unit Reference

Description

---

Adafruit 1.9" 320x170 Color IPS TFT Display LCD Driver unit

Adafruit 1.9" 320x170 Color IPS TFT display has 320x170 16-bit full-color pixels and is an IPS display, so the color looks great up to 80 degrees off-axis in any direction.

The TFT driver (Sitronix ST7789) is very similar to the popular ST7735.

Details:

ST7789

Width: 170 Height: 320

SPI Mode: 0 SPI Frequency: 42000000 SPI Chip Select: SPI_CS_0

DC GPIO: GPIO_PIN_25 (Pull: GPIO_PULL_NONE) RST GPIO: GPIO_PIN_27 (Pull: GPIO_PULL_NONE)

Backlight GPIO: GPIO_PIN_18 (GPIO / PWM)

Constants

---

[Expand]

IPSTFT19 specific constants IPSTFT19_*

IPSTFT19_FRAMEBUFFER_DESCRIPTION = 'Adafruit 1.9" IPS TFT';	Description of IPSTFT19 device
IPSTFT19_SIGNATURE = $AF000019;
IPSTFT19_SCREEN_WIDTH = 170;
IPSTFT19_SCREEN_HEIGHT = 320;
IPSTFT19_COLSTART = 35;
IPSTFT19_DEFAULT_ROTATION = FRAMEBUFFER_ROTATION_90;

[Expand]

IPSTFT19 GPIO IPSTFT19_LCD_*

IPSTFT19_LCD_DC = GPIO_PIN_25;
IPSTFT19_LCD_RST = GPIO_PIN_27;
IPSTFT19_LCD_BL = GPIO_PIN_18;

Type definitions

---

IPSTFT19 specific types

[Expand]

PIPSTFT19LCD = ^TIPSTFT19LCD;

TIPSTFT19LCD = record

Signature:LongWord;	Signature for entry validation
Rotation:LongWord;	Framebuffer rotation (eg FRAMEBUFFER_ROTATION_180)
SPI:PSPIDevice;	SPI device for this display
GPIO:PGPIODevice;	GPIO device for this display
Framebuffer:PFramebufferDevice;	Framebuffer (ST7789) device for this display

Public variables

---

IPSTFT19 specific variables

IPSTFT19_SPI_DEVICE:String = 'SPI0';

IPSTFT19_LCD_CHIPSELECT:Word = SPI_CS_0;

IPSTFT19_BL_PWM_ENABLE:LongBool = True;

Function declarations

---

Initialization functions

[Expand]

procedure IPSTFT19Init;

Description: Initialize the IPSTFT19 unit and parameters

Note	Called only during system startup

[Expand]

function IPSTFT19Start(Rotation:LongWord; const Device:String; DisplaySelect:word):THandle;

Description: Start the IPSTFT19 driver and Framebuffer device associated with the display

Rotation	The rotation of the display (eg FRAMEBUFFER_ROTATION_180)
Device	The SPI device that the ST7789 device is connected to
DisplaySelect	The SPI chip select of the ST7789 LCD controller
Return	The handle of the IPSTFT19 on success or INVALID_HANDLE_VALUE on failure
Note	This function will be called during startup if the parameter IPSTFT19_AUTOSTART is True. Can be called multiple times to support more than one IPSTFT LCD display.

[Expand]

function IPSTFT19Stop(Handle:THandle):Boolean;

Description: Stop the IPSTFT19 driver and Framebuffer device associated with the display

Handle	The handle of the IPSTFT19 or INVALID_HANDLE_VALUE for the default display
Return	True if completed or False on failure

Return to Unit Reference