GT9XX驱动移植说明书-for-Android-2014011401

1、GODDiXGODDiX用心团队创新DevotedCoIIaborativeCreative地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾EH业大厦B座13层邮編：518000电话：86-755-33338828传真：486-755-33338788Email：地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾EH业大厦B座13层邮編：518000电话：86-755-33338828传真：486-755-33338788Email：GGDDiX团队创新GGDDiX团队创新CollaborativeCreative用心Devoted地址：深圳市福旧保税区腾地址：深圳市福旧保税区腾E工业大厦B座1

2、3层邮編：518000电话：+86-755-33338828传真：+86-755-33338788Enail：infogoodix.cdGT9XXforAndroid驱动移植说明书一、驱动基本信息支持芯片型号GT911GT9110GT9U0PGT913GT915GT918GT927GT928GT960GT968GT910GT912GT960FGT950GT968FGT9158GT967GT9150GT963GT9271GT917DI2C设备地址(7位)0 x5d、0 x14I2C寄存器地址16位APKT具/ADB工具支持自动升级固件头文件，搜寻bin文件支持SensorID数6个二、驱动文件说

3、明一般情况下，驱动参考资料包的referencedrivers文件夹下面包含以下儿个文件，下面对每个文件的功能和使用方法进行说明：.gt9xx.c(Required)：驱动主功能文件，用来实现驱动的挂報、读取上报坐标、休眠唤醒处理等触摸屏驱动的基本功能。gt9xx.h(Requ”e6：驱动头文件，包含驱动中要用到的一些宏和常量的定义、外部变屋和函数的声明等。gt9xx_update.c(Recommended):驱动用于支持固件升级的文件，对于触摸屏驱动来说，该文件不是必需的，但是强烈推荐在驱动中增加该功能，以便于您使用的触控IC在必要时升级为最新版本的固件。gt9xx_firmware.h(

4、Recommended):默认存放头文件升级默认固件数组，数组默认为空。如需开启兼容GT9XXF模式(GTP.COMPATIBLE.MODE置1),您需要将GT9XXFFirmwareHeaders中相应GT9XXF文件夹下的gt9xx_firmware.h替换驱动中的同名文件。goodix_tool.c(Recommended):驱动中用于支持gtp_tools.apkZC具和ADBZE具的文件，该工具可以在装成整机后再Android层对触控IC进行测试、调试、检测等功能，强烈推荐在驱动中增加此功能，特别是使用COB(触控IC直接layout在主板上)模式的TP时，此工具能极人的方便整机上的

5、TP调试。三、驱动移植STEP_BY_STEP复制文件：将referencedriver文件夹中的所有文件复制到kernel的drivers/input/touchscreen/目录下。修改Makefile：在drivers/input/touchscreen/目录下，打开Makefile文件，并在文件中增加以下条目(注意不同的(-0)文件之间用空格分开)：。obj-y+=gt9xx.ogt9xx_update.ogoodix.tool.o添加设备：找到kernel中初始化I2C总线的板级文件，如本驱动的开发平台real6410开发板是位于arch/arm/mach-s3c6410/mach-

6、smdk641O.c文件中，如需要将触扌夷屏驱动挂我I2C0总线上，则按以下方法添加TP的i2c设备驱动即可，Ox5d为该型号触控IC的i2c从设备地址，具体为多少需参阅该型号芯片的datasheet,”Goodx-TS”为i2c设备驱动名，必须与驱动参考代码中的GTP_I2C_NAME保持相同。staticstructi2c_board_infoi2c_devsOinitdata=l2C_B0ARD_INF0(,Goodix-TS,Ox5d),；修改参考代码：一般情况下，移植过程中只需修改gt9xx.h文件中的内容即可，打开该头文件，按照注释中的提示移植，重点注意TODOpart的修改即可。

7、STEP1替换配置信息表(REQUIRED):将对应于您止在使用TP的配置信息(一般为TP厂提供的(*cfg或*txt)文件里面的内容)，替换CTP_CFG_GROUP中的内容。/TODO:defineyourowndefaultorforSensor_ID=0confighere,defineCTP_CFJGR0UP10 x42,OxEO,0 x01,0 x20,0 x03,0 x05,0 x14,0 x01,0 x02,0 x08,/TODO：defineyourconfigforSensorJD=1here,ifneeded#defineCTP_CFG_GROUP2/TODO：defin

8、eyourconfigforSensorJD=2here,ifneeded#defineCTP_CFG_GROUP3/TODO：defineyourconfigforSensorJD=3here,ifneededGGDDiX团队创新GGDDiX团队创新CoIIaborativeCreative用心DevotedGGDDiX团队创新GGDDiX团队创新CoIIaborativeCreative用心Devoted地址：深圳地址：深圳rlffralTI保税区腾EH业大厦B座13层邮編：518000电话：86-755-33338828传处486-755-33338788Ernail：infogoodi

9、x.con地址：深圳地址：深圳rlffralTI保税区腾EH业大厦B座13层邮編：518000电话：86-755-33338828传处486-755-33338788Ernail：infogoodix.conGGDDiX团队创新GGDDiX团队创新CollaborativeCreative用心Devoted地址：深圳市福旧保税区腾地址：深圳市福旧保税区腾E工业大厦B座13层邮編：518000电话：+86-755-33338828传真：+86-755-33338788Enail：infogoodix.cd#defineCTP_CFG_GR0UP4/TODO:defineyourconfigfor

10、Sensor_ID=4here,ifneeded#defineCTP_CFG_GROUP5/TODO:defineyourconfigforSensor_ID=5here,ifneeded#defineCTP_CFG_GROUP6注意事项：如果没有设置sensorID(详见附录)，请务必将配置信息宏定义在CTP_CFG_GROUP1,并保持其他几组为空，替换完成后，需要在每行后面增加宏定义的连接符“”;如果实际使用的sensorID数多于参考驱动中的6组，请参照这三组完成其他组的配置通过sensorID来区分；如果配置宏的第一行设置了配置信息的写入寄存器GTP_REG_CONFIG_DATA,

11、则请将配置从第二行开始替换。STEP2修改10定义和10操作方式(REQUIRED):将GTP_INT_PORT和GTP_RST_PORT的定义修改为对应于该项目的引脚定义，另外还需检查后面几个关于IO操作的语句是否适用于您止在使用的平台，如果不是，则需修改成相应的操作方式。/STEP_2(REQUIRED):ChangeI/Odefine&I/Ooperationmode.#defineGTP_INT_PORTS3C64XX_GPN(15)#defineGTP_RST_PORTS3C64XX_GPL(10)#defineGTP_INT_IRQgpirq(GTP_INT_PORT)#defin

12、eGTP_GPIO_AS_INPUT(pin)dogpio_direction_input(pin);s3c_gpio_setpul1(pin,S3C_GPIO_PULL_NONE);while(O)注意事项：中断脚和复位脚应初始化为悬浮输入态。(悬浮:既不上拉,也不下拉)。STEP3客户自定义参数(OPTIONAL):如杲您需要自己指定分辨率、中断触发方式、支持的最多TOUCH数等参数，请在ON/OFFdefine中打开GTP_CUSTOM_CFG宏，并参照以下修改参数。/*伙*立*PART1ON/OFFdefine*#defimeGTPCUSTOMCFG1GGDDiX团队创新GGDDiX团

13、队创新CoIIaborativeCreative用心DevotedGGDDiX团队创新GGDDiX团队创新CoIIaborativeCreative用心Devoted地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾ET业大厦B座13层邮編，518000电话：86-755-33338828传真：486-755-33338788Email：infotgoodix.cd地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾ET业大厦B座13层邮編，518000电话：86-755-33338828传真：486-755-33338788Email：infotgoodix.cdGGDDiX团队创新GGDDiX团

14、队创新CollaborativeCreative用心Devoted地址：深圳市福旧保税区腾地址：深圳市福旧保税区腾E工业大厦B座13层邮編：518000电话：+86-755-33338828传真：+86-755-33338788Enail：infogoodix.cdGGDDiX团队创新GGDDiX团队创新CoIIaborativeCreative用心DevotedGGDDiX团队创新GGDDiX团队创新CoIIaborativeCreative用心Devoted地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾ET业大厦B座13层邮編，518000电话：86-755-33338828传真：486

15、-755-33338788Email：infotgoodix.cd地址：深圳市福闪保税区腾地址：深圳市福闪保税区腾ET业大厦B座13层邮編，518000电话：86-755-33338828传真：486-755-33338788Email：infotgoodix.cdGGDDiX团队创新GGDDiX团队创新CollaborativeCreative用心Devoted地址：深圳市福旧保税区腾地址：深圳市福旧保税区腾E工业大厦B座13层邮編：518000电话：+86-755-33338828传真：+86-755-33338788Enail：infogoodix.cd(4)/STEP_3(option

16、al):Custom#ifGTP_CUSTOM_CFG#define#define#define#define#else#define#define#define#define#endifsetsomeconfigbycustom,ifneed.键,键,GTP_MAX_WIDTHGTP_MAX_HEIGHTGTP_MAX_TOUCHGTP_INT_TRIGGERGTP_MAX_WIDTHGTP_MAX_HEIGHTGTP_MAX_TOUCHGTP_INT_TRIGGER800480504096409651STEP4配置触摸按键(OPTIONAL)：如果您止在使用的TP带有触摸按键，则需要配置触

17、扌英按先在ON/OFFdefine中打开GTP_HAVE_TOUCH_KEY开关，然后再参照以下设置按按键的功能和顺序请在GTP_KEY_TAB中按需调整。/*part:ON/OFFdefin兴rfrf*i*伙兴rf*#defineGTP_HAVE_TOUCH_KEY1/伙*先*part2tododefine*/STEP_4(optional):Ifthisprojecthavetouchkey,Settouchkeyconfig.#ifGTP_HAVE_TOUCH_KEY#defineGTP_KEY_TABKEY_MENU,KEY_HOME,KEY_SEND#endif(5)STEP5增加包

18、含文件(OPTIONAL)：在该头文件的前面增加对应您使用平台所必须的include包含文件，这个步骤也是可选的，根据您编译的情况按需加入。(6)GT9XXF兼容说明GT9XXF目前的IC有GT910,GT912,GT95O,GT960F,GT968F。在驱动中做出了兼容处理，其宏开关为GTP_COMPATTBLE_MODE,如果需开启此开关，请先将GT9XXFFirmwareHeaders文件夹中的对应GT9XXF文件夹下的qt9xxfirmware力替换驱动中的qt9xxfirmware力。另请确保GTP_DRIVER_SEND_CFG开启，另请开启GTP_ESD_PROTECT开关。即推

19、荐组合:GGDDiX团队创新GGDDiX团队创新CollaborativeCreative用心Devoted地址：深圳帀福旧保税区腾地址：深圳帀福旧保税区腾业大厦B座13层邮編：518000电话：486-755-33338828传486-755-33338788Email：info地址：深圳地址：深圳rtJfrain保税区腾El：业大厦B座13层邮編：518000电话：4-86-755-33338828传真：486-755-33338788Email：GODDiX团队创新GODDiX团队创新ColIaborativeCreative用心Devoted地址：深圳市福旧保税区腾飞工业大厦地址：深圳

20、市福旧保税区腾飞工业大厦B座13层邮編：518000电话：+86-755-33338828传真：+86-755-33338788Email：infoS#defineGTP_COMPATIBLE_MODE#defineGTP_DRIVER_SEND_CFG#defineGTP_ESD_PROTECT如果断电关屏的方式采用小系统的方式，您需要开启如下开关:#defineGTP_COMPATIBLE_MODE1#defineGTP_DRIVER_SEND_CFG1#defineGTP_ESD_PROTECT1#defineGTP_POWER_CTRL_SLEEP1#defineGTPFLLITTLE

21、SYSTEM1（7）自动升级说明使用自动升级您需要开启宏GTP_AUTO_UDPATE,自动升级有两种方式：搜寻BIN文件升级：GT9XX预设文件路径）/data/_goodix_update_.bin和/sdcard/_goodix_udpate_.bin,GT9XXF）/data/_fl_update_.bin和/sdcard/_fl_update_.bino固件数组升级：使用gt9xx_firmware.h中的固件数组gtp_default_FW进行升级，您需要开启GTP_AUTO_UDPATE与GTP_HEADER_FW_UPDATEe此种方式GT9XXF不支持。IC类型非GT9XXF

22、,如需要自动升级配置，您需要同时开启宏GTP_AUTO_UPDATE_CFG,配置口动升级路径预设为:/data/_goodix_config_.cfg利data/_goodix_config_.cfg使用的方式会与BIN文件一齐搜寻，如找到则先进行配置升级：使用的方式，将在升级完固件之后进行文件搜寻升级。（8）手势/滑动唤醒相关说明手势/滑动唤醒相关联的宏为GTP_GESTURE_WAKEUP。此功能需添加如下电路（电路详细设计请参考Datasheet）：在INT引脚上串接RC电路，R：680欧，C：680p,如下图：用心团队创新绩效Lr用心团队创新绩效LrB端接GT91XINT,C端接ho

23、stINT,host的INT不能接上拉电阻。四、附录SensorID：如呆同一个项目中，使用儿家TP厂的TP,并且都使用GOODIX的同一款IC,则可以对触控IC设置SensorID,主机在初始化的时候发送相应ID的配置信息，从而区分不同厂家的TPSensor工D的设置方法一般是layout时对IC的某一个或者儿个IOI进行上拉、下拉或者悬空等设置，每款芯片的设置方法有所差异，具体请参照各IC的datasheetoIC固彳牛和配置信息：固件是IC内部运行的程序，固件是针对一款IC的，而配置信息则是在固件运行的前期对固件进行初始化的一个数组，主机上电后通过I2C发送给IC,IC才能止常运行，配置

24、信息是针对一款TP的，TP的结构、工艺、通道数等大部分修改都需要通过修改配置信息来适应。酉己置版本号与固化酉己置：GT9XX配置信息的第一个数据为配置信息版本号，只有发送的配置信息的版本号大于或等于芯片中保存的配置版本号时，发送的配置信息才会被GT9XX接受并生效，如果调试过程中发现配置信息发不下去，请首先读出芯片中的配置信息版本号，看是否满足要求。将IC配置版本配置为0 x5A(90)以上，驱动将不会发送配置，以此可达到固化配置的目的，否刚驱动将会将IC配置版本清为0 x41(65)。SLOT报点方式：有些android4.0系统上层配置必须采用SLOT方式报点，此时若驱动依旧采取传统的报点

25、方式，android上层可能会将上报的坐标识别成相对坐标，如杲出现这种现象，请将GTP_ICS_SLOT_REPORT宏打开，将报点方式切换到SLOT方式即可。详细内容请参考linux输入子系统和android上层InputReader.cpp中关于上报事件的相关资料。ESD防护机需！J:是指在驱动中增加一个线程，来查询IC的工作状态，如果发现工作异常，则复位IC,主要用于较强ESD条件下的避免TP失效，您可以根据ESD测试结呆来决定是否打开该功能。注意：该功能使用的前提是CTP芯片的VDD可由主机控制开关或主机可以通过RESET控制GVP芯片复位。宏开关定义：驱动中gt9xx.h在0N/OFFdefine部分定义了一些宏开关，以便在调试的过注意：该功能使用的前提是CTP芯片的VDD可由主机控制开关或主机可以通过RESET控制GVP芯片复位。宏开关定义：驱动中gt9xx.h在0N/OFFdefine部分定义