首页 > 代码库 > 基于GPL329xx linux平台电容屏gsl1680的驱动调试分析

基于GPL329xx linux平台电容屏gsl1680的驱动调试分析

   因客户有用到了gsl1680 7寸电容屏,所以拿了一块过来,便在329xx的平台上面开始调试了。

       大概浏览了一下所提供的资料,只有介绍模组的资料跟一份中文版的datasheet,datasheet只是说了个大概,没有提到读取触摸坐标的寄存器。不过还好有给一份在其他处理器平台的驱动,所以读取坐标的部分代码移植过来就可以了。

      gsl1680接口跟其他的电容屏一样,也是i2c接口的,貌似市面上的电容屏都是i2c接口,电容屏自带了微控制器MCU,用与处理采样,坐标转换等,还有一些抖动算法处理,完后将坐标保存在固定的寄存器里面,之后会给出一个中断信号输出到pin脚,通知主控读取坐标。不过手上拿到这一款内部是没有flash的,即自身不带firmware的,初始化时要靠主控将firmware透过i2c接口加载到触摸屏的RAM里面,之后电容屏才能正常工作。个人觉得这种方式有两个缺点:1.firmware有8000多个值,加载需要花掉大概10s左右,增加了开机时间(后续可以将i2c clk调为400K试试看);2.本身不带firmware,需要加载才能工作,无疑给调试增加了难度。不过,相对电阻屏,电容屏的调试还是比较简单的,不必处理采样/转换,还有干扰/抖动等问题。电容屏而言,自带了的MCU,所以这些工作都已经帮你做好了,倒是很方便。

       下面我们具体先看一下gsl1680硬件模组的接口,总共有12个pin,有效的只有6个pin,分别是GND,VCC,SDA,SCL,IO CNTL,INT。

1----GND       2-----NC

3----NC          4-----NC

5----NC          6-----GND

7----SDA        8-----SCL

9----IO Cntl  10-----INT

11----VDD     12-----VDD

简单说明一下:

1,6 :pin接GND;

2,3,4,5  悬空

7,8    i2c接口

9   IO Cntl  硬件reset/wake pin

10 INT 中断pin脚

11,12   VCC接3.0或者3.3V

 

      了解了上面的硬件接口,触摸屏需要占用的主控的硬件资源有:i2c接口,一个外部中断,一个GPIO(用于控制触摸屏硬件reset/power down进入省电模式)就可以完成触摸屏坐标的获取了。

       下面,先介绍一下驱动具体流程。

1.module_init函数里面,注册平台设备platform device;

2.注册platform device driver;

static struct platform_device gp_tp_device = {
 .name = "gp_tp",
 .id   = -1,
 .dev = {
  .release = gp_tp_device_release,
 }
};

static struct platform_driver gp_tp_driver = {
       .driver         = {
        .name   = "gp_tp",
        .owner  = THIS_MODULE,
       },
       .probe          = gp_tp_probe,
       .remove         = gp_tp_remove,
       .suspend        = gp_tp_suspend,
       .resume         = gp_tp_resume,

};

上面的platform_driver里面的probe函数将会完成以下几件事情:

1)创建单一内核线程,注册内核线程函数,用于中断下半部的触摸屏坐标的读取,以及将坐标值上报给linux input子系统;

      通过调用create_singlethread_workqueue API创建一个工作队列内核线程;

2)创建一个event设备,从触摸屏获取到的坐标会上报给event,用户层将会从这个event读取到触摸屏按下的坐标;

3)i2c 设备的申请;用于与触摸屏通信跟加载firmware;

4)申请一个GPIO口,用于控制触摸屏的reset/wake ,即接到9 IO Cntl pin脚;

5)软件/硬件复位触摸屏,加载firmware;

6)申请/注册外部中断函数;

以上就是在probe函数里面完成的工作,接下来就是等待触摸屏按下,然后中断函数通知内核线程函数去读取触摸的坐标,上报给event,

之后也是不断循环这个过程。

  触摸屏驱动probe函数完整的实现代码如下所示:

