在RK3568平臺(tái)的Android11系統(tǒng)開(kāi)發(fā)中，匯頂GT911作為小尺寸5點(diǎn)電容觸控芯片是常見(jiàn)選型，其驅(qū)動(dòng)移植核心圍繞設(shè)備樹(shù)適配、內(nèi)核編譯配置、驅(qū)動(dòng)代碼微調(diào)三大環(huán)節(jié)展開(kāi)。本文結(jié)合實(shí)際項(xiàng)目修改補(bǔ)丁，從驅(qū)動(dòng)核心分析、移植配置步驟、常見(jiàn)報(bào)錯(cuò)排查三方面，詳解GT911在RK3568+Android11上的開(kāi)發(fā)配置全流程，最終實(shí)現(xiàn)觸控功能正?？捎?。

一、GT911觸控驅(qū)動(dòng)核心分析

GT911驅(qū)動(dòng)基于匯頂官方gt9xx系列框架開(kāi)發(fā)，核心由gt9xx.c（驅(qū)動(dòng)實(shí)現(xiàn)）、gt9xx.h（宏定義/結(jié)構(gòu)體）和GT911芯片手冊(cè)組成，適配RK3568需重點(diǎn)理解以下核心設(shè)計(jì)：

1.通信與工作模式

?I2C通信：GT911作為I2C從設(shè)備，支持兩組從地址0xBA/0xBB和0x28/0x29，項(xiàng)目中配置為0x14（對(duì)應(yīng)0x28/0x29，I2C地址右移一位），驅(qū)動(dòng)通過(guò)gtp_i2c_read/write實(shí)現(xiàn)與主控的寄存器讀寫、坐標(biāo)數(shù)據(jù)傳輸。

?工作模式：支持**中斷模式（默認(rèn)）**和輪詢模式，中斷引腳觸發(fā)觸控事件后，驅(qū)動(dòng)讀取芯片0x814E開(kāi)始的坐標(biāo)寄存器，上報(bào)觸控點(diǎn)信息；同時(shí)芯片支持Normal/Green/Sleep三種功耗模式，驅(qū)動(dòng)通過(guò)gtp_enter_sleep/gtp_wakeup_sleep實(shí)現(xiàn)功耗管理。

?觸控能力：GT911最大支持5點(diǎn)觸控，驅(qū)動(dòng)中通過(guò)GTP_MAX_TOUCH配置，可讀取觸摸坐標(biāo)、觸摸面積、移動(dòng)軌跡，適配7~8寸屏幕。

2.驅(qū)動(dòng)關(guān)鍵適配邏輯

gt9xx.c中通過(guò)**tp-size設(shè)備樹(shù)屬性**做芯片型號(hào)的差異化適配，驅(qū)動(dòng)會(huì)根據(jù)設(shè)備樹(shù)傳入的tp-size值，設(shè)置對(duì)應(yīng)的標(biāo)志位和坐標(biāo)參數(shù)：

?當(dāng)tp-size = <911>時(shí)，驅(qū)動(dòng)會(huì)將bgt911 = TRUE，匹配GT911芯片的專屬配置；

?同時(shí)驅(qū)動(dòng)提供gtp_change_x2y（坐標(biāo)XY交換）、gtp_x_reverse/gtp_y_reverse（坐標(biāo)反轉(zhuǎn)）宏，解決芯片物理坐標(biāo)與屏幕顯示坐標(biāo)的匹配問(wèn)題，這是GT911適配的核心微調(diào)點(diǎn)。

3.驅(qū)動(dòng)架構(gòu)核心函數(shù)

二、RK3568+Android11 GT911移植配置全步驟

本次移植基于RK3568 EVB開(kāi)發(fā)板，核心是禁用原有Focaltech觸控驅(qū)動(dòng)，適配GT911的I2C節(jié)點(diǎn)、GPIO、編譯配置，所有修改均為項(xiàng)目實(shí)測(cè)有效補(bǔ)丁，分設(shè)備樹(shù)、內(nèi)核編譯、驅(qū)動(dòng)代碼三部分展開(kāi)。

步驟1：設(shè)備樹(shù)配置修改（核心）

設(shè)備樹(shù)修改集中在rk3568-evb.dtsi和rk3568-evb1-ddr4-v10.dtsi，核心是配置GT911的I2C節(jié)點(diǎn)、復(fù)位/中斷GPIO，禁用原有FTS觸控驅(qū)動(dòng)，對(duì)應(yīng)補(bǔ)丁解析如下：

1.1配置I2C1總線的GT911節(jié)點(diǎn)

