Difference between revisions of "ORCA SOM/ORCA Evaluation Kit/Interfaces and Connectors/Touchscreen"

From DAVE Developer's Wiki
Jump to: navigation, search
(Created page with "{{subst:EVB_Interfaces_and_Connectors | nome-som=ORCA SOM | nome-peripheral = Touchscreen}}")
 
Line 1: Line 1:
−
<section begin=History/>
+
<section begin="History" />
 
{| style="border-collapse:collapse; "
 
{| style="border-collapse:collapse; "
−
!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History
+
! colspan="4" style="width:100%; text-align:left" ; border-bottom:solid 2px #ededed" |History
 
|-  
 
|-  
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Version
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white" |Version
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Issue Date
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white" |Issue Date
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white" |Notes
 
|-
 
|-
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|X.Y.Z
+
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |1.0.0
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Month Year
+
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |Sep 2021
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|TBD
+
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |First release
 
|-
 
|-
−
|-
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|[TBD_link X.Y.Z]
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Month Year
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|TBD
 
−
|-
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|...
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|...
 
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|...
 
 
|-
 
|-
 
|}
 
|}
−
<section end=History/>
+
<section end="History" />
−
<section begin=Body/>
+
<section begin="Body" />
  
 
==Touchscreen interface ==
 
==Touchscreen interface ==
  
−
''TBD: sostituire le sezioni con le informazioni sull'uso della periferica e del suo connettore''
+
=== Description  ===
−
''Nell'esempio di seguito c'è la descrizione dell'interfaccia UART/console''
+
The Evaluation Kit default LCD panel (provided on request) interfaces the touchscreen via USB, thus it is connected to J3 or J4, see [[ORCA SOM/ORCA Evaluation Kit/Interfaces and Connectors/USB ports|USB ports]] section.
  
−
=== Description  ===
+
Many touchscreen types use instead an I2C interface with two additional control signals (RST, IRQ).
  
−
The Touchscreen interface available on the Evaluation Kit at the connector ''TBD:Jxxx''.  
+
To use these type of touchscreens the interface signals can be routed to the expansion connector J8.  
  
−
''Jxx'' is a ''TBD:connector-type'' header connector for the RS232 two-wires UART3 port, used for debug purposes (bootloader and operating system serial console).
+
An external circuit is recommended to correctly conditioning the interface signals, such as buffers and pull up/down, according to the touchscreen specifications.  
  
  
Line 40: Line 32:
 
===Signals ===
 
===Signals ===
  
−
The following table describes the interface signals:
+
The following table describes the available I2C signals on J8 connector, see [[ORCA SOM/ORCA Evaluation Kit/Interfaces and Connectors/GPIOs|GPIO section]] for available control signals:
  
 
{| class="wikitable"  
 
{| class="wikitable"  
−
! latexfontsize="scriptsize"| Pin#
+
! latexfontsize="scriptsize" | Pin#
−
! latexfontsize="scriptsize"| SOM Pin#
+
! latexfontsize="scriptsize" | SOM Pin#
−
! latexfontsize="scriptsize"| Pin name
+
! latexfontsize="scriptsize" | Pin name
−
! latexfontsize="scriptsize"| Pin function
+
! latexfontsize="scriptsize" | Pin function
−
! latexfontsize="scriptsize"| Pin Notes
+
! latexfontsize="scriptsize" | Pin Notes
 +
|-
 +
|19
 +
|
 +
|ECSPI2_MOSI
 +
|I2C3_SDA
 +
|
 +
|-
 +
|21
 +
|
 +
|ECSPI2_MISO
 +
|I2C4_SCL
 +
|
 +
|-
 +
|22
 +
|
 +
|SAI5_MCLK
 +
|I2C5_SDA
 +
|
 +
|-
 +
|23
 +
|
 +
|ECSPI2_SCLK
 +
|I2C3_SCL
 +
|
 +
|-
 +
|24
 +
|
 +
|ECSPI2_SS0
 +
|I2C4_SDA
 +
|
 +
|-
 +
|32
 +
|
 +
|SAI5_RXFS
 +
|I2C6_SCL
 +
|
 +
|-
 +
|38
 +
|
 +
|SAI5_RXD0
 +
|I2C5_SCL
 +
|
 +
|-
 +
|40
 +
|
 +
|SAI5_RXC
 +
|I2C6_SDA
 +
|
 
|-
 
|-
−
|1,2,4,6,,7,8,10
+
|1, 17
 
| -
 
| -
−
| N.A.
+
|3V3_CB
−
| N.C.
+
| +3.3V
−
| Not connected
+
|BOARD_PGOOD driven rail
 
|-
 
|-
−
| 3
+
|2, 4
−
| J1.189
+
| -
−
| RS232_RX
+
|5V_VIN
−
| Receive line
+
| +5V
−
|
+
|Always powered
−
|-
 
−
| 3
 
−
| J1.187
 
−
| RS232_TX
 
−
| Transmit line
 
−
|  
 
 
|-
 
|-
−
| 9
+
|6, 9, 14, 20, 25, 30, 34, 39
 
| -
 
| -
−
| DGND
+
|DGND
−
| Ground
+
|Ground
−
|  
+
|
 
|}
 
|}
 +
