FT5X06 如何应用在10寸电容屏（linux-3.5电容屏驱动简析&移植10寸电容屏驱动到Android4.2） （by liukun321咕唧咕唧）

这是几个月以前的东西了，在彻底遗忘之前拿出来好好写写。做个笔记，也算是造福后来人了。在做这个项目之前，没有做过电容屏的驱动，印象中的电容触摸屏是不需要校正的。IC支持多大的屏就要配多大的屏。但是拿到需求，发现要用FT5406做10寸屏，可是FT5406手册上明明写了，最大支持到8.9寸。由于经验不足，感到略懵。就去核实这个需求方案是不是搞错了？！得到的答案：蓝魔的平板也是这个搭配。这样， 那需求应该就没问题了。先看现象再说：

硬件搭起来看现象,如下图：



红色区域是FT5406上报有效数据的范围（1280*600），以左上角为原点 ，X轴方向上报数据的最大值1280，Y轴方向上报的最大数据是600.。但是我用的LG的10.1寸屏，分辨率为1366*768。若想把触摸IC上报的数据和像素点的值一一对应起来，只能通过校正了。开始做校正的时候有点犯抽。竟然自己写校正算法，代码冗长不说，校准误差也特别大。 还好，后来想起了tslib这个东西。tslib是专门为电阻屏设计的一个校正库，只能校正单点触摸数据。而FT5406是支持5点触摸的。
不过只需要校正一点就可以了，这个点与其他四个点的上报数据的偏差大小无区别，只需要在驱动中做相同的消除偏差处理即可。思路有了，下面就从驱动开始说起：

1. FT5406 在Linux 3.5 中的驱动要点----数据上报过程

FT5406是通过IIC总线同CPU进行数据交互的，内核中的驱动框架符合一个典型IIC设备驱动+输入子系统（默认大家是了解IIC设备驱动和输入子系统驱动的）。硬件I/O的初始化和寄存器配置就不在这里赘述了， 照着手册来就可以了。重点看一下，数据上报过程，先看一个FT5406 原理图（图中标的是5206 ，没关系接口是一样的）：：




原理图上可以看到，用到了EINT14这根中断线。通过这条中断线，差不多就能猜到上报流程了吧：当用户触摸到触摸板以后，产生中断，在中断服务程序中读IIC。这样就完成了一次数据的上报。下面就看看内核源码的实现，先看一个流程图：




中断代码实现如下：

static void ft5x0x_ts_pen_irq_work(struct work_struct *work) { //底半部中断
	struct ft5x0x_ts_data *ts = container_of(work, struct ft5x0x_ts_data, work);

	if (!ft5x0x_read_data(ts)) {
		ft5x0x_ts_report(ts);
	}

	enable_irq(this_client->irq);
}

static irqreturn_t ft5x0x_ts_interrupt(int irq, void *dev_id) {//顶半部中断
	struct ft5x0x_ts_data *ts = dev_id;

	disable_irq_nosync(this_client->irq);

	if (!work_pending(&ts->work)) {
		queue_work(ts->queue, &ts->work);
	}

	return IRQ_HANDLED;
}

从IC中读取触摸数据：

