Return to Unit Reference
Description
Sitronix ST77XX TFT LCD Driver unit
The ST77XX is a family of single-chip controllers/drivers for color, graphic type TFT-LCD display.
Instantiate the ST77XX driver by calling ST77XXFramebufferCreate() with the required parameters:
SPI: The SPI device that this ST77XX is connected to
ChipSelect: The SPI chip select to use when communicating with this device
Name: The text description of this device which will show in the device list (Optional)
Rotation: The rotation value for the framebuffer device (eg FRAMEBUFFER_ROTATION_180)
Width: The width of the framebuffer in pixels
Height: The height of the framebuffer in pixels
ColStart:
RST: GPIO pin information for the Reset pin (Optional)
DC: GPIO pin information for the Data/Command pin
BL: GPIO pin information for the Backlight pin (Optional)
Constants
[Expand]
ST77XX specific constants ST77XX_*
ST77XX_FRAMEBUFFER_DESCRIPTION = 'ST77XX TFT LCD DRIVER';
|
Description of ST77XX device
|
[Expand]
ST77XX SPI ST77XX_SPI_*
ST77XX_SPI_RATE = 32000000;
|
Default SPI clock rate
|
ST_CMD_DELAY = $80;
|
Special signifier for command lists
|
[Expand]
ST77XX control command ST77XX_*
ST77XX_NOP = $00;
|
8.2.1. NOP: No Operation
|
ST77XX_SWRESET = $01;
|
8.2.2. SWRESET: Software Reset
|
ST77XX_RDDID = $04;
|
new_cmd
|
ST77XX_RDDST = $09;
|
new_cmd
|
|
|
ST77XX_SLPIN = $10;
|
new_cmd
|
ST77XX_SLPOUT = $11;
|
8.2.12. SLPOUT: Sleep Out (This command turns off sleep mode)
|
ST77XX_PTLON = $12;
|
new_cmd
|
ST77XX_NORON = $13;
|
new_cmd
|
|
|
ST77XX_INVOFF = $20;
|
new_cmd
|
ST77XX_INVON = $21;
|
new_cmd
|
ST77XX_GAMSET = $26;
|
8.2.17. GAMSET: Gamma Set (This command is used to select the desired Gamma curve for the current display)
|
ST77XX_DISPOFF = $28;
|
8.2.18. DISPOFF: Display OFF (This command is used to enter into DISPLAY OFF mode. In this mode, the output from Frame Memory is disabled and blank page inserted)
|
ST77XX_DISPON = $29;
|
8.2.19. DISPON: Display ON (This command is used to recover from DISPLAY OFF mode. Output from the Frame Memory is enabled)
|
ST77XX_CASET = $2A;
|
8.2.20. CASET: Column Address Set (This command is used to define area of frame memory where MCU can access)
|
ST77XX_RASET = $2B;
|
8.2.21. PASET: Page Address Set (This command is used to define area of frame memory where MCU can access)
|
ST77XX_RAMWR = $2C;
|
8.2.22. Memory Write (This command is used to transfer data from MCU to frame memory)
|
ST77XX_RGBSET = $2D;
|
Color setting for 4096, 64K and 262K colors
|
ST77XX_RAMRD = $2E;
|
new_cmd
|
|
|
ST77XX_RDDPM = $0A;
|
Read display power mode
|
ST77XX_RDD_MADCTL = $0B;
|
Read display MADCTL
|
ST77XX_RDD_COLMOD = $0C;
|
Read display pixel format
|
ST77XX_RDDIM = $0D;
|
Read display image mode
|
ST77XX_RDDSM = $0E;
|
Read display signal mode
|
ST77XX_RDDSR = $0F;
|
Read display self-diagnostic result (ST7789V)
|
|
|
ST77XX_PTLAR = $30;
|
new_cmd
|
ST77XX_VSCRDEF = $33;
|
Vertical scrolling definition (ST7789V)
|
ST77XX_TEOFF = $34;
|
Tearing effect line off
|
ST77XX_TEON = $35;
|
Tearing effect line on
|
ST77XX_MADCTL = $36;
|
8.2.29. MADCTL: Memory Access Control (This command defines read/write scanning direction of frame memory)
|
ST77XX_IDMOFF = $38;
|
Idle mode off
|
ST77XX_IDMON = $39;
|
Idle mode on
|
ST77XX_RAMWRC = $3C;
|
Memory write continue (ST7789V)
|
ST77XX_RAMRDC = $3E;
|
Memory read continue (ST7789V)
|
ST77XX_COLMOD = $3A;
|
8.2.33. COLMOD: Pixel Format Set (This command sets the pixel format for the RGB image data used by the interface)
|
[Expand]
ST77XX memory access control ST77XX_*CTL_*
| See ST77XX datasheet 8.2.29. Memory Access Control
|
ST77XX_MADCTL_MY = $80;
|
Row Address Order
|
ST77XX_MADCTL_MX = $40;
|
Column Address Order
|
ST77XX_MADCTL_MV = $20;
|
Row / Column Exchange
|
ST77XX_MADCTL_ML = $10;
|
Row / Column Exchange
|
ST77XX_MADCTL_MH = $04;
|
Horizontal Refresh Order
|
ST77XX_MADCTL_RGB = $00;
|
Colour selector switch control (0=RGB colour filter panel, 1=BGR colour filter panel)
|
ST77XX_MADCTL_BGR = $08;
|
|
|
|
ST77XX_RAMCTRL = $B0;
|
RAM control
|
ST77XX_RGBCTRL = $B1;
|
RGB control
|
ST77XX_PORCTRL = $B2;
|
Porch control
|
ST77XX_FRCTR1 = $B3;
|
8.3.2. FRCTR1: Frame Rate Control (In Normal Mode/Full Colors)
|
ST77XX_PARCTRL = $B5;
|
Partial mode control
|
ST77XX_GCTRL = $B7;
|
Gate control
|
ST77XX_GTADJ = $B8;
|
Gate on timing adjustment
|
ST77XX_DGMEN = $BA;
|
Digital gamma enable
|
ST77XX_VCOMS = $BB;
|
VCOMS setting
|
ST77XX_DISCTRL = $B6;
|
8.3.7. DISCTRL: Display Function Control
|
|
|
ST77XX_LCMCTRL = $C0;
|
LCM control
|
ST77XX_IDSET = $C1;
|
ID setting
|
ST77XX_VDVVRHEN = $C2;
|
VDV and VRH command enable
|
ST77XX_VRHS = $C3;
|
VRH set
|
ST77XX_VDVSET = $C4;
|
VDV setting
|
ST77XX_VCMOFSET = $C5;
|
VCOMS offset set
|
ST77XX_FRCTR2 = $C6;
|
FR Control 2
|
ST77XX_CABCCTRL = $C7;
|
CABC control
|
ST77XX_REGSEL1 = $C8;
|
Register value section 1
|
ST77XX_REGSEL2 = $CA;
|
Register value section 2
|
ST77XX_PWMFRSEL = $CC;
|
PWM frequency selection
|
|
|
ST77XX_PWCTRL1 = $D0;
|
8.3.16. PWCTRL1: Power Control 1
|
ST77XX_VAPVANEN = $D2;
|
Enable VAP/VAN signal output
|
ST77XX_CMD2EN = $DF;
|
Command 2 enable
|
|
|
ST77XX_VMCTRL1 = $C5;
|
8.3.21. VMCTRL1: VCOM Control 1
|
ST77XX_VMCTRL2 = $C7;
|
8.3.22. VMCTRL2: VCOM Control 2
|
|
|
ST77XX_PGAMCTRL = $E0;
|
Positive voltage gamma control
|
ST77XX_NGAMCTRL = $E1;
|
Negative voltage gamma control
|
ST77XX_DGMLUTR = $E2;
|
Digital gamma look-up table for red
|
ST77XX_DGMLUTB = $E3;
|
Digital gamma look-up table for blue
|
ST77XX_GATECTRL = $E4;
|
Gate control
|
ST77XX_SPI2EN = $E7;
|
SPI2 enable
|
ST77XX_PWCTRL2 = $E8;
|
Power control 2
|
ST77XX_EQCTRL = $E9;
|
Equalize time control
|
ST77XX_PROMCTRL = $EC;
|
Program control
|
|
|
ST77XX_PROMEN = $FA;
|
Program mode enable
|
ST77XX_NVMSET = $FC;
|
NVM setting
|
ST77XX_PROMACT = $FE;
|
Program action
|
|
|
ST77XX_COLOR_MODE_16bit =$55;
|
|
ST77XX_COLOR_MODE_18bit =$66;
|
|
Type definitions
ST77XX specific types
[Expand]
PST77XXFramebuffer = ^TST77XXFramebuffer;
TST77XXFramebuffer = record
| TFT Properties
|
TFT:TTFTFramebuffer;
|
|
Public variables
None defined
Function declarations
ST77XX functions
[Expand]
function ST77XXFramebufferCreate(SPI:PSPIDevice; ChipSelect:Word; const Name:String; Rotation,Width,Height,ColStart:LongWord; RST,DC,BL:PGPIOInfo):PFramebufferDevice;
Description: Create, register and allocate a new ST77XX Framebuffer device which can be accessed using the framebuffer API
| SPI
|
The SPI device that this ST77XX is connected to
|
| ChipSelect
|
The SPI chip select to use when communicating with this device
|
| Name
|
The text description of this device which will show in the device list (Optional)
|
| Rotation
|
The rotation value for the framebuffer device (eg FRAMEBUFFER_ROTATION_180)
|
| Width
|
The width of the framebuffer in pixels
|
| Height
|
The height of the framebuffer in pixels
|
| RST
|
GPIO pin information for the Reset pin (Optional)
|
| DC
|
GPIO pin information for the Data/Command pin
|
| BL
|
GPIO pin information for the Backlight pin (Optional)
|
| Return
|
Pointer to the new Framebuffer device or nil if the framebuffer device could not be created
|
[Expand]
function ST77XXFramebufferDestroy(Framebuffer:PFramebufferDevice):LongWord;
Description: Release, deregister and destroy an ST77XX Framebuffer device created by this driver
| Framebuffer
|
The Framebuffer device to destroy
|
| Return
|
ERROR_SUCCESS if completed or another error code on failure
|
ST77XX framebuffer functions
[Expand]
function ST77XXFramebufferBlank(Framebuffer:PFramebufferDevice; Blank:Boolean):LongWord;
Description: Implementation of FramebufferDeviceBlank API for ST77XX
| Note
|
Not intended to be called directly by applications, use FramebufferDeviceBlank instead
|
[Expand]
function ST77XXFramebufferSetBacklight(Framebuffer:PFramebufferDevice; Brightness:LongWord):LongWord;
Description: Implementation of FramebufferDeviceSetBacklight API for ST77XX
| Note
|
Not intended to be called directly by applications, use FramebufferDeviceSetBacklight instead
|
ST77XX TFTFramebuffer functions
[Expand]
function ST77XXTFTFramebufferInitialize(Framebuffer:PTFTFramebuffer; Defaults:PFramebufferProperties):LongWord;
Description: Implementation of TFTFramebufferInitialize API for ST77XX
| Note
|
Not intended to be called directly by applications
|
[Expand]
function ST77XXTFTFramebufferDeinitialize(Framebuffer:PTFTFramebuffer):LongWord;
Description: Implementation of TFTFramebufferDeinitialize API for ST77XX
| Note
|
Not intended to be called directly by applications
|
[Expand]
function ST77XXTFTFramebufferGetDefaults(Framebuffer:PTFTFramebuffer; Properties,Defaults:PFramebufferProperties):LongWord;
Description: Implementation of TFTFramebufferGetDefaults API for ST77XX
| Note
|
Not intended to be called directly by applications
|
[Expand]
function ST77XXTFTFramebufferSetWriteAddress(Framebuffer:PTFTFramebuffer; X1,Y1,X2,Y2:LongWord):LongWord;
Description: Implementation of TFTFramebufferSetWriteAddress API for ST77XX
| Note
|
Not intended to be called directly by applications
|
[Expand]
function ST77XXTFTFramebufferWriteMemory(Framebuffer:PTFTFramebuffer; Address:PtrUInt; Size:LongWord):LongWord;
Description: Implementation of TFTFramebufferWriteMemory API for ST77XX
| Note
|
Not intended to be called directly by applications
|
ST77XX helper functions
[Expand]
function ST77XXWriteCommand(Framebuffer:PTFTFramebuffer; Value:Byte):LongWord;
Description: Write a single command value to the ST77XX
[Expand]
function ST77XXWriteCommandEx(Framebuffer:PTFTFramebuffer; const Values:array of Byte):LongWord;
Description: Write multiple command values to the ST77XX
[Expand]
function ST77XXWriteData(Framebuffer:PTFTFramebuffer; Value:Byte):LongWord;
Description: Write a single data value to the ST77XX
[Expand]
function ST77XXWriteDataEx(Framebuffer:PTFTFramebuffer; const Values:array of Byte):LongWord;
Description: Write multiple data values to the ST77XX
Return to Unit Reference
