android lcm驱动解读及调试

lcm驱动的源代码解读

在我们调屏之前，我们一定要弄懂源代码框架以及每一行代码代表的意思，那么就让我们首先来看看代码（以ili9806e为例）

  1 #if defined(BUILD_LK)
  2 #include <string.h>
  3 #else
  4 #include <linux/string.h>
  5 #endif
  6 
  7 #ifdef BUILD_LK
  8     #include <platform/disp_drv_platform.h>
  9 
 10 #elif defined(BUILD_UBOOT)
 11     #include <asm/arch/mt_gpio.h>
 12 #else
 13     //#include <linux/delay.h>
 14     #include <mach/mt_gpio.h>
 15 #endif
 16 #include <cust_gpio_usage.h>
 17 
 18 #include "lcm_drv.h"
 19 
 20 


 22 // --------------------------------------------------------------------
 23 //  Local Constants
 24 // ---------------------------------------------------------------------
 25 
 26 #define FRAME_WIDTH                    (480)
 27 #define FRAME_HEIGHT                   (800)
 28 
 29 #define REGFLAG_DELAY                  0xFD
 30 #define REGFLAG_END_OF_TABLE           0xFE   // END OF REGISTERS MARKER
 31 
 32 #define LCM_DSI_CMD_MODE               0
 33 
 34
 35 #ifndef TRUE
 36     #define TRUE 1
 37 #endif
 38 
 39 #ifndef FALSE
 40     #define FALSE 0
 41 #endif
 42 
 43 #define GPIO_LCM_ID GPIO18
 44 #define LCM_TDT         0
 45 
 46 bool lcm_ili9806e_vendor=LCM_TDT;   //default to choose byd panel
 47 
 48 
 49 //set LCM IC ID
 50 #define LCM_ID_ILI9806E                (0x980604)
 51 
 52 #define LCM_DEBUG
 53 
 54 
 55 


 56 // ----------------------------------------------------------------------
 57 //  Local Variables
 58 // ----------------------------------------------------------------------
 59 
 60 static LCM_UTIL_FUNCS lcm_util = {0};
 61 
 62 //复位引脚
 63 #define SET_RESET_PIN(v)    (lcm_util.set_reset_pin((v)))   //这里就会直接使用GPIO_LCD_RST硬引脚
 64 #define UDELAY(n)           (lcm_util.udelay(n))
 65 #define MDELAY(n)           (lcm_util.mdelay(n))
 66 


 68 // ----------------------------------------------------------------------
 69 //  Local Functions
 70 // ----------------------------------------------------------------------
 71 
 72 /**********数据传输接口***************/
 73 #define dsi_set_cmdq_V2(cmd, count, ppara, force_update) lcm_util.dsi_set_cmdq_V2(cmd, count, ppara, force_update)
 74 #define dsi_set_cmdq(pdata, queue_size, force_update)       lcm_util.dsi_set_cmdq(pdata, queue_size, force_update)
 75 
 76 /*********读写寄存器接口函数*********/
 77 #define wrtie_cmd(cmd)                             lcm_util.dsi_write_cmd(cmd)
 78 #define write_regs(addr, pdata, byte_nums)                  lcm_util.dsi_write_regs(addr, pdata, byte_nums)
 79 #define read_reg(cmd)                                       lcm_util.dsi_dcs_read_lcm_reg(cmd)
 80 #define read_reg_v2(cmd, buffer, buffer_size)               lcm_util.dsi_dcs_read_lcm_reg_v2(cmd, buffer, buffer_size)
 81 
 82 
 83 struct LCM_setting_table {
 84     unsigned char cmd;
 85     unsigned char count;
 86     unsigned char para_list[64];
 87 };
 88 
 90 /*************** 初始化参数及函数接口 *******************/
 91 static struct LCM_setting_table lcm_initialization_setting[] = {
 92 
 93             /* 数据格式：命令，数据个数，数据 */  //命令一般是对应寄存器地址
 94 
 95     {0xFF,5,{0xFF,0x98,0x06,0x04,0x01}},//ChangetoPage1
 96     {0x08,1,{0x10}},//outputSDA
 97     {0x21,1,{0x01}},//DE=1Active
 98     {0x30,1,{0x02}},//480X800
 99     {0x31,1,{0x00}},//ColumnInversion
100     {0x60,1,{0x07}},//SDTI
101     {0x61,1,{0x04}},//CRTI
102     {0x62,1,{0x08}},//EQTI
103     {0x63,1,{0x04}},//PCTI
104     {0x40,1,{0x10}},//10
105     {0x41,1,{0x44}},//77//DVDDHDVDDLclamp
106     {0x42,1,{0x03}},//11//VGH/VGL00
107     {0x43,1,{0x89}},//VGH/VGL
108     {0x44,1,{0x86}},//VGH/VGL
109     //{0x45,1,{0x1B}},//VGL_REG-10V
            .....(此处省略代码n条初始化代码）
234     {0x11,1,{0x00}},                 // Sleep-Out  
235     {REGFLAG_DELAY,120,{}},
236     {0x29,1,{0x00}},
237     {REGFLAG_DELAY, 20, {}},
238   //{0xFF,5,{0xFF,0x98,0x06,0x04,0x08}},   // Change to Page 8
239     {REGFLAG_END_OF_TABLE, 0x00, {}}
240 };
241 

420 /*******************初始化数据的函数************************/
421 static void push_table(struct LCM_setting_table *table, unsigned int count, unsigned char force_update)
422 {
423     unsigned int i;
424 
425     for(i = 0; i < count; i++) {
426 
427         unsigned cmd;
428         cmd = table[i].cmd;
429 
430         switch (cmd) {
431 
432             case REGFLAG_DELAY :
433                 MDELAY(table[i].count);
434                 break;
435 
436             case REGFLAG_END_OF_TABLE :
437                 break;
438 
439             default:
440         dsi_set_cmdq_V2(cmd, table[i].count, table[i].para_list, force_update);
441         }
442     }
443 
444 }
445 

448 // ----------------------------------------------------------------------
449 //  LCM Driver Implementations
450 // ----------------------------------------------------------------------
451 
452 static void lcm_set_util_funcs(const LCM_UTIL_FUNCS *util)
453 {
454     memcpy(&lcm_util, util, sizeof(LCM_UTIL_FUNCS));
455 }
456 
457 
458 /* 获取lcm各个参数 */
459 static void lcm_get_params(LCM_PARAMS *params)
460 {
461     memset(params, 0, sizeof(LCM_PARAMS));        //先将LCM_PARAMS结构清空
462 
463     params->type   = LCM_TYPE_DSI;                //lcm接口类型
464 
465     params->width  = FRAME_WIDTH;                 //lcm显示宽度
466     params->height = FRAME_HEIGHT;                //lcm显示高度
467 
468     /*********设置通信模式*************/
469 
470     // enable tearing-free
471 #ifndef BUILD_UBOOT
472     //params->dbi.te_mode               = LCM_DBI_TE_MODE_VSYNC_ONLY;
473     //params->dbi.te_edge_polarity      = LCM_POLARITY_RISING;
474     params->dbi.te_mode                 = LCM_DBI_TE_MODE_DISABLED;
475 #endif
476 
477         /* dsi分两种模式，一种是cmd模式，一种是video模式 */
478 #if (LCM_DSI_CMD_MODE)  
479     params->dsi.mode = CMD_MODE;            //cmd模式
480 #else
481     params->dsi.mode   = SYNC_PULSE_VDO_MODE;
482 #endif
483 
484     /*××××××××××××设置数据格式××××××××××××*/
485 
486     // DSI
487     /* Command mode setting */
488     params->dsi.LANE_NUM                = LCM_TWO_LANE;             //两通道MIPI
489     //The following defined the fomat for data coming from LCD engine.
490     params->dsi.data_format.color_order = LCM_COLOR_ORDER_RGB;
491     params->dsi.data_format.trans_seq   = LCM_DSI_TRANS_SEQ_MSB_FIRST;
492     params->dsi.data_format.padding     = LCM_DSI_PADDING_ON_LSB;

493     params->dsi.data_format.format      = LCM_DSI_FORMAT_RGB888;
494 
495     // Highly depends on LCD driver capability.
496     // Not support in MT6573
497     params->dsi.packet_size=256;
498 
499     // Video mode setting       
500     params->dsi.intermediat_buffer_num = 2;
501 
502     params->dsi.PS=LCM_PACKED_PS_24BIT_RGB888;
503 
504     /*************垂直参数设置×××××××××××××××××*/
505 
506     params->dsi.vertical_sync_active = 6;
507     params->dsi.vertical_backporch   = 14;
508     params->dsi.vertical_frontporch  = 20;
509     params->dsi.vertical_active_line = FRAME_HEIGHT;
510 
511     /*************水平参数设置×××××××××××××××××*/
512 
513     params->dsi.horizontal_sync_active = 10;
514     params->dsi.horizontal_backporch   = 80;
515     params->dsi.horizontal_frontporch  = 80;
516     params->dsi.horizontal_active_pixel = FRAME_WIDTH;
517 
518     //params->dsi.pll_div1=1;   // div1=0,1,2,3;div1_real=1,2,4,4
519     //params->dsi.pll_div2=1;   // div2=0,1,2,3;div2_real=1,2,4,4
520     //params->dsi.fbk_div =28;      // fref=26MHz, fvco=fref*(fbk_div+1)*2/(div1_real*div2_real)
521 
522     /*××××××××××××××××时钟频率××××××××××××××××*/
523 
524     params->dsi.PLL_CLOCK = 130;
525     //params->dsi.ssc_disable = 0;
526     //params->dsi.ssc_range = 4;
527 }
528 
529 
530 //legen add for detect lcm vendor
531 static bool lcm_select_panel(void)
532 {
533     int value=0;
534 
535     mt_set_gpio_mode(GPIO_LCM_ID,GPIO_MODE_00);
536 
537     mt_set_gpio_pull_enable(GPIO_LCM_ID, GPIO_PULL_DISABLE);
538 
539     mt_set_gpio_dir(GPIO_LCM_ID, GPIO_DIR_IN);
540 
541     value+=mt_get_gpio_in(GPIO_LCM_ID);
542     if(value)
543         return LCM_TDT;
544 
545     return LCM_TDT;
546 }
547 //legen add end 
548 
549 
550 
551 /***************lcm初始化函数************************/
552 static void lcm_init(void)
553 {
554 /*  lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ONE);  //SET_RESET_PIN(1);
555     MDELAY(10);
556     lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ZERO);  //SET_RESET_PIN(0);
557     MDELAY(10);
558     lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ONE);  //SET_RESET_PIN(1);
559     MDELAY(120);*/
560 
561     //复位
562     SET_RESET_PIN(1);
563     SET_RESET_PIN(0);
564     MDELAY(100);
565     SET_RESET_PIN(1);
566     MDELAY(50);
567 
568     //初始化数据
569     push_table(lcm_initialization_setting, sizeof(lcm_initialization_setting) / sizeof(struct LCM_setting_table), 1);
570 }
571 
572 
573 /********************休眠******************************/
574 /*    挂起的机制一般有两种： 简单睡眠或深度睡眠  
575  简单睡眠：设备还处于工作状态，可以被唤醒，但是此时也会存在待机功耗等问题；
576  深度睡眠：设备处于休眠状态，基本处于不工作状态，因此无法被唤醒；
577 
578  一般程序设计都是使用深度睡眠，在唤醒时进行重新初始化；
579  */
580 static void lcm_suspend(void)
581 {
582 #ifdef BUILD_LK     
583     printf("%s, ALS/PS bbbbbbbbbbbbbbb \n", __func__); //lk层只能用printf
584 #else
585     printk("%s, ALS/PS bbbbbbbbbbbbbb  \n", __func__); //内核层只能用printk
586 #endif
587 
588     push_table(lcm_deep_sleep_mode_in_setting, sizeof(lcm_deep_sleep_mode_in_setting) / sizeof(struct LCM_setting_table), 1);
589 }
590 
591 
592 
593 /*******************唤醒**********************************/
594 static void lcm_resume(void)
595 {
596 
597     lcm_init();
598     //MDELAY(200);
599 
600     //push_table(lcm_sleep_out_setting, sizeof(lcm_sleep_out_setting) / sizeof(struct LCM_setting_table), 1);
601 }
602 
603 
604 
605 /********************lcm升级****************************************/
606 static void lcm_update(unsigned int x, unsigned int y,
607                        unsigned int width, unsigned int height)
608 {
609     unsigned int x0 = x;
610     unsigned int y0 = y;
611     unsigned int x1 = x0 + width - 1;
612     unsigned int y1 = y0 + height - 1;
613 
614     unsigned char x0_MSB = ((x0>>8)&0xFF);
615     unsigned char x0_LSB = (x0&0xFF);
616     unsigned char x1_MSB = ((x1>>8)&0xFF);
617     unsigned char x1_LSB = (x1&0xFF);
618     unsigned char y0_MSB = ((y0>>8)&0xFF);
619     unsigned char y0_LSB = (y0&0xFF);
620     unsigned char y1_MSB = ((y1>>8)&0xFF);
621     unsigned char y1_LSB = (y1&0xFF);
622 
623     unsigned int data_array[16];
633     dsi_set_cmdq(data_array, 7, 0);
634 
635 }
636 
637 
638 static unsigned int lcm_esd_test = FALSE;      ///only for ESD test
639 
640 static unsigned int lcm_esd_check(void)
641 {
642   #ifndef BUILD_LK
643     char  buffer[3];
644     char  buffer2[4];
645     int   array[4];
646 
647     if(lcm_esd_test)
648     {
649         lcm_esd_test = FALSE;
650         return TRUE;
651     }
652     return TRUE;
653  #endif
654 
655 }
656 
657 static unsigned int lcm_esd_recover(void)
658 {
659   #ifndef BUILD_LK
660     lcm_init();
661     //lcm_resume();
662 
663     printk("lcm_esd_recover\n");
664 
665     return TRUE;
666   #endif
667 }
668 
669 
670 /********************设备id匹配********************************/
671 static unsigned int lcm_compare_id(void)
672 {
673 
674     int array[4];
675     char buffer[5];
676     char id_high=0;
677     char id_midd=0;
678     char id_low=0;
679     int id=0;
680 
681     //Do reset here
682     /*lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ONE);  //SET_RESET_PIN(1);
683     lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ZERO);  //SET_RESET_PIN(0);
684     MDELAY(25);       
685     lcm_util.set_gpio_out(GPIO_DISP_LRSTB_PIN, GPIO_OUT_ONE);  //SET_RESET_PIN(1);
686     MDELAY(50);      */
687 
688     //首先进行复位操作
689     SET_RESET_PIN(1);
690     SET_RESET_PIN(0);
691     MDELAY(100);
692     SET_RESET_PIN(1);
693     MDELAY(50);
694 
695     //enable CMD2 Page1
696     array[0]=0x00063902;
697     array[1]=0x0698ffff;
698     array[2]=0x00000104;
699     dsi_set_cmdq(array, 3, 1);
700     MDELAY(10);
701 
702 
703     array[0]=0x00033700;
704     dsi_set_cmdq(array, 1, 1);
705     //read_reg_v2(0x04, buffer, 3);//if read 0x04,should get 0x008000,that is both OK.
706 
707     read_reg_v2(0x00, buffer,1);
708     id_high = buffer[0]; ///////////////////////0x98
709 
710     read_reg_v2(0x01, buffer,1);
711     id_midd = buffer[0]; ///////////////////////0x06
712 
713     read_reg_v2(0x02, buffer,1);
714     id_low = buffer[0]; ////////////////////////0x04
715 
716     id =(id_high << 16) | (id_midd << 8) | id_low;
717 
718     #if defined(BUILD_LK)
719     printf("ILI9806E compare-LK:0x%02x,0x%02x,0x%02x,0x%02x\n", id_high, id_midd, id_low, id);
720     #else
721     printk("ILI9806E compare:0x%02x,0x%02x,0x%02x,0x%02x\n", id_high, id_midd, id_low, id);
722     #endif
723 
724     return (id == LCM_ID_ILI9806E)?1:0;
725 }
726 
727 
728 
729 LCM_DRIVER ili9806e_wvga_dsi_vdo_lcm_drv=
730 {
731     .name           = "ili9806e_wvga_dsi_vdo",       //设备名
732     .set_util_funcs = lcm_set_util_funcs,            //获得LCM_DRIVER结构
733     .get_params     = lcm_get_params,                //获得lcm参数
734     .init           = lcm_init,                      //初始化lcm
735     .suspend        = lcm_suspend,                   //lcm挂起
736     .resume         = lcm_resume,                    //lcm恢复
737     .compare_id     = lcm_compare_id,                //lcm设备id匹
738     .esd_check      = lcm_esd_check,                    //
739     .esd_recover    = lcm_esd_recover,                  //
740 #if (LCM_DSI_CMD_MODE)
741     .update         = lcm_update,                    //lcm升级
742 #endif
743     };
744 

一般情况下lcm驱动无非就是这些函数组成，当然lcm屏厂商当然会给我们提供一些初始化代码，以及lcm屏数据手册，这些是我们要认真看的。

lcm移植过程：

lk: 

    在内核目录下bootable/bootloader/lk/dev/lcm/下存放的是各种lcm厂商的lcm驱动，其中也有一个mt67xx_lcm_list.c文件，里面定义了所有的lcm驱动）

1.移植是首先要在lcm/目录下建立一个所移植的那个lcm屏的目录文件夹，目录文件夹名字选取是根据你所定义的设备名统一。
2.在建的这个目录下添加lcm驱动和makefile文件，如果你有lcm驱动就放在这个目录下，如果没有，就找lcm目录下其他的lcm驱动文件夹中的.c文件进行修改后放在此目录下

3.准备工作做好后，修改文件主要有几个，一个是mt67xx_list.c：
    在这个文件中加入你所添加的驱动定义：格式和方法参照文件中其他lcm的定义。
另一个是bootable/blltloader/lk/project/这个目录下有你编译的工程文件（就是你lunch的时候选取的那个文件，Project.mk）.mk文件，
    在这个文件下主要修改的是CUSTOM_LK_LCM、和BOOT_LOGO，把这两个修改成你移植的对应的参数，CUSTOM_LK_LCM要和你的文件名，目录名，还有你的.c文件中的.name变量的值统一。logo，以及lcm屏的宽、高，看lcm数据手册。

kernel：

  kernel/drives/misc/mediatek/lcm/....在这个目录下加入和lk当时候加入的是一样的。直接拷贝过来就可以。同样修改mt67xx_lcm_list.c文件

kernel-3.10/arch/arm64/configs/..目录下是：工程名_debug_defconfig,和对应：工程名_defconfig这两种文件，其中后缀是debug_defconfig的文件是eng对应的，而defconfig是user对应的。

（在我们的lunch所打印出来的工程中有三种后缀，eng(调试工程)、user(用户工程)、userdebug，

进入这个文件后，反斜杠搜索/lcm  然后修改对应的名称和分辨率。


编译： make -j12 2>&1 | tee log.txt

上面讲述的仅仅是加入文件的修改过程，至于调试的话，这个是要积累的经验，把所移植好的代码烧进我们对应的板子，然后编译看效果，然后在针对对应的效果进行调试。