&i2c1 {  status ="okay"; //替換原有g(shù)t1x為gt9xx，啟用GT911驅(qū)動(dòng)  gt9xx: gt9xx@14{    status ="okay";    compatible ="goodix,gt9xx";//匹配gt9xx驅(qū)動(dòng)的of_match_table    reg = <0x14>;//GT911 I2C從地址（0x28右移一位）    pinctrl-names ="default";    pinctrl-0= <&touch_gpio>;//綁定觸控GPIO引腳   reset-gpio = <&gpio0 RK_PB6 GPIO_ACTIVE_HIGH>;//復(fù)位GPIO    touch-gpio = <&gpio0 RK_PB5 IRQ_TYPE_LEVEL_LOW>;//中斷GPIO，低電平觸發(fā)    max-x= <1920>;//屏幕X軸分辨率    max-y= <1080>;//屏幕Y軸分辨率    tp-size = <911>;//關(guān)鍵：告訴驅(qū)動(dòng)適配GT911芯片  }; //禁用原有Focaltech FTS觸控驅(qū)動(dòng)  // focaltech: focaltech@38{ ... };};

關(guān)鍵修改原因：

?compatible = "goodix,gt9xx"：必須與gt9xx.c中of_device_id的兼容屬性一致，否則驅(qū)動(dòng)無(wú)法匹配加載；

?tp-size = <911>：驅(qū)動(dòng)的核心識(shí)別標(biāo)志，觸發(fā)GT911的專屬配置邏輯；

?中斷GPIO配置為IRQ_TYPE_LEVEL_LOW：與GT911芯片的中斷輸出模式匹配。

1.2禁用原有GT1X驅(qū)動(dòng)節(jié)點(diǎn)

// >1x {//   status = "okay";//   power-supply = <&vcc3v3_lcd0_n>;// };

1.3注釋原有FTS的GPIO引腳配置

原有FTS觸控的GPIO與GT911復(fù)用，需注釋避免引腳沖突：

// ft5x26 {//   ft5x26_gpio: ft5x26-gpio {//     rockchip,pins = <0 RK_PB5 RK_FUNC_GPIO &pcfg_pull_none>,//             <0 RK_PB6 RK_FUNC_GPIO &pcfg_pull_none>;//   };// };

步驟2：內(nèi)核編譯配置修改

修改rockchip_defconfig和觸控驅(qū)動(dòng)Makefile，啟用GT9XX驅(qū)動(dòng)，禁用FTS驅(qū)動(dòng)，修正驅(qū)動(dòng)編譯路徑：

2.1開(kāi)啟GT9XX/關(guān)閉FTS驅(qū)動(dòng)（rockchip_defconfig）

CONFIG_TOUCHSCREEN_GT9XX=y# 啟用GT9xx系列驅(qū)動(dòng)# CONFIG_TOUCHSCREEN_FTS=y # 禁用Focaltech FTS驅(qū)動(dòng)CONFIG_TOUCHSCREEN_GT1X=y# 保留（不影響，已在設(shè)備樹(shù)禁用）

2.2修正驅(qū)動(dòng)編譯路徑（Makefile）

原有GT1X驅(qū)動(dòng)的編譯路徑替換為GT9XX，避免編譯沖突：

#原配置#obj-$(CONFIG_TOUCHSCREEN_GT1X)     += gt1x/#新配置obj-$(CONFIG_TOUCHSCREEN_GT1X)     += gt9xx/

步驟3：GT911驅(qū)動(dòng)代碼微調(diào)

核心修改gt9xx.c中GT911的坐標(biāo)適配參數(shù)，解決坐標(biāo)XY交換問(wèn)題，這是觸控點(diǎn)與屏幕點(diǎn)擊位置匹配的關(guān)鍵：

elseif(val ==911) {  m89or101 =FALSE;  bgt911 =TRUE;  gtp_change_x2y =FALSE;// 原TRUE改為FALSE，關(guān)閉XY坐標(biāo)交換  gtp_x_reverse =FALSE;  gtp_y_reverse =TRUE;}

修改原因：GT911芯片的感應(yīng)通道與屏幕的XY軸物理排布一致，無(wú)需交換坐標(biāo)，若保持gtp_change_x2y=TRUE會(huì)出現(xiàn)點(diǎn)擊屏幕X軸，觸控點(diǎn)在Y軸移動(dòng)的偏移問(wèn)題。

三、編譯與燒錄驗(yàn)證

1.內(nèi)核編譯

執(zhí)行RK3568 Android11的內(nèi)核編譯命令，生成包含GT911驅(qū)動(dòng)的內(nèi)核鏡像：

2.燒錄驗(yàn)證

將編譯后的boot.img通過(guò)RKDevTool燒錄到開(kāi)發(fā)板，重啟后通過(guò)以下命令驗(yàn)證驅(qū)動(dòng)加載狀態(tài)：

（1）查看驅(qū)動(dòng)加載日志

dmesg| grep -i goodix

正常輸出：包含GTP Driver Version: V2.2、GTP I2C Address: 0x14、GTP works in interrupt mode、X_MAX: 1920, Y_MAX: 1080等信息，說(shuō)明驅(qū)動(dòng)成功匹配并加載。

（2）查看觸控輸入設(shè)備

getevent-l

正常輸出：能看到/dev/input/eventX（X為數(shù)字）的輸入設(shè)備，名稱為goodix-ts，表示觸控設(shè)備已成功注冊(cè)到input子系統(tǒng)。

（3）測(cè)試觸控事件

getevent /dev/input/eventX

點(diǎn)擊屏幕，會(huì)輸出連續(xù)的觸控點(diǎn)坐標(biāo)、觸摸壓力等信息，說(shuō)明觸控事件正常上報(bào)，GT911功能可用。

四、GT911常見(jiàn)報(bào)錯(cuò)與排查方案

在RK3568+Android11平臺(tái)適配GT911時(shí)，常見(jiàn)問(wèn)題集中在I2C通信失敗、觸控?zé)o響應(yīng)、坐標(biāo)偏移、中斷異常四大類，以下為針對(duì)性排查方案，結(jié)合芯片手冊(cè)和驅(qū)動(dòng)邏輯逐一解析：

問(wèn)題1：dmesg提示“I2C communication ERROR!”，驅(qū)動(dòng)加載失敗

現(xiàn)象：驅(qū)動(dòng)probe階段提示I2C讀寫出錯(cuò)，無(wú)法檢測(cè)到GT911芯片；

原因&排查步驟：

1.I2C地址不匹配：檢查設(shè)備樹(shù)reg = <0x14>是否與GT911實(shí)際地址一致（芯片地址可通過(guò)Reset/INT引腳配置，0x14對(duì)應(yīng)0x28/0x29，0x5A對(duì)應(yīng)0xBA/0xBB）；

2.復(fù)位GPIO未拉通：GT911上電需先復(fù)位，檢查reset-gpio的引腳號(hào)、電平極性（GPIO_ACTIVE_HIGH）是否正確，可通過(guò)cat /sys/class/gpio/gpioX/value查看GPIO狀態(tài)；

3.I2C總線被占用：執(zhí)行i2cdetect -y 1（I2C1總線），查看0x14地址是否被占用，若被占用需排查其他設(shè)備的I2C節(jié)點(diǎn)；

4.硬件接線問(wèn)題：檢查GT911的SDA/SCL引腳是否與RK3568的I2C1引腳連接正常，是否接拉電阻（4.7K）。

問(wèn)題2：驅(qū)動(dòng)加載成功，但屏幕觸控?zé)o響應(yīng)

