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

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

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

1.通信與工作模式

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

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

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

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

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

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

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

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

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

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

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

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

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

&i2c1 {  status ="okay"; //替換原有g(shù)t1x為gt9xx，啟用GT911驅(qū)動  gt9xx: gt9xx@14{    status ="okay";    compatible ="goodix,gt9xx";//匹配gt9xx驅(qū)動的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ū)動適配GT911芯片  }; //禁用原有Focaltech FTS觸控驅(qū)動  // focaltech: focaltech@38{ ... };};

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

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

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

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

1.2禁用原有GT1X驅(qū)動節(jié)點

// >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ū)動Makefile，啟用GT9XX驅(qū)動，禁用FTS驅(qū)動，修正驅(qū)動編譯路徑：

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

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

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

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

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

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

核心修改gt9xx.c中GT911的坐標(biāo)適配參數(shù)，解決坐標(biāo)XY交換問題，這是觸控點與屏幕點擊位置匹配的關(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軸物理排布一致，無需交換坐標(biāo)，若保持gtp_change_x2y=TRUE會出現(xiàn)點擊屏幕X軸，觸控點在Y軸移動的偏移問題。

三、編譯與燒錄驗證

1.內(nèi)核編譯

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

2.燒錄驗證

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

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

dmesg| grep -i goodix

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

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

getevent-l

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

（3）測試觸控事件

getevent /dev/input/eventX

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

四、GT911常見報錯與排查方案

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

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

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

原因&排查步驟：

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

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

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

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

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

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

原因&排查步驟：

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

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

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

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

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

原因&排查步驟：

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

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

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

問題4：觸控點亂跳，或偶爾無響應(yīng)

現(xiàn)象：屏幕無觸摸時，觸控點自動跳動，或點擊時偶爾無響應(yīng)；

原因&排查步驟：

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

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

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

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

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

原因&排查步驟：

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

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

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

五、總結(jié)

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

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

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

3.排錯先軟后硬：先通過dmesg、getevent、i2cdetect排查軟件配置問題，再檢查硬件接線、電源、接地等問題；

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

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

審核編輯 黃宇