高通平台LCD与TP驱动Porting：设备树、时序与联调排错

1. 先把 Porting 拆成两条线整体设计与思路高通平台上的 TP 和 LCD 驱动 Porting说白了就是让一块陌生的屏幕亮起来、让一层陌生的触摸膜准起来。在手机、平板、POS 机、车机这类整机项目里这两件事几乎永远绑在一起做屏不亮触摸没得调触摸不准屏亮了也没法验证。它要解决的从来不是“写一个驱动”而是“把一块面板的所有电气特性、时序特性、协议特性准确翻译成 SoC 显示控制器和输入子系统能理解的语言”。适合谁看刚接手 bring up 的驱动工程师、从 MCU 平台转过来的嵌入式开发者以及需要判断供应商给的东西到底靠不靠谱的硬件负责人。我做过不少轮这种活最深的体会是绝大多数“点不亮”不是驱动代码写错了而是 DTS 里某个参数和面板规格书没对上或者上电时序早了几毫秒。所以这篇不打算讲内核框架大道理重点放在“顺序怎么排、参数怎么算、坑长什么样”。1.1 LCD 和 TP 为什么必须并行推进很多新手会想着先把屏点亮再搞触摸线性推进。实际项目里这么干会卡住。原因很实在LCD 的 reset、TE、供电这几路 GPIO 和 regulator往往和 TP 的中断脚、复位脚共用同一组 PMIC 输出或者同一个 LDO 域你调屏的时候如果不知道 TP 那一路有没有把电压拉低、有没有在中断脚上挂一个上拉屏的时序就会莫名其妙地飘。我遇到过一次屏在冷启动时大概有 20% 概率白屏闪一下。查了两天最后发现是 TP 驱动的 probe 里把共用的 1.8V LDO 关了一下又打开屏的 DSI PHY 已经锁定了供电塌陷导致 link 失步。这种问题只做单侧调试是发现不了的。更合理的做法是把 bring up 分成三个可独立验证的里程碑第一屏能稳定出图且有正确的初始化画面第二TP 能上报原始坐标且坐标范围和屏分辨率一致第三两者在休眠唤醒、亮度切换、快速开关机这些交叉场景下不互相干扰。这三个里程碑各自的验证手段不同前两个可以并行第三个必须两者都在。并行还有个隐含好处屏的 TE 信号是 TP 报点同步的重要参考。有些方案会拿 TE 做触摸扫描的同步源减少显示噪声对触摸采样的干扰。你在屏还没调通的时候就把 TP 的 TE 通路预留好后面就不会返工。1.2 高通平台显示链路的软件分层与改动落点高通平台的显示子系统这些年变化不小但分层逻辑基本稳定。最底下是 DSI 控制器和 DSI PHY往上是 DRM 框架下的msm驱动再往上是面板抽象层panel driver最上面是 SurfaceFlinger 通过 HWC 提交图层。你要动的 90% 的内容在两处设备树里的 panel 节点以及 panel driver 里的初始化命令序列。现在的平台把显示驱动做成了独立可加载模块放在 vendor 分区里跟主内核解耦。这意味着改完 panel 参数之后你要重新打包的是 dlkm 或者 vendor_boot而不是整个 boot.img迭代速度会快很多。但反过来说如果你只 push 了 dtbo 而没同步更新 vendor 侧的模块就会出现“参数改了但没生效”的假象白折腾半天。一个判断改动是否落到正确位置的小技巧开机后去看/sys/kernel/debug/dri/下面的节点或者直接 dump DSI 的寄存器状态。panel 名字、当前帧率、lane 数这些信息能读出来就说明你改的 DTS 节点确实被匹配到了。读不到那就是 compatible 字符串写错、节点被 disable、或者 dtbo 根本没刷进去跟驱动逻辑一点关系都没有。1.3 触摸链路的落点与选型判断触摸这边相对简单本质是一个挂在 I2C 或者 SPI 上的外设驱动注册进 Linux input 子系统。但选型上有几个点值得提前想清楚。走 I2C 还是 SPI取决于触摸 IC 的报点率和数据量。120Hz 报点、十点触控的常规方案I2C 400kHz 或者 1MHz 基本够用但如果对方号称 240Hz 甚至更高报点率还带压力、面积、防水检测这些附加数据I2C 的带宽会成为瓶颈这时候 SPI 更稳。判断方法很土但有效拿规格书里的单帧数据长度乘以报点率算出来的字节数除以总线速率占用率超过 50% 就该考虑换总线了。另一个选型点是中断方式。边沿触发还是电平触发取决于触摸 IC 的 INT 引脚行为。大多数方案是“有数据时拉低、主机读完释放”这种适合下降沿触发。但如果 IC 在固件升级或者校准期间会持续拉低边沿触发就会漏中断得改成电平触发并配合轮询兜底。还有个大坑是唤醒通路。现在的项目基本都要求息屏双击唤醒这条路径要求触摸 IC 在主 SoC 休眠时保持低功耗扫描检测到手势后拉高中断脚把主控叫醒。高通平台在这块有一个手势唤醒的中间层驱动需要按它的接口把“进入低功耗”“退出低功耗”“上报唤醒事件”这三件事注册进去否则双击能亮但系统不知道是谁唤醒的会出现亮屏后锁屏界面没解锁、或者唤醒源统计里看不到触摸的情况。2. LCD 驱动 Porting 的核心细节与实操要点2.1 点屏前的硬件确认清单动手改代码之前我一般会花半小时把硬件层面的事情核一遍这半小时能省掉后面至少一天的抓瞎。清单不长但每一项都必须有确定答案。第一是供电域。面板通常要三路IO 电压1.8V 或 1.2V、模拟电压正压 VSP、负压 VSN。AMOLED 还可能有 ELVDD/ELVSS。你要确认这三路的实际电压值、上电先后顺序、每一路到稳定需要多久。规格书里会画一条上电时序曲线上面标着 T1、T2、T3 这些时间点这些数值最终会变成 DTS 里的reset-sequence和驱动里的mdelay。第二是复位和 TE。复位脚是低有效还是高有效、需要保持多久、释放后多久才能发第一条 DSI 命令。TE 信号在 command mode 面板上是必须的用来告诉主机“我这边帧缓冲可以更新了”如果 TE 没接或者接错脚画面会撕裂或者卡住。第三是 MIPI 走线。lane 数是 4 还是 3有没有做 lane swap时钟 lane 和数据的极性有没有反。这些在硬件上如果做错了软件层面是有补救手段的DTS 里有 lane 映射的配置但前提是你得知道硬件上到底怎么接的。检查项典型值/常见坑确认方式IO 供电1.8V容差 ±5%万用表实测空载和带载模拟正压/负压5.5V / -5.5V 一类示波器看上升沿斜率复位有效电平多为低有效保持 ≥10ms规格书时序图复位释放到首条命令常见 10~120ms规格书 实测TE 引脚必须接到 SoC 的 TE 专用脚查原理图 pinmuxlane 数4 lane 居多小屏可能 2 lane规格书 原理图2.2 设备树里必须对齐的那几组参数面板节点里参数几十个但真正决定能不能点亮的就是那几组。分辨率、porch、脉冲宽度、帧率、lane 数、bpp这六组对不上后面全是白搭。qcom,mdss-dsi-panel-width和height是有效像素区这个一般不会错。真正容易错的是h-front-porch、h-back-porch、h-pulse-width和对应的 v 系列。这里有个非常经典的陷阱不同面板厂对“back porch”的定义不一样有的把 sync 宽度算进去有的不算。高通的定义里h-back-porch是不含h-pulse-width的。如果供应商给的 HBP 是含 sync 的值你直接填进去总行数就多了几个像素pixel clock 跟着偏表现出来就是帧率略低于标称或者画面在特定刷新率下抖动。我的做法是拿到参数后自己反算一遍 pixel clock和规格书里给的典型值比。偏差在 1% 以内算正常超过 3% 就说明双方对 porch 的理解不一致得回去问清楚。这个反算过程后面第 4 章会详细写。还有qcom,mdss-dsi-traffic-mode。burst mode 是突发传输non-burst 是同步传输。绝大多数现代面板用 burst因为省电。但如果你用的是较老的面板或者调试阶段画面有明显的水平条纹干扰可以试试切到 non-burst 排除问题。2.3 command mode 与 video mode 的取舍这两个模式的选择不是喜好问题是面板特性决定的。video mode 下主机持续不断地往面板推流面板自己有时序发生器靠连续的数据流维持画面。好处是简单、不需要 TE、CPU 占用可预测。坏处是息屏显示AOD这类超低刷新场景很费劲因为流不能停。command mode 下面板内部有帧缓冲主机只在需要更新的时候发命令和像素数据更新完就可以停。省电天然支持局部刷新和 AOD。但必须有 TE 信号做同步否则你不知道什么时候能写下一帧。现在的手机屏基本都是 command mode 加 TE因为要支持 LTPO 那种 1Hz 到 120Hz 的自适应刷新。做这种屏的 portingTE 的配置是重点qcom,mdss-dsi-te-pin-select、qcom,mdss-dsi-te-dcs-command、qcom,mdss-dsi-te-check-enable这几个属性必须和面板规格书里的 TE 行为一致。TE 极性搞反了表现是画面完全不动或者每次更新都卡住等不到信号——很多人第一次遇到会以为是 DSI 链路的问题其实是 TE 没配对。2.4 上电时序与命令序列怎么写面板初始化命令序列是从供应商那里拿到的通常是一大串十六进制。直接粘进去能用的概率大概七成剩下三成会出问题原因集中在三类命令之间的延时不够、命令格式和当前平台的打包方式不一致、以及某些命令在特定电压下才有意义。高通的 DTS 里命令有两种写法一种是把命令和参数混在一起写成数组靠qcom,mdss-dsi-on-command-state标记这条序列在什么状态下发另一种是用更结构化的格式每条命令的参数长度单独标注。后者更啰嗦但排错容易我一般优先用后者。命令之间的延时是最容易被忽略的。供应商的初始化表里经常有“发完 0x11 之后 delay 120ms 再发 0x29”这种很多人直接省掉结果就是有的板子能亮有的不亮因为屏内部电源还在爬升。凡是规格书里明确写了 delay 的一个都不能省。有个细节值得单独说reset-sequence这个属性是三步数组形如高电平时间、低电平时间、再高电平时间。写反了会变成“上电瞬间复位”屏根本不会响应。而且这个延时是毫秒级不是微秒写成 1 和 1000 效果天差地别。另外AMOLED 面板在低亮度下对 gamma 和 ELVSS 的配合很敏感如果初始化序列里没有针对不同亮度档位做补偿低亮度会出现明显的色偏或者“抹布屏”。这部分通常要供应商提供额外的命令不能自己拍脑袋加。2.5 背光与亮度曲线的调法背光这块看起来简单实际是最容易出用户投诉的地方。首先要确认背光控制方式。DC 背光是通过 DSI 的 DCS 命令直接设亮度寄存器PWM 背光是控制外部背光 IC 的 PWM 占空比。前者简单但低亮度下限受面板限制后者灵活但需要额外占一路 PWM且低频 PWM 有可见闪烁。亮度曲线我一般不会直接用线性映射。人眼对亮度的感知是接近对数关系的线性映射的结果就是“低亮度区间几乎没变化高亮度区间跳变剧烈”。常规做法是准备一张 256 级的映射表把 UI 层的 0~255 映射到面板实际能接受的最小值到最大值之间并且在高亮度段做压缩避免电池和发热压力。低亮度还有一个隐藏问题DC 调光在低亮度下因为电流很小面板的一致性会变差同一批次不同板子可能出现明显的亮度差异。这时候要么切到 PWM 调光要么在工厂模式里做逐台校准把校准值写进分区。这条如果前期不考虑量产后返修率会很难看。3. TP 驱动 Porting 的核心细节与实操要点3.1 驱动骨架与设备树节点触摸驱动的基本骨架就那几块probe 里做电源上电、GPIO 初始化、中断注册、input 设备注册然后读固件版本、做一次自检中断里读报点数据、解析、上报suspend/resume 里做低功耗切换。设备树节点一般挂在对应的 I2C 控制器下面reg是 IC 的从地址常见 0x38、0x3E 这类interrupt-parent指向 GPIO 控制器interrupts里第一个数是 GPIO 编号第二个是触发类型。这里最容易错的是触发类型编码不同内核版本里的宏值不完全一样填错了表现是中断进不来或者进来一次之后再也不进。vdd-supply和vcc_i2c-supply要分开写虽然实际可能是同一个 LDO但驱动里上电顺序不同——先 IO 后核心或者反过来取决于 IC 规格。写错顺序有些 IC 会直接锁死必须断电重来。还有个必须写的是坐标范围。touchscreen-size-x和touchscreen-size-y填的是触摸 IC 的原始坐标系分辨率不是屏幕分辨率。这两个值经常不一致比如触摸面板是 1080x2400 对应 IC 内部 1440x3200 的坐标系就需要在驱动里做缩放。填错的后果是所有触摸位置整体偏移或者边缘点报不出来。3.2 中断处理与多点触摸协议 B 上报Linux input 子系统的多点触摸有两套协议A 协议是无状态全量上报B 协议是带 slot 的增量上报。现在的触摸驱动基本都用 B 协议因为内核能自动处理“某一指抬起但其他指不变”这种场景驱动代码更清爽。B 协议的核心是把每个触点绑定到一个 slot 上上报时先input_mt_slot()指定槽位再input_mt_report_slot_state()声明这一槽位是否有手指最后上报 X、Y、压力、面积。所有点报完后调一次input_mt_sync_frame()做帧同步。for (i 0; i point_cnt; i) { input_mt_slot(ts-input_dev, i); input_mt_report_slot_state(ts-input_dev, MT_TOOL_FINGER, true); input_report_abs(ts-input_dev, ABS_MT_POSITION_X, x[i]); input_report_abs(ts-input_dev, ABS_MT_POSITION_Y, y[i]); input_report_abs(ts-input_dev, ABS_MT_TOUCH_MAJOR, w[i]); input_report_abs(ts-input_dev, ABS_MT_PRESSURE, p[i]); } input_mt_sync_frame(ts-input_dev); input_sync(ts-input_dev);这段代码看着标准实际有三个地方会翻车。第一slot 的分配策略。如果每一帧都从 0 开始重新编号快速滑动时会看到光标跳来跳去因为内核认为“0 号手指突然从这跳到那”。正确做法是维护一份上一帧的触点列表按距离做匹配让同一根手指尽量留在同一个 slot 上。第二input_sync的调用时机。有些驱动为了省事在中断里分多次上报中间还调了 sync结果上层收到一堆半帧数据表现出来就是画线断断续续。第三中断里读 I2C 数据。I2C 读操作可能睡眠而很多平台的中断上下文不允许睡眠必须改成线程化中断或者用 workqueue。这个问题在调试阶段不一定暴露压力测试一跑就炸。3.3 坐标映射、边缘补偿与误触策略坐标映射是最琐碎的一环。IC 报上来的原始坐标要经过三步先按 DTS 里的范围缩放到屏幕分辨率再根据屏幕安装方向做旋转或镜像最后做边缘补偿。旋转和镜像一定要在驱动里做不要在 HAL 层做。因为从驱动到 HAL 中间还有一层输入事件的分发如果在 HAL 做某些系统级手势比如从边缘滑入拿到的坐标还是未旋转的逻辑就乱了。边缘补偿针对的是物理结构问题。触摸面板的边缘电极因为电场分布不均报点会往内侧偏。补偿方式通常是给边缘区域一个非线性的增益越靠近边缘增益越大。这个曲线要拿实际样机打点测出来一般打 5x5 或者 7x7 的网格记录每个点上报值和真实值的偏差拟合一条补偿曲线。误触策略分几类手掌抑制靠面积阈值握持抑制靠触摸点分布形态口袋模式靠接近传感器配合。这些策略的实现位置各家不同有的在 IC 固件里有的在驱动里有的在框架层。如果 IC 固件自带的抑制效果够用就别在驱动里重复做两层逻辑叠加往往会打出负优化。3.4 手势唤醒与低功耗通路双击唤醒这条链路涉及的面比较广从触摸 IC 固件到驱动到内核到电源管理任何一环断了都不工作。驱动侧要做三件事suspend 时不要彻底断掉 IC 的电而是发命令让它进入低功耗手势模式把中断脚配置成唤醒源让它能在系统睡眠时把 CPU 叫醒resume 时把 IC 切回正常模式并清掉唤醒状态。static int tp_suspend(struct device *dev) { enable_irq_wake(ts-irq); tp_enter_gesture_mode(ts); return 0; }enable_irq_wake只是一半还得在 DTS 的中断控制器节点上确认这个 GPIO 所在的 bank 支持唤醒。有些 bank 不支持中断脚接错了 bank双击唤醒就永远不生效日志里也看不出来只能靠示波器量中断脚有没有电平变化。还有个常见问题是唤醒后第一帧触摸丢失。原因是 resume 时重新初始化 IC 需要时间这段时间用户的手指已经在屏上了但 IC 还没准备好上报。解决办法是 resume 完成后主动读一次 IC 的当前状态把已有的触点补报上去。3.5 固件升级与产线校准固件升级不是量产才需要考虑的事bring up 阶段就应该把通路打通。因为供应商给你的样片固件八成是旧的有各种奇怪的 bug升级到最新版能省掉很多误判。升级通路一般是通过驱动的 sysfs 节点往里面写固件文件驱动分块下发。这里要注意的是升级期间必须屏蔽中断和上报否则会出现“升级到一半系统还在处理触摸事件”的诡异状态。升级完要做一次软复位并重新读版本号校验。产线校准主要是两件事一是屏幕和触摸的坐标对齐二是原始数据的基准校准。前者靠打点后者靠无触摸时采集环境基准值。校准数据写进 IC 内部或者分区开机时驱动读出来应用。校准如果漏做表现是“同一批次有的机器边缘点不准有的机器有幽灵触摸”。4. 从零到联通的完整实操流程4.1 分阶段 bring up 顺序我把整个过程分成六个阶段每个阶段都有明确的通过标准不通过不往下走。阶段一是电源和时钟。只上电、只给 DSI 控制器时钟不发任何命令。通过标准是用示波器量到三路电压正确、复位时序正确、DSI 时钟输出正常。阶段二是链路训练。发最少的初始化命令把 DSI 链路拉到高速模式读回一个能反映链路状态的寄存器。通过标准是读回值符合预期链路没有报错。阶段三是点亮。发完整初始化序列出纯色画面。通过标准是红绿蓝白四个画面都正常没有花屏、没有局部黑块。阶段四是时序校准。改 porch 参数观察不同刷新率下的表现。通过标准是标称帧率实测误差在 1% 以内长时间运行不闪。阶段五是触摸通。屏出图的同时触摸能上报坐标且坐标和画面上的触点位置一致。阶段六是交叉场景。休眠唤醒、亮度切换、快速开关机、边充电边触摸。4.2 时序参数与 MIPI 速率的手算过程拿一块 1080x2400、60Hz、4 lane、24bpp 的面板举例。规格书给的 porch 是hfp40、hbp40、hpw4、vfp20、vbp12、vpw2。先算总行数和总列数h_total 1080 40 40 4 1164v_total 2400 20 12 2 2434再算像素时钟pclk 1164 × 2434 × 60 ≈ 169,990,560 Hz约 170 MHz然后算每 lane 的比特率bit_rate pclk × bpp / lane 数 170e6 × 24 / 4 ≈ 1.02 Gbps这个 1.02Gbps 就是 DSI PHY 需要跑到的速率。一般会留 5%~10% 余量取 1.1Gbps 左右配置也不会出错因为实际传输是按 DSI 的 HS 时钟走的不是严格等于算出来的值。如果规格书里给的典型 pclk 是 175MHz而你算出来 170MHz偏差 3%那就得回去确认 porch 定义。常见情况是供应商的 hbp 里含了 hpw你多算了一次。参数规格书值计算值判定h_total未给1164需与厂方对账v_total未给2434同上pclk175 MHz170 MHz偏差 3%需确认 porch 定义lane 速率1.05 Gbps1.02 Gbps在容差内4.3 休眠唤醒联调这一块是交叉问题最集中的地方我一般按这个顺序排先单独测屏的休眠唤醒。息屏后按电源键看亮屏是否正常有没有闪一下。如果闪多半是 panel 的 off 序列和 on 序列不对称比如 on 里加了延时但 off 里没加导致下次上电时屏内部状态没复位干净。再单独测触摸的休眠唤醒。息屏后随便点一下看是否能正常上报不要求唤醒。如果点了没反应但亮屏后能正常用说明 suspend 时 IC 断电了或者中断被 disable 了。最后测双击唤醒。这里如果失败按这个顺序查IC 是否进了手势模式、中断脚是否有电平变化、中断控制器对应 bank 是否支持唤醒、唤醒后 resume 顺序是否正确。有个很隐晦的问题部分平台的电源管理框架会在系统进入深度睡眠时把 I2C 控制器也挂起。如果触摸 IC 在低功耗模式下还依赖 I2C 通信比如要轮询状态就会卡住。这时候要么改成纯中断驱动要么把 I2C 控制器标记为可在睡眠中唤醒。4.4 验证清单点亮之后别急着交差这份清单我每次都过一遍四种纯色画面各保持 5 分钟无闪烁、无残影灰阶渐变图无断层、无色带标称帧率下连续播放视频 30 分钟无掉帧、无撕裂亮度从最低到最高扫一遍无跳变、无闪烁息屏唤醒 50 次成功率 100%双击唤醒 50 次成功率不低于 95%受限于手势识别算法本身十点同时触摸坐标全部正确边缘 5mm 内划线无断点边充电边触摸无跳点高温45℃和低温-10℃各跑一轮基础功能5. 常见问题与排查技巧实录5.1 显示侧问题速查表现象高概率原因快速验证手段完全黑屏无背光供电未上、复位时序错、DSI 链路未建立量电压、量复位脚、看 dmesg 里 DSI 报错有背光但无图像初始化序列未发或发错、lane 映射错抓 DSI 波形确认有数据输出花屏、彩色噪点lane 数配置错、lane 顺序错、速率不匹配逐个 lane 试、降速率试画面偏移或压缩porch 参数错、分辨率配错对比计算 pclk 与规格书局部黑块面板排线接触不良、初始化命令里某条未生效换板对比单独重发该条命令闪烁帧率不稳、TE 配置错、背光 PWM 频率低固定帧率试、改 PWM 频率试撕裂command mode 下 TE 未启用或极性反检查 TE 相关属性5.2 触摸侧问题速查表现象高概率原因快速验证手段完全无触摸中断未注册成功、I2C 通信失败、供电异常读 IC ID 寄存器看中断计数能触摸但坐标全偏坐标范围配置错、旋转未做打印原始坐标对比边缘点不准未做边缘补偿、坐标缩放取整误差打点测试看偏差分布跳点、断触中断丢失、上报帧不完整、电源噪声看中断计数与上报帧数是否一致多点触摸只识别一个slot 分配逻辑错、协议用成 A 协议检查上报代码息屏后无法唤醒中断脚唤醒未使能、IC 未进手势模式量中断脚电平变化充电时触摸异常电源噪声、地线干扰换充电器试、加滤波电容试5.3 调试手段与日志抓取显示侧最有用的是 DSI 的状态节点。开机后去 debugfs 下找 DSI 相关目录能看到当前面板名、lane 数、当前时序参数、错误计数。错误计数非零基本就能定位到是链路问题还是面板问题。另一个手段是把 panel 的初始化命令逐条打印。很多驱动支持在命令序列里插入打印或者在 debug 节点里重放命令。当屏不亮时逐条发命令并观察现象能快速定位到是哪一条命令之后出的问题。触摸侧主要靠三个数据中断计数、上报帧数、I2C 错误数。这三个数在正常状态下应该大致成比例。中断远多于上报帧数说明中断里有大量空读上报帧数远少于中断数说明解析逻辑有问题I2C 错误数非零说明总线有干扰或者时序不满足。# 查看中断计数 cat /proc/interrupts | grep -i tp # 查看 input 设备信息 cat /proc/bus/input/devices # 实时查看触摸事件 getevent -l /dev/input/eventXgetevent这个工具在 bring up 阶段几乎是必备的。它能直接打印出每一个 input 事件包括 ABS_MT 类型的原始值。当上层反馈“触摸不准”时先用它确认驱动上报的值对不对能立刻把问题范围缩小一半。5.4 几个踩过的坑有一次屏幕在实验室一切正常到了产线小批量试产有 5% 的机器开机白屏。查了很久最后发现是某批次面板的复位释放时间比规格书标称的长我们按标称值给了 10ms实际需要 15ms。这种问题的特点是“同一版软件在不同板子上表现不同”一旦遇到首先怀疑时序余量不够把所有延时统一乘 1.5 再试。还有一次触摸的幽灵报点静态放置时会随机冒出单点触摸。用getevent看到上报的坐标每次都在同一个位置说明不是噪声而是 IC 把某个固定电平当成了触摸。最后查出来是校准数据没做IC 的基准值还是出厂默认和环境不匹配。这类问题的特征是“坐标固定、不随手指移动”和真正的干扰噪声坐标随机能区分开。再有一个是关于休眠的。系统休眠后触摸偶尔无法唤醒日志里能看到唤醒中断进来了但 resume 流程走完触摸就死了。排查发现是 resume 里重新初始化 IC 的时候I2C 总线的时钟还没恢复稳定第一条命令发出去就 NAK 了。解决办法是在 resume 开始时加一个短延时或者把 I2C 的恢复顺序调到前面。我个人在实际操作中的体会是TP 和 LCD 的 porting 有七成时间花在“确认信息”上只有三成在写代码。规格书里的一句话、原理图上的一个脚、供应商邮件里的一个参数往往就是卡住一整天的那颗钉子。所以与其急着改代码不如在动手之前把硬件、时序、协议这三份材料对着实物核一遍把不确定的地方全部标出来逐个问清楚。真正开始写的时候你会发现代码量其实很小难的是知道该填什么数。