Difference between revisions of "TSC2102 Linux driver"

From ArmadeusWiki
Jump to: navigation, search
m (Usage)
m (Usage)
 
(39 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
This page details the installation and the usage of the Linux drivers for the [[TSC2102|TSC210x chips]] (touch & temp/voltage control). Sound (ALSA) specific part [[ALSA|can be found here.]]
 +
 
==Driver Installation==
 
==Driver Installation==
$ make linux-menuconfig
+
These drivers are now installed by default in standard Armadeus rootfs. [[Talk:TSC2102_Linux_driver|Here]] you will find instructions to know how we configured Linux to activate these drivers (may be useful if you want to deactivate them).
 
+
in '''Device Drivers  ---> Input device support  --->''' select '''<*>  Event interface'''  as builtin
+
in '''Device Drivers  ---> Input device support  ---> [*]   Touchscreens  --->''' select '''<M>  TSC 2102 based touchscreens''' as module
+
+
in '''Device Drivers  ---> SPI support  ---> ''' select '''<M> Freescale iMX SPI controller''' as module
+
in '''Device Drivers  ---> SPI support  ---> --- TSC2102 codec support''' should be selected
+
+
in '''Device Drivers  --->''' select '''<M> Hardware Monitoring support  --->''' as module
+
 
+
$ make linux
+
 
+
Then reflash your Linux kernel and your Rootfs...
+
  
 
==Architecture==
 
==Architecture==
  
{| border="1" cellpadding="5" cellspacing="0" summary="Driver Architecture"
+
[[Image:TSC_arch.png]]
|- style="background:#efefef;"
+
! '''Touchscreen (tsc2102_ts.ko)''' || '''HWmon''' || '''ALSA'''
+
|----------------
+
| colspan="3" align="center" | TSC2102 Main driver (tsc2102.ko)
+
|----------------
+
| colspan="3" align="center" | Linux API
+
|-
+
|}
+
  
 
==Usage==
 
==Usage==
* load all the needed drivers:
+
* Load all the needed drivers:
# insmod /lib/modules/drivers/hwmon/hwmon.ko
+
<pre class="apf">
  # insmod /lib/modules/drivers/spi/spi_imx.ko
+
  # modprobe tsc2102_ts
# insmod /lib/modules/drivers/spi/tsc2102.ko
+
TI TSC210x driver initializing
# insmod /lib/modules/drivers/input/touchscreen/tsc2102_ts.ko
+
TSC2101 detected
# insmod /lib/modules/2.6.23.1/kernel/drivers/input/evdev.ko
+
input: TSC210x Touchscreen as /devices/platform/mxc_spi.1/spi1.0/tsc210x-ts/input/input0
 +
TSC210x Touchscreen driver initialized
 +
</pre>
  
Then:
+
===Touchscreen===
* get temperature and voltage with [http://lxr.linux.no/source/Documentation/hwmon/sysfs-interface?v=2.6.18 hwmon] (Hardware Monitoring) interface
+
Before use, the touchscreen has to be (at least one time) calibrated:
  cat /sys/class/hwmon/hwmon0/device/temp1_input  -- result in m°C
+
<pre class="apf">
* play sounds through [http://www.alsa-project.org/ ALSA interface]
+
  # ts_calibrate
 +
</pre>
 +
[[Image:Tslib_calibrate.png]]
  
==TSLib API Installation==
+
Then it can be tested with:
[[tslib | Install the Tslib touchscreen API]]
+
<pre class="apf">
 +
# ts_test
 +
</pre>
 +
[[Image:Tslib_test.png]]
  
===Envt variables===
+
If it does not work you can quickly check driver functionality; touch the screen and check that tsc2102 interrupts count is increasing:
* You should define some ENVT variables to use the touchscreen API (tslib):
+
<pre class="apf">
export TSLIB_TSDEVICE=/dev/input/event0
+
export TSLIB_TSEVENTTYPE=INPUT
+
export TSLIB_CONFFILE=/etc/ts.conf
+
export TSLIB_CALIBFILE=/etc/pointercal
+
 
+
===Device file creation if not exist===
+
* ''/dev/input/event0'' is created from the infos got from:
+
# cat /sys/class/input/event0/dev
+
13:64
+
# mkdir /dev/input
+
# cd /dev/input/
+
# mknod event0 c 13 64
+
# ls -al
+
drwxr-xr-x    2 root    root            0 Jan  1 00:39 .
+
drwxr-xr-x    5 root    root            0 Jan  1 00:39 ..
+
crw-r--r--    1 root    root      13,  64 Jan  1 00:39 event0
+
#
+
 
+
==Quick test==
+
To quickly check driver fonctionnality, touch the screen and check that tsc2102 interrupts count is increasing:
+
 
  # cat /proc/interrupts
 
  # cat /proc/interrupts
 
           CPU0
 
           CPU0
Line 77: Line 46:
 
  61:          0        MPU  DMA
 
  61:          0        MPU  DMA
 
  110:        0        GPIO  eth0
 
  110:        0        GPIO  eth0
  '''168:        0        GPIO  tsc2102'''
+
  168:        0        GPIO  tsc2102   <<<<--------
 
  Err:        0
 
  Err:        0
 
  #
 
  #
 +
</pre>
  
or start the touchscreen calibration tool:
+
More informations concerning the Tslib can be found [[tslib | here]].
  /usr/bin/ts_calibrate
+
 
 +
===Audio===
 +
 
 +
You can play sounds through [[ALSA| ALSA interface]].
 +
 
 +
===Miscellaneous===
 +
* get temperature and voltage with [http://lxr.linux.no/source/Documentation/hwmon/sysfs-interface?v=2.6.18 hwmon] (Hardware Monitoring) interface. For example, get board temperature from TSC210x:
 +
<pre class="apf">
 +
  # modprobe hwmon
 +
# cat /sys/class/hwmon/hwmon0/device/temp1_input        -- result in m°C
 +
</pre>
  
 
==Links==
 
==Links==
* http://source.mvista.com/git/gitweb.cgi?p=linux-omap-2.6.git;a=log;t=7 (search for TSC2102)
+
* [http://source.mvista.com/git/gitweb.cgi?p=linux-omap-2.6.git;a=log;t=7 Driver for OMAP] (search for TSC2102)
 +
* [http://www.avr32linux.org/archives/kernel/2007-August/000209.html Driver for AVR32]
 
* http://osdir.com/ml/linux.ports.arm.omap/2006-08/msg00183.html
 
* http://osdir.com/ml/linux.ports.arm.omap/2006-08/msg00183.html
 
* [http://docs.blackfin.uclinux.org/doku.php?id=touchscreen Touchscreen usage on Blackfin]
 
* [http://docs.blackfin.uclinux.org/doku.php?id=touchscreen Touchscreen usage on Blackfin]
Line 91: Line 72:
 
* http://www.opentom.org/Tslib
 
* http://www.opentom.org/Tslib
 
* http://www.openembedded.org/filebrowser/org.openembedded.packaged-staging/packages/tslib
 
* http://www.openembedded.org/filebrowser/org.openembedded.packaged-staging/packages/tslib
 +
 +
[[Category:Linux drivers]]
 +
[[Category:Touchscreen]]

Latest revision as of 02:45, 10 August 2011

This page details the installation and the usage of the Linux drivers for the TSC210x chips (touch & temp/voltage control). Sound (ALSA) specific part can be found here.

Driver Installation

These drivers are now installed by default in standard Armadeus rootfs. Here you will find instructions to know how we configured Linux to activate these drivers (may be useful if you want to deactivate them).

Architecture

TSC arch.png

Usage

  • Load all the needed drivers:
 # modprobe tsc2102_ts
TI TSC210x driver initializing
TSC2101 detected
input: TSC210x Touchscreen as /devices/platform/mxc_spi.1/spi1.0/tsc210x-ts/input/input0
TSC210x Touchscreen driver initialized

Touchscreen

Before use, the touchscreen has to be (at least one time) calibrated:

 # ts_calibrate

Tslib calibrate.png

Then it can be tested with:

 # ts_test

Tslib test.png

If it does not work you can quickly check driver functionality; touch the screen and check that tsc2102 interrupts count is increasing:

 # cat /proc/interrupts
           CPU0
 26:          0         MPU  IMX-uart
 29:         17         MPU  IMX-uart
 30:         22         MPU  IMX-uart
 35:         12         MPU  imx-mmc
 39:         14         MPU  I2C_IMX
 40:         16         MPU  imx-spi.2
 41:          0         MPU  imx-spi.1
 59:       3682         MPU  i.MX Timer Tick
 60:          0         MPU  DMA
 61:          0         MPU  DMA
 110:         0        GPIO  eth0
 168:         0        GPIO  tsc2102   <<<<--------
 Err:         0
 #

More informations concerning the Tslib can be found here.

Audio

You can play sounds through ALSA interface.

Miscellaneous

  • get temperature and voltage with hwmon (Hardware Monitoring) interface. For example, get board temperature from TSC210x:
 # modprobe hwmon
 # cat /sys/class/hwmon/hwmon0/device/temp1_input         -- result in m°C

Links