Changes between Version 22 and Version 23 of ventana/LVDS

Timestamp:

09/27/2021 10:48:33 PM (3 years ago)

Author:

Tim Harvey

Comment:

added tslib section

ventana/LVDS

@@ -760 +760 @@
 
 
+=== Touch input libraries
+
+[=#tslib]
+==== tslib
+The tslib project provides a cross-platform library that provides access to touchscreen devices and the ability to apply filters to their input events. Linux input events are translated via a 5-pt matrix configured by default in /etc/pointercal.
+
+References:
+ * http://www.tslib.org/
+ * https://github.com/libts/tslib
+
+tslib uses several env variables that can be used to specify the linux input dev, pointercal, ts.conf etc:
+ * 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. Default: /dev/tty
+ * TSLIB_FBDEVICE - Framebuffer device. Default: /dev/fb0
+
+tslib consists of several applications to test and calibrate your touchscreen:
+ - ts_print will show you touch events (filtered)
+ - ts_test will show your touch events on the display
+ - ts_calibrate prompt for touch events on the display at the four corners and center in order to create /etc/pointercal to translate (filter) events
+
+Example:
+ * install libts and tools
+{{{#!bash
+# apt install libts-bin
+}}}
+ * run ts_calibrate to create /etc/pointercal
+{{{#!bash
+# ts_calibrate
+xres = 1024, yres = 600
+Took 2 samples...
+Top left : X =  961 Y =  530
+Took 1 samples...
+Top right : X =   48 Y =  539
+Took 3 samples...
+Bot right : X =   67 Y =   71
+Took 1 samples...
+Bot left : X =  966 Y =   57
+Took 2 samples...
+Center : X =  514 Y =  293
+1041.238403 -1.020124 -0.026010
+623.628540 -0.013489 -1.062863
+Calibration constants: 68238600 -66854 -1704 40870120 -884 -69655 65536
+# cat /etc/pointercal
+-66854 -1704 68238600 -884 -69655 40870120 65536 1024 600 0
+}}}
+ * run ts_test to test input
+{{{
+# ts_test
+}}}
+
+
+
 [=#adding]
 == Adding Support for a Touchscreen