All the I2C signals use 0 - 3.3V levels, external pull-ups to <code>3V3_CB</code> are needed.
  
 
=== Device mapping ===
 
=== Device mapping ===
−
UART3 is mapped to <code>/dev/ttymxc2</code> device in Linux. The peripheral is used as the default serial console, both for the bootloader and the kernel.
+
The device is typically mapped to <code>/dev/touchscreen0</code> device in Linux.
  
−
=== Device usage ===
+
The touch controller is attached to the generic Linux input event interface (evdev).
  
−
To connect to the debug serial port:
+
For I2C touchscreen controllers a dedicated node in the device-tree has to be configured to correctly bind the driver.
  
−
# connect the DB9 adapter bracket to the J22 connector on the SBCX board
+
=== Device usage ===
−
# connect a serial cable between DB9 connector and PC COM port through a NULL-modem cable (not provided)
+
The touchscreen device is often passed as parameter to the user interface application or is automatically discovered.
−
# start your favorite terminal emulator software on PC (eg: PuTTY); communication parameters are: 115200,N,8,1
 
  
 +
Touchscreen can be tested with the <code>evtest</code> tool that prints the finger coordinates to the console.
 
----
 
----
  
 
[[Category:ORCA SOM]]
 
[[Category:ORCA SOM]]

Revision as of 13:43, 8 September 2021

HOME SOMs SBCs ToloMEO Embedded Assistant Sale-tag.pngGET A QUOTE Customer-service.pngONLINE HELPDESK
Roadmap IoT Services ML/AI services Embedded Design Services
History
Version Issue Date Notes
1.0.0 Sep 2021 First release


Touchscreen interface[edit | edit source]

Description[edit | edit source]

The Evaluation Kit default LCD panel (provided on request) interfaces the touchscreen via USB, thus it is connected to J3 or J4, see USB ports section.

Many touchscreen types use instead an I2C interface with two additional control signals (RST, IRQ).

To use these type of touchscreens the interface signals can be routed to the expansion connector J8.

An external circuit is recommended to correctly conditioning the interface signals, such as buffers and pull up/down, according to the touchscreen specifications.


[[File:{Template:Nome-som-EVB-Touchscreen-connector.png|thumb|center|500px|Touchscreen connector]]

Signals[edit | edit source]

The following table describes the available I2C signals on J8 connector, see GPIO section for available control signals:

Pin# SOM Pin# Pin name Pin function Pin Notes
19 ECSPI2_MOSI I2C3_SDA
21 ECSPI2_MISO I2C4_SCL
22 SAI5_MCLK I2C5_SDA
23 ECSPI2_SCLK I2C3_SCL
24 ECSPI2_SS0 I2C4_SDA
32 SAI5_RXFS I2C6_SCL
38 SAI5_RXD0 I2C5_SCL
40 SAI5_RXC I2C6_SDA
1, 17 - 3V3_CB +3.3V BOARD_PGOOD driven rail
2, 4 - 5V_VIN +5V Always powered
6, 9, 14, 20, 25, 30, 34, 39 - DGND Ground

All the I2C signals use 0 - 3.3V levels, external pull-ups to 3V3_CB are needed.

Device mapping[edit | edit source]

The device is typically mapped to /dev/touchscreen0 device in Linux.

The touch controller is attached to the generic Linux input event interface (evdev).

For I2C touchscreen controllers a dedicated node in the device-tree has to be configured to correctly bind the driver.

Device usage[edit | edit source]

The touchscreen device is often passed as parameter to the user interface application or is automatically discovered.

Touchscreen can be tested with the evtest tool that prints the finger coordinates to the console.

HOME SOMs SBCs ToloMEO Embedded Assistant Sale-tag.pngGET A QUOTE Customer-service.pngONLINE HELPDESK
Roadmap IoT Services ML/AI services Embedded Design Services
Retrieved from "https://wiki.dave.eu/index.php?title=ORCA_SOM/ORCA_Evaluation_Kit/Interfaces_and_Connectors/Touchscreen&oldid=14495"