/** device driver probe*/
static int __init gp_tp_probe(struct platform_device *pdev)
{
 int rc;
 int ret = 0;
 int intidx, slaveAddr;
 int io_wake= -1;
 gpio_content_t ctx; 
 unsigned int debounce = 1;//27000; /*1ms*/
 //gp_board_touch_t *touch_config = NULL;
 
 print_info("Entering gp_tp_probe\n");

#ifdef VIRTUAL_KEYS
 virtual_keys_init();
#endif

 memset(&ts, 0, sizeof(gp_tp_t));

 /* Create single thread work queue */
 ts.touch_wq = create_singlethread_workqueue("touch_wq");
 if (!ts.touch_wq)
 {
  print_info("%s unable to create single thread work queue\n", __func__);
  ret = -ENOMEM;
  goto __err_work_queue;
 }
 INIT_WORK(&ts.mt_set_nice_work, gp_mt_set_nice_work);
 queue_work(ts.touch_wq, &ts.mt_set_nice_work);

 ts.dev = input_allocate_device();
 if ( NULL==ts.dev ){
  print_info("Unable to alloc input device\n");
  ret = -ENOMEM;
  goto __err_alloc;
 }

I2C_REQUEST:
 gp_i2c_handle = gslx680_i2c_request();
 if (gp_i2c_handle == -1) {
  DIAG_ERROR("cap touch panel iic request error!\n");
  goto I2C_REQUEST;
  return -ENOMEM;
 }

 __set_bit(EV_ABS, ts.dev->evbit);

 input_set_abs_params(ts.dev, ABS_MT_POSITION_X, 0, SCREEN_MAX_X - 1, 0, 0);
 input_set_abs_params(ts.dev, ABS_MT_POSITION_Y, 0, SCREEN_MAX_Y - 1, 0, 0);
 input_set_abs_params(ts.dev, ABS_MT_TRACKING_ID, 0, (MAX_CONTACTS + 1), 0, 0);
 input_set_abs_params(ts.dev, ABS_MT_TOUCH_MAJOR, 0, 255, 0, 0);

 input_set_capability(ts.dev, EV_KEY, KEY_BACK);
 input_set_capability(ts.dev, EV_KEY, KEY_HOME);
 input_set_capability(ts.dev, EV_KEY, KEY_MENU);

 ts.dev->name = "gp_ts";
 ts.dev->phys = "gp_ts";
 ts.dev->id.bustype = BUS_I2C;

 /* All went ok, so register to the input system */
 rc = input_register_device(ts.dev);
 if (rc) {
  ret = -EIO;
  goto __err_reg_input;
 }
 /* request cpt reset pin*/
 intidx = MK_GPIO_INDEX( RST_CHANNEL, RST_FUNC, RST_GID, RST_PIN );
 touch_reset = gp_gpio_request(intidx, "touch_reset"); /* GPIO1[7] ---- */
 if(IS_ERR((void*)touch_reset)) {
  print_info("%s unable to register client\n", __func__);
  ret = -ENOMEM;
  goto __err_register;
 }
 gp_gpio_set_output(touch_reset, 1,0);

 DBG_PRINT("=======gslx680 ctp test=====\n");
 gp_i2c_handle = gslx680_i2c_request();
 if (gp_i2c_handle == -1) {
  DIAG_ERROR("cap touch panel iic request error!\n");
  return -ENOMEM;
 }

  gp_gpio_set_output(touch_reset, 0,0);
 msleep(100);
 gp_gpio_set_output(touch_reset, 1,0);
 msleep(100);
 reset_chip();
 gp_load_ctp_fw();
 startup_chip();
 msleep(50);
 reset_chip();
 startup_chip();

 //gp_i2c_bus_release(gp_i2c_handle);

 INIT_WORK(&ts.mt_work, gp_multi_touch_work);

 intidx = MK_GPIO_INDEX( INT_IRQ_CHANNEL, INT_IRQ_FUNC, INT_IRQ_GID, INT_IRQ_PIN );
 ts.client = gp_gpio_request(intidx, "touch_int"); /* GPIO1[7] ---- */
 if(IS_ERR((void*)ts.client)) {
  print_info("%s unable to register client\n", __func__);
  ret = -ENOMEM;
  goto __err_register;
 }
 gp_gpio_set_input(ts.client, GPIO_PULL_LOW);
 gp_gpio_irq_property(ts.client, GPIO_IRQ_EDGE_TRIGGER|GPIO_IRQ_ACTIVE_RISING, &debounce);
 gp_gpio_register_isr(ts.client, gp_ts_callback, (void *)ts.client);

 print_info("End gp_tp_probe\n");

 return 0;


__err_register:
 input_unregister_device(ts.dev);
__err_reg_input:
 //gp_ti2c_bus_release(ts.i2c_handle);
__err_i2c:
// kfree(ts.i2c_handle); 
__err_i2c_allocate:
 //gp_gpio_release(ts.touch_reset);
__err_pin_request:
 input_free_device(ts.dev);
__err_alloc:
 destroy_workqueue(ts.touch_wq);
__err_work_queue:
 return ret;
}

   触摸屏按下中断处理函数如下所示

