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}}")
 
 
(5 intermediate revisions by 2 users not shown)
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" |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" |{{oldid|12508|2021/01/11}}
−
|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" |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
 
 
|-
 
|-
−
|-
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |2023/09/01
−
|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:#ededed; padding:5px; color:#000000" |Add USB touchscreen
−
|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 Touchscreen interface is available on USB or I2C interface connectors.
  
−
=== Description  ===
+
ETRA Evaluation Kit uses, by default, the USB interface for connecting the touchscreen controller. Anyway, the I2C interface is available too and - optionally - can be activated in the device tree for enabling the I2C touch controller driver.
 +
 
 +
=== USB touchscreen ===
 +
 
 +
The USB OTG port - available on J16 connector - is configured as USB Host controller for driving the touchscreen. For this purpose, it is required to enable the <code>USB OTG ID</code> signals a low. This can be possible using the S1.4 DIP switch which forces the ID signal as low:
 +
 
 +
[[File:ETRA-EVK-USB-touchscreen.png|thumb|center|300px|Touchscreen connector]]
 +
 
 +
[[File:ETRA_EVK-S1.4-USB_OTG_ID.png|thumb|center|300px|USB OTG ID set to low]]
  
−
The Touchscreen interface available on the Evaluation Kit at the connector ''TBD:Jxxx''.
+
=== I2C touchscreen ===
  
−
''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).
+
The I2C 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:{{{nome-som}}-EVB-Touchscreen-connector.png|thumb|center|500px|Touchscreen connector]]
+
[[File:ETRA-EVK-I2C-touchscreen.png|thumb|center|500px|Touchscreen connector]]
  
−
===Signals ===
+
====Signals ====
  
 
The following table describes the interface signals:
 
The following table describes the interface 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
 
|-
 
|-
−
|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 <code>tslib</code> library and <code>ts_tools</code> 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]]

Latest revision as of 16:12, 6 September 2023

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
Issue Date Notes

2021/01/11

First Release
2023/09/01 Add USB touchscreen


Touchscreen interface[edit | edit source]

Description[edit | edit source]

The Touchscreen interface is available on USB or I2C interface connectors.

ETRA Evaluation Kit uses, by default, the USB interface for connecting the touchscreen controller. Anyway, the I2C interface is available too and - optionally - can be activated in the device tree for enabling the I2C touch controller driver.

USB touchscreen[edit | edit source]

The USB OTG port - available on J16 connector - is configured as USB Host controller for driving the touchscreen. For this purpose, it is required to enable the USB OTG ID signals a low. This can be possible using the S1.4 DIP switch which forces the ID signal as low:

Touchscreen connector
USB OTG ID set to low

I2C touchscreen[edit | edit source]

The I2C 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.

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.

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=ETRA_SOM/ETRA_Evaluation_Kit/Interfaces_and_Connectors/Touchscreen&oldid=18596"