Unit FT5x06Touch

Return to Unit Reference

Description

---

EDT FocalTech FT5x06 I2C Touchscreen Driver unit

The EDT FocalTech FT5x06 I2C controllers are a range of capacitive touchscreen controllers that include multipoint touch support and are used by a variety of small LCD displays. The exact features and capability of each device can be found by checking the datasheets which can be obtained online.

This driver is compatible with the following devices:

 edt,edt-ft5206       (5 touch points)
 edt,edt-ft5306       (5 touch points)
 edt,edt-ft5406       (5 touch points)
 edt,edt-ft5506       (10 touch points)
 evervision,ev-ft5726 (10 touch points)
 focaltech,ft6236     (2 touch points)

Constants

---

To be documented

Type definitions

---

FT5x06 registers

PFT5X06Registers = ^TFT5X06Registers;

TFT5X06Registers = record

Threshold:Byte;
ReportRate:Byte;
Gain:Byte;
Offset:Byte;
OffsetX:Byte;
OffsetY:Byte;
NumX:Byte;
NumY:Byte;

FT5x06 parameters

PFT5X06Parameters = ^TFT5X06Parameters;

TFT5X06Parameters = record

Threshold:Byte;
ReportRate:Byte;
Gain:Byte;
Offset:Byte;
OffsetX:Byte;
OffsetY:Byte;
NumX:Byte;
NumY:Byte;

FT5x06 touch

PFT5X06Touch = ^TFT5X06Touch;

TFT5X06Touch = record

Touch Properties
Touch:TTouchDevice;
I2C Properties
I2C:PI2CDevice;	The I2C device this device is connected to
Address:Word;	The I2C address of the device
General Properties
IRQ:TGPIOInfo;	The GPIO information for the IRQ line (Optional)
RST:TGPIOInfo;	The GPIO information for the Reset line (Optional)
Timer:TTimerHandle;	Handle for touch release timer
MaxX:Word;	Maximum X value from current configuration
MaxY:Word;	Maximum Y value from current configuration
Width:Word;	Screen width value supplied during create
Height:Word;	Screen height value supplied during create
MaxPoints:LongWord;	Maximum touch points for this device
LastPoints:LongWord;	Points reported in last input report
FT5x06 Properties
Version:LongWord;	Version constant for this device (eg FT5X06_EDT_M06)
ModelName:String;	Model name string for this device
FirmwareVersion:String;	Firmware version string for this device
Registers:TFT5X06Registers;	Register addresses for this device
Parameters:TFT5X06Parameters;	Configuration parameters for this device
SwapReportXY:Boolean;	If True swap the X and Y values in the input report
InvertReportX:Boolean;	If True invert the X value in the input report
InvertReportY:Boolean;	If True invert the Y value in the input report

Public variables

---

To be documented

Function declarations

---

Initialization functions

procedure FT5X06Init;

Description: Initialize the FT5x06 Touch unit and parameters

Note	Called internally by other functions

FT5x06 functions

function FT5X06TouchCreate(I2C:PI2CDevice; Address:Word; Width,Height:LongWord; IRQ,RST:PGPIOInfo):PTouchDevice;

Description: Create, register and start a new FT5x06 Touch device connected to the specified I2C device

I2C	The I2C device this FT5x06 Touch device is connected to
Address	The I2C address for this FT5x06 Touch device
Width	The width of the screen in pixels (When set at TOUCH_ROTATION_0)
Height	The height of the screen in pixels (When set at TOUCH_ROTATION_0)
IRQ	The GPIO information for the IRQ line (Optional)
Return	Pointer to the new Touch device or nil on failure

function FT5X06TouchDestroy(Touch:PTouchDevice):LongWord;

Description: Stop, deregister and destroy a FT5x06 Touch device created by this driver

Touch	The Touch device to destroy
Return	ERROR_SUCCESS if completed or another error code on failure

FT5x06 touch functions

function FT5X06TouchStart(Touch:PTouchDevice):LongWord;

Description: Implementation of TouchDeviceStart API for FT5x06 Touch device

Note	Not intended to be called directly by applications, use TouchDeviceStart instead.

function FT5X06TouchStop(Touch:PTouchDevice):LongWord;

Description: Implementation of TouchDeviceStop API for FT5x06 Touch device

Note	Not intended to be called directly by applications, use TouchDeviceStop instead.

function FT5X06TouchUpdate(Touch:PTouchDevice):LongWord;

Description: Implementation of TouchDeviceUpdate API for FT5x06 Touch device

Note	Not intended to be called directly by applications, use TouchDeviceUpdate instead.

procedure FT5X06TouchTimer(Touch:PFT5X06Touch);

Description: Touch device timer event handler for FT5x06 Touch device

Note	Not intended to be called directly by applications

procedure FT5X06TouchCallback(Touch:PFT5X06Touch; Pin,Trigger:LongWord);

Description: Touch device event callback (Interrupt) handler for FT5x06 Touch device

Note	Not intended to be called directly by applications

Return to Unit Reference