Tslib

From ArmadeusWiki
Revision as of 10:52, 30 December 2009 by JulienB (Talk | contribs) (Adding Tslib support to SDL)

Jump to: navigation, search

Library which provides a common interface to touchscreen and allows touchscreen events filtering or calibrating...

Compiling

Preliminaries checks

Warning Warning:

This part is required on: Ubuntu 6.04, KUbuntu 6.10 or more
This part is normaly not required on following distribution: KUbuntu 9.04


  • Be sure to have libtool package installed (tested with 1.5.22-4 & 1.5.24-1 versions).
    Otherwise you will have following errors:
configure.ac:25: error: possibly undefined macro: AC_DISABLE_STATIC
     If this token and others are legitimate, please use m4_pattern_allow.
     See the Autoconf documentation.
configure.ac:26: error: possibly undefined macro: AC_ENABLE_SHARED
configure.ac:27: error: possibly undefined macro: AC_LIBTOOL_DLOPEN
configure.ac:28: error: possibly undefined macro: AC_PROG_LIBTOOL
  • Be sure to have automake-1.6 or higher package installed (tested with 1.7 version -> working, 1.9.6 -> not working & 1.10 -> working !).
    After automake package installation don't forget to update your /etc/alternatives/automake and /etc/alternatives/aclocal symlinks (tested on Ubuntu).
 $ sudo ln -sf /usr/bin/automake-1.7 /etc/alternatives/automake
 $ sudo ln -sf /usr/bin/aclocal-1.7 /etc/alternatives/aclocal
  -->
 lrwxrwxrwx 1 root root 20 2007-06-27 21:43 /etc/alternatives/aclocal -> /usr/bin/aclocal-1.7
 lrwxrwxrwx 1 root root 21 2007-06-27 21:39 /etc/alternatives/automake -> /usr/bin/automake-1.7
Warning Warning:

The following part is MANDATORY:


  • In Buildroot, if you don't have configured the C++ cross-compiler yet (done in default configuration), then:
 $ make menuconfig
Toolchain Options  --->
    [*] Build/install c++ compiler and libstdc++?
    [*] Build/install a shared libgcc?

Config

  • After all these checks, activate libts package in Buildroot configuration:
$ make menuconfig

Menuconfig package.png

Menuconfig package graphics.png

$ make
  • Or compile it directly (won't update your rootfs JFFS2/UBIFS image):
$ make tslib

Configuration details

Most are now automatically done in recent Armadeus SDK releases. If you are interested, history is kept here.

Config file

  • Tslib plugins can be tuned with /etc/ts.conf. A default one is provided in all rootfs:
 # cat /etc/ts.conf
 
 module_raw input
 module pthres pmin=1
 module variance delta=30
 module dejitter delta=100
 module linear

Envt variables

  • Some ENVT variables are needed too. By default they are defined in /etc/profile:
 export TSLIB_TSDEVICE=/dev/input/event0
 export TSLIB_TSEVENTTYPE=INPUT
 export TSLIB_CONFFILE=/etc/ts.conf
 export TSLIB_CALIBFILE=/etc/pointercal
  • If you have other input devices (like mouse or keyboard) and they have been detected by Linux before your touchscreen device, then you will probably need to adapt TSLIB_TSDEVICE variable.

Calibration

  • Before first usage, a touchscreen needs to be calibrated. When starting, Tslib will look at /etc/pointercal to get calibration data. This file is created when running Tslib's calibration tool:
 # /usr/bin/ts_calibrate

Tslib calibrate.png

Testing it

# /usr/bin/ts_test

Tslib test.png

Adding Tslib support to SDL

SDL is by default compiled with Tslib support in current Buildroot distribution. You just have to make SDL knows the presence of Tslib when launching your application with:

 export SDL_MOUSEDRV=TSLIB
 export SDL_MOUSEDEV=$TSLIB_TSDEVICE

To have an example of a SDL application using Tslib, take a look at target/demos/backlight_control/ sources.

Adding Tslib support to Qt

When selecting Qt in Buildroot menuconfig you can choose the input method to be Tslib. See Qt installation for more informations.

Links