static int ft5x0x_read_data(struct ft5x0x_ts_data *ts) {
	struct ft5x0x_event *event = &ts->event;
	u8 buf[32] = { 0 };
	int ret;

#ifdef CONFIG_FT5X0X_MULTITOUCH
	ret = ft5x0x_i2c_rxdata(buf, 31);
#else
	ret = ft5x0x_i2c_rxdata(buf, 7);
#endif
	if (ret < 0) {
		printk("%s: read touch data failed, %d\n", __func__, ret);
		return ret;
	}

	memset(event, 0, sizeof(struct ft5x0x_event));

	event->touch_point = buf[2] & 0x07;

	if (!event->touch_point) {
		ft5x0x_ts_release(ts);
		return 1;
	}

#ifdef CONFIG_FT5X0X_MULTITOUCH
	switch (event->touch_point) {
		case 5:
			event->x[4] = (s16)(buf[0x1b] & 0x0F)<<8 | (s16)buf[0x1c];
			event->y[4] = (s16)(buf[0x1d] & 0x0F)<<8 | (s16)buf[0x1e];
		case 4:
			event->x[3] = (s16)(buf[0x15] & 0x0F)<<8 | (s16)buf[0x16];
			event->y[3] = (s16)(buf[0x17] & 0x0F)<<8 | (s16)buf[0x18];
		case 3:
			event->x[2] = (s16)(buf[0x0f] & 0x0F)<<8 | (s16)buf[0x10];
			event->y[2] = (s16)(buf[0x11] & 0x0F)<<8 | (s16)buf[0x12];
		case 2:
			event->x[1] = (s16)(buf[0x09] & 0x0F)<<8 | (s16)buf[0x0a];
			event->y[1] = (s16)(buf[0x0b] & 0x0F)<<8 | (s16)buf[0x0c];
		case 1:
			event->x[0] = (s16)(buf[0x03] & 0x0F)<<8 | (s16)buf[0x04];
			event->y[0] = (s16)(buf[0x05] & 0x0F)<<8 | (s16)buf[0x06];
			break;
		default:
			printk("%s: invalid touch data, %d\n", __func__, event->touch_point);
			return -1;
	}
#else
	if (event->touch_point == 1) {
		event->x[0] = (s16)(buf[0x03] & 0x0F)<<8 | (s16)buf[0x04];
		event->y[0] = (s16)(buf[0x05] & 0x0F)<<8 | (s16)buf[0x06];
	}
#endif

	event->pressure = 200;

	return 0;
}

上报过程代码：

static void ft5x0x_ts_report(struct ft5x0x_ts_data *ts) {
	struct ft5x0x_event *event = &ts->event;
	int x, y;
	int i;

#ifdef CONFIG_FT5X0X_MULTITOUCH
	for (i = 0; i < event->touch_point; i++) {
		if (swap_xy) {
			x = event->y[i];
			y = event->x[i];
		} else {
			x = event->x[i];
			y = event->y[i];
		}

		if (scal_xy) {
			x = (x * ts->screen_max_x) / TOUCH_MAX_X;
			y = (y * ts->screen_max_y) / TOUCH_MAX_Y;
		}

		input_report_abs(ts->input_dev, ABS_MT_POSITION_X, x);
		input_report_abs(ts->input_dev, ABS_MT_POSITION_Y, y);

		input_report_abs(ts->input_dev, ABS_MT_PRESSURE, event->pressure);
		input_report_abs(ts->input_dev, ABS_MT_TOUCH_MAJOR, event->pressure);
		input_report_abs(ts->input_dev, ABS_MT_TRACKING_ID, i);

		input_mt_sync(ts->input_dev);
	}
#else
	if (event->touch_point == 1) {
		if (swap_xy) {
			x = event->y[i];
			y = event->x[i];
		} else {
			x = event->x[i];
			y = event->y[i];
		}

		if (scal_xy) {
			x = (x * ts->screen_max_x) / TOUCH_MAX_X;
			y = (y * ts->screen_max_y) / TOUCH_MAX_Y;
		}

		input_report_abs(ts->input_dev, ABS_X, x);
		input_report_abs(ts->input_dev, ABS_Y, y);
		input_report_abs(ts->input_dev, ABS_PRESSURE, event->pressure);
	}

	input_report_key(ts->input_dev, BTN_TOUCH, 1);
#endif

	input_sync(ts->input_dev);
}

IC驱动的大致工作流程就是这样的，下面就来看看该怎么去做校正：

一、这个电容屏是往exynos4412 核心 Android4.2设备上移植的，所以第一步要做的是往Anroid移植TSlib1.4库。简述移植过程

1.生成configure

./autogen.sh

安装tslib中遇到的错误：./autogen.sh:
4: autoreconf: not found

是因为在不同版本的 tslib 下执行 autogen.sh 产生。它们产生的原因一样,是

因为没有安装
automake 工具,
(ubuntu 13.10)用下面的命令安装好就可以了。

sudo apt-get install autoconf automake libtool

