Difference between revisions of "ETRA SOM/ETRA 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=ETRA | 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" |Dec 2020
|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''
 
  
=== Description  ===
+
The Touchscreen interface is available on the Evaluation Kit at the connector ''J20''
  
The Touchscreen interface available on the Evaluation Kit at the connector ''TBD:Jxxx''.  
+
''J20'' is a 6 pin ''Molex PicoBlade'' connector for the I2C and control signals needed by most of the capacitive TSC.
  
''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).
+
This interface can be configured to work with 3.3V (default) or 5V power and signal levels.
  
  
Line 43: Line 34:
  
 
{| 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
 
|-
 
|-
|1,2,4,6,,7,8,10
+
|1
 
| -
 
| -
| N.A.
+
| DGND
| N.C.
+
| Ground
| Not connected
+
|  
 
|-
 
|-
| 3
+
| 2
| J1.189
+
| J18.48
| RS232_RX
+
| TOUCH_SDA
| Receive line
+
| I2C_SDA
 
|  
 
|  
 
|-
 
|-
 
| 3
 
| 3
| J1.187
+
| J18.38
| RS232_TX
+
| TOUCH_SCL
| Transmit line
+
| I2C_SCL
 
|  
 
|  
 
|-
 
|-
| 9
+
| 4
| -
+
|J18.101
| DGND
+
| TOUCH_VDD
| Ground
+
| TSC power
|  
+
| powered through a control switch
 +
|-
 +
|5
 +
|J18.201
 +
|TOUCH_INT
 +
|TSC interrupt
 +
|input
 +
|-
 +
|6
 +
|J18.199
 +
|TOUCH_RES
 +
|TSC reset
 +
|output
 
|}
 
|}
  
 
=== 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.
 +
 
 +
The touch controller is attached to the generic Linux input event interface (evdev).
  
 
=== Device usage ===
 
=== Device usage ===
  
To connect to the debug serial port:
+
The simplest tools for touch screen management are the tslib library and ts_tools utilities. To calibrate the touch screen, the <code>ts_calibrate</code> command line tool is available. After calibration, the touch screen can be tested using the graphical <code>ts_test</code> utility or the <code>ts_print</code> command line tool.
 
 
# connect the DB9 adapter bracket to the J22 connector on the SBCX board
 
# connect a serial cable between DB9 connector and PC COM port through a NULL-modem cable (not provided)
 
# start your favorite terminal emulator software on PC (eg: PuTTY); communication parameters are: 115200,N,8,1
 
  
 
----
 
----
  
 
[[Category:ETRA]]
 
[[Category:ETRA]]

Revision as of 15:20, 31 December 2020

History
Version Issue Date Notes
1.0.0 Dec 2020 First Release


Touchscreen interface[edit | edit source]

Description[edit | edit source]

The Touchscreen interface is available on the Evaluation Kit at the connector J20

J20 is a 6 pin Molex PicoBlade connector for the I2C and control signals needed by most of the capacitive TSC.

This interface can be configured to work with 3.3V (default) or 5V power and signal levels.


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

Signals[edit | edit source]

The following table describes the interface signals:

Pin# SOM Pin# Pin name Pin function Pin Notes
1 - DGND Ground
2 J18.48 TOUCH_SDA I2C_SDA
3 J18.38 TOUCH_SCL I2C_SCL
4 J18.101 TOUCH_VDD TSC power powered through a control switch
5 J18.201 TOUCH_INT TSC interrupt input
6 J18.199 TOUCH_RES TSC reset output

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).

Device usage[edit | edit source]

The simplest tools for touch screen management are the tslib library and ts_tools utilities. To calibrate the touch screen, the ts_calibrate command line tool is available. After calibration, the touch screen can be tested using the graphical ts_test utility or the ts_print command line tool.