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，接着运行着的线程被叫醒，执行坐标上报关键代码。

至此一个驱动大概框架就是这样，后面再为大家带来一些细致的讲解