2./configure
--host=交叉编译器路径（注意要用对应android平台自带的bionic c编译器而不是配套开发板的GNU C编译器）

ac_cv_func_malloc_0_nonnull=yes -static

在tslib/config.h文件中加入如下定义：

#define TS_CONF "/system/etc/ts.conf"

#define PLUGIN_DIR "/system/lib"

#define TS_POINTERCAL "/data/etc/pointercal"





另外由于bionic c 和GNU c的差异，需要修改几个tslib的头文件编译才能通过

将下面路径文件

tslib/src/ts_open.c

tslib/tests/ts_calibrate.c

tslib/tests/fbutils.c

中的

#include <sys/fcntl.h>

修改成

#include <fcntl.h>

将tslib/tests/ts_calibrate.c文件中

static int clearbuf(struct tsdev *ts)

修改为

static void clearbuf(struct tsdev *ts)



如果使用GNU C编译器在android shell下运行ts_calibrate会出现如下错误：

sh:
./system/bin/ts_calibrate: No such file or directory








3.编译make

将etc/ts.conf 的参考配置：

修改tslib/etc/ts.conf内容如下：

module_raw input

module pthres pmin=1

module variance delta=30

module dejitter delta=100

module linear

4.在android源代码init.rc中声明tslib相关环境变量如下：

# touchscreen parameters

export TSLIB_FBDEVICE /dev/graphics/fb0

export TSLIB_CALIBFILE /data/etc/pointercal

export TSLIB_CONFFILE /system/etc/ts.conf

export TSLIB_TRIGGERDEV /dev/input/event0

export TSLIB_TSDEVICE /dev/input/event1



5. 将/src/.lib
中生成的库文件，分别全部拷贝开发板的根文件系统对应/system/lib
目录中，将tests目录中的ts_calibrate cp到system/bin中

到此完成对tslib的移植。

在运行[b]ts_calibrate前首先要取消内核对多点触摸的支持，因为tslib只能处理单点的数据格式，而且单点的数据，必须要满足以下上报顺寻：[/b]

[b]
input_report_abs(ts->input_dev, ABS_X, x);

input_report_abs(ts->input_dev, ABS_Y, y);

input_report_abs(ts->input_dev, ABS_PRESSURE, event->pressure);

[/b]

通过运行ts_calibrate，获得校正参数，存放在/data 目录下的pointercal文件中
最后要做的就是修改内核驱动 /drivers/input/touchscreen/ft5x06_ts.c，添加校正算法(如下)并添加获得的校正参数（红色标注即为获得的校正参数）。如下：

#ifdef CONFIG_INPUT_TS_LINEAR
static int ts_linear_scale(int *x, int *y, int swap_xy)
{
        int xtemp, ytemp;
        int a[7] = {87701,-382,-420352,-89,84218,-936128,65536};
        xtemp = *x;
        ytemp = *y;

        if (a[6] == 0)
            return -EINVAL;

        *x = (a[2] + a[0] * xtemp + a[1] * ytemp) / a[6];
        *y = (a[5] + a[3] * xtemp + a[4] * ytemp) / a[6];

        if (swap_xy) {
                int tmp = *x;
                *x = *y;
                *y = tmp;
        }
        return 0;
}
#endif

static void ft5x0x_ts_report(struct ft5x0x_ts_data *ts) {

struct ft5x0x_event *event = &ts->event;

int x, y;

int i;

#ifdef CONFIG_FT5X0X_MULTITOUCH

for (i = 0; i < event->touch_point; i++) {

if (swap_xy) {

x = event->y[i];

y = event->x[i];

} else {

x = event->x[i];

y = event->y[i];

}

if (scal_xy) {

x = (x * ts->screen_max_x) / TOUCH_MAX_X;

y = (y * ts->screen_max_y) / TOUCH_MAX_Y;

}

#ifdef CONFIG_INPUT_TS_LINEAR

ts_linear_scale(&x, &y, swap_xy);

#endif

在上报过程 首先通过static int ts_linear_scale(int *x, int *y, int swap_xy)函数将从IC获得的触摸点坐标消除偏差。