JehuLiang/tslib

libts

module_raw input
module median depth=3
module dejitter delta=100
module linear

driver --> raw read --> median  --> dejitter --> linear --> application (using `ts_read_mt()`)
           module       module      module       module

# ts_calibrate

# ts_test_mt

TSLIB_TSDEVICE          Touchscreen device file name.
                        Default:                automatic detection (on Linux)

TSLIB_CALIBFILE         Calibration file.
                        Default:                ${sysconfdir}/pointercal

TSLIB_CONFFILE          Config file.
                        Default:                ${sysconfdir}/ts.conf

TSLIB_PLUGINDIR         Plugin directory.
                        Default:                ${datadir}/plugins

TSLIB_CONSOLEDEVICE     Console device. (not needed when using --with-sdl2)
                        Default:                /dev/tty

TSLIB_FBDEVICE          Framebuffer device.
                        Default:                /dev/fb0

# ts_uinput -d -v

driver --> raw read --> filter(s) ... --> ts_uinput --> libevdev read  --> GUI app/toolkit
           module       module(s) ...     daemon        e.g. in libinput

SUBSYSTEM=="input", KERNEL=="event[0-9]*", ATTRS{name}=="NAME_OF_THE_TOUCH_CONTROLLER", SYMLINK+="input/ts", TAG+="systemd" ENV{SYSTEMD_WANTS}="ts_uinput.service"
SUBSYSTEM=="input", KERNEL=="event[0-9]*", ATTRS{name}=="ts_uinput", SYMLINK+="input/ts_uinput"

  TSLIB_CALIBFILE=/etc/pointercal
  TSLIB_CONFFILE=/etc/ts.conf
  TSLIB_PLUGINDIR=/usr/lib/ts

  [Unit]
  Description=touchscreen input
  BindsTo=dev-input-ts.device
  After=dev-input-ts.device
  RequiresMountsFor=/etc/ts.env

  [Service]
  Type=forking
  EnvironmentFile=/etc/ts.env
  ExecStart=/usr/bin/ts_uinput -d

       |--------|       |-----|      |--------------|
x ---> | median | ----> | IIR | ---> |              | ---> x'
       |--------|    -> |-----|      |    screen    |
                    |                |  transform   |
                    |                | (calibrate)  |
       |--------|   |   |-----|      |              |
y ---> | median | ----> | IIR | ---> |              | ---> y'
       |--------|   |-> |-----|      |--------------|
                    |
                    |
             |----------|
p ---------> | debounce | -------------------------------> p'
             |----------|

module_raw input
module debounce drop_threshold=40
module median depth=5
module iir N=6 D=10
module linear

#include <tslib.h>

PKG_CHECK_MODULES([TSLIB], [tslib >= 1.10],,
  AC_MSG_ERROR([libts 1.10 or newer not found.])
)

#include <tslib.h>

#ifndef TSLIB_VERSION_MT
        /* ts_read() as before (due to old tslib) */
#else
        /* new ts_setup() and ret = ts_read_mt() */
        if (ret == -ENOSYS)
                /* ts_read() as before (due to user config) */
#endif

#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/time.h>
#include <unistd.h>
#include <errno.h>

#include <tslib.h>

#define SLOTS 5
#define SAMPLES 1

int main(int argc, char **argv)
{
    struct tsdev *ts;
    char *tsdevice = NULL;
    struct ts_sample_mt **samp_mt = NULL;
    int ret, i, j;

    ts = ts_setup(tsdevice, 0);
    if (!ts) {
            perror("ts_setup");
            return -1;
    }

    samp_mt = malloc(SAMPLES * sizeof(struct ts_sample_mt *));
    if (!samp_mt) {
            ts_close(ts);
            return -ENOMEM;
    }
    for (i = 0; i < SAMPLES; i++) {
            samp_mt[i] = calloc(SLOTS, sizeof(struct ts_sample_mt));
            if (!samp_mt[i]) {
                    for (i--; i >= 0; i--)
                            free(samp_mt[i]);
                    free(samp_mt);
                    ts_close(ts);
                    return -ENOMEM;
            }
    }

    while (1) {
            ret = ts_read_mt(ts, samp_mt, SLOTS, SAMPLES);
            if (ret < 0) {
                    perror("ts_read_mt");
                    ts_close(ts);
                    exit(1);
            }

            for (j = 0; j < ret; j++) {
            	for (i = 0; i < SLOTS; i++) {
		#ifdef TSLIB_MT_VALID
			if (!(samp_mt[j][i].valid & TSLIB_MT_VALID))
				continue;
		#else
			if (samp_mt[j][i].valid < 1)
				continue;
		#endif

			printf("%ld.%06ld: (slot %d) %6d %6d %6d\n",
			       samp_mt[j][i].tv.tv_sec,
			       samp_mt[j][i].tv.tv_usec,
			       samp_mt[j][i].slot,
			       samp_mt[j][i].x,
			       samp_mt[j][i].y,
			       samp_mt[j][i].pressure);
                    }
            }
    }

    ts_close(ts);
}

