Component: Touch Screen (XPT2046) (Graphical Library): Difference between revisions

Revision as of 14:23, 13 July 2026

Author	Matrix Ltd
Version	13.13
Category	Graphical Library

Touch Screen (XPT2046) component

Low level routines for controlling or interacting with the XPT2046 touch screen controller IC found on a lot of common low cost resistive touch screen products.

Version information

Library Version, Component Version, Date, Author, Info
12, 1.0, 26-07-24, BR, Removed ghost greay square connection line
13, 13.0, 20-02-25, MW, Sample sensor now retuns the pressure value instead 0 or 1

Detailed description

No detailed description exists yet for this component

Examples

Example using the XPT2046 touchscreen driver IC with a 4.3" TFT Display using the SSD1963 Graphical LCD Controller. GLCD 4.3 Touch

Example using the XPT2046 touchscreen driver IC with a 7" TFT Display using the SSD1963 Graphical LCD Controller. GLCD 7 Touch

Macro reference

Initialise

	Initialise
Activates the SPI peripheral and claims control over the I/O pins.
- VOID	Return

ReadCoord

	ReadCoord
Reads a coordinate returned from the Sample Sensor macro. Coordinate is scaled to the X/Y Pixel bounds specified.
- BYTE	Coordinate
0 = X, 1 = Y, 2 = Pressure
- UINT	Return

SampleSensor

	SampleSensor
Reads the touch controller and returnsthe pressure value of touch in progress. The touch coordinates can be read using the ReadCoord macro. Return 0 = No Touch, >=1 Touch in progress
- BYTE	Return

SetOrientation

	SetOrientation
Allows the orientation to be overridden.
- BYTE	Orientation
Range: 0 - 3
- VOID	Return

Property reference

	Properties
	LinkTo

	Bus Settings
	Channel
SPI Channel selector
	Prescale
Prescale option selector
	Connections
	MOSI
SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.
	MISO
SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.
	CLK
SPI Clock Pin CLK - The Clock signal is driven by the SPI master.
	CS / SS
Chip Select / Slave Select Pin Master Mode: General purpose output pin used to select the remote SPI device. Slave Mode: Hardware chip select pin input used to select the SPI device.
	Configuration
	Analogue Mode

	X Pixel

	Y Pixel

	Flip X

	Flip Y

	Simulation
	Label
Label used to identify the component on the panel.
	Enable Interrupt
Allows the simulated display to fire an interrupt to allow you to action inputs as they happen.
	Interrupt Macro
Macro called when the simulated display fires an interrupt.
	Simulate Comms
Allows the SPI communications to be simulated and piped through an API to real world hardware.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_TouchScreen_XPT2046.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_TouchScreen_XPT2046.fcfx

@@ Line 89: / Line 89: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+| width="90%" class="mtx-class-macrohead" | '''Initialise'''
 |-
 | colspan="2" | Activates the SPI peripheral and claims control over the I/O pins.&nbsp;
@@ Line 103: / Line 103: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadCoord'''
+| width="90%" class="mtx-class-macrohead" | '''ReadCoord'''
 |-
 | colspan="2" | Reads a coordinate returned from the Sample Sensor macro. Coordinate is scaled to the X/Y Pixel bounds specified.&nbsp;
@@ Line 122: / Line 122: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SampleSensor'''
+| width="90%" class="mtx-class-macrohead" | '''SampleSensor'''
 |-
 | colspan="2" | Reads the touch controller and returnsthe pressure value of  touch in progress. The touch coordinates can be read using the ReadCoord macro. Return 0 = No Touch,  >=1  Touch in progress&nbsp;
@@ Line 136: / Line 136: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetOrientation'''
+| width="90%" class="mtx-class-macrohead" | '''SetOrientation'''
 |-
 | colspan="2" | Allows the orientation to be overridden.&nbsp;
@@ Line 156: / Line 156: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-

SteveT (talk | contribs)