MTK-TP(触屏)解读一
MTK中的TP代码结构并不复杂，相比于其他的系统更为的简单些。它使用的是input子系统，通过该系统来上报触摸按键。
首先我们来看看TP的文件夹下的各代码文件的功能。
|
文件名 |
具体功能 |
关系文件 |
|
tpd.h |
一些宏和extern 函数，外部使用 |
Mtk_tpd.c |
|
tpd_button.c |
关于实体按键的定义 |
|
|
Tpd_calibrate.c |
矫准，比如偏移，可能是MTK以前做电阻屏留下的架构 |
|
|
Tpd_calibrate.h |
矫准，一些宏和数据结构 |
|
|
Tpd_debug.c |
一些函数用于debug信息 |
|
|
Tpd_debug.h |
一些dubug信息和函数申明 |
|
|
Tpd_default.c |
函数似乎为完成，函数只有一个 |
|
|
Tpd_default.h |
似乎未完成 |
|
|
Tpd_init.c |
空文件夹 |
|
|
Tpd_misc.c |
导出一些符号，基本都是切换模式函数 |
|
|
Tpd_setting.c |
传些参数至上层应用 |
|
|
MTK_tpd.c |
关键代码区 |
|
|
met_ftrace_touch.h |
Ftrace工具，用来代码内追踪运行情况 |
|
以上代码文件中较为重要的就是mtk_tpd.c，故重点分析该文件。
在此会有以下几个关键的点：
1.mtk_tpd.c中的函数运行流程。
2.mtk_tpd.c中的input系统。
3.注册i2C
4.tpd_driver_add函数
5.LDO芯片设置
6.通过设备数或者其他方式获取RST，EINT引脚号
7.通过设备节点获得中断，并请求一个中断号，和注册中断handle
8.运行线程开启
9.中断处理函数，唤醒线程，并上报键值
在此，我将这几个分为一些几部分：
一、注册MTK下的TP框架，与建立I2C框架。
二、在probe函数中完成相应电源，设备数，硬件中断，GPIO等设置。
三、建立一个上报框架分为如下：1）开启一个线程2)申请一个中断irq来绑定硬件中断触发3）irq_handle中唤醒work 4）work在唤醒wait事件5）开启的线程等到wait事件执行上报关键代码。，否则睡眠。
四、填充关键的TP上报代码（input系统上报）。
1.mtk_tpd.c中的函数运行流程。
mtk_tpd.c中，我们最先查看init函数，也就是module添加。
1 static int tpd_remove(struct platform_device *pdev) 2 { 3 input_unregister_device(tpd->dev); 4 return 0; 5 } 6 7 /* called when loaded into kernel */ 8 static int __init tpd_device_init(void) 9 { 10 TPD_DEBUG("MediaTek touch panel driver init\n"); 11 if (platform_driver_register(&tpd_driver) != 0) { 12 TPD_DMESG("unable to register touch panel driver.\n"); 13 return -1; 14 } 15 return 0; 16 }
可能有些版本的代码是使用了workqune去注册的，使用这个是让tpd的probe在所有子tp系统add之后再运行mtk_tpd中的probe。
看到上面代码中，在init中建立一个workqueue，这样使得tpd_init_work_callback中的platform_driver_register延迟工作，在被内核调度室才会进行注册，注册时的probe函数也随之延后运行。（具体作用暂时不知，我们仅仅知道注册了一个platform设备）。
接下来再看tpd_driver_add：
1 /* Add driver: if find TPD_TYPE_CAPACITIVE driver successfully, loading it */ 2 int tpd_driver_add(struct tpd_driver_t *tpd_drv) 3 { 4 int i; 5 6 if (g_tpd_drv != NULL) { 7 TPD_DMESG("touch driver exist\n"); 8 return -1; 9 } 10 /* check parameter */ 11 if (tpd_drv == NULL) 12 return -1; 13 14 //runyee zhou add device info,20161012 15 #if defined(CONFIG_RUNYEE_DEVICE_INFO_SUPPORT) 16 hct_touchpanel_device_add(tpd_drv,DEVICE_SUPPORTED); 17 #endif 18 19 20 tpd_drv->tpd_have_button = tpd_dts_data.use_tpd_button; 21 /* R-touch 电阻屏，geneic也就是list[0]为电阻屏*/ 22 if (strcmp(tpd_drv->tpd_device_name, "generic") == 0) { 23 tpd_driver_list[0].tpd_device_name = tpd_drv->tpd_device_name; 24 tpd_driver_list[0].tpd_local_init = tpd_drv->tpd_local_init; 25 tpd_driver_list[0].suspend = tpd_drv->suspend; 26 tpd_driver_list[0].resume = tpd_drv->resume; 27 tpd_driver_list[0].tpd_have_button = tpd_drv->tpd_have_button; 28 return 0; 29 } 30 for (i = 1; i < TP_DRV_MAX_COUNT; i++) { 31 /* add tpd driver into list 使用该函数就会被填入到list中*/ 32 if (tpd_driver_list[i].tpd_device_name == NULL) { 33 tpd_driver_list[i].tpd_device_name = tpd_drv->tpd_device_name; 34 tpd_driver_list[i].tpd_local_init = tpd_drv->tpd_local_init; 35 tpd_driver_list[i].suspend = tpd_drv->suspend; 36 tpd_driver_list[i].resume = tpd_drv->resume; 37 tpd_driver_list[i].tpd_have_button = tpd_drv->tpd_have_button; 38 tpd_driver_list[i].attrs = tpd_drv->attrs; 39 #if 0 40 if (tpd_drv->tpd_local_init() == 0) { 41 TPD_DMESG("load %s successfully\n", 42 tpd_driver_list[i].tpd_device_name); 43 g_tpd_drv = &tpd_driver_list[i]; 44 } 45 #endif 46 break; 47 } 48 if (strcmp(tpd_driver_list[i].tpd_device_name, tpd_drv->tpd_device_name) == 0) 49 return 1; /* driver exist */ 50 } 51 52 return 0; 53 }
在此函数中的tpd_driver_list是一个全局的tpd_driver_t结构体，里面的TP_DRV_MAX_COUNT是支持的最大tp设备数。
驱动中调用add来向tpd_driver_list添加一个新的设备，并在添加前检查该名字是否为NULL，保证add在最末尾。
接着看probe函数，我们跳过probe前面部分，直接到：
1 /* save dev for regulator_get() before tpd_local_init() */ 2 tpd->tpd_dev = &pdev->dev; 3 for (i = 1; i < TP_DRV_MAX_COUNT; i++) { 4 /* add tpd driver into list */ 5 if (tpd_driver_list[i].tpd_device_name != NULL) { 6 tpd_driver_list[i].tpd_local_init();//执行具体TP驱动的local_init 7 /* msleep(1); */ 8 if (tpd_load_status == 1) { 9 TPD_DMESG("[mtk-tpd]tpd_probe, tpd_driver_name=%s\n", 10 tpd_driver_list[i].tpd_device_name); 11 g_tpd_drv = &tpd_driver_list[i]; 12 // 13 #if defined(CONFIG_RUNYEE_DEVICE_INFO_SUPPORT) 14 hct_set_touch_device_used(g_tpd_drv->tpd_device_name, 0); 15 #endif 16 break; 17 } 18 } 19 } 20 if (g_tpd_drv == NULL) { 21 if (tpd_driver_list[0].tpd_device_name != NULL) { 22 g_tpd_drv = &tpd_driver_list[0]; 23 /* touch_type:0: r-touch, 1: C-touch */ 24 touch_type = 0; 25 g_tpd_drv->tpd_local_init(); 26 TPD_DMESG("[mtk-tpd]Generic touch panel driver\n"); 27 } else { 28 TPD_DMESG("[mtk-tpd]cap touch and Generic touch both are not loaded!!\n"); 29 return 0; 30 } 31 }
在这里面我们可以看到，这里会遍历tpd_driver_list这个表，并且执行表中所有的tpd_local_init函数,而tpd_local_init通常会注册i2C驱动，在register时会执行i2c的probe函数，这样在一个probe函数中将所有的TP注册全部完成。
在最末尾，执行了input系统注册：
1 /* use fb_notifier */ 2 tpd_fb_notifier.notifier_call = tpd_fb_notifier_callback;//和上层接收TP是否存在相关 3 if (fb_register_client(&tpd_fb_notifier)) 4 TPD_DMESG("register fb_notifier fail!\n"); 5 /* TPD_TYPE_CAPACITIVE handle */ 6 if (touch_type == 1) { 7 //正常的input设备注册 8 set_bit(ABS_MT_TRACKING_ID, tpd->dev->absbit); 9 set_bit(ABS_MT_TOUCH_MAJOR, tpd->dev->absbit); 10 set_bit(ABS_MT_TOUCH_MINOR, tpd->dev->absbit); 11 set_bit(ABS_MT_POSITION_X, tpd->dev->absbit); 12 set_bit(ABS_MT_POSITION_Y, tpd->dev->absbit); 13 input_set_abs_params(tpd->dev, ABS_MT_POSITION_X, 0, TPD_RES_X, 0, 0); 14 input_set_abs_params(tpd->dev, ABS_MT_POSITION_Y, 0, TPD_RES_Y, 0, 0); 15 #if defined(CONFIG_MTK_S3320) || defined(CONFIG_MTK_S3320_47) \ 16 || defined(CONFIG_MTK_S3320_50) || defined(CONFIG_MTK_MIT200) \ 17 || defined(CONFIG_TOUCHSCREEN_SYNAPTICS_S3528) || defined(CONFIG_MTK_S7020) 18 input_set_abs_params(tpd->dev, ABS_MT_PRESSURE, 0, 255, 0, 0); 19 input_set_abs_params(tpd->dev, ABS_MT_WIDTH_MAJOR, 0, 15, 0, 0); 20 input_set_abs_params(tpd->dev, ABS_MT_WIDTH_MINOR, 0, 15, 0, 0); 21 input_mt_init_slots(tpd->dev, 10, 0); 22 #else 23 input_set_abs_params(tpd->dev, ABS_MT_TOUCH_MAJOR, 0, 100, 0, 0); 24 input_set_abs_params(tpd->dev, ABS_MT_TOUCH_MINOR, 0, 100, 0, 0); 25 #endif /* CONFIG_MTK_S3320 */ 26 TPD_DMESG("Cap touch panel driver\n"); 27 } 28 input_set_abs_params(tpd->dev, ABS_X, 0, TPD_RES_X, 0, 0); 29 input_set_abs_params(tpd->dev, ABS_Y, 0, TPD_RES_Y, 0, 0); 30 input_abs_set_res(tpd->dev, ABS_X, TPD_RES_X); 31 input_abs_set_res(tpd->dev, ABS_Y, TPD_RES_Y); 32 input_set_abs_params(tpd->dev, ABS_PRESSURE, 0, 255, 0, 0); 33 input_set_abs_params(tpd->dev, ABS_MT_TRACKING_ID, 0, 10, 0, 0); 34 35 if (input_register_device(tpd->dev)) 36 TPD_DMESG("input_register_device failed.(tpd)\n");
在此就不展开input_set_abs_params参数的意义，后面会继续深入。
2.mtk_tpd.c中的input系统
要向用户空间发送信息，且是中断，少不了input系统，这里使用MTK中自带的GT9XXTB_hotknot来分析：
1 static int tpd_history_x = 0, tpd_history_y; 2 static void tpd_down(s32 x, s32 y, s32 size, s32 id) 3 { 4 if ((!size) && (!id)) { 5 input_report_abs(tpd->dev, ABS_MT_PRESSURE, 100); 6 input_report_abs(tpd->dev, ABS_MT_TOUCH_MAJOR, 100); 7 } else { 8 input_report_abs(tpd->dev, ABS_MT_PRESSURE, size); 9 input_report_abs(tpd->dev, ABS_MT_TOUCH_MAJOR, size); 10 /* track id Start 0 */ 11 input_report_abs(tpd->dev, ABS_MT_TRACKING_ID, id); 12 } 13 14 input_report_key(tpd->dev, BTN_TOUCH, 1); 15 input_report_abs(tpd->dev, ABS_MT_POSITION_X, x); 16 input_report_abs(tpd->dev, ABS_MT_POSITION_Y, y); 17 input_mt_sync(tpd->dev); 18 TPD_DEBUG_SET_TIME; 19 TPD_EM_PRINT(x, y, x, y, id, 1); 20 tpd_history_x = x; 21 tpd_history_y = y; 22 /* MMProfileLogEx(MMP_TouchPanelEvent, MMProfileFlagPulse, 1, x+y); */ 23 if (tpd_dts_data.use_tpd_button) { 24 if (FACTORY_BOOT == get_boot_mode() || 25 RECOVERY_BOOT == get_boot_mode()) 26 tpd_button(x, y, 1); 27 } 28 }
这一段tdp_down是关键的上报代码，也就是说最后从TP芯片来的坐标数据需要通过以上input_report_adbs等函数来上报，那先暂时记住该部分。其中的input其实是不需要再次去注册的，因为在mtk_tpd.c中已经注册，只需要：extern struct tpd_device *tpd; 例子中在include/tpd_gt9xx_common.h有定义。
那么我们大概清楚了，MTK下的TP其实就是我们自己写驱动上报（我们需要做的事），其他的input系统注册我们就不操心了。那么大多数TP都是i2c，我们则需要进行i2c注册。
3.具体驱动中的i2c注册
注册I2C这里就简略提一下，i2C可以使用各种方式注册，在此实例使用的是i2c_board_info来注册，同样的先注册device，然后在drivers注册时会匹配进入probe，其中需要做以下事情：
static s32 tpd_i2c_probe(struct i2c_client *client, const struct i2c_device_id *id) { //1.i2c_clien获得，给read，write函数使用 //2.上电，因为有些TP可能是使用LDO去控制的，所以要开启电源regulator_set_voltage或者mtk的hwPowerDown(MT65XX_POWER_LDO_VGP2, "TP"); //3.使用设备树，或者直接设置RST，INT脚的状态。 //4.简易的test测试tp是否存在，比如读取version，添加异常处理 //5.INT脚配置硬件中断申请，并链接处理函数 //6.使用 kthread_run开启一个可休眠线程，等待中断唤醒处理坐标上报 //7.添加自己的input参数，比如压力，按压面的size //8.与芯片相关的其他操作 }
以上操作都可在代码中发现，也是一些基本的必须的设置，调试时应该先以大体框架通过为主，大体框架就是，local_init->i2c_probe->相关函数设置(thread_run有没有跑，中断函数是否申请了，设备树是否成功匹配)，然后再去进行硬件调试：i2c通不通，中断是否能正常触发，能否读取版本等。
4.tpd_driver_add函数
1 /* called when loaded into kernel */ 2 static int __init tpd_driver_init(void) 3 { 4 GTP_INFO("MediaTek gt91xx touch panel driver init\n"); 5 tpd_get_dts_info(); 6 if (tpd_driver_add(&tpd_device_driver) < 0) 7 GTP_INFO("add generic driver failed\n"); 8 9 return 0; 10 }
在init函数中加入tpd_driver_add 函数。这样只要以下流程完成即可调试硬件。
至此，添加一个MTK TP的框架搭建完了，回顾下，主要是：
1. I2C框架，device与driver注册，还有probe函数（接下来的工作）
2. 使用tpd_driver_add向MTK TP框架添加设备，完成local_tpd_init函数
总结下运行流程如下：
5.各操作实例
5.1.LDO芯片设置
有些硬件使用PMU来为TP供电，所以有可能需要使用代码来设备如：
如果没有的话就直接设置供电打开即可。
5.2通过设备树或者其他方式获取RST，EINT引脚号
有些平台使用的是设备树来获取的这两个引脚，这里我的是MTK6755平台，如下：
也可以使用GPIO_request来获取，只要能做到控制这两个引脚即可。
5.3通过设备节点获得中断，并请求一个中断号，和注册中断handle
因为上报事件应该定义为一个中断事件，故应该为ENIT引脚分配一个中断号，并申请中断handle。在此使用的是通过设备节点来申请的中断节点，也是使用的是MTK的设备树来获取的，所以可能需要修改dtsi。
紫色框中是MTK的注册硬件IRQ handle 的方法，而这里使用的是设备树获取中断硬件中断号，并分配中断向量号，之候使用request来注册中断handle。
5.4运行线程开启
报点需要高响应，延迟低，所以为TP开启一个线程来保证高效。具体代码如下：
我们进入ilitek_irq_handle_thread
红色框中是关键的TP坐标上报代码，而在此之前这个线程是睡眠的，只是偶尔运行一次，该线程等待中断事件打断，并运行，而唤醒的代码则在之前申请的硬件中断的handle中的work会唤醒。
5.5中断处理函数，唤醒线程，并上报键值
该函数则是唤醒wait，则在上节的线程会被唤醒，进行关键的上报代码。
也就是说当你的手触摸屏幕，屏幕的中断引脚会产生中断（拉低或者高），使得申请的硬件中断handle运行，handle中唤醒wait，接着运行着的线程被叫醒，执行坐标上报关键代码。
至此一个驱动大概框架就是这样，后面再为大家带来一些细致的讲解
