Difference between revisions of "Unit RPIFT5406"

From Ultibo.org
Jump to: navigation, search
Line 59: Line 59:
 
----
 
----
  
−
''To be documented''
+
 
 +
'''RPiFT5406 touch point'''
 +
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PRPiFT5406TouchPoint = ^TRPiFT5406TouchPoint;</code>
 +
 
 +
<code>TRPiFT5406TouchPoint = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
| <code>xh:Byte;</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
| <code>xl:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>yh:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>yl:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>res1:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>res2:Byte;</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div>
 +
 
 +
'''RPiFT5406 registers'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PRPiFT5406Registers = ^TRPiFT5406Registers;</code>
 +
 
 +
<code>TRPiFT5406Registers = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
| <code>DeviceMode:Byte;</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
| <code>GestureId:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>NumPoints:Byte;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Point:array[0..RPIFT5406_MAX_POINTS - 1] of TRPiFT5406TouchPoint;</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div> 
 +
 
 +
'''RPiFT5406 touch'''
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="border: 1; font-family: arial;">
 +
<code>PRPiFT5406Touch = ^TRPiFT5406Touch;</code>
 +
 
 +
<code>TRPiFT5406Touch = record</code>
 +
<div class="mw-collapsible-content" style="text-align: left; padding-left: 5px;">
 +
{| class="wikitable" style="font-size: 14px; background: white;"
 +
|-
 +
|colspan="2"|''Touch Properties''
 +
|-
 +
| <code>Touch:TTouchDevice;</code>
 +
| style="width: 50%;"|&nbsp;
 +
|-
 +
|colspan="2"|''RPiFT5406 Properties''
 +
|-
 +
| <code>Thread:TThreadHandle;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Terminate:Boolean;</code>
 +
| &nbsp;
 +
|-
 +
| <code>Registers:PRPiFT5406Registers;</code>
 +
| &nbsp;
 +
|-
 +
|}
 +
</div></div>
 +
<br />
  
 
=== Public variables ===
 
=== Public variables ===

Revision as of 03:14, 25 January 2017

Return to Unit Reference


Description

Raspberry Pi FT5406 Touch Driver unit

This is the touchscreen driver for the Official Raspberry Pi 7" Touchscreen. While this device uses a FocalTech FT5406 10 point capactive touchscreen controller it is actually connected to the GPU and not directly accessible to the ARM processor.

In order to make the touchscreen data available the GPU provides a memory based interface that can be read by polling an address returned from a mailbox call.

The Linux driver uses a thread to poll the data approximately 60 times per second so this driver does something similar.

Constants


RPiFT5406 specific constants RPIFT5406_*
RPIFT5406_TOUCH_DESCRIPTION = 'Raspberry Pi FT5406 Touch Controller'; Description of RPiFT5406 Touch device
 
RPIFT5406_THREAD_NAME = 'RPiFT5406 Touch'; Name of the RPiFT5406 Touch polling thread
 
RPIFT5406_MAX_POINTS = 10;  
RPIFT5406_MAX_X = $FFF;  
RPIFT5406_MAX_Y = $FFF;  
RPIFT5406_MAX_Z = 0;  
 
RPIFT5406_SCREEN_WIDTH = 800;  
RPIFT5406_SCREEN_HEIGHT = 480;  


Type definitions


RPiFT5406 touch point

PRPiFT5406TouchPoint = ^TRPiFT5406TouchPoint;

TRPiFT5406TouchPoint = record

xh:Byte;  
xl:Byte;  
yh:Byte;  
yl:Byte;  
res1:Byte;  
res2:Byte;  

RPiFT5406 registers

PRPiFT5406Registers = ^TRPiFT5406Registers;

TRPiFT5406Registers = record

DeviceMode:Byte;  
GestureId:Byte;  
NumPoints:Byte;  
Point:array[0..RPIFT5406_MAX_POINTS - 1] of TRPiFT5406TouchPoint;  

RPiFT5406 touch

PRPiFT5406Touch = ^TRPiFT5406Touch;

TRPiFT5406Touch = record

Touch Properties
Touch:TTouchDevice;  
RPiFT5406 Properties
Thread:TThreadHandle;  
Terminate:Boolean;  
Registers:PRPiFT5406Registers;  


Public variables

None defined

Function declarations


Initialization functions 

procedure RPiFT5406Init;
Description: Initialize the RPiFT5406 unit and create, register and start the device
Note Called only during system startup


RPiFT5406 touch functions 

function RPiFT5406TouchStart(Touch:PTouchDevice):LongWord;
Description: Implementation of TouchDeviceStart API for RPiFT5406
Note Not intended to be called directly by applications, use TouchDeviceStart instead 


function RPiFT5406TouchStop(Touch:PTouchDevice):LongWord;
Description: Implementation of TouchDeviceStop API for RPiFT5406
Note Not intended to be called directly by applications, use TouchDeviceStop instead 


function RPiFT5406TouchExecute(Touch:PRPiFT5406Touch):PtrInt;
Description: Thread function for the RPiFT5406 Touch controller driver. The thread polls the memory touch buffer approximately 60 times per second for new touch data and inserts received touch points into the buffer of the passed device
Note Not intended to be called directly by applications


Return to Unit Reference

Retrieved from "https://ultibo.org/mediawiki_ultibo_org/index.php?title=Unit_RPIFT5406&oldid=2541"