[系统运维]linux应用编程-tslib库

目录

1、简介

2、源码编译

2.1、下载源码

2.2、配置工程

2.3、编译工程

2.4、安装

3、编译生成文件

3.1、ts.conf

4、移植

4.1、拷贝文件

4.2、配置环境变量

4.3、设置LD_LIBRARY_PATH

5、tslib库函数

5.1、ts_open()函数

5.2、ts_setup()函数

5.3、ts_close()函数

5.4、ts_config()函数

5.5、ts_read()函数

5.6、ts_read_mt()函数

5.7、ts_sample结构体

5.8、ts_sample_mt结构体

1、简介

tslib是触摸屏驱动和应用层之间的适配层， 它把应用程序中读取触摸屏input_event结构体类型数据并进行解析的操作过程进行了封装，向使用者提供了封装好的 API 接口。 tslib从触摸屏中获得原始的坐标数据， 并通过一系列的去噪、去抖、坐标变换等操作，来去除噪声并将原始的触摸屏坐标转换为相应的屏幕坐标。
注：tslib库是 Linux 系统下， 专门为触摸屏开发的应用层函数库。

注：tslib 可以作为 Qt 的触摸屏输入插件，为 Qt 提供触摸输入支持。

2、源码编译

2.1、下载源码

https://github.com/libts/tslib/releases

2.2、配置工程

1）指定指定交叉编译工具链

????????--host 选项用于指定交叉编译工具链，通常将--host 设置为交叉编译器名称的前缀，譬如 arm-linux-gnueabi-gcc 前缀就是 arm-linux-gnueabi；

2）指定install路径

?????????--prefix 选项则用于指定库文件的安装路径。

例如 ./configure --host=arm-linux-gnueabi --prefix=路径

2.3、编译工程

使用make命令编译工程

2.4、安装

使用make install命令进行安装。

3、编译生成文件

3.1、ts.conf

tslib 有一个配置文件 ts.conf， 该配置文件中提供了一些配置参数、用户可以对其进行修改！

4、移植

4.1、拷贝文件

1）bin/目录下的所有可执行文件;

2）etc/目录下的配置文件 ts.conf;

3）lib/目录下的所有库文件；

4.2、配置环境变量

4.3、设置LD_LIBRARY_PATH

export LD_LIBRARY_PATH="运行库路径"

5、tslib库函数

5.1、ts_open()函数

打开触摸屏设备。

#include "tslib.h"

struct tsdev *ts_open(const char *dev_name, int nonblock);

参数 dev_name：指定了触摸屏的设备节点；

参数 nonblock:表示是否以非阻塞方式打开触摸屏设备，如果nonblock 等于 0 表示阻塞方式，如果为非 0 值则表示以非阻塞方式打开。
返回值：调用成功返回一个 struct tsdev *指针， 指向触摸屏设备句柄；如果打开设备失败，将返回 NULL。

5.2、ts_setup()函数

ts_setup()相比 ts_open()，除了打开触摸屏设备外，还对触摸屏设备进行了配置。

#include "tslib.h"

struct tsdev *ts_setup(const char *dev_name, int nonblock)

参数 dev_name：指定了触摸屏的设备节点；当 dev_name 设置为 NULL 时， ts_setup()函数内部会读取TSLIB_TSDEVICE 环境变量， 获取该环境变量的内容以得知触摸屏的设备节点。
参数 nonblock:表示是否以非阻塞方式打开触摸屏设备。

返回值：调用成功返回一个 struct tsdev *指针， 指向触摸屏设备句柄；如果打开设备失败，将返回 NULL。

5.3、ts_close()函数

关闭触摸屏设备。

#include "tslib.h"

int ts_close(struct tsdev *);

5.4、ts_config()函数

配置触摸屏设备。

注：所谓配置其实指的就是解析 ts.conf 文件中的配置信息，加载相应的插件。

#include "tslib.h"

int ts_config(struct tsdev *ts);

参数 ts:?指向触摸屏句柄。
返回值：成功返回 0，失败返回-1。

5.5、ts_read()函数

读取单点触摸数据。

#include "tslib.h"

int ts_read(struct tsdev *ts, struct ts_sample *samp, int nr);

参数 ts ：指向一个触摸屏设备句柄。

参数samp：指向一个 struct ts_sample 对象。

参数 nr ：表示对一个触摸点的采样数。

5.6、ts_read_mt()函数

用于读取多点触摸数据。

#include "tslib.h"

int ts_read_mt(struct tsdev *ts, struct ts_sample_mt **samp, int max_slots, int nr);

参数 ts ：指向一个触摸屏设备句柄。

参数samp：指向一个struct ts_sample_mt *对象。

参数max_slots ：表示触摸屏支持的最大触摸点数（可以通过调用 ioctl()函数获取到）。

参数 nr ：表示对一个触摸点的采样数。

5.7、ts_sample结构体

struct ts_sample 数据结构描述了触摸点的信息。

struct ts_sample {
    int x; //X 坐标
    int y; //Y 坐标
    unsigned int pressure; //按压力大小
    struct timeval tv; //时间
};

5.8、ts_sample_mt结构体

多点触摸的每一个触摸点的信息使用 struct ts_sample_mt 数据结构来描述；

struct ts_sample_mt {
    /* ABS_MT_* event codes. linux/include/uapi/linux/input-event-codes.h
    * has the definitions.
    */
    int x; //X 坐标
    int y; //Y 坐标
    unsigned int pressure; //按压力大小
    int slot; //触摸点 slot
    int tracking_id; //ID
    int tool_type;
    int tool_x;
    int tool_y;
    unsigned int touch_major;
    unsigned int width_major;
    unsigned int touch_minor;
    unsigned int width_minor;
    int orientation;
    int distance;
    int blob_id;
    struct timeval tv; //时间
    /* BTN_TOUCH state */
    short pen_down; //BTN_TOUCH 的状态
    /* valid is set != 0 if this sample
    * contains new data; see below for the
    * bits that get set.
    * valid is set to 0 otherwise
    */
    short valid; //此次样本是否有效标志 触摸点数据是否发生更新
};