/**
 * interrupt callback
 */
void gp_ts_callback(void* client)
{
 gp_gpio_enable_irq(ts.client, 0);
 queue_work(ts.touch_wq, &ts.mt_work);
}

  linux的中断机制一般分为两个部分:上半部跟下半部。上半部处理的工作一般要尽可能的少,快速;而将繁重、繁琐、处理时间比较长的工作留在下半部去处理。所以,上半部执行的任务算是比较轻松的,这里只是清掉了外部中端状态寄存器,然后调度下半部工作的运行。

  下面我们再看一下,触摸屏按下中断的下半部的工作:

static void
gp_mt_set_nice_work(
 struct work_struct *work
)
{
 print_info("[%s:%d]\n", __FUNCTION__, __LINE__);
 set_user_nice(current, -20);
}

static inline unsigned int  join_bytes(unsigned char a, unsigned char b)
{
 unsigned int ab = 0;
 ab = ab | a;
 ab = ab << 8 | b;
 return ab;
}

static void
gp_multi_touch_work(
 struct work_struct *work
)
{

 int i,ret;
 char touched, id;
 unsigned short x, y;
 unsigned int pending;
 int irq_state;
  char tp_data[(MULTI_TP_POINTS + 1)*4 ];
  
 //print_info("WQ  gp_multi_touch_work.\n");

#if ADJUST_CPU_FREQ
 clockstatus_configure(CLOCK_STATUS_TOUCH,1);
#endif

 ret = gsl_ts_read(0x80, tp_data, sizeof(tp_data));
 if( ret < 0) {
  print_info("gp_tp_get_data fail,return %d\n",ret);
  gp_gpio_enable_irq(ts.client, 1);
  return;
 }

 touched = (tp_data[0]< MULTI_TP_POINTS ? tp_data[0] : MULTI_TP_POINTS);
 for (i=1;i<=MAX_CONTACTS;i++) {
  id_state_flag[i] = 0;  
 }
 //printk("point = %d  ",touched);
 for (i = 0; i < touched; i++) {
  id = tp_data[4 *( i + 1) + 3] >> 4;
  x = join_bytes(tp_data[4 *( i + 1) + 3] & 0xf,tp_data[4 *( i + 1) + 2]);
  y = join_bytes(tp_data[4 *( i + 1) + 1],tp_data[4 *( i + 1) + 0]);  
  if(1 <= id && id <= MAX_CONTACTS){
   record_point(x, y, id);
   report_data(x_new, y_new, 10, id);
   id_state_flag[id] = 1;
  }
 }
 if (touched == 0) {
  input_mt_sync(ts.dev);
 }
 for(i=1;i<=MAX_CONTACTS;i++)
 { 
  if( (0 == touched) || ((0 != id_state_old_flag[i]) && (0 == id_state_flag[i])) )
  {
   id_sign[i]=0;
  }
  id_state_old_flag[i] = id_state_flag[i];  
 }

#if ADJUST_CPU_FREQ
 if(touched == 0){
  clockstatus_configure(CLOCK_STATUS_TOUCH,0);
 }
#endif
 ts.prev_touched = touched;
 input_sync(ts.dev);

__error_check_touch_int:
__error_get_mt_data:

 /* Clear interrupt flag */
 pending = (1 << GPIO_PIN_NUMBER(ts.intIoIndex));
 gpHalGpioSetIntPending(ts.intIoIndex, pending);
 gp_gpio_enable_irq(ts.client, 1);
}

  先从触摸屏控制器0x80的寄存器开始读取24个byte,然后将读回来的数据进行解析,得到当前触摸的点数,坐标等,之后经过相关的处理后,上报给event。因为是采集多点坐标,然后一起处理这些点的坐标,所以上报完一个点要调用input_mt_sync,直到上报完当前所有按下的点的坐标之后,再调用input_sync 函数达到同步的目的。

  以上大致分析了gsl1680电容屏的linux驱动,其实电容屏的驱动处理流程都是大同小异的,处理流程都差不多,具有通用性。

  之前还调试过一款墩泰的ft5x06的电容屏,这款比较简单,初始化不用加载firmware,接口也基本差不多,只是ft5x06 手指按下时中断输出引脚为低电平,然而gsl1680这款手指按下的中断信号为周期性的方波。

  以上仅供参考,不足之处还请指正。

基于GPL329xx linux平台电容屏gsl1680的驱动调试分析