17. 使用 tslib 库
- 1. tslib 简介
- 2. tslib 移植
- 2.1 下载 tslib 源码
- 2.2 编译 tslib 源码
- 2.3 tslib 安装目录下的文件夹介绍
- 2.4 在开发板上测试 tslib
- 3. tslib 库函数介绍
- 3.1 打开触摸屏设备
- 3.2 配置触摸屏设备
- 3.3 读取触摸屏设备
- 4. 基于 tslib 编写触摸屏应用程序
- 4.1 单点触摸应用程序
- 4.2 多点触摸应用程序
1. tslib 简介
tslib 是专门为触摸屏设备所开发的 Linux 应用层函数库,并且是开源。tslib 为触摸屏驱动和应用层之间的适配层, 它把应用程序中读取触摸屏 struct input_event 类型数据(这是输入设备上报给应用层的原始数据)并进行解析的操作过程进行了封装,向使用者提供了封装好的 API 接口。tslib 从触摸屏中获得原始的坐标数据, 并通过一系列的去噪、去抖、坐标变换等操作,来去除噪声并将原始的触摸屏坐标转换为相应的屏幕坐标。
2. tslib 移植
2.1 下载 tslib 源码
下载源码包:git源码地址,我下载的是 1.16
2.2 编译 tslib 源码
将上面下载的文件拷贝到系统根目录下。解压tar -xzf tslib-1.16.tar.gz
,在家目录下创建 tools/tslib 目录。
进入解压后的目录中,使用source /opt/fsl-imx-x11/4.1.15-2.1.0/environment-setup-cortexa7hf-neon-poky-linux-gnueabi
设置交叉编译工具;./configure --host=arm-poky-linux-gnueabi --prefix=/home/dnkrc/tools/tslib/
执行配置,注意将dnkrc
替换为你的地址。然后 make,再 make install 安装。
2.3 tslib 安装目录下的文件夹介绍
bin: 一些 tslib 提供的小工具,用于测试触摸屏
etc: 有一个配置文件 ts.conf,直接使用默认的就好
include: 只有一个头文件tslib.h
,包含一些结构体以及接口的声明
lib: 包含了编译 tslib 源码得到的库文件,默认都是动态
share: 可忽略
2.4 在开发板上测试 tslib
将 tslib 目录下的一些文件拷贝到开发板系统目录下。
- bin 目录下所有可执行文件拷贝到开发板 /usr/bin 目录下
- etc 目录下的配置文件 ts.conf 拷贝到开发板 /etc 目录下
- lib 目录下的所有库文件拷贝到开发板 /usr/lib 目录下
在开发板系统中,还需要配置一些环境变量。
export TSLIB_CONSOLEDEVICE=none
export TSLIB_FBDEVICE=/dev/fb0
export TSLIB_TSDEVICE=/dev/input/event1
export TSLIB_CONFFILE=/etc/ts.conf
export TSLIB_PLUGINDIR=/usr/lib/ts
如果想每次启动系统都能生效,可以把这些命令放置在/etc/profile 脚本中执行
3. tslib 库函数介绍
3.1 打开触摸屏设备
#include <tslib.h>
struct tsdev *ts_open(const char *dev_name,int nonblock);
struct tsdev *ts_setup(const char *dev_name,int nonblock);
int ts_clock(struct tsdev *);
上面两个函数都可以打开触摸屏设备
dev_name: 指定了触摸屏的设备节点,对于 ts_setup 可以设备为 NULL,会读取环境变量,从而获取设备节点
nonblock: 为 0 表示阻塞方式,不为 0 表示非阻塞方式
3.2 配置触摸屏设备
int ts_config(struct tsdev *ts);
就是解析 ts.conf 文件中的配置信息
3.3 读取触摸屏设备
int ts_read(struct tedev *ts,struct te_sample *samp,int nr);
int ts_read_mt(struct tsdev *ts,struct ts_sample_mt **samp,int max_slots,int nr);
参数 ts 指向一个触摸屏设备句柄,参数 nr 表示对一个触摸点的采样数,设置为 1 即可.
ts_read()函数的 samp 参数是一个 struct ts_sample *类型的指针,指向一个 struct ts_sample 对象, struct ts_sample 数据结构描述了触摸点的信息;调用 ts_read()函数获取到的数据会存放在 samp 指针所指向的内存中。struct ts_sample 结构体内容如下所示:
ts_read_mt()函数的 samp 参数是一个 struct ts_sample_mt **类型的指针,多点触摸应用程序,每一个触摸点的信息使用 struct ts_sample_mt 数据结构来描述;一个触摸点的数据使用一个 struct ts_sample_mt 对象来装载,将它们组织成一个 struct ts_sample_mt 数组,调用 ts_read_mt()时,将数组地址赋值给 samp 参数。struct ts_sample 结构体内容如下所示:
4. 基于 tslib 编写触摸屏应用程序
4.1 单点触摸应用程序
#include <stdio.h>
#include <stdlib.h>
#include <tslib.h>
int main(int argc,char *argv[])
{
struct tsdev *ts = NULL;
struct ts_sample samp;
int pressure = 0; // 保存上一次压力,初始为 0,表示松开
ts=ts_setup(NULL,0);
for(;;)
{
ts_read(ts,&samp,1);
if(samp.pressure)
{
if(pressure) // 上一次按压力
printf("移动(%d, %d)\n", samp.x, samp.y);
else
printf("按下(%d, %d)\n", samp.x, samp.y);
}
else
printf("松开\n");
pressure=samp.pressure;
}
ts_close(ts);
return 0;
}
压力大于 0,则需要根据上一次压力判断状态。
编译代码时,需要指定头文件、库文件的路径以及动态链接库文件名:
${CC} -I /home/dnkrc/tools/tslib/include -L /home/dnkrc/tools/tslib/lib -lts -o testApp testApp.c
4.2 多点触摸应用程序
int main(int argc, char *argv[])
{
struct tsdev *ts = NULL;
struct ts_sample_mt *mt_ptr = NULL;
struct input_absinfo slot;
int max_slots;
unsigned int pressure[12] = {0}; //用于保存每一个触摸点上一次的按压力,初始为 0,表示松开
int i;
/* 打开并配置触摸屏设备 */
ts = ts_setup(NULL, 0);
if (NULL == ts)
{
fprintf(stderr, "ts_setup error");
return -1;
}
/* 获取触摸屏支持的最大触摸点数 */
ioctl(ts_fd(ts), EVIOCGABS(ABS_MT_SLOT), &slot);
max_slots = slot.maximum + 1 - slot.minimum;
printf("max_slots: %d\n", max_slots);
/* 内存分配 */
mt_ptr = calloc(max_slots, sizeof(struct ts_sample_mt));
/* 读数据 */
for ( ; ; )
{
ts_read_mt(ts, &mt_ptr, max_slots, 1);
for (i = 0; i < max_slots; i++)
{
if (mt_ptr[i].valid) //有效表示有更新
{
if (mt_ptr[i].pressure) //如果按压力>0
{
if (pressure[mt_ptr[i].slot])//如果上一次的按压力>0
printf("slot<%d>, 移动(%d, %d)\n", mt_ptr[i].slot, mt_ptr[i].x, mt_ptr[i].y);
else
printf("slot<%d>, 按下(%d, %d)\n", mt_ptr[i].slot, mt_ptr[i].x, mt_ptr[i].y);
}
else
printf("slot<%d>, 松开\n", mt_ptr[i].slot);
pressure[mt_ptr[i].slot] = mt_ptr[i].pressure;
}
}
}
ts_close(ts);
free(mt_ptr);
return 0;
}