目录
一、tslib 介绍
二、tslib 框架分析
三、交叉编译、测试 tslib
1.安装工具链 tslib
(1)设置交叉编译工具链
(2)进入tslib目录
(3)安装工具链
(4)确定工具链中头文件、库文件目录
2.测试 tslib
四、自己编写一个测试程序
1.接口函数深入分析
2.编写代码
3.上机测试
一、tslib 介绍
tslib 是一个触摸屏的开源库,可以使用它来访问触摸屏设备,可以给输入设备添加各种 “ filter ” ( 过 滤 器 , 就 是 各 种 处 理 ) , 地 址 是 :http:// http://www.tslib.org/。
tslib在Linux系统中的主要作用是提供一个统一的、抽象的接口来管理不同类型的输入设备,尤其是触摸屏设备。这个库通过处理底层的硬件差异和复杂的数据转换,让开发人员可以更专注于应用层面的开发,而不必关心硬件层面的细节。
编译 tslib 后,可以得到 libts 库,还可以得到各种工具:较准工具、测试工具。
二、tslib 框架分析
tslib 的主要代码如图:
核心在于“plugins”目录里的“插件”,或称为“module”。这个目录下的每个文件都是一个 module,每个 module 都提供 2 个函数:read、read_mt,前者用于读取单点触摸屏的数据,后者用于读取多点触摸屏的数据。
要分析 tslib 的框架,先看看示例程序怎么使用,我们参考 ts_test.c 和 ts_test_mt.c,前者用于一般触摸屏(比如电阻屏、单点电容屏),后者用于多点触摸屏。 一个图就可以弄清楚 tslib 的框架:
调用 ts_open 后,可以打开某个设备节点,构造出一个 tsdev 结构体。然后调用 ts_config 读取配置文件的处理,假设 /etc/ts.conf 内容如下:
每行表示一个“module”或“moduel_raw”。
对于所有的“module”,都会插入 tsdev.list 链表头,也就是 tsdev.list 执行配置文件中最后一个“module”,配置文件中第一个“module”位于链表的尾部。
对于所有的“module_raw”,都会插入 tsdev.list_raw 链表头,一般只有一个“module_raw”。
注意:tsdev.list 中最后一个“module”会指向 ts_dev.list_raw 的头部。
无论是调用 ts_read 还是 ts_read_mt,都是通过 tsdev.list 中的模块来处理数据的。这些模块是递归调用的,比如linear模块的read函数如图:
linear 模块的 read_raw 函数如图:
因为是递归调用,所有最先使用 input 模块读取设备节点得到原始数据,再依次经过 pthres 模块、dejitter 模块、linear 模块处理后,才返回最终数据。
三、交叉编译、测试 tslib
1.安装工具链 tslib
(1)设置交叉编译工具链
export ARCH=arm
export CROSS_COMPILE=arm-buildroot-linux-gnueabihf-
export PATH=$PATH:/home/book/100ask_imx6ull-sdk/ToolChain/arm-buildroot-linux-gnueabihf_sdk-buildroot/bin
(2)进入tslib目录
从window上传tslib压缩包到ubuntu,然后执行下面命令进入tslib目录:
tar -xzf tslib-1.21.tar.xz
cd tslib-1.21
(3)安装工具链
执行下面命令:
./configure --host=arm-buildroot-linux-gnueabihf --prefix=/
make
make install DESTDIR=$PWD/tmp
cd tmp/
(4)确定工具链中头文件、库文件目录
echo 'main(){}'| arm-buildroot-linux-gnueabihf-gcc -E -v -
cp include/* /home/book/100ask_imx6ull-sdk/ToolChain/arm-buildroot-linux-gnueabihf_sdk-buildroot/arm-buildroot-linux-gnueabihf/sysroot/usr/include
cp -d lib/*so* /home/book/100ask_imx6ull-sdk/ToolChain/arm-buildroot-linux-gnueabihf_sdk-buildroot/arm-buildroot-linux-gnueabihf/sysroot/usr/lib/
2.测试 tslib
把库文件放到单板上:运行程序要用。先在开发板上使用 NFS 挂载 Ubuntu 的目录,再把前面编译出来的 tslib-1.21/tmp/部分文件复制到板子上,示例命令如下:
对于 IMX6ULL,首先需要关闭默认的 qt gui 程序,才可以执行 ts_test_mt 测试命令,关闭 qt 命令如下所示:
mv /etc/init.d/*hmi* /root
mv /etc/init.d/*lvgl* /root
reboot
在单板上执行测试程序:
export TSLIB_PLUGINDIR=/lib/ts
ts_test_mt
四、自己编写一个测试程序
1.接口函数深入分析
驱动程序使用 slot、tracking_id 来标识一个触点;当 tracking_id 等于 -1 时,标识这个触点被松开了。
触摸屏可能支持多个触点,比如 5 个:tslib 为了简化处理,即使只有 2 个 触点,ts_read_mt 函数也会返回 5 个触点数据,可以根据标志位判断数据是否有效。
ts_read_mt 函数原型如图:
假设nr设置为1,max_slots设置为5,那么读到的数据保存在:samp[0][0]、 samp[0][1]、samp[0][2]、samp[0][3]、samp[0][4]中。
假设nr设置为2,max_slots设置为5,那么读到的数据保存在:samp[0][0]、 samp[0][1] 、 samp[0][2] 、 samp[0][3] 、 samp[0][4] 和 samp[1][0] 、 samp[1][1]、samp[1][2]、samp[1][3]、samp[1][4]中。
ts_sample_mt 结构体如图:
2.编写代码
实现一个程序,不断打印 2 个触点的距离。
思路:假设是 5 点触摸屏,调用一次 ts_read_mt 可以得到 5 个新数据;使用新旧数据进行判断,如果有 2 个触点,就打印出距离。
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include <signal.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <getopt.h>
#include <linux/input.h>
#include <sys/ioctl.h>
#include <tslib.h>
int distance(struct ts_sample_mt *point1, struct ts_sample_mt *point2)
{
int x = point1->x - point2->x;
int y = point1->y - point2->y;
return x*x + y*y;
}
int main(int argc, char **argv)
{
struct tsdev *ts;
int i;
int ret;
struct ts_sample_mt **samp_mt;
struct ts_sample_mt **pre_samp_mt;
int max_slots;
int point_pressed[20];
struct input_absinfo slot;
int touch_cnt = 0;
ts = ts_setup(NULL, 0);
if (!ts)
{
printf("ts_setup err\n");
return -1;
}
if (ioctl(ts_fd(ts), EVIOCGABS(ABS_MT_SLOT), &slot) < 0) {
perror("ioctl EVIOGABS");
ts_close(ts);
return errno;
}
max_slots = slot.maximum + 1 - slot.minimum;
samp_mt = malloc(sizeof(struct ts_sample_mt *));
if (!samp_mt) {
ts_close(ts);
return -ENOMEM;
}
samp_mt[0] = calloc(max_slots, sizeof(struct ts_sample_mt));
if (!samp_mt[0]) {
free(samp_mt);
ts_close(ts);
return -ENOMEM;
}
pre_samp_mt = malloc(sizeof(struct ts_sample_mt *));
if (!pre_samp_mt) {
ts_close(ts);
return -ENOMEM;
}
pre_samp_mt[0] = calloc(max_slots, sizeof(struct ts_sample_mt));
if (!pre_samp_mt[0]) {
free(pre_samp_mt);
ts_close(ts);
return -ENOMEM;
}
for ( i = 0; i < max_slots; i++)
pre_samp_mt[0][i].valid = 0;
while (1)
{
ret = ts_read_mt(ts, samp_mt, max_slots, 1);
if (ret < 0) {
printf("ts_read_mt err\n");
ts_close(ts);
return -1;
}
for (i = 0; i < max_slots; i++)
{
if (samp_mt[0][i].valid)
{
memcpy(&pre_samp_mt[0][i], &samp_mt[0][i], sizeof(struct ts_sample_mt));
}
}
touch_cnt = 0;
for (i = 0; i < max_slots; i++)
{
if (pre_samp_mt[0][i].valid && pre_samp_mt[0][i].tracking_id != -1)
point_pressed[touch_cnt++] = i;
}
if (touch_cnt == 2)
{
printf("distance: %08d\n", distance(&pre_samp_mt[0][point_pressed[0]], &pre_samp_mt[0][point_pressed[1]]));
}
}
return 0;
}
3.上机测试
交叉编译.c文件:记得链接 ts 库,否则会报错。
arm-buildroot-linux-gnueabihf-gcc mt_cal_distance.c -o test -lts
上电开发板,挂载 ubuntu 的 NFS 目录,执行 ./test ,用手在屏幕滑动即可看到现象。