現(xiàn)象：dmesg無(wú)報(bào)錯(cuò)，getevent能看到設(shè)備，但點(diǎn)擊屏幕無(wú)任何事件輸出；

原因&排查步驟：

1.中斷GPIO異常：檢查touch-gpio的引腳號(hào)、觸發(fā)方式（IRQ_TYPE_LEVEL_LOW）是否正確，執(zhí)行cat /proc/interrupts | grep goodix查看中斷是否被注冊(cè)，若中斷計(jì)數(shù)為0，說(shuō)明GPIO未觸發(fā)中斷；

2.芯片未進(jìn)入工作模式：GT911若進(jìn)入Sleep模式會(huì)停止掃描，可通過(guò)驅(qū)動(dòng)gtp_wakeup_sleep函數(shù)喚醒，或檢查硬件電源是否為2.8~3.3V（芯片推薦工作電壓）；

3.配置寄存器未發(fā)送：驅(qū)動(dòng)gtp_init_panel會(huì)向GT911發(fā)送配置參數(shù)，若bgt911未設(shè)為TRUE，會(huì)導(dǎo)致配置不匹配，檢查設(shè)備樹(shù)tp-size = <911>是否配置正確。

問(wèn)題3：觸控有響應(yīng)，但坐標(biāo)偏移/反轉(zhuǎn)（點(diǎn)擊東，觸控點(diǎn)西）

現(xiàn)象：點(diǎn)擊屏幕某位置，觸控點(diǎn)出現(xiàn)在其他位置，或X/Y軸反轉(zhuǎn)；

原因&排查步驟：

