利用tslib为MiniGui提供触摸屏的IAL引擎(2)---tslib 的 API 接口介绍

 

tslib 的 API 接口

      作者的想法是通过 tslib 来构建 MiniGUI 的输入引擎。tslib 是一个用于触摸屏设备的函数库。通过这样一个函数库，可以将编程者从繁琐的数据处理中解脱出来。为什么会出现这样的情况呢？因为触摸屏的坐标和液晶显示屏 之间的坐标并不是一一对应的， 所以，要让从触摸屏上得到的坐标正确转换为液晶显示屏上的坐标，需要经过一个转换过程。除此之外，tslib 还以插件的形式提供了一些附加的功能，比如去除点击触摸屏时的抖动等。
      下面就先来看看 tslib 都提供了哪些接口。首先，tslib 中定义了两个结构体：
struct tsdev {
      int fd;
      struct tslib_module_info *list;
     };
struct ts_sample {
      int       x;
      int       y;
      unsigned int      pressure;
      struct timeval tv;
};
      struct tsdev 表示的是触摸屏设备，其中，fd 是打开的触摸屏设备的文件描述符，list 是一个链表，在这个链表中依次存放着指向 tslib 的插件的指针。
      struct ts_sample 用于存放按键消息，x 和 y 表示按键的坐标位置，注意这两个坐标都是以液晶屏幕的坐标系为基准的，pressure 表示的是按键的轻重程度，tv 是一个 struct timeval类型的变量，表示按键发生的时间。
      在基于 tslib 的程序中，所要用到的数据结构就只有上面这样两个。下面再看看 tslib 的函数，这里只列举后面将会用到的几个函数：
struct tsdev *ts_open(const char *dev_name, int nonblock);
int ts_config(struct tsdev *);
int ts_close(struct tsdev *);
int ts_fd(struct tsdev *);
int ts_read(struct tsdev *, struct ts_sample *, int);
      ts_open()函数打开触摸屏设备， 第一个参数 dev_name 是要打开的触摸屏设备的文件名，第二个参数 nonblock 指明以何种方式读写触摸屏设备，如果 nonblock 非 0，则以非阻塞方式访问，如果 nonblock 为 0，则以阻塞方式访问。如果 ts_open()打开触摸屏设备成功，则返回一个 struct tsdev 类型的指针，否则返回 NULL。
      ts_config()函数的作用是读取触摸屏配置文件，并决定是否加载相关的插件。在作者所用的平台上，触摸屏配置文件为/etc/ts.conf，其内容如下：
module variance xlimit=50 ylimit=50 pthreshold=1
module dejitter xdelta=10 ydelta=10 pthreshold=1
module linear
      上述内容表明 tslib 要加载三个插件模块，其作用分别是限定点击力度的方差、去除点击抖动、将触摸屏上的点击坐标转换成液晶屏幕上的坐标。variance 模块会采集四个采样点， 只有当这四个采样点在 x 轴和 y 轴方向上的方差都小于或等于模块参数 xlimit并计算其方差，和 ylimit 限定的范围时，这几个采样点才会被接受，否则 variance 模块将重新采集四个采样点计算。直到有符合要求的采样点才会将其递交给应用程序。dejitter 模块的作用是去抖动，其参数的含义用当前的采样点的坐标与前一个采样点的坐标求差值，    只有当差值小于或者等于 xdelta 和 ydelta 限定的范围时，采样点的坐标值才有效。
      如果正确加载了插值模块，ts_config()返回 0，否则返回-1。
      ts_close()的作用是释放触摸屏设备以及相关的资源。
      ts_fd()返回打开的触摸屏设备的文件描述符。
      ts_read()的作用是从触摸屏设备中读取采样点的坐标。第一个参数指向一个已经打开的触摸屏设备，第二个参数是一个 struct ts_sample 指针，从触摸屏设备读取到的值将填充到该指针指向的空间中，第三个参数指定了要读取多少个采样点。 有两个文件是与 tslib 密切相关的， ts.conf 指出了 MiniGUI、应该加载哪些插件模块。 这两个文件的位置是由当前环境变量指定的，详细请见下文中的有关Tslib的环境变量、配置文件等进行简要的介绍的 文章，需要注意的是这里的配置文件的路径必须放置正确，否则程序运行时将会报错。另一个文件是 pointercal，在这个文件中包含了触摸屏的校准数据（calibration）   ，正是由于该文件的存在，tslib 才能正确地在触摸屏坐标和液晶屏幕的坐标之间进行转换。在 tslib 的源代码中包含了工具 ts_calibrate，如果没有 pointercal 文件，那么可以用这个工具来产生 pointercal 文件中的校准数据。（首先运行它在目标板上产生pointercal文件）;

转载注明出处：http://hi.baidu.com/luv%5Fresplendent/modify/blog/eb8f5d032f64878ed43f7cfe