動(dòng)開(kāi)發(fā)：從設(shè)備樹(shù)到Android框架的CST226SE移植實(shí)戰(zhàn))
1. 項(xiàng)目概述當(dāng)CST226SE觸摸屏遇上MSM8953平臺(tái)最近在做一個(gè)基于高通MSM8953平臺(tái)的項(xiàng)目需要調(diào)試一款新的觸摸屏芯片——CST226SE。這活兒聽(tīng)起來(lái)就是“驅(qū)動(dòng)移植”的老套路但真上手了才發(fā)現(xiàn)從拿到原理圖到觸摸屏流暢響應(yīng)中間每一步都可能藏著坑。MSM8953作為一款經(jīng)典的中端手機(jī)SoC其內(nèi)核和驅(qū)動(dòng)架構(gòu)在嵌入式領(lǐng)域應(yīng)用廣泛而CST226SE則是一款性能不錯(cuò)的電容觸摸控制器。兩者的結(jié)合考驗(yàn)的不僅僅是配置幾個(gè)GPIO和I2C地址更是對(duì)整個(gè)Android/Linux內(nèi)核輸入子系統(tǒng)、設(shè)備樹(shù)Device Tree以及芯片本身特性的理解。如果你也在為類(lèi)似平臺(tái)的觸摸調(diào)試頭疼或者好奇一個(gè)觸摸功能從無(wú)到有需要經(jīng)歷哪些步驟那么我這次踩坑和填坑的經(jīng)歷或許能給你一份清晰的路線(xiàn)圖。2. 核心需求與方案選型解析2.1 為什么是CST226SE與MSM8953的組合在項(xiàng)目選型初期我們?cè)u(píng)估了幾款觸摸芯片。最終選擇CST226SE主要基于幾個(gè)考量首先是性?xún)r(jià)比它在報(bào)告率、精度和抗干擾能力上達(dá)到了一個(gè)很好的平衡能滿(mǎn)足我們產(chǎn)品一款工業(yè)手持設(shè)備對(duì)可靠觸控的需求其次是供應(yīng)商的支持提供了相對(duì)完整的Linux內(nèi)核驅(qū)動(dòng)代碼和調(diào)試工具這能極大縮短開(kāi)發(fā)周期。而MSM8953平臺(tái)我們團(tuán)隊(duì)對(duì)其內(nèi)核通常是Android 7/8對(duì)應(yīng)的Linux 3.18或4.9內(nèi)核和硬件接口非常熟悉其成熟的I2C、中斷、電源管理框架為外設(shè)驅(qū)動(dòng)開(kāi)發(fā)提供了穩(wěn)定基礎(chǔ)。這個(gè)組合的核心需求很明確在MSM8953的Linux內(nèi)核上使能CST226SE觸摸控制器實(shí)現(xiàn)穩(wěn)定、精準(zhǔn)的多點(diǎn)觸控功能并集成到Android系統(tǒng)的輸入服務(wù)中。這不僅僅是一個(gè)“點(diǎn)亮”屏幕的問(wèn)題更涉及到坐標(biāo)校準(zhǔn)、手勢(shì)識(shí)別、功耗優(yōu)化等一系列工程細(xì)節(jié)。2.2 整體調(diào)試思路與工具鏈準(zhǔn)備面對(duì)這樣一個(gè)驅(qū)動(dòng)調(diào)試任務(wù)我的思路是分層推進(jìn)從硬件到軟件從底層到上層硬件確認(rèn)層確保原理圖連接正確電源、I2C、中斷線(xiàn)INT、復(fù)位線(xiàn)RST等硬件信號(hào)萬(wàn)無(wú)一失。這是所有工作的基石硬件錯(cuò)了軟件調(diào)死也沒(méi)用。內(nèi)核驅(qū)動(dòng)層這是核心戰(zhàn)場(chǎng)。需要獲取CST226SE的驅(qū)動(dòng)源碼將其適配到MSM8953的內(nèi)核中重點(diǎn)修改設(shè)備樹(shù)DTS來(lái)描述硬件連接并確保驅(qū)動(dòng)能正確初始化、注冊(cè)為輸入設(shè)備。系統(tǒng)驗(yàn)證層驅(qū)動(dòng)加載后通過(guò)內(nèi)核日志、輸入子系統(tǒng)調(diào)試接口、以及Android端的getevent工具來(lái)驗(yàn)證原始觸摸數(shù)據(jù)是否正確上報(bào)?？蚣芘渲脤釉贏ndroid系統(tǒng)層面配置輸入設(shè)備IDidc文件和觸摸屏參數(shù)tp文件或inputflinger配置確保系統(tǒng)能正確識(shí)別并處理來(lái)自CST226SE的觸摸事件。功能與性能調(diào)優(yōu)層解決可能出現(xiàn)的坐標(biāo)漂移、跳點(diǎn)、邊緣不靈、功耗高等問(wèn)題進(jìn)行參數(shù)微調(diào)。工欲善其事必先利其器。調(diào)試過(guò)程中離不開(kāi)以下工具硬件工具萬(wàn)用表、示波器用于抓取I2C波形和中斷信號(hào)排查硬件通信問(wèn)題、邏輯分析儀更深入的協(xié)議分析。軟件工具串口調(diào)試助手這是與設(shè)備內(nèi)核交互的生命線(xiàn)。通過(guò)串口查看dmesg內(nèi)核日志是診斷驅(qū)動(dòng)問(wèn)題的最直接方式。我習(xí)慣使用minicom或picocom在Linux主機(jī)上操作當(dāng)然Windows下也有SecureCRT、MobaXterm等優(yōu)秀工具。ADBAndroid Debug Bridge當(dāng)系統(tǒng)啟動(dòng)后ADB是連接設(shè)備和上位機(jī)進(jìn)行文件傳輸、命令執(zhí)行、日志抓取的關(guān)鍵。內(nèi)核及文件系統(tǒng)源碼MSM8953的BSP板級(jí)支持包和CST226SE的驅(qū)動(dòng)源碼。文本編輯與對(duì)比工具如VSCode、Vim用于代碼修改和diff比較。3. 硬件連接與設(shè)備樹(shù)DTS配置詳解3.1 原理圖關(guān)鍵信號(hào)核對(duì)拿到硬件原理圖首先要像偵探一樣審視以下幾個(gè)關(guān)鍵點(diǎn)任何一處疏漏都可能導(dǎo)致后續(xù)調(diào)試陷入僵局電源軌CST226SE通常需要1.8V或3.3V的IO電源VDDIO和模擬電源AVDD。必須確認(rèn)MSM8953平臺(tái)上的相應(yīng)電源網(wǎng)絡(luò)能否提供穩(wěn)定、干凈的電壓上電時(shí)序是否符合芯片要求。用萬(wàn)用表實(shí)測(cè)電壓是必不可少的步驟。I2C總線(xiàn)確認(rèn)SCL和SDA線(xiàn)連接到了MSM8953的哪個(gè)I2C控制器如i2c_0i2c_1。特別注意上拉電阻通常需要在總線(xiàn)上拉例如4.7KΩ到VDDIO如果原理圖遺漏需要在PCB上補(bǔ)焊。中斷信號(hào)INT這是觸摸事件通知的關(guān)鍵。確認(rèn)INT引腳連接到了MSM8953的哪個(gè)GPIO。必須配置為中斷輸入模式并且要確認(rèn)中斷觸發(fā)方式上升沿、下降沿或低電平與CST226SE的數(shù)據(jù)手冊(cè)描述一致。通常電容觸摸芯片在有觸摸時(shí)INT會(huì)拉低。復(fù)位信號(hào)RST有的設(shè)計(jì)會(huì)用GPIO控制芯片硬復(fù)位確保開(kāi)機(jī)或異常時(shí)能可靠復(fù)位。需要確認(rèn)連接和極性高電平復(fù)位還是低電平復(fù)位。I2C從機(jī)地址CST226SE的I2C地址通常由某個(gè)引腳如ADDR的電平?jīng)Q定查看原理圖確認(rèn)該引腳是接高、接低還是懸空內(nèi)部有上拉/下拉從而確定7位從機(jī)地址例如0x2E。實(shí)操心得強(qiáng)烈建議在焊接第一塊樣板后先用示波器抓一下I2C總線(xiàn)的波形。在系統(tǒng)上電、內(nèi)核啟動(dòng)過(guò)程中看看主控是否嘗試去訪(fǎng)問(wèn)你預(yù)設(shè)的I2C地址。如果連起始信號(hào)START和地址包都看不到那問(wèn)題很可能出在硬件連接、電源或I2C控制器使能上。3.2 設(shè)備樹(shù)DTS節(jié)點(diǎn)編寫(xiě)設(shè)備樹(shù)是Linux內(nèi)核用來(lái)描述硬件資源配置的數(shù)據(jù)庫(kù)。對(duì)于MSM8953這類(lèi)ARM平臺(tái)驅(qū)動(dòng)匹配硬件主要靠它。我們需要在對(duì)應(yīng)的板級(jí)DTS文件如msm8953-mtp.dtsi或項(xiàng)目自定義的DTS中添加CST226SE的節(jié)點(diǎn)。假設(shè)我們的硬件連接是I2C總線(xiàn)為i2c_3對(duì)應(yīng)i2c_3 INT引腳連接至GPIO 25 RST引腳連接至GPIO 32 I2C地址為0x2E。/* 在 i2c_3 節(jié)點(diǎn)內(nèi)添加 */ i2c_3 { status “okay”; // 確保該I2C控制器已啟用 cst226se_ts: cst226se2e { compatible “chipone,cst226se”; // 驅(qū)動(dòng)匹配的關(guān)鍵字 reg 0x2e; // I2C從機(jī)地址 interrupt-parent tlmm; // 中斷控制器MSM平臺(tái)通常是tlmm interrupts 25 0x2008; // GPIO 25 觸發(fā)方式0x2008通常代表邊沿觸發(fā)、高電平有效具體需查平臺(tái)定義 reset-gpios tlmm 32 GPIO_ACTIVE_LOW; // 復(fù)位GPIO低電平有效 vdd-supply pm8953_l10; // 模擬電源引用PMIC上的LDO vddio-supply pm8953_l5; // IO電源引用PMIC上的LDO /* 芯片特定參數(shù) */ chipone,x-res 720; // 觸摸屏X方向分辨率 chipone,y-res 1280; chipone,irq-gpio tlmm 25 0x2008; // 再次明確中斷GPIO有些驅(qū)動(dòng)需要這樣寫(xiě) chipone,reset-gpio tlmm 32 0; // 可能還有其他參數(shù)如最大觸摸點(diǎn)數(shù)、報(bào)告率等需參考驅(qū)動(dòng)源碼 }; };關(guān)鍵點(diǎn)解析compatible屬性這是靈魂。字符串必須與CST226SE驅(qū)動(dòng)源碼中of_device_id表里的條目完全一致。通常驅(qū)動(dòng)商會(huì)提供這個(gè)字符串。interrupts屬性格式為GPIO號(hào) 中斷標(biāo)志。0x2008是一個(gè)常見(jiàn)值表示IRQ_TYPE_EDGE_RISING上升沿觸發(fā)但務(wù)必根據(jù)芯片數(shù)據(jù)手冊(cè)和平臺(tái)頭文件如dt-bindings/interrupt-controller/irq.h確認(rèn)。錯(cuò)誤的中斷觸發(fā)方式會(huì)導(dǎo)致無(wú)法收到中斷或持續(xù)收到中斷。GPIO引用MSM平臺(tái)使用tlmm作為GPIO控制器。GPIO_ACTIVE_LOW表示低電平有效這對(duì)于復(fù)位引腳很常見(jiàn)。電源管理使用vdd-supply和vddio-supply引用PMIC電源管理芯片的調(diào)節(jié)器可以讓內(nèi)核在系統(tǒng)掛起/恢復(fù)時(shí)自動(dòng)控制觸摸屏的供電實(shí)現(xiàn)低功耗。注意事項(xiàng)修改DTS后需要重新編譯內(nèi)核或DTB設(shè)備樹(shù)二進(jìn)制文件并燒錄到設(shè)備。確保編譯系統(tǒng)正確包含了你的修改。一個(gè)快速驗(yàn)證DTB是否正確的方法是在系統(tǒng)啟動(dòng)后通過(guò)adb shell進(jìn)入執(zhí)行cat /proc/device-tree/或使用dtc工具反編譯當(dāng)前運(yùn)行的DTB查看你的節(jié)點(diǎn)是否存在且屬性正確。4. 內(nèi)核驅(qū)動(dòng)移植與編譯4.1 驅(qū)動(dòng)源碼結(jié)構(gòu)與適配通常芯片原廠(chǎng)或模組廠(chǎng)會(huì)提供一個(gè)Linux內(nèi)核驅(qū)動(dòng)包。其核心文件一般包括chipone_ts.c主驅(qū)動(dòng)文件包含初始化、探測(cè)probe、移除remove、中斷處理、上報(bào)輸入事件等核心函數(shù)。chipone_ts.h頭文件定義寄存器地址、數(shù)據(jù)結(jié)構(gòu)、配置參數(shù)。Makefile和Kconfig用于將驅(qū)動(dòng)集成到內(nèi)核編譯體系。適配工作的核心確認(rèn)兼容性檢查驅(qū)動(dòng)代碼所依賴(lài)的內(nèi)核API。MSM8953的內(nèi)核版本可能較老如3.18而供應(yīng)商提供的驅(qū)動(dòng)可能是針對(duì)更新內(nèi)核如4.19編寫(xiě)的。需要關(guān)注input_devAPI、GPIO API、中斷API、電源管理API等是否有變化。常見(jiàn)的適配點(diǎn)是devm_gpio_request_one、request_threaded_irq等函數(shù)的參數(shù)或頭文件路徑。集成到內(nèi)核樹(shù)將驅(qū)動(dòng)源碼文件夾例如chipone-touch/放置在內(nèi)核源碼的drivers/input/touchscreen/目錄下。修改Makefile/Kconfig在drivers/input/touchscreen/Makefile中添加一行obj-$(CONFIG_TOUCHSCREEN_CST226SE) chipone-touch/在drivers/input/touchscreen/Kconfig中添加一個(gè)配置選項(xiàng)config TOUCHSCREEN_CST226SE tristate “ChipOne CST226SE touchscreen” depends on I2C help Say Y here if you have a ChipOne CST226SE touchscreen connected to your system. If unsure, say N.驅(qū)動(dòng)中的硬件抽象層HAL適配仔細(xì)查看驅(qū)動(dòng)中的probe函數(shù)。它需要通過(guò)of_系列函數(shù)如of_get_gpio、of_property_read_u32從我們剛寫(xiě)的DTS節(jié)點(diǎn)中讀取GPIO編號(hào)、分辨率等參數(shù)。確保驅(qū)動(dòng)代碼能正確解析你在DTS中設(shè)置的屬性名如chipone,irq-gpio。4.2 內(nèi)核配置與編譯完成代碼放置和配置后需要在內(nèi)核編譯菜單中啟用該驅(qū)動(dòng)。# 在內(nèi)核源碼根目錄 make ARCHarm64 menuconfig # 對(duì)于64位的MSM8953 # 或者 make ARCHarm menuconfig # 對(duì)于32位內(nèi)核導(dǎo)航至Device Drivers --- Input device support --- [*] Touchscreens --- * ChipOne CST226SE touchscreen選擇*表示編譯進(jìn)內(nèi)核鏡像M表示編譯為內(nèi)核模塊。對(duì)于觸摸屏這種基礎(chǔ)設(shè)備建議直接編譯進(jìn)內(nèi)核*。保存退出后開(kāi)始編譯內(nèi)核和DTBmake ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j8編譯完成后在輸出目錄如arch/arm64/boot/找到Image.gz-dtb或單獨(dú)的Image.gz和*.dtb文件將其燒錄到設(shè)備。踩坑記錄有一次編譯順利但驅(qū)動(dòng)死活不工作。dmesg里甚至看不到驅(qū)動(dòng)的探測(cè)probe信息。排查了半天發(fā)現(xiàn)是內(nèi)核的CONFIG_I2C配置中我使用的那個(gè)具體I2C控制器編號(hào)如CONFIG_I2C_QUP沒(méi)有被啟用。所以不僅要開(kāi)啟觸摸驅(qū)動(dòng)本身還要確保其依賴(lài)的底層總線(xiàn)驅(qū)動(dòng)I2C/SPI以及對(duì)應(yīng)的控制器驅(qū)動(dòng)也已啟用。5. 系統(tǒng)啟動(dòng)與初步調(diào)試5.1 內(nèi)核日志分析與驅(qū)動(dòng)狀態(tài)確認(rèn)燒錄新內(nèi)核后通過(guò)串口觀(guān)察啟動(dòng)日志。你需要關(guān)注以下幾個(gè)關(guān)鍵信息I2C控制器初始化搜索i2c_3或你使用的總線(xiàn)編號(hào)看是否成功注冊(cè)。設(shè)備樹(shù)節(jié)點(diǎn)解析內(nèi)核會(huì)打印解析到的設(shè)備節(jié)點(diǎn)。驅(qū)動(dòng)探測(cè)Probe這是最關(guān)鍵的日志。如果一切順利你應(yīng)該能看到類(lèi)似這樣的信息[ 2.345678] i2c i2c-3: new_device: Found device chipone,cst226se at address 0x2e [ 2.345690] cst226se 3-002e: Probing ChipOne CST226SE touchscreen [ 2.356789] cst226se 3-002e: Touchscreen size: 720x1280 [ 2.356801] cst226se 3-002e: Successfully initialized [ 2.356812] input: chipone,cst226se as /devices/platform/soc/78b7000.i2c/i2c-3/3-002e/input/input5最后一行特別重要它表明驅(qū)動(dòng)已經(jīng)向輸入子系統(tǒng)Input Subsystem成功注冊(cè)了一個(gè)名為chipone,cst226se的輸入設(shè)備路徑是/dev/input/eventX這里的event5。如果看不到Probing信息可能的原因有DTS節(jié)點(diǎn)compatible字符串與驅(qū)動(dòng)不匹配。I2C通信失敗地址錯(cuò)誤、總線(xiàn)未使能、硬件問(wèn)題。驅(qū)動(dòng)編譯未生效或未包含進(jìn)內(nèi)核。如果探測(cè)失敗驅(qū)動(dòng)可能會(huì)打印錯(cuò)誤碼如-ENODEV-EIO等這是最重要的調(diào)試線(xiàn)索。5.2 使用輸入子系統(tǒng)工具驗(yàn)證數(shù)據(jù)上報(bào)驅(qū)動(dòng)成功注冊(cè)后就可以在用戶(hù)空間驗(yàn)證觸摸數(shù)據(jù)了。查看輸入設(shè)備列表adb shell cat /proc/bus/input/devices在輸出列表中尋找你的觸摸屏設(shè)備確認(rèn)其Handlers中包含eventX。使用getevent工具監(jiān)聽(tīng)原始事件adb shell getevent -l /dev/input/event5這個(gè)命令會(huì)實(shí)時(shí)打印出該輸入設(shè)備上報(bào)的所有原始事件。用手指觸摸屏幕你應(yīng)該能看到連續(xù)的EV_ABS絕對(duì)坐標(biāo)事件數(shù)據(jù)流包括ABS_MT_TRACKING_ID觸摸點(diǎn)ID、ABS_MT_POSITION_X、ABS_MT_POSITION_Y等。這是驅(qū)動(dòng)與上層通信的“原始語(yǔ)言”。如果能看到坐標(biāo)變化恭喜底層驅(qū)動(dòng)基本通了如果沒(méi)有任何輸出可能是中斷未觸發(fā)或者驅(qū)動(dòng)內(nèi)部的數(shù)據(jù)解析、上報(bào)邏輯有問(wèn)題。需要結(jié)合內(nèi)核日志dmesg -w動(dòng)態(tài)查看驅(qū)動(dòng)在中斷處理函數(shù)中是否有打印信息。使用evtest工具進(jìn)行更詳細(xì)的測(cè)試adb shell evtest /dev/input/event5evtest會(huì)提供更友好的交互界面顯示所有支持的事件類(lèi)型和具體的坐標(biāo)值非常適合驗(yàn)證多點(diǎn)觸控多個(gè)TRACKING_ID是否正常工作。實(shí)操心得在驅(qū)動(dòng)調(diào)試初期可以在中斷處理函數(shù)、坐標(biāo)上報(bào)函數(shù)里添加一些printk內(nèi)核打印語(yǔ)句輸出原始寄存器值或計(jì)算后的坐標(biāo)。雖然這會(huì)降低性能但對(duì)于定位問(wèn)題比如坐標(biāo)計(jì)算錯(cuò)誤、上報(bào)頻率異常非常有效。調(diào)試完成后記得移除或禁用這些調(diào)試打印。6. Android框架層配置與校準(zhǔn)6.1 配置輸入設(shè)備標(biāo)識(shí).idc文件Android系統(tǒng)通過(guò)Input Device Configuration文件來(lái)定義輸入設(shè)備的特性如是否為觸摸屏、虛擬鍵映射等。對(duì)于觸摸屏通常需要?jiǎng)?chuàng)建一個(gè).idc文件。在設(shè)備的/system/usr/idc/目錄下如果是只讀系統(tǒng)需要在編譯時(shí)集成到vendor分區(qū)創(chuàng)建一個(gè)文件命名規(guī)則通常為Vendor_XXXX_Product_XXXX.idc。你可以從getevent的輸出中找到input設(shè)備的name或者用更簡(jiǎn)單的方法創(chuàng)建一個(gè)以設(shè)備eventX節(jié)點(diǎn)名命名的文件例如chipone,cst226se.idc。文件內(nèi)容示例# 基本設(shè)備類(lèi)型 touch.deviceType touchScreen # 觸摸屏方向0代表自然方向 touch.orientationAware 1 # 校準(zhǔn)矩陣初始為單位矩陣后續(xù)校準(zhǔn)會(huì)覆蓋 touch.size.calibration normalized touch.pressure.calibration physical這個(gè)文件告訴Android“這是一個(gè)觸摸屏設(shè)備需要處理方向旋轉(zhuǎn)并使用標(biāo)準(zhǔn)化的尺寸和壓力校準(zhǔn)”。6.2 觸摸屏校準(zhǔn)與參數(shù)微調(diào)即使原始坐標(biāo)能上報(bào)直接使用也可能不準(zhǔn)可能出現(xiàn)點(diǎn)擊位置偏移、劃線(xiàn)不直、邊緣無(wú)效等問(wèn)題。這時(shí)就需要校準(zhǔn)。使用ts_calibrate基于Tslib對(duì)于嵌入式Linux經(jīng)典的校準(zhǔn)工具是tslib中的ts_calibrate。你需要先為Android系統(tǒng)交叉編譯tslib并將其push到設(shè)備上。運(yùn)行ts_calibrate后會(huì)在屏幕上依次顯示五個(gè)點(diǎn)點(diǎn)擊后生成一個(gè)校準(zhǔn)文件如/etc/pointercal。驅(qū)動(dòng)或中間層需要讀取這個(gè)文件來(lái)應(yīng)用校準(zhǔn)矩陣。注意這種方法更適用于老式的電阻屏或需要非線(xiàn)性校正的電容屏。對(duì)于現(xiàn)代投射式電容屏如CST226SE其線(xiàn)性度通常很好校準(zhǔn)更多是解決安裝位置偏移如TP與LCD貼合有偏差和坐標(biāo)映射問(wèn)題。在驅(qū)動(dòng)或HAL層進(jìn)行坐標(biāo)變換更常見(jiàn)的做法是在驅(qū)動(dòng)或Android的InputReader階段進(jìn)行軟件校準(zhǔn)。這通常涉及幾個(gè)參數(shù)X/Y軸反轉(zhuǎn)invert_x,invert_y。坐標(biāo)交換swap_xy。坐標(biāo)偏移和縮放offset_x,offset_y,scale_x,scale_y。 這些參數(shù)可以通過(guò)DTS屬性傳入驅(qū)動(dòng)或者在驅(qū)動(dòng)的platform_data中設(shè)置。例如如果觸摸屏的坐標(biāo)系原點(diǎn)在右下角而LCD原點(diǎn)在左上角就需要設(shè)置invert_x和invert_y。利用Android的inputflinger調(diào)試Android提供了強(qiáng)大的調(diào)試命令。通過(guò)adb shell dumpsys input可以查看所有輸入設(shè)備的詳細(xì)狀態(tài)、配置和最近事件。你可以在這里檢查你的觸摸屏設(shè)備是否被正確識(shí)別以及當(dāng)前的InputMapper應(yīng)用了哪些轉(zhuǎn)換參數(shù)。校準(zhǔn)流程建議編寫(xiě)一個(gè)簡(jiǎn)單的測(cè)試APK在屏幕上顯示一個(gè)十字準(zhǔn)星和觸摸點(diǎn)的實(shí)時(shí)坐標(biāo)。用手指點(diǎn)擊屏幕四個(gè)角和中心對(duì)比觸摸點(diǎn)坐標(biāo)和實(shí)際顯示位置。根據(jù)偏差計(jì)算并調(diào)整上述的offset和scale參數(shù)有時(shí)還需要微調(diào)resolution屬性。將最終確定的參數(shù)固化到DTS或驅(qū)動(dòng)的初始化代碼中。7. 高級(jí)調(diào)試與性能優(yōu)化7.1 常見(jiàn)問(wèn)題排查速查表問(wèn)題現(xiàn)象可能原因排查步驟驅(qū)動(dòng)完全無(wú)打印getevent無(wú)設(shè)備1. DTS節(jié)點(diǎn)錯(cuò)誤或未編譯進(jìn)DTB2. I2C通信失敗3. 驅(qū)動(dòng)未編譯/加載1. 檢查dmesg啟動(dòng)日志搜索I2C和compatible字符串。2. 用示波器測(cè)量I2C波形確認(rèn)地址和數(shù)據(jù)。3. 檢查/sys/bus/i2c/devices/下是否有對(duì)應(yīng)地址的設(shè)備節(jié)點(diǎn)。驅(qū)動(dòng)probe成功但getevent無(wú)數(shù)據(jù)1. 中斷未正確觸發(fā)或未注冊(cè)2. 芯片未初始化成功固件、配置3. 電源不穩(wěn)定1. 測(cè)量INT引腳電壓觸摸時(shí)是否跳變。2. 在驅(qū)動(dòng)中斷處理函數(shù)加打印。3. 檢查驅(qū)動(dòng)初始化流程確認(rèn)是否成功向芯片寫(xiě)了配置寄存器。觸摸有數(shù)據(jù)但坐標(biāo)全為0或固定值1. 坐標(biāo)數(shù)據(jù)解析錯(cuò)誤寄存器地址、字節(jié)序2. 芯片報(bào)告的數(shù)據(jù)格式與驅(qū)動(dòng)預(yù)期不符1. 在驅(qū)動(dòng)中打印原始寄存器數(shù)據(jù)。2. 對(duì)照數(shù)據(jù)手冊(cè)檢查驅(qū)動(dòng)解析X/Y坐標(biāo)的代碼。坐標(biāo)跳動(dòng)跳點(diǎn)1. 電源噪聲干擾2. 屏體或FPC受到干擾3. 驅(qū)動(dòng)濾波算法太弱或參數(shù)不當(dāng)1. 用示波器檢查觸摸屏供電的紋波。2. 檢查FPC連接器是否接觸良好屏蔽是否到位。3. 調(diào)整驅(qū)動(dòng)中的濾波參數(shù)如平均濾波窗口大小。邊緣觸摸不靈或坐標(biāo)錯(cuò)誤1. 屏體與蓋板貼合問(wèn)題邊緣氣泡、壓力不均2. 驅(qū)動(dòng)中定義的max_x/max_y與實(shí)際有效感應(yīng)區(qū)不匹配1. 檢查硬件裝配。2. 校準(zhǔn)工具測(cè)試邊緣點(diǎn)調(diào)整驅(qū)動(dòng)中的分辨率或映射范圍。多點(diǎn)觸控失效1. 驅(qū)動(dòng)僅支持單點(diǎn)上報(bào)2. 芯片固件或配置未開(kāi)啟多點(diǎn)3. Androididc文件配置錯(cuò)誤1. 確認(rèn)驅(qū)動(dòng)使用input_mt_report_slot_state等MT協(xié)議函數(shù)。2. 檢查芯片初始化序列。3. 確認(rèn).idc文件中touch.deviceType touchScreen。系統(tǒng)休眠后觸摸失靈1. 電源管理PM未正確配置休眠后未給TP供電2. 驅(qū)動(dòng)未實(shí)現(xiàn)resume函數(shù)或?qū)崿F(xiàn)有誤1. 檢查DTS中vdd-supply的PMIC LDO在休眠時(shí)是否被關(guān)閉。2. 在驅(qū)動(dòng)中實(shí)現(xiàn)pm_ops確保resume時(shí)重新初始化芯片。7.2 性能與功耗優(yōu)化要點(diǎn)中斷優(yōu)化默認(rèn)情況下每次觸摸事件都會(huì)觸發(fā)一次中斷。對(duì)于高報(bào)告率的TP這可能導(dǎo)致系統(tǒng)中斷負(fù)載過(guò)高?？梢钥紤]使用中斷合并有些觸摸芯片支持設(shè)置報(bào)告率或驅(qū)動(dòng)中可以在短時(shí)間內(nèi)合并多次坐標(biāo)上報(bào)只上報(bào)最后一次。檢查中斷觸發(fā)方式確保是邊沿觸發(fā)而非電平觸發(fā)避免持續(xù)中斷。電源管理充分利用Runtime PM在驅(qū)動(dòng)中實(shí)現(xiàn)runtime_suspend和runtime_resume回調(diào)。當(dāng)屏幕關(guān)閉或一段時(shí)間無(wú)觸摸時(shí)讓芯片進(jìn)入低功耗模式。精細(xì)控制供電通過(guò)DTS中的vdd-supply和vddio-supply讓內(nèi)核在系統(tǒng)休眠suspend時(shí)自動(dòng)斷開(kāi)TP電源喚醒時(shí)再上電。驅(qū)動(dòng)代碼效率中斷處理函數(shù)irq_handler要盡可能短小只做必要的數(shù)據(jù)讀取和上報(bào)復(fù)雜的處理可以推到工作隊(duì)列workqueue或線(xiàn)程化中斷的下半部。避免在中斷上下文中使用printk等可能引起睡眠的函數(shù)。調(diào)試CST226SE觸摸屏驅(qū)動(dòng)是一個(gè)典型的嵌入式Linux外設(shè)驅(qū)動(dòng)開(kāi)發(fā)過(guò)程。它串聯(lián)了硬件原理、設(shè)備樹(shù)、內(nèi)核驅(qū)動(dòng)、輸入子系統(tǒng)、Android框架等多個(gè)層面的知識(shí)。最花時(shí)間的往往不是寫(xiě)代碼而是定位問(wèn)題。耐心分析內(nèi)核日志、善用硬件調(diào)試工具、對(duì)芯片數(shù)據(jù)手冊(cè)和內(nèi)核框架有清晰的理解是解決問(wèn)題的關(guān)鍵。當(dāng)屏幕終于精準(zhǔn)地響應(yīng)手指的每一次滑動(dòng)時(shí)那種成就感就是對(duì)所有調(diào)試工作的最好回報(bào)。希望這份詳細(xì)的記錄能幫你繞過(guò)我踩過(guò)的那些坑。 嵌入式Linux觸摸屏驅(qū)動(dòng)開(kāi)發(fā)：從設(shè)備樹(shù)到Android框架的CST226SE移植實(shí)戰(zhàn)
1. 項(xiàng)目概述當(dāng)CST226SE觸摸屏遇上MSM8953平臺(tái)最近在做一個(gè)基于高通MSM8953平臺(tái)的項(xiàng)目需要調(diào)試一款新的觸摸屏芯片——CST226SE。這活兒聽(tīng)起來(lái)就是“驅(qū)動(dòng)移植”的老套路但真上手了才發(fā)現(xiàn)從拿到原理圖到觸摸屏流暢響應(yīng)中間每一步都可能藏著坑。MSM8953作為一款經(jīng)典的中端手機(jī)SoC其內(nèi)核和驅(qū)動(dòng)架構(gòu)在嵌入式領(lǐng)域應(yīng)用廣泛而CST226SE則是一款性能不錯(cuò)的電容觸摸控制器。兩者的結(jié)合考驗(yàn)的不僅僅是配置幾個(gè)GPIO和I2C地址更是對(duì)整個(gè)Android/Linux內(nèi)核輸入子系統(tǒng)、設(shè)備樹(shù)Device Tree以及芯片本身特性的理解。如果你也在為類(lèi)似平臺(tái)的觸摸調(diào)試頭疼或者好奇一個(gè)觸摸功能從無(wú)到有需要經(jīng)歷哪些步驟那么我這次踩坑和填坑的經(jīng)歷或許能給你一份清晰的路線(xiàn)圖。2. 核心需求與方案選型解析2.1 為什么是CST226SE與MSM8953的組合在項(xiàng)目選型初期我們?cè)u(píng)估了幾款觸摸芯片。最終選擇CST226SE主要基于幾個(gè)考量首先是性?xún)r(jià)比它在報(bào)告率、精度和抗干擾能力上達(dá)到了一個(gè)很好的平衡能滿(mǎn)足我們產(chǎn)品一款工業(yè)手持設(shè)備對(duì)可靠觸控的需求其次是供應(yīng)商的支持提供了相對(duì)完整的Linux內(nèi)核驅(qū)動(dòng)代碼和調(diào)試工具這能極大縮短開(kāi)發(fā)周期。而MSM8953平臺(tái)我們團(tuán)隊(duì)對(duì)其內(nèi)核通常是Android 7/8對(duì)應(yīng)的Linux 3.18或4.9內(nèi)核和硬件接口非常熟悉其成熟的I2C、中斷、電源管理框架為外設(shè)驅(qū)動(dòng)開(kāi)發(fā)提供了穩(wěn)定基礎(chǔ)。這個(gè)組合的核心需求很明確在MSM8953的Linux內(nèi)核上使能CST226SE觸摸控制器實(shí)現(xiàn)穩(wěn)定、精準(zhǔn)的多點(diǎn)觸控功能并集成到Android系統(tǒng)的輸入服務(wù)中。這不僅僅是一個(gè)“點(diǎn)亮”屏幕的問(wèn)題更涉及到坐標(biāo)校準(zhǔn)、手勢(shì)識(shí)別、功耗優(yōu)化等一系列工程細(xì)節(jié)。2.2 整體調(diào)試思路與工具鏈準(zhǔn)備面對(duì)這樣一個(gè)驅(qū)動(dòng)調(diào)試任務(wù)我的思路是分層推進(jìn)從硬件到軟件從底層到上層硬件確認(rèn)層確保原理圖連接正確電源、I2C、中斷線(xiàn)INT、復(fù)位線(xiàn)RST等硬件信號(hào)萬(wàn)無(wú)一失。這是所有工作的基石硬件錯(cuò)了軟件調(diào)死也沒(méi)用。內(nèi)核驅(qū)動(dòng)層這是核心戰(zhàn)場(chǎng)。需要獲取CST226SE的驅(qū)動(dòng)源碼將其適配到MSM8953的內(nèi)核中重點(diǎn)修改設(shè)備樹(shù)DTS來(lái)描述硬件連接并確保驅(qū)動(dòng)能正確初始化、注冊(cè)為輸入設(shè)備。系統(tǒng)驗(yàn)證層驅(qū)動(dòng)加載后通過(guò)內(nèi)核日志、輸入子系統(tǒng)調(diào)試接口、以及Android端的getevent工具來(lái)驗(yàn)證原始觸摸數(shù)據(jù)是否正確上報(bào)?？蚣芘渲脤釉贏ndroid系統(tǒng)層面配置輸入設(shè)備IDidc文件和觸摸屏參數(shù)tp文件或inputflinger配置確保系統(tǒng)能正確識(shí)別并處理來(lái)自CST226SE的觸摸事件。功能與性能調(diào)優(yōu)層解決可能出現(xiàn)的坐標(biāo)漂移、跳點(diǎn)、邊緣不靈、功耗高等問(wèn)題進(jìn)行參數(shù)微調(diào)。工欲善其事必先利其器。調(diào)試過(guò)程中離不開(kāi)以下工具硬件工具萬(wàn)用表、示波器用于抓取I2C波形和中斷信號(hào)排查硬件通信問(wèn)題、邏輯分析儀更深入的協(xié)議分析。軟件工具串口調(diào)試助手這是與設(shè)備內(nèi)核交互的生命線(xiàn)。通過(guò)串口查看dmesg內(nèi)核日志是診斷驅(qū)動(dòng)問(wèn)題的最直接方式。我習(xí)慣使用minicom或picocom在Linux主機(jī)上操作當(dāng)然Windows下也有SecureCRT、MobaXterm等優(yōu)秀工具。ADBAndroid Debug Bridge當(dāng)系統(tǒng)啟動(dòng)后ADB是連接設(shè)備和上位機(jī)進(jìn)行文件傳輸、命令執(zhí)行、日志抓取的關(guān)鍵。內(nèi)核及文件系統(tǒng)源碼MSM8953的BSP板級(jí)支持包和CST226SE的驅(qū)動(dòng)源碼。文本編輯與對(duì)比工具如VSCode、Vim用于代碼修改和diff比較。3. 硬件連接與設(shè)備樹(shù)DTS配置詳解3.1 原理圖關(guān)鍵信號(hào)核對(duì)拿到硬件原理圖首先要像偵探一樣審視以下幾個(gè)關(guān)鍵點(diǎn)任何一處疏漏都可能導(dǎo)致后續(xù)調(diào)試陷入僵局電源軌CST226SE通常需要1.8V或3.3V的IO電源VDDIO和模擬電源AVDD。必須確認(rèn)MSM8953平臺(tái)上的相應(yīng)電源網(wǎng)絡(luò)能否提供穩(wěn)定、干凈的電壓上電時(shí)序是否符合芯片要求。用萬(wàn)用表實(shí)測(cè)電壓是必不可少的步驟。I2C總線(xiàn)確認(rèn)SCL和SDA線(xiàn)連接到了MSM8953的哪個(gè)I2C控制器如i2c_0i2c_1。特別注意上拉電阻通常需要在總線(xiàn)上拉例如4.7KΩ到VDDIO如果原理圖遺漏需要在PCB上補(bǔ)焊。中斷信號(hào)INT這是觸摸事件通知的關(guān)鍵。確認(rèn)INT引腳連接到了MSM8953的哪個(gè)GPIO。必須配置為中斷輸入模式并且要確認(rèn)中斷觸發(fā)方式上升沿、下降沿或低電平與CST226SE的數(shù)據(jù)手冊(cè)描述一致。通常電容觸摸芯片在有觸摸時(shí)INT會(huì)拉低。復(fù)位信號(hào)RST有的設(shè)計(jì)會(huì)用GPIO控制芯片硬復(fù)位確保開(kāi)機(jī)或異常時(shí)能可靠復(fù)位。需要確認(rèn)連接和極性高電平復(fù)位還是低電平復(fù)位。I2C從機(jī)地址CST226SE的I2C地址通常由某個(gè)引腳如ADDR的電平?jīng)Q定查看原理圖確認(rèn)該引腳是接高、接低還是懸空內(nèi)部有上拉/下拉從而確定7位從機(jī)地址例如0x2E。實(shí)操心得強(qiáng)烈建議在焊接第一塊樣板后先用示波器抓一下I2C總線(xiàn)的波形。在系統(tǒng)上電、內(nèi)核啟動(dòng)過(guò)程中看看主控是否嘗試去訪(fǎng)問(wèn)你預(yù)設(shè)的I2C地址。如果連起始信號(hào)START和地址包都看不到那問(wèn)題很可能出在硬件連接、電源或I2C控制器使能上。3.2 設(shè)備樹(shù)DTS節(jié)點(diǎn)編寫(xiě)設(shè)備樹(shù)是Linux內(nèi)核用來(lái)描述硬件資源配置的數(shù)據(jù)庫(kù)。對(duì)于MSM8953這類(lèi)ARM平臺(tái)驅(qū)動(dòng)匹配硬件主要靠它。我們需要在對(duì)應(yīng)的板級(jí)DTS文件如msm8953-mtp.dtsi或項(xiàng)目自定義的DTS中添加CST226SE的節(jié)點(diǎn)。假設(shè)我們的硬件連接是I2C總線(xiàn)為i2c_3對(duì)應(yīng)i2c_3 INT引腳連接至GPIO 25 RST引腳連接至GPIO 32 I2C地址為0x2E。/* 在 i2c_3 節(jié)點(diǎn)內(nèi)添加 */ i2c_3 { status “okay”; // 確保該I2C控制器已啟用 cst226se_ts: cst226se2e { compatible “chipone,cst226se”; // 驅(qū)動(dòng)匹配的關(guān)鍵字 reg 0x2e; // I2C從機(jī)地址 interrupt-parent tlmm; // 中斷控制器MSM平臺(tái)通常是tlmm interrupts 25 0x2008; // GPIO 25 觸發(fā)方式0x2008通常代表邊沿觸發(fā)、高電平有效具體需查平臺(tái)定義 reset-gpios tlmm 32 GPIO_ACTIVE_LOW; // 復(fù)位GPIO低電平有效 vdd-supply pm8953_l10; // 模擬電源引用PMIC上的LDO vddio-supply pm8953_l5; // IO電源引用PMIC上的LDO /* 芯片特定參數(shù) */ chipone,x-res 720; // 觸摸屏X方向分辨率 chipone,y-res 1280; chipone,irq-gpio tlmm 25 0x2008; // 再次明確中斷GPIO有些驅(qū)動(dòng)需要這樣寫(xiě) chipone,reset-gpio tlmm 32 0; // 可能還有其他參數(shù)如最大觸摸點(diǎn)數(shù)、報(bào)告率等需參考驅(qū)動(dòng)源碼 }; };關(guān)鍵點(diǎn)解析compatible屬性這是靈魂。字符串必須與CST226SE驅(qū)動(dòng)源碼中of_device_id表里的條目完全一致。通常驅(qū)動(dòng)商會(huì)提供這個(gè)字符串。interrupts屬性格式為GPIO號(hào) 中斷標(biāo)志。0x2008是一個(gè)常見(jiàn)值表示IRQ_TYPE_EDGE_RISING上升沿觸發(fā)但務(wù)必根據(jù)芯片數(shù)據(jù)手冊(cè)和平臺(tái)頭文件如dt-bindings/interrupt-controller/irq.h確認(rèn)。錯(cuò)誤的中斷觸發(fā)方式會(huì)導(dǎo)致無(wú)法收到中斷或持續(xù)收到中斷。GPIO引用MSM平臺(tái)使用tlmm作為GPIO控制器。GPIO_ACTIVE_LOW表示低電平有效這對(duì)于復(fù)位引腳很常見(jiàn)。電源管理使用vdd-supply和vddio-supply引用PMIC電源管理芯片的調(diào)節(jié)器可以讓內(nèi)核在系統(tǒng)掛起/恢復(fù)時(shí)自動(dòng)控制觸摸屏的供電實(shí)現(xiàn)低功耗。注意事項(xiàng)修改DTS后需要重新編譯內(nèi)核或DTB設(shè)備樹(shù)二進(jìn)制文件并燒錄到設(shè)備。確保編譯系統(tǒng)正確包含了你的修改。一個(gè)快速驗(yàn)證DTB是否正確的方法是在系統(tǒng)啟動(dòng)后通過(guò)adb shell進(jìn)入執(zhí)行cat /proc/device-tree/或使用dtc工具反編譯當(dāng)前運(yùn)行的DTB查看你的節(jié)點(diǎn)是否存在且屬性正確。4. 內(nèi)核驅(qū)動(dòng)移植與編譯4.1 驅(qū)動(dòng)源碼結(jié)構(gòu)與適配通常芯片原廠(chǎng)或模組廠(chǎng)會(huì)提供一個(gè)Linux內(nèi)核驅(qū)動(dòng)包。其核心文件一般包括chipone_ts.c主驅(qū)動(dòng)文件包含初始化、探測(cè)probe、移除remove、中斷處理、上報(bào)輸入事件等核心函數(shù)。chipone_ts.h頭文件定義寄存器地址、數(shù)據(jù)結(jié)構(gòu)、配置參數(shù)。Makefile和Kconfig用于將驅(qū)動(dòng)集成到內(nèi)核編譯體系。適配工作的核心確認(rèn)兼容性檢查驅(qū)動(dòng)代碼所依賴(lài)的內(nèi)核API。MSM8953的內(nèi)核版本可能較老如3.18而供應(yīng)商提供的驅(qū)動(dòng)可能是針對(duì)更新內(nèi)核如4.19編寫(xiě)的。需要關(guān)注input_devAPI、GPIO API、中斷API、電源管理API等是否有變化。常見(jiàn)的適配點(diǎn)是devm_gpio_request_one、request_threaded_irq等函數(shù)的參數(shù)或頭文件路徑。集成到內(nèi)核樹(shù)將驅(qū)動(dòng)源碼文件夾例如chipone-touch/放置在內(nèi)核源碼的drivers/input/touchscreen/目錄下。修改Makefile/Kconfig在drivers/input/touchscreen/Makefile中添加一行obj-$(CONFIG_TOUCHSCREEN_CST226SE) chipone-touch/在drivers/input/touchscreen/Kconfig中添加一個(gè)配置選項(xiàng)config TOUCHSCREEN_CST226SE tristate “ChipOne CST226SE touchscreen” depends on I2C help Say Y here if you have a ChipOne CST226SE touchscreen connected to your system. If unsure, say N.驅(qū)動(dòng)中的硬件抽象層HAL適配仔細(xì)查看驅(qū)動(dòng)中的probe函數(shù)。它需要通過(guò)of_系列函數(shù)如of_get_gpio、of_property_read_u32從我們剛寫(xiě)的DTS節(jié)點(diǎn)中讀取GPIO編號(hào)、分辨率等參數(shù)。確保驅(qū)動(dòng)代碼能正確解析你在DTS中設(shè)置的屬性名如chipone,irq-gpio。4.2 內(nèi)核配置與編譯完成代碼放置和配置后需要在內(nèi)核編譯菜單中啟用該驅(qū)動(dòng)。# 在內(nèi)核源碼根目錄 make ARCHarm64 menuconfig # 對(duì)于64位的MSM8953 # 或者 make ARCHarm menuconfig # 對(duì)于32位內(nèi)核導(dǎo)航至Device Drivers --- Input device support --- [*] Touchscreens --- * ChipOne CST226SE touchscreen選擇*表示編譯進(jìn)內(nèi)核鏡像M表示編譯為內(nèi)核模塊。對(duì)于觸摸屏這種基礎(chǔ)設(shè)備建議直接編譯進(jìn)內(nèi)核*。保存退出后開(kāi)始編譯內(nèi)核和DTBmake ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j8編譯完成后在輸出目錄如arch/arm64/boot/找到Image.gz-dtb或單獨(dú)的Image.gz和*.dtb文件將其燒錄到設(shè)備。踩坑記錄有一次編譯順利但驅(qū)動(dòng)死活不工作。dmesg里甚至看不到驅(qū)動(dòng)的探測(cè)probe信息。排查了半天發(fā)現(xiàn)是內(nèi)核的CONFIG_I2C配置中我使用的那個(gè)具體I2C控制器編號(hào)如CONFIG_I2C_QUP沒(méi)有被啟用。所以不僅要開(kāi)啟觸摸驅(qū)動(dòng)本身還要確保其依賴(lài)的底層總線(xiàn)驅(qū)動(dòng)I2C/SPI以及對(duì)應(yīng)的控制器驅(qū)動(dòng)也已啟用。5. 系統(tǒng)啟動(dòng)與初步調(diào)試5.1 內(nèi)核日志分析與驅(qū)動(dòng)狀態(tài)確認(rèn)燒錄新內(nèi)核后通過(guò)串口觀(guān)察啟動(dòng)日志。你需要關(guān)注以下幾個(gè)關(guān)鍵信息I2C控制器初始化搜索i2c_3或你使用的總線(xiàn)編號(hào)看是否成功注冊(cè)。設(shè)備樹(shù)節(jié)點(diǎn)解析內(nèi)核會(huì)打印解析到的設(shè)備節(jié)點(diǎn)。驅(qū)動(dòng)探測(cè)Probe這是最關(guān)鍵的日志。如果一切順利你應(yīng)該能看到類(lèi)似這樣的信息[ 2.345678] i2c i2c-3: new_device: Found device chipone,cst226se at address 0x2e [ 2.345690] cst226se 3-002e: Probing ChipOne CST226SE touchscreen [ 2.356789] cst226se 3-002e: Touchscreen size: 720x1280 [ 2.356801] cst226se 3-002e: Successfully initialized [ 2.356812] input: chipone,cst226se as /devices/platform/soc/78b7000.i2c/i2c-3/3-002e/input/input5最后一行特別重要它表明驅(qū)動(dòng)已經(jīng)向輸入子系統(tǒng)Input Subsystem成功注冊(cè)了一個(gè)名為chipone,cst226se的輸入設(shè)備路徑是/dev/input/eventX這里的event5。如果看不到Probing信息可能的原因有DTS節(jié)點(diǎn)compatible字符串與驅(qū)動(dòng)不匹配。I2C通信失敗地址錯(cuò)誤、總線(xiàn)未使能、硬件問(wèn)題。驅(qū)動(dòng)編譯未生效或未包含進(jìn)內(nèi)核。如果探測(cè)失敗驅(qū)動(dòng)可能會(huì)打印錯(cuò)誤碼如-ENODEV-EIO等這是最重要的調(diào)試線(xiàn)索。5.2 使用輸入子系統(tǒng)工具驗(yàn)證數(shù)據(jù)上報(bào)驅(qū)動(dòng)成功注冊(cè)后就可以在用戶(hù)空間驗(yàn)證觸摸數(shù)據(jù)了。查看輸入設(shè)備列表adb shell cat /proc/bus/input/devices在輸出列表中尋找你的觸摸屏設(shè)備確認(rèn)其Handlers中包含eventX。使用getevent工具監(jiān)聽(tīng)原始事件adb shell getevent -l /dev/input/event5這個(gè)命令會(huì)實(shí)時(shí)打印出該輸入設(shè)備上報(bào)的所有原始事件。用手指觸摸屏幕你應(yīng)該能看到連續(xù)的EV_ABS絕對(duì)坐標(biāo)事件數(shù)據(jù)流包括ABS_MT_TRACKING_ID觸摸點(diǎn)ID、ABS_MT_POSITION_X、ABS_MT_POSITION_Y等。這是驅(qū)動(dòng)與上層通信的“原始語(yǔ)言”。如果能看到坐標(biāo)變化恭喜底層驅(qū)動(dòng)基本通了如果沒(méi)有任何輸出可能是中斷未觸發(fā)或者驅(qū)動(dòng)內(nèi)部的數(shù)據(jù)解析、上報(bào)邏輯有問(wèn)題。需要結(jié)合內(nèi)核日志dmesg -w動(dòng)態(tài)查看驅(qū)動(dòng)在中斷處理函數(shù)中是否有打印信息。使用evtest工具進(jìn)行更詳細(xì)的測(cè)試adb shell evtest /dev/input/event5evtest會(huì)提供更友好的交互界面顯示所有支持的事件類(lèi)型和具體的坐標(biāo)值非常適合驗(yàn)證多點(diǎn)觸控多個(gè)TRACKING_ID是否正常工作。實(shí)操心得在驅(qū)動(dòng)調(diào)試初期可以在中斷處理函數(shù)、坐標(biāo)上報(bào)函數(shù)里添加一些printk內(nèi)核打印語(yǔ)句輸出原始寄存器值或計(jì)算后的坐標(biāo)。雖然這會(huì)降低性能但對(duì)于定位問(wèn)題比如坐標(biāo)計(jì)算錯(cuò)誤、上報(bào)頻率異常非常有效。調(diào)試完成后記得移除或禁用這些調(diào)試打印。6. Android框架層配置與校準(zhǔn)6.1 配置輸入設(shè)備標(biāo)識(shí).idc文件Android系統(tǒng)通過(guò)Input Device Configuration文件來(lái)定義輸入設(shè)備的特性如是否為觸摸屏、虛擬鍵映射等。對(duì)于觸摸屏通常需要?jiǎng)?chuàng)建一個(gè).idc文件。在設(shè)備的/system/usr/idc/目錄下如果是只讀系統(tǒng)需要在編譯時(shí)集成到vendor分區(qū)創(chuàng)建一個(gè)文件命名規(guī)則通常為Vendor_XXXX_Product_XXXX.idc。你可以從getevent的輸出中找到input設(shè)備的name或者用更簡(jiǎn)單的方法創(chuàng)建一個(gè)以設(shè)備eventX節(jié)點(diǎn)名命名的文件例如chipone,cst226se.idc。文件內(nèi)容示例# 基本設(shè)備類(lèi)型 touch.deviceType touchScreen # 觸摸屏方向0代表自然方向 touch.orientationAware 1 # 校準(zhǔn)矩陣初始為單位矩陣后續(xù)校準(zhǔn)會(huì)覆蓋 touch.size.calibration normalized touch.pressure.calibration physical這個(gè)文件告訴Android“這是一個(gè)觸摸屏設(shè)備需要處理方向旋轉(zhuǎn)并使用標(biāo)準(zhǔn)化的尺寸和壓力校準(zhǔn)”。6.2 觸摸屏校準(zhǔn)與參數(shù)微調(diào)即使原始坐標(biāo)能上報(bào)直接使用也可能不準(zhǔn)可能出現(xiàn)點(diǎn)擊位置偏移、劃線(xiàn)不直、邊緣無(wú)效等問(wèn)題。這時(shí)就需要校準(zhǔn)。使用ts_calibrate基于Tslib對(duì)于嵌入式Linux經(jīng)典的校準(zhǔn)工具是tslib中的ts_calibrate。你需要先為Android系統(tǒng)交叉編譯tslib并將其push到設(shè)備上。運(yùn)行ts_calibrate后會(huì)在屏幕上依次顯示五個(gè)點(diǎn)點(diǎn)擊后生成一個(gè)校準(zhǔn)文件如/etc/pointercal。驅(qū)動(dòng)或中間層需要讀取這個(gè)文件來(lái)應(yīng)用校準(zhǔn)矩陣。注意這種方法更適用于老式的電阻屏或需要非線(xiàn)性校正的電容屏。對(duì)于現(xiàn)代投射式電容屏如CST226SE其線(xiàn)性度通常很好校準(zhǔn)更多是解決安裝位置偏移如TP與LCD貼合有偏差和坐標(biāo)映射問(wèn)題。在驅(qū)動(dòng)或HAL層進(jìn)行坐標(biāo)變換更常見(jiàn)的做法是在驅(qū)動(dòng)或Android的InputReader階段進(jìn)行軟件校準(zhǔn)。這通常涉及幾個(gè)參數(shù)X/Y軸反轉(zhuǎn)invert_x,invert_y。坐標(biāo)交換swap_xy。坐標(biāo)偏移和縮放offset_x,offset_y,scale_x,scale_y。 這些參數(shù)可以通過(guò)DTS屬性傳入驅(qū)動(dòng)或者在驅(qū)動(dòng)的platform_data中設(shè)置。例如如果觸摸屏的坐標(biāo)系原點(diǎn)在右下角而LCD原點(diǎn)在左上角就需要設(shè)置invert_x和invert_y。利用Android的inputflinger調(diào)試Android提供了強(qiáng)大的調(diào)試命令。通過(guò)adb shell dumpsys input可以查看所有輸入設(shè)備的詳細(xì)狀態(tài)、配置和最近事件。你可以在這里檢查你的觸摸屏設(shè)備是否被正確識(shí)別以及當(dāng)前的InputMapper應(yīng)用了哪些轉(zhuǎn)換參數(shù)。校準(zhǔn)流程建議編寫(xiě)一個(gè)簡(jiǎn)單的測(cè)試APK在屏幕上顯示一個(gè)十字準(zhǔn)星和觸摸點(diǎn)的實(shí)時(shí)坐標(biāo)。用手指點(diǎn)擊屏幕四個(gè)角和中心對(duì)比觸摸點(diǎn)坐標(biāo)和實(shí)際顯示位置。根據(jù)偏差計(jì)算并調(diào)整上述的offset和scale參數(shù)有時(shí)還需要微調(diào)resolution屬性。將最終確定的參數(shù)固化到DTS或驅(qū)動(dòng)的初始化代碼中。7. 高級(jí)調(diào)試與性能優(yōu)化7.1 常見(jiàn)問(wèn)題排查速查表問(wèn)題現(xiàn)象可能原因排查步驟驅(qū)動(dòng)完全無(wú)打印getevent無(wú)設(shè)備1. DTS節(jié)點(diǎn)錯(cuò)誤或未編譯進(jìn)DTB2. I2C通信失敗3. 驅(qū)動(dòng)未編譯/加載1. 檢查dmesg啟動(dòng)日志搜索I2C和compatible字符串。2. 用示波器測(cè)量I2C波形確認(rèn)地址和數(shù)據(jù)。3. 檢查/sys/bus/i2c/devices/下是否有對(duì)應(yīng)地址的設(shè)備節(jié)點(diǎn)。驅(qū)動(dòng)probe成功但getevent無(wú)數(shù)據(jù)1. 中斷未正確觸發(fā)或未注冊(cè)2. 芯片未初始化成功固件、配置3. 電源不穩(wěn)定1. 測(cè)量INT引腳電壓觸摸時(shí)是否跳變。2. 在驅(qū)動(dòng)中斷處理函數(shù)加打印。3. 檢查驅(qū)動(dòng)初始化流程確認(rèn)是否成功向芯片寫(xiě)了配置寄存器。觸摸有數(shù)據(jù)但坐標(biāo)全為0或固定值1. 坐標(biāo)數(shù)據(jù)解析錯(cuò)誤寄存器地址、字節(jié)序2. 芯片報(bào)告的數(shù)據(jù)格式與驅(qū)動(dòng)預(yù)期不符1. 在驅(qū)動(dòng)中打印原始寄存器數(shù)據(jù)。2. 對(duì)照數(shù)據(jù)手冊(cè)檢查驅(qū)動(dòng)解析X/Y坐標(biāo)的代碼。坐標(biāo)跳動(dòng)跳點(diǎn)1. 電源噪聲干擾2. 屏體或FPC受到干擾3. 驅(qū)動(dòng)濾波算法太弱或參數(shù)不當(dāng)1. 用示波器檢查觸摸屏供電的紋波。2. 檢查FPC連接器是否接觸良好屏蔽是否到位。3. 調(diào)整驅(qū)動(dòng)中的濾波參數(shù)如平均濾波窗口大小。邊緣觸摸不靈或坐標(biāo)錯(cuò)誤1. 屏體與蓋板貼合問(wèn)題邊緣氣泡、壓力不均2. 驅(qū)動(dòng)中定義的max_x/max_y與實(shí)際有效感應(yīng)區(qū)不匹配1. 檢查硬件裝配。2. 校準(zhǔn)工具測(cè)試邊緣點(diǎn)調(diào)整驅(qū)動(dòng)中的分辨率或映射范圍。多點(diǎn)觸控失效1. 驅(qū)動(dòng)僅支持單點(diǎn)上報(bào)2. 芯片固件或配置未開(kāi)啟多點(diǎn)3. Androididc文件配置錯(cuò)誤1. 確認(rèn)驅(qū)動(dòng)使用input_mt_report_slot_state等MT協(xié)議函數(shù)。2. 檢查芯片初始化序列。3. 確認(rèn).idc文件中touch.deviceType touchScreen。系統(tǒng)休眠后觸摸失靈1. 電源管理PM未正確配置休眠后未給TP供電2. 驅(qū)動(dòng)未實(shí)現(xiàn)resume函數(shù)或?qū)崿F(xiàn)有誤1. 檢查DTS中vdd-supply的PMIC LDO在休眠時(shí)是否被關(guān)閉。2. 在驅(qū)動(dòng)中實(shí)現(xiàn)pm_ops確保resume時(shí)重新初始化芯片。7.2 性能與功耗優(yōu)化要點(diǎn)中斷優(yōu)化默認(rèn)情況下每次觸摸事件都會(huì)觸發(fā)一次中斷。對(duì)于高報(bào)告率的TP這可能導(dǎo)致系統(tǒng)中斷負(fù)載過(guò)高?？梢钥紤]使用中斷合并有些觸摸芯片支持設(shè)置報(bào)告率或驅(qū)動(dòng)中可以在短時(shí)間內(nèi)合并多次坐標(biāo)上報(bào)只上報(bào)最后一次。檢查中斷觸發(fā)方式確保是邊沿觸發(fā)而非電平觸發(fā)避免持續(xù)中斷。電源管理充分利用Runtime PM在驅(qū)動(dòng)中實(shí)現(xiàn)runtime_suspend和runtime_resume回調(diào)。當(dāng)屏幕關(guān)閉或一段時(shí)間無(wú)觸摸時(shí)讓芯片進(jìn)入低功耗模式。精細(xì)控制供電通過(guò)DTS中的vdd-supply和vddio-supply讓內(nèi)核在系統(tǒng)休眠suspend時(shí)自動(dòng)斷開(kāi)TP電源喚醒時(shí)再上電。驅(qū)動(dòng)代碼效率中斷處理函數(shù)irq_handler要盡可能短小只做必要的數(shù)據(jù)讀取和上報(bào)復(fù)雜的處理可以推到工作隊(duì)列workqueue或線(xiàn)程化中斷的下半部。避免在中斷上下文中使用printk等可能引起睡眠的函數(shù)。調(diào)試CST226SE觸摸屏驅(qū)動(dòng)是一個(gè)典型的嵌入式Linux外設(shè)驅(qū)動(dòng)開(kāi)發(fā)過(guò)程。它串聯(lián)了硬件原理、設(shè)備樹(shù)、內(nèi)核驅(qū)動(dòng)、輸入子系統(tǒng)、Android框架等多個(gè)層面的知識(shí)。最花時(shí)間的往往不是寫(xiě)代碼而是定位問(wèn)題。耐心分析內(nèi)核日志、善用硬件調(diào)試工具、對(duì)芯片數(shù)據(jù)手冊(cè)和內(nèi)核框架有清晰的理解是解決問(wèn)題的關(guān)鍵。當(dāng)屏幕終于精準(zhǔn)地響應(yīng)手指的每一次滑動(dòng)時(shí)那種成就感就是對(duì)所有調(diào)試工作的最好回報(bào)。希望這份詳細(xì)的記錄能幫你繞過(guò)我踩過(guò)的那些坑。