struct ts_sample_mt TouchScreenSamples[SAMPLES][SLOTS];

struct ts_sample_mt (*pTouchScreenSamples)[SLOTS] = TouchScreenSamples;
struct ts_sample_mt *ts_samp[SAMPLES];
for (i = 0; i < SAMPLES; i++)
        ts_samp[i] = pTouchScreenSamples[i];

ts_read_mt(ts, ts_samp, SLOTS, SAMPLES);

libts.so -> libts.so.0.7.0
libts.so.0 -> libts.so.0.7.0
libts.so.0.7.0

./configure --enable-static --disable-shared --enable-input=static --enable-linear=static --enable-iir=static

mkdir build && cd build
cmake ../
# or adding configuration options: cmake -Denable-input-evdev=ON ../
cmake --build .
cmake -P cmake_install.cmake

cmake_minimum_required(VERSION 3.10)
project(tslib_client)
find_package(tslib 1.16)
add_executable(tslib_client main.c)
target_link_libraries(tslib_client PUBLIC tslib::tslib)

Name	Introduced
`TSLIB_VERSION_MT`	1.10
`TSLIB_VERSION_OPEN_RESTRICTED`	1.13
`TSLIB_VERSION_EVENTPATH`	1.15
`TSLIB_VERSION_VERSION`	1.16
`TSLIB_MT_VALID`	1.13
`TSLIB_MT_VALID_TOOL`	1.13
`tslib_version`	1.16
`ts_print_ascii_logo`	1.16
`ts_libversion`	1.10
`ts_close`	1.0
`ts_config`	1.0
`ts_reconfig`	1.3
`ts_setup`	1.4
`ts_error_fn`	1.0
`ts_open_restricted`	1.13
`ts_close_restricted`	1.13
`ts_fd`	1.0
`ts_load_module`	1.0
`ts_open`	1.0
`ts_option`	1.1
`ts_read`	1.0
`ts_read_mt`	1.3
`ts_read_raw`	1.0
`ts_read_raw_mt`	1.3
`tslib_parse_vars`	1.0
`ts_get_eventpath`	1.15
`ts_conf_get`	1.18
`ts_conf_set`	1.18

JehuLiang/tslib

C library for filtering touchscreen events

contact

website

table of contents

setup and configure tslib

install tslib

configure tslib

calibrate the touch screen

test the filtered input behaviour

environment variables (optional)

use the filtered result in your system (X.org method)

use the filtered result in your system (ts_uinput method)

symlink /dev/input/ts_uinput to the new event file

running as systemd service (optional)

other operating systems

filter modules

module: linear

module: invert

module: median

module: pthres

module: iir

module: dejitter

module: debounce

module: skip

module: lowpass

module: evthres

module: variance

screen rotation

the libts library

the libts API

using libts

compiling using autoconf and pkg-config

ABI - Application Binary Interface

libts Soname versions

tslib package version

dependencies

related libraries

libts users

shipped as part of tslib

third party applications

tslib module API

Symbols in Versions

building tslib

shared vs. static builds

CMake

Using tslib in client apps

portable ts_calibrate and ts_test_mt using SDL2

portability

libts and filter plugins (module)

input plugins (module_raw)

test programs and tools

download binaries?

touchscreen hardware support

Contributors

support this project

Sponsors

portable `ts_calibrate` and `ts_test_mt` using SDL2

libts and filter plugins (`module`)

input plugins (`module_raw`)