1.坐標(biāo)交換/反轉(zhuǎn)參數(shù)錯(cuò)誤：調(diào)整gt9xx.c中的gtp_change_x2y（XY交換）、gtp_x_reverse/gtp_y_reverse（坐標(biāo)反轉(zhuǎn)），逐一枚舉測(cè)試（如gtp_y_reverse=FALSE）；

2.屏幕分辨率不匹配：檢查設(shè)備樹(shù)max-x/max-y是否與實(shí)際屏幕分辨率一致，若分辨率錯(cuò)誤會(huì)導(dǎo)致坐標(biāo)比例失調(diào)；

3.GT911傳感器配置錯(cuò)誤：芯片的驅(qū)動(dòng)/感應(yīng)通道與屏幕的物理排布需匹配，若硬件做了通道調(diào)整，需修改驅(qū)動(dòng)中Sensor_CH0~CH13、Driver_CH0~CH25的寄存器配置（0x80B7~0x80EE）。

問(wèn)題4：觸控點(diǎn)亂跳，或偶爾無(wú)響應(yīng)

現(xiàn)象：屏幕無(wú)觸摸時(shí)，觸控點(diǎn)自動(dòng)跳動(dòng)，或點(diǎn)擊時(shí)偶爾無(wú)響應(yīng)；

原因&排查步驟：

1.抗干擾配置不足：GT911支持跳頻功能，可在驅(qū)動(dòng)中開(kāi)啟跳頻（配置0x807A~0x808F跳頻寄存器），避開(kāi)電源、LCD的干擾頻率；

2.硬件接地不良：GT911的AGND/DGND需可靠接地，否則會(huì)出現(xiàn)電容檢測(cè)干擾，導(dǎo)致點(diǎn)飄；

3.去抖參數(shù)設(shè)置不合理：調(diào)整驅(qū)動(dòng)中Shake_Count（去抖次數(shù)，寄存器0x804F），增大去抖次數(shù)可減少點(diǎn)飄（如設(shè)置為5）。

問(wèn)題5：休眠喚醒后觸控?zé)o響應(yīng)

現(xiàn)象：系統(tǒng)休眠前觸控正常，喚醒后觸控?zé)o響應(yīng)；

原因&排查步驟：

1.休眠后芯片未喚醒：驅(qū)動(dòng)goodix_ts_early_resume函數(shù)中需調(diào)用gtp_wakeup_sleep喚醒GT911，檢查該函數(shù)是否被正常調(diào)用；

2.中斷未重新使能：休眠時(shí)驅(qū)動(dòng)會(huì)禁用中斷，喚醒后需重新執(zhí)行g(shù)tp_irq_enable，檢查中斷使能邏輯是否完整；

3.電源管理問(wèn)題：若觸控芯片的電源被休眠關(guān)閉，需在設(shè)備樹(shù)中配置power-supply，保證休眠時(shí)電源常供（如power-supply = <&vcc3v3_lcd0_n>）。

五、總結(jié)

RK3568+Android11平臺(tái)的GT911觸控驅(qū)動(dòng)移植，核心是抓住“設(shè)備樹(shù)標(biāo)識(shí)匹配、GPIO/中斷配置、坐標(biāo)參數(shù)微調(diào)”三個(gè)關(guān)鍵點(diǎn)，本次實(shí)戰(zhàn)的核心經(jīng)驗(yàn)如下：

1.設(shè)備樹(shù)是基礎(chǔ)：compatible、tp-size、reg三個(gè)屬性必須與驅(qū)動(dòng)嚴(yán)格匹配，否則驅(qū)動(dòng)無(wú)法加載；

2.坐標(biāo)適配是關(guān)鍵：GT911的gtp_change_x2y是適配痛點(diǎn)，需根據(jù)硬件的物理排布調(diào)整，這是解決坐標(biāo)偏移的核心；

3.排錯(cuò)先軟后硬：先通過(guò)dmesg、getevent、i2cdetect排查軟件配置問(wèn)題，再檢查硬件接線、電源、接地等問(wèn)題；

4.驅(qū)動(dòng)復(fù)用性強(qiáng)：匯頂gt9xx系列驅(qū)動(dòng)框架兼容GT911/GT9110/GT9271等芯片，僅需通過(guò)tp-size做差異化配置，無(wú)需大幅修改驅(qū)動(dòng)。

本次配置的補(bǔ)丁已在RK3568 EVB開(kāi)發(fā)板實(shí)測(cè)通過(guò)，可直接作為GT911在RK3568+Android11平臺(tái)的移植模板，僅需根據(jù)實(shí)際硬件的GPIO引腳、屏幕分辨率微調(diào)即可。

審核編輯 黃宇