Difference between revisions of "Component: Touch Screen (XPT2046) (Graphical Library)"
From Flowcode Help
Jump to navigationJump to search (Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | Matrix Ltd |- | width="20%" style="color:gray;" | Version | 2.0 |- | width="20%" style="color:gray...") |
|||
| (11 intermediate revisions by 2 users not shown) | |||
| Line 15: | Line 15: | ||
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. | 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 | ||
==Detailed description== | ==Detailed description== | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| Line 38: | Line 49: | ||
==Examples== | ==Examples== | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| Line 56: | Line 77: | ||
Example using the XPT2046 touchscreen driver IC with a 4.3" TFT Display using the SSD1963 Graphical LCD Controller. | Example using the XPT2046 touchscreen driver IC with a 4.3" TFT Display using the SSD1963 Graphical LCD Controller. | ||
{{Fcfile|GLCD4.3_Touch.fcfx|GLCD 4.3 Touch}} | {{Fcfile|GLCD4.3_Touch.fcfx|GLCD 4.3 Touch}} | ||
| + | |||
Example using the XPT2046 touchscreen driver IC with a 7" TFT Display using the SSD1963 Graphical LCD Controller. | Example using the XPT2046 touchscreen driver IC with a 7" TFT Display using the SSD1963 Graphical LCD Controller. | ||
{{Fcfile|GLCD7_Touch.fcfx|GLCD 7 Touch}} | {{Fcfile|GLCD7_Touch.fcfx|GLCD 7 Touch}} | ||
| − | == | + | ==Macro reference== |
| + | ===Initialise=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | ''' | + | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise''' |
|- | |- | ||
| − | | colspan="2" | | + | | colspan="2" | Activates the SPI peripheral and claims control over the I/O pins. |
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | + | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID |
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
| + | ===ReadCoord=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| Line 92: | Line 116: | ||
| + | ===SampleSensor=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | ''' | + | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SampleSensor''' |
|- | |- | ||
| − | | colspan="2" | | + | | colspan="2" | Reads the touch controller and returns true if there is currently a touch in progress. The touch coordinates can be read using the ReadCoord macro. Return 0 = No Touch, 1 = Touch in progress |
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | + | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE |
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
| − | |||
| − | |||
| Line 211: | Line 234: | ||
| colspan="2" | Allows the SPI communications to be simulated and piped through an API to real world hardware. | | colspan="2" | 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: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_TouchScreen_XPT2046.fcfx FC_Comp_Source_TouchScreen_XPT2046.fcfx] | ||
| + | |||
| + | Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_TouchScreen_XPT2046.fcfx FC_Comp_Source_TouchScreen_XPT2046.fcfx] | ||
Latest revision as of 14:32, 26 July 2024
| Author | Matrix Ltd |
| Version | 2.0 |
| Category | Graphical Library |
Contents
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
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 returns true if there is currently a touch in progress. The touch coordinates can be read using the ReadCoord macro. Return 0 = No Touch, 1 = Touch in progress | |
| - BYTE
|
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
