做FPGA的兄弟一旦把ZYNQ玩熟了基本都会走到这一步显示屏能亮了接着就想让触摸屏点起来。这个场景在工业HMI、仪器仪表、边缘网关项目里太常见了而7寸屏又是出货量最大的尺寸之一。前阵子正好用黑金的ZYNQ平台把7寸电容触摸屏在Linux下的驱动完整走了一遍中间踩了不少坑从设备树到内核配置从I2C扫描到坐标校准这篇就把整个Linux触摸屏驱动的开发思路和实操过程一次性讲透适合正在学FPGA Linux开发的人参考。这套流程的本质是触摸屏本身是一块电容传感面板面板上那颗触摸控制芯片通过I2C把手指坐标上报给处理器而Linux端要做的就是让内核识别这颗芯片把坐标数据通过input子系统转成标准的事件上层QT、LVGL或者网页应用才能拿到触摸信息。听起来不复杂但实际涉及硬件连接、内核编译、设备树、驱动匹配、中断处理、坐标标定一整个链路任何一个环节出错表现都是“没反应”或“乱跳”。下面我按实际开发顺序来拆。1. 整体设计与方案选型1.1 先搞清楚这件事里的“角色分工”在ZYNQ这类SoC平台上FPGA和Linux各有各的活。FPGA那边的PL可编程逻辑负责产生LCD需要的像素时钟、行场同步、DE信号把RGB888的图像数据送到屏幕而触摸部分通常不走PL触摸控制芯片通过I2C接口直接连到PS端的MIO引脚上INT中断引脚也接到PS端GPIO由Linux内核里I2C子系统和input子系统来完成驱动。理解这一点很重要。不少刚开始做软硬件协同的工程师会把“触摸屏驱动”想象成Verilog逻辑实际上在ZYNQ上跑Linux的架构里触摸驱动是标准的Linux内核驱动和PC上的触控板驱动本质上没区别。我们不能用FPGA的思维去写触摸逻辑而应该用Linux设备驱动模型的思路去解决。PL端最多在需要扩展IO时提供一组GPIOEMIO给触摸屏的中断和复位用其余事情完全不归PL管。1.2 硬件链路解析从触摸屏到SoC引脚以黑金常见的7寸电容触摸屏模组为例这块屏从硬件角度可以拆成两部分一部分是LCD显示面板RGB接口另一部分是贴在面板上的电容触摸玻璃触摸玻璃连着一个小控制板板上有一颗触摸控制芯片。这颗芯片就是这次驱动的核心对象。很多7寸模组用的是FT5x06系列比如FT5206或者GT911、GT9147这类国产电容触摸芯片。它们都提供标准I2C从站接口平时休眠手指触摸后内部完成电容扫描、坐标计算然后通过INT引脚给主机发中断信号主机再通过I2C读取坐标寄存器。硬件连接上需要确认清楚四类引脚I2C数据线SCL、SDA接到ZYNQ PS端的I2C0或I2C1。中断引脚INT触摸芯片在检测到触摸时会拉低也有拉高的看芯片极性接到PS的MIO或PL的EMIO。复位引脚RST一般低电平复位接到任意一个GPIO。供电触摸逻辑一般3.3V供电。这些信息必须查原理图确认不能靠猜。我记得第一次做的时候直接把I2C地址和中断号按网上别人的设备树抄结果那块板子的INT并没有接到MIO而是走了EMIO设备树里中断配置不对驱动probe之后中断永远来不了触摸自然没反应。1.3 驱动方案的三种选择与取舍同一个触摸屏在Linux下可以有三条路走方案优点缺点适用场景直接用内核自带驱动维护成本低代码由社区维护稳定需要内核配置和设备树正确否则不生效绝大多数上手项目首选芯片厂商或开发板商提供的驱动模块拿过来就能insmod方便往往需要内核源码版本匹配换内核必挂临时验证、调试初期自己从头写input驱动完全可控能学到内核驱动完整开发流程开发周期长要处理中断、I2C时序、多触点协议想彻底搞懂驱动原理或芯片太冷门只能自己写这次教程的核心思路是“方案1为主结合方案3的思路做排障”。因为FT5x06这类芯片在Linux主线内核里已经有非常成熟的驱动支持正常情况下根本不需要自己写代码只要把内核菜单打开设备树节点写对触摸屏就能工作。但如果你只会在网上找驱动然后瞎试一旦出了问题就会很被动所以我后面会花一节专门讲驱动内部到底在做什么这样出了问题你能自己判断是硬件、设备树还是驱动层的问题。2. 环境准备与硬件连接2.1 搭建Linux开发环境与准备板端镜像在开始整驱动之前先把开发环境理顺。开发主机建议用Ubuntu虚拟机或者实体机需要准备交叉编译工具链、内核源码、以及设备树编译工具。如果还没自己移植过Linux建议直接用开发板厂商提供的出厂镜像和配套工具链先让板子在能跑Linux的状态下启动起来这样后期改动范围小排障容易。板子上电后通过串口终端登录Linux第一步就是确认内核版本uname -r这一步非常重要。后续编译设备树、编译驱动模块都需要和当前板子运行的内核版本严格对应。如果你拿到的内核源码版本是4.14而板上跑的是5.4那编译出来的模块是肯定加载不进去的设备树格式也可能存在兼容问题。黑金ZYNQ的资料包里一般都会提供和出厂镜像对应的内核源码路径别贪新用配套版本最稳。启动介质方面ZYNQ通用做法是把BOOT.BIN、内核镜像、设备树、根文件系统放到SD卡里。BOOT.BIN里打包了FSBL、bitstream和U-Boot其中bitstream就是PL端的FPGA逻辑显示时序、GPIO扩展等逻辑都在这里面。触摸驱动开发过程中如果改了PL端逻辑需要重新生成BOOT.BIN如果只改Linux侧则替换对应的内核和dtb文件即可。2.2 用i2c-tools先验证硬件通路这一步很多人会跳过但我建议无论如何先做。与其写完设备树之后一脸懵地查问题不如在动手之前先用i2c-tools确认触摸芯片在I2C总线上到底能不能被发现。先把i2c-tools装进根文件系统或者直接用busybox里自带的i2c工具。查看系统里有几条I2C总线i2cdetect -l正常会看到类似i2c-0、i2c-1这样的总线号对应PS端的I2C0、I2C1。接下来对I2C0做地址扫描i2cdetect -y 0如果触摸芯片正常上电并且I2C引脚连接正确扫描结果里能看到十六进制地址比如FT5206常见的是0x38。如果扫描不到任何设备别急着查驱动先查硬件I2C总线有没有在设备树里使能、触摸芯片供电是否正常、复位引脚是否被拉死、SCL/SDA有没有接反。这个排查手段是最快定位硬件问题的办法省下来的时间远比装工具花的时间多。等能扫到地址了就说明PS端I2C控制器工作正常触摸芯片也在线后面的驱动工作才有意义。顺便说一句GT911的I2C地址比较特殊通常可以通过地址0x14或0x5D扫描到如果扫描不到可以试试往指定地址写入再扫描这种芯片需要主机先发一个唤醒命令我们后面专门说。2.3 确认中断和复位引脚的真实连接触摸驱动能正常工作的另一个前提是中断机制正确。从原理图上找到触摸芯片INT引脚接的PS端GPIO编号换算成Linux里的GPIO号。这里有个很容易踩的坑MIO引脚编号和GPIO编号之间不是简单等值。ZYNQ-7000的PS端GPIO分成bank0和bank1bank0对应MIO0~MIO31bank1对应MIO32~MIO53。所以在设备树里如果INT接的是MIO14那GPIO号就是14如果接的是MIO51GPIO号就要换算成1951-32因为bank1的GPIO号从0开始算。如果接了EMIO那就要看PL端的引脚分配而且还要在PL逻辑里把EMIO引脚引出来并且在内核配置里打开对应的GPIO控制器。建议在写设备树之前先在Linux命令行用GPIO sysfs或debugfs手动操作一下复位引脚看看能不能控制触摸芯片复位再确认中断引脚会不会在有触摸时产生电平变化。这套手法虽然土但能非常有效地把硬件和软件问题隔离开。等验证完就可以胸有成竹地写设备树了。3. 内核配置与驱动实现3.1 打开内核触摸屏驱动选项FT5x06在Linux内核对口的驱动是edt-ft5x06菜单路径在Device Drivers - Input device support - Touchscreens - Elan eKTF2127 / FocalTech / EDT FT5x06 touchscreen配置方式要么用make menuconfig图形菜单进去勾选要么直接改.config。建议编成模块也就是CONFIG_TOUCHSCREEN_EDT_FT5X06m方便开发和替换。编成模块后在板子上手动modprobe如果出错能直接看到错误信息不用反复刷内核。编译模块时注意需要用到目标板对应内核源码树的编译产物。大致流程export ARCHarm export CROSS_COMPILEarm-linux-gnueabihf- make modules编完之后把模块拷贝到根文件系统insmod或modprobe加载。如果是编进内核y那就直接替换内核镜像。对于刚开始接触的读者我强烈建议先用模块方式迭代速度快避免反复刷内核把系统搞挂。3.2 编写设备树节点设备树的作用就是告诉内核“I2C0总线上挂了这么一颗芯片它的地址是多少用哪个中断怎么复位。”对于Linux驱动来说设备树就是整个硬件拓扑的说明书。以I2C0为例一个基础的FT5x06节点长这样i2c0 { status okay; clock-frequency 100000; touch: ft5x0638 { compatible edt,edt-ft5206; reg 0x38; interrupt-parent gpio0; interrupts 14 IRQ_TYPE_EDGE_FALLING; reset-gpios gpio0 15 GPIO_ACTIVE_LOW; touchscreen-size-x 1024; touchscreen-size-y 600; }; };我来逐个解释每个属性的含义。compatible是驱动匹配的关键字符串内核靠它找到对应驱动reg就是I2C从机地址7位地址模式FT5206就是0x38interrupt-parent声明中断控制器ZYNQ的PS端GPIO在设备树里对应gpio0interrupts里面第一个数字是GPIO号第二个是触发类型FT5x06一般是下降沿触发reset-gpios定义一个复位引脚低电平有效。有一个细节需要注意设备树里interrupts字段里的GPIO号与上面提到的MIO号换算规则相关。如果INT接在MIO14这里就是14如果INT接在MIO51要写成19同时bank的编号要写对。很多人在这里直接抄网上设备树结果中断接的就是不对。如果你在设备树里没有给触摸节点配中断驱动也能注册成功但只能靠轮询读取触摸数据CPU开销大响应也慢建议还是把中断配好。关于GT911设备树写法和FT5206略有不同它的I2C地址可能是0x14或0x5D而且INT/RST引脚的初始化顺序有讲究需要在驱动probe阶段先拉高INT再拉低RST否则芯片可能进入异常模式。如果你的7寸屏用的GT911设备树建议先看看芯片数据手册里的上电时序要求再配合厂家的驱动源码来写不要照抄FT5206的写法。3.3 重新编译与部署设备树设备树修改完成后需要重新编译。ZYNQ用的设备树源文件通常在内核源码的arch/arm/boot/dts目录下板级厂商会提供一个类似zynq-黑金型号.dts的文件。编译方式make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- dtbs然后把编译出来的dtb文件替换掉SD卡对应分区的同名文件。重启后在串口终端里执行dmesg | grep -i ft5x06如果驱动加载成功能看到类似“input: EDT-FT5x06 touchscreen as /devices/.../input/inputX”的日志。这说明设备树匹配上了驱动成功probeinput设备已经注册。到这一步触摸驱动最核心的工作已经完成剩下就是验证和校准。如果没有任何日志先确认两点一是内核配置里是不是真的把驱动编进去了或模块有没有加载二是设备树里compatible字符串和驱动匹配表里的是不是一致。可以用这个命令查看当前设备树里有没有这个节点ls /proc/device-tree/i2c0/ft5x0638/能看到属性文件就说明U-Boot加载的dtb包含这个节点接下来问题大概率出在驱动编译或加载上。4. 驱动工作原理解读与坐标校准4.1 触摸控制器是怎么把手指变成坐标的先说原理不然遇到问题很难定位。电容触摸屏面板上有按行列排列的透明电极形成一个电容矩阵。手指靠近时局部电容值发生变化触摸控制芯片扫描整个矩阵后通过算法计算出一组或多组触点坐标然后把坐标值写进自己的寄存器。主机侧看到的是一颗I2C从设备里面有一块数据寄存器区域。当触摸事件发生时芯片的INT引脚产生一个下降沿主机收到中断后发起I2C读操作把触点数量、每个触点的X坐标、Y坐标、压力值等信息一口气读出来。可以想象成你去前台签到指纹触发感应器INT中断前台把登记表寄存器交给你你抄下来回去用。触摸芯片扫描频率一般几十到几百赫兹对应到Linux里就是中断频繁发生但每次处理时间很短所以驱动里必须用效率高的方式读取数据不能傻等也不能在中断上下文里做耗时操作。4.2 内核驱动到底做了什么理解了芯片行为再去看edt-ft5x06这个驱动的代码就非常清晰了。驱动本质上是一个I2C设备驱动结构体里的id_table或of_match_table用来匹配设备树里的compatible字符串。匹配成功后内核调用probe回调函数probe里做三件事第一初始化硬件相关资源解析reset-gpios把复位引脚拉高让芯片退出复位状态申请中断号注册中断处理函数。第二注册input设备调用input_allocate_device、input_set_capability等系列函数声明这个设备支持绝对坐标事件ABS_X、ABS_Y同时声明支持多点触摸协议ABS_MT_POSITION_X、ABS_MT_POSITION_Y再把触摸分辨率通过input_set_abs_params告诉input核心。第三注册中断处理函数后驱动就进入工作状态。一旦有触摸中断中断处理函数要么直接读取寄存器要么把读取操作放到工作队列里执行读回来的坐标经过换算后用input_report_abs上报给input核心。所有触点都报完后最后调用input_sync告诉上层“这一批触摸事件完整了”。上报逻辑看起来简单但有几个地方容易出问题。比如多触点上报时必须遵循B协议触摸点的slot要正确切换否则会出现“触点漂移”或“拖影”的现象。再比如坐标换算时芯片寄存器里给出的是12位原始值范围0~4095而屏幕分辨率可能是1024x600或者1280x800驱动里如果用原始值直接上报上层应用获取到的坐标范围就是错误的触摸位置自然不准确。4.3 坐标校准与分辨率映射坐标校准分两步先做分辨率映射再做触摸校准。分辨率映射是固定公式显示坐标X 触摸原始X × 屏幕宽度 / 4095 显示坐标Y 触摸原始Y × 屏幕高度 / 4095这个公式可以在驱动里实现也可以在上层应用里实现。设备树里touchscreen-size-x和touchscreen-size-y就是告诉驱动原始坐标的最大值驱动会按这个比例自动换算。但有的时候触摸面板贴装角度、屏幕物理安装方向不同会出现坐标翻转、镜像的问题也就是触摸位置和显示位置对不上。简单场景下可以用设备树属性修正比如触摸屏上下反了就加touchscreen-inverted-y或者用touchscreen-swapped-x-y交换横纵坐标。如果是在没有桌面环境的嵌入式Linux里跑QT或者LVGL通常还会用tslib做一次更精细的校准。tslib的校准思路是屏幕上依次显示5个校准点用户点触系统拟合出触摸坐标到屏幕坐标的转换矩阵。编译tslib的时候要交叉编译一份放到根文件系统里然后配置环境变量export TSLIB_TSDEVICE/dev/input/event1 export TSLIB_CALIBFILE/etc/pointercal export TSLIB_CONFFILE/etc/ts.conf执行ts_calibrate按要求点击校准点生成的校准文件会自动保存。之后运行ts_test可以实时看到触摸坐标的反馈验证校准效果。电容屏一般来说出厂一致性比较好如果你做的是简单项目不做tslib校准也可以直接靠驱动里线性映射就够了。但如果你发现某个角度触摸漂移明显或者屏幕边缘区域定位不准那大概率还是要上tslib做一次完整校准。这一步看起来麻烦实际上对提升交互体验帮助很大值得做。5. 常见问题与排查技巧实录5.1 故障速查表我在调试过程中遇到过的故障基本可以收敛成下面这几种场景先放到一起方便大家按症状查现象可能原因排查方向触摸完全无反应设备树未匹配、中断错误、I2C不通i2cdetect看设备在不在dmesg看驱动日志触摸偶尔有反应但一点都不准坐标映射不对、分辨率参数错误检查触摸原始事件范围对照屏幕分辨率坐标镜像或左右翻转屏幕安装方向或触摸面板方向问题设备树inverted-x/y/swapped属性修正触摸会“漂移”手指不动坐标自己跑电源噪声、探测不准、触摸芯片校准丢失查供电稳定性做tslib校准只能识别一个触点多指没反应驱动不支持多点触摸的上报确认input_set_capability里有没有MT绝对坐标系统启动后偶尔无触摸重启恢复复位时序不对、供电时序问题检查RST初始化时序尝试软件反复复位触摸芯片5.2 调试三板斧dmesg、evtest、i2cdetect第一个必须学会的就是看内核日志。dmesg里能看到驱动probe是否成功、中断是否申请、有没有I2C传输错误。任何时候都不要跳步先把日志看明白再动手改。第二个是evtest。如果没有现成的evtest可以交叉编译一个放进根文件系统。运行evtest /dev/input/eventX能看到实时上报的触摸事件而且会按照input subsystem的协议把ABS_X、ABS_MT_POSITION_X这些字段解析出来非常直观。用它判断两点事件到底有没有上来坐标范围是否正常。如果这里看到的事件坐标和实际物理触摸点位置差了很远那就是坐标映射问题跟驱动加载没关系。第三个是i2cdetect和i2cdump。前者确认设备在线后者可以把自己要读的寄存器打印出来。有些I2C触摸芯片出现了总线锁死或者复位后没准备好i2cdetect就扫不到设备。这时候重新上电、手动复位触摸芯片再扫描一次。如果还是扫不到就得考虑是不是I2C引脚被其他外设占用了或者上拉电阻没接。这一套三板斧组合下来至少能解决90%的“没反应”类问题。5.3 我踩过的几个坑与经验第一个坑是中断号换算错误。前面已经提到MIO编号和GPIO编号的换算规则但实际操作时我又遇到了gpio0和gpio1的问题。ZYNQ设备树里gpio0控制器覆盖的就是bank0和bank1的所有64个GPIO所以换算时不能简单的用MIO号去对GPIO号一定要结合设备树里gpio控制器组织方式来定。最好的办法是先把GPIO导出来通过sysfs里active_low这些属性验证GPIO号有没有对应上引脚再写进设备树。第二个坑是复位时序不够。FT5206这类芯片上电后需要先把RST拉高并保持一段时间芯片才能正常初始化。我在设备树里配了reset-gpios但驱动里的复位延时太短芯片还没完全启动就尝试I2C通信结果就是设备扫描不到或者初始化失败。后来在probe流程里手动加了延时问题就消失了。如果你是直接用内核自带驱动尽量确保reset-gpios配置正确因为内核驱动里的时序别人已经调好了。第三个坑是I2C总线频率。PS端I2C控制器默认频率可能是400kHz但有些触摸芯片或者信号质量不太好的layout在400kHz下会出现偶发通信错误表现就是触摸时好时坏。后来把设备树的clock-frequency改成100kHz整个触摸就稳定了。性能上100kHz读一次触摸寄存器也用不了多少时间稳定性优先。第四个坑是“有中断但没数据”。当时在某块板子上INT引脚接到了EMIO我在设备树里中断节点指向了gpio0结果当然不行EMIO对应的中断控制器逻辑不一样。最后是通过读GPIO状态发现INT引脚压根没在预期电平翻转顺着这个线索追到引脚复用问题才解决。这里也提醒一句引脚复用配置很关键MIO引脚需要在设备树里设置为GPIO功能如果被某个外设占用了那中断和复位引脚都不好使。还有一个容易迷糊的地方触摸事件节点名。系统里可能有多个event设备比如鼠标、键盘、触摸屏。每次重启后event编号还可能变化所以不要硬编码evtest里的eventX更好的方式是通过sysfs确认事件设备对应的input设备名cat /proc/bus/input/devices根据名称找到触摸屏对应的event编号或者用udev规则按设备名固定成稳定的符号链接。关于后续扩展简单说一个思路。如果你的项目需要支持两块屏幕或者一块HDMI显示器加一块7寸触摸屏那么触摸坐标和显示帧缓冲之间的映射关系会复杂一些需要在应用层把触摸事件坐标换算到对应的输出显示区域。ZYNQ里还可以用PL端做触摸坐标到显示画面的叠加处理甚至做边缘检测、手势识别这些就是FPGA领域的进阶玩法了。底层的触摸驱动开发逻辑和这篇讲的完全一样把基础打牢了再往上层走不会白费功夫。