第一次在FPGA板卡上接7寸触摸屏，我花了一个下午找到的是一根弯折的FPC排线，而不是改设备树。后来我才明白，触摸驱动这件事从来不是"加载一个内核模块"这么简单，它是完整的一条链路：屏幕模组上的触摸控制芯片、FPGA里的总线主控逻辑、设备树描述、内核input子系统事件上报，最后才是用户态的校准工具。黑金云课堂这套FPGA技术教程的Linux开发部分，把7寸触摸屏驱动当作一个非常典型的软硬件结合案例来讲，确实讲到了点子上。
网上搜"触摸屏驱动"，大部分结果都是某个芯片在树莓派或者x86工控机上的移植笔记，比如XPT2046的SPI时序、FT5x06的I2C地址。这些内容有用，但如果你是在FPGA上做Linux开发，会很快发现这些笔记缺了最重要的"前一半"——触摸控制器和CPU之间那截总线、中断、寄存器，在FPGA方案里需要你自己设计。这篇文章就把我在这条路上的完整思路整理出来，从硬件连接、FPGA逻辑、设备树、内核驱动、用户态校准到实测踩坑，一条线串完，适合刚把Linux跑上FPGA、正被屏幕和触摸折磨的开发者。
1. 一块7寸屏在FPGA板卡上是怎么"长"出来的
1.1 先分清你是在给谁写驱动
同样是"Linux触摸驱动"，FPGA平台上其实有两条差别很大的路径。
第一类是SoC FPGA，典型代表是Xilinx Zynq-7000、Zynq UltraScale+和Intel Cyclone V SoC。芯片里集成了一颗ARM硬核，Linux跑在ARM上，FPGA（PL侧）主要负责外设扩展。触摸芯片的SPI或I2C引脚可以挂在PL的IO上，但总线控制器可以复用PS自带的SPI/I2C外设，也可以自己在PL里做一个。这种方案下，你的主要精力放在设备树、管脚约束和内核配置上，HDL逻辑有时候只是一层引脚转发。
第二类是纯FPGA加软核处理器，例如Nios II或MicroBlaze上跑Linux。这才是很多老教程里"FPGA味"最重的方案：触摸控制器作为自研外设挂在片上总线上，Linux驱动面对的是内存映射寄存器，而不是直接操作SPI/I2C控制器。你既要写HDL状态机，又要写C驱动，两边都要看懂。
我见过不少人在论坛里贴出设备树片段问"为什么不进中断"，结果一问才发现板子根本没有ARM硬核，Linux跑在软核上，设备树里的compatible对不上任何现成驱动。所以第一步不是抄代码，是认清楚你的硬件属于哪条路径。
1.2 电阻、电容、红外，三种触摸方案选型差异
7寸屏的触摸方案，在FPGA板卡上基本就是三类。我先把它们在Linux主线里的状态整理一下。
| 类型 | 代表芯片 | 接口 | 常用内核配置 | 场景 |
|---|---|---|---|---|
| 电阻式 | XPT2046、ADS7846、TSC2007 | SPI | CONFIG_TOUCHSCREEN_XPT2046 / ADS7846 | 工控HMI、低成本单点 |
| 电容式 | FT5x06、GT911、GT9147 | I2C | CONFIG_TOUCHSCREEN_EDT_FT5X06 / GOODIX | 量产设备、多点触控 |
| 红外式 | 各品牌红外框，如TouchKit | USB HID / 串口 | 多为usbhid或厂家协议 | 大尺寸自助设备，7寸很少用 |
FPGA开发板上电阻式最常见，原因很直白：标准7寸RGB接口模组大量自带电阻触摸，配的触摸控制芯片往往是XPT2046或它的兼容片，SPI接口简单到可以用几十行状态机实现，不依赖厂商闭源固件。电容屏体验好，但I2C时序和初始化配置没有SPI那么透明，FocalTech早期芯片甚至要加载一堆寄存器参数，主线上edt,edt-ft5x06驱动能覆盖一部分，不见得覆盖所有批次的模组。至于红外式，7寸面板上基本不用，如果你搜到"TouchKit红外触摸屏驱动"这种关键词，那大概率是15寸以上的查询机和自助设备，接口通常是USB HID或串口私有协议，跟FPGA里的触摸逻辑是完全不同的技术路线，别混着查。
1.3 触摸和显示是两条独立通路
新手最容易绕进去的死胡同，是把触摸和LCD当成一回事。实际上触摸模组和LCD模组在物理上是一体的，但在信号链路上完全是分开的：显示走RGB/MIPI/HDMI，由FPGA的时序控制器或SoC的显示控制器负责；触摸走SPI/I2C再加一根中断脚。你调通了framebuffer，不代表触摸就能工作；反过来触摸设备树节点写错，也不影响屏幕显示。
有个真实的对比案例。同一块7寸屏，接到Zynq上，显示路径要配置VDMA、时序发生器、屏幕背光，占用不少FPGA资源和DDR带宽；而触摸路径只需要一根SPI或I2C加上一个中断，资源占用几乎可以忽略。所以如果你发现屏幕显示正常但触摸完全没反应，别怀疑是VDMA或MIPI配置问题，大概率是触摸这条小通路断了——排线没插紧、触摸芯片没供电、中断引脚被复用成了别的功能，这些才是常见原因。
2. 硬件连接与FPGA侧触摸控制逻辑
2.1 XPT2046的引脚连接参考
以最经典的XPT2046电阻触摸方案为例。7寸模组上有一个触摸控制芯片，它的引脚通过FPC引出，到了FPGA板上就是下面这几根线。
| 信号 | 方向 | 作用 |
|---|---|---|
| SCLK | FPGA -> XPT2046 | SPI时钟 |
| MOSI/DIN | FPGA -> XPT2046 | 下发命令，选择读X还是Y |
| MISO/DOUT | XPT2046 -> FPGA | 回传12位ADC采样值 |
| CS | FPGA -> XPT2046 | 片选，低有效 |
| PENIRQ | XPT2046 -> FPGA | 笔按下的中断输出，低有效 |
| VCC/GND | 电源 | 多数模组是3.3V |
几个容易出错的地方。第一，电平匹配。很多7寸模组接口是3.3V，如果FPGA的IO bank配置成2.5V，触摸芯片可能能工作但信号边沿会很难看，甚至直接不工作。第二，PENIRQ这根脚。部分模组的PENIRQ是开漏输出，板上已经做了上拉；如果你自己画板，一定别忘了在FPGA内部或PCB上加上拉电阻，否则按下屏幕时中断脚被拉低，松开后又没有确定的高电平，Linux里的中断计数会被毛刺刷爆。第三，FPC排线尽量不要过度弯折，触摸芯片的SPI时钟也就2MHz上下，排线质量问题不至于直接导致时序失败，但会带来触摸值随机跳变，排查起来特别隐蔽。
2.2 SPI时序是第一个分水岭
XPT2046的读取过程看着简单：CS拉低，发送一个8位控制字（选择X通道、Y通道还是压力），然后读回12位ADC数据。但很多第一次写FPGA SPI状态机的人会在第一个分水岭翻车——时钟极性和相位。
控制字的格式大致是：最高位是起始位，接着是通道选择位，然后是12/8位模式选择、参考电压选择、掉电模式选择。比如要读X坐标，下发0xD0；读Y坐标，下发0x90。这只是常见的命令举例，不同厂家的兼容片可能定义略有出入，最终以模组上实际芯片的数据手册为准。
在FPGA逻辑里，SPI Master状态机本身不难，难的是采样边沿。我的习惯做法是：SCLK空闲为低，在SCLK的下降沿把MOSI上的下一位移出，在SCLK的上升沿把MISO采回来。这实际上就是SPI Mode 0。如果你在Linux侧还挂了一个SPI控制器配合着用，设备树里的spi-cpha、spi-cpol属性和FPGA里的时序必须一致，否则最常见的表现是读回来的坐标恒为某个固定值，或者每次采样都不稳定。
下面是一段简化到只剩主干的Verilog状态机示意，只说明状态转移，实际工程还要加时钟分频、去抖、bit计数清零等逻辑。
// 简化版 XPT2046 读坐标状态机 localparam IDLE = 2'd0; localparam SEND = 2'd1; // 移出 8bit 控制字 localparam READ = 2'd2; // 采样 12bit ADC localparam DONE = 2'd3; always @(posedge clk or negedge rst_n) begin if (!rst_n) begin state <= IDLE; cs_n <= 1'b1; end else begin case (state) IDLE: if (touch_start) begin cs_n <= 1'b0; state <= SEND; end SEND: if (bit_cnt == 4'd8) begin bit_cnt <= 4'd0; state <= READ; end READ: if (bit_cnt == 4'd11) begin data <= shift_data; done <= 1'b1; state <= DONE; end DONE: begin cs_n <= 1'b1; done <= 1'b0; state <= IDLE; end endcase end end2.3 中断来了不要马上读坐标
PENIRQ拉低，表示有人碰到了屏幕，但这时候坐标大概率还在抖动。机械抖动、ADC建立时间、面板本身的噪声，都会让紧跟着读回来的坐标在几十到上百个ADC码值之间跳。硬件上比较稳妥的处理是：检测到PENIRQ下降沿后，在FPGA里做一个10ms左右的延时，然后再启动SPI读取；连续读到两次坐标差小于某个阈值，才认为坐标稳定，可以更新寄存器。
这个去抖逻辑在Linux内核里也有对应物。ADS7846兼容驱动有ti,debounce-max、ti,debounce-tol、ti,debounce-rep这几个参数，控制"连续多少次、误差在多大范围内算有效"。如果你在FPGA侧没做任何去抖，光在内核里调debounce参数也能缓解，但不如硬件上先把脏数据过滤掉来得干净。我的建议是FPGA侧做基础去抖，内核侧参数只负责微调，两边分工才不容易互相影响。
2.4 I2C电容屏：能复用PS控制器就复用
如果你用的是Zynq这类带硬核的平台，电容屏尽量用PS自带的I2C控制器，通过EMIO把SDA/SCL引到PL对应的引脚上。这个方案里FPGA只需要做引脚约束和上下拉配置，Linux里走标准I2C总线，设备树挂一个子节点就行，省去自己写I2C Master的麻烦。
如果平台没有可复用的I2C控制器，或者你想在软核上自己来，那就得在FPGA里实现一个轻量I2C Master。I2C比SPI麻烦的地方在于它是半双工、有ACK、有START/STOP等时序要求，状态机要比SPI复杂不少。还有一个特别容易忽略的点：I2C是开漏总线，必须有上拉电阻。很多人在FPGA工程里不管物理上拉，直接在代码里把SDA写成强拉高，然后折腾半天找不到问题——实际上你看到的"高电平"只是FPGA内部弱上拉，驱动能力根本不够。
3. Linux内核驱动：从设备树到input子系统
3.1 设备树里的触摸节点怎么挂
不管是用SPI的XPT2046，还是I2C的FT5x06，设备树节点都要挂在正确的总线节点下面。下面是一个常见的XPT2046节点写法，挂在名为spi0的控制器下。
&spi0 { status = "okay"; touch: xpt2046@0 { compatible = "xpt2046"; reg = <0>; spi-max-frequency = <2000000>; touchscreen-min-x = <100>; touchscreen-max-x = <3800>; touchscreen-min-y = <120>; touchscreen-max-y = <3700>; touchscreen-max-pressure = <255>; }; };要注意，touchscreen-min-x、touchscreen-max-x这些值不是屏幕分辨率，而是触摸采样值的上下限。具体数值要靠实测获取，用一个调试工具先读原始ADC值是最快的。如果你内核版本较老没有xpt2046驱动，改用compatible = "ti,ads7846"并按ADS7846的文档补上ti,x-plate-ohms等属性，也能驱动兼容芯片。
电容屏FT5x06的节点则挂在I2C总线下。
&i2c1 { status = "okay"; ft5x06: ft5x06@38 { compatible = "edt,edt-ft5x06"; reg = <0x38>; interrupt-parent = <&gpio0>; interrupts = <7 IRQ_TYPE_EDGE_FALLING>; reset-gpios = <&gpio0 8 GPIO_ACTIVE_LOW>; touchscreen-size-x = <1024>; touchscreen-size-y = <600>; }; };很多7寸模组上的电容芯片丝印是FT5406或FT6206，只要协议兼容，edt,edt-ft5x06驱动也能认。GT911那类Goodix芯片同样挂在I2C下，内核里有CONFIG_TOUCHSCREEN_GOODIX，具体compatible字符串要按你内核源码里的匹配表来，别照抄别的平台。
3.2 内核配置该开哪些项
设备树写完了，内核配置不够的话照样白搭。触摸相关的开关基本在Device Drivers -> Input device support -> Touchscreens这个菜单树下。常用配置项按你实际方案勾选：
- CONFIG_INPUT_TOUCHSCREEN=y
- CONFIG_TOUCHSCREEN_XPT2046=y
- CONFIG_TOUCHSCREEN_ADS7846=y（老内核或ADS7846方案）
- CONFIG_TOUCHSCREEN_EDT_FT5X06=y
- CONFIG_TOUCHSCREEN_GOODIX=y（GT9xx系列）
- CONFIG_INPUT_EVDEV=y
- CONFIG_INPUT_MOUSEDEV=y（可选，把触摸模拟成鼠标）
这里有个容易被忽略的关联配置：如果你的触摸芯片挂在内核I2C子系统下，I2C控制器本身的驱动必须打开，比如Zynq PS侧的I2C对应的是Cadence I2C控制器，配置项通常叫CONFIG_I2C_CADENCE。很多人触摸节点没问题、芯片也在，但总枚举不到设备，最后发现是I2C控制器根本没编进内核。
3.3 驱动上报事件的模型：单点、多点、MT协议
你不需要为这个项目从零写完整的内核驱动，因为XPT2046、FT5x06这些主线驱动已经存在。但读驱动程序的时候，最好知道它们内部是怎么上报数据的。单点触摸上报的核心就是四个调用：
input_report_key(input, BTN_TOUCH, 1); input_report_abs(input, ABS_X, x); input_report_abs(input, ABS_Y, y); input_sync(input);多点触摸则要遵循MT协议。内核里常见的是Type B，也就是带slot的报法，大致长这样：
input_mt_slot(input, 0); input_mt_report_slot_state(input, MT_TOOL_FINGER, true); input_report_abs(input, ABS_MT_POSITION_X, x); input_report_abs(input, ABS_MT_POSITION_Y, y); input_mt_report_slot_state(input, MT_TOOL_FINGER, false); input_sync(input);这里有个值得说的细节：XPT2046这种电阻屏驱动，很多用的是input_polled_dev轮询模式，也就是每隔一段时间主动去读一次ADC，而不是完全靠中断触发。轮询模式的优点是硬件链路简单，缺点是CPU占用和功耗略高。如果你用中断加轮询混合的方式，担心漏事件可以把input_poll_interval调短一点，但别小于1ms，不然一帧数据还没读完又触发下一次，内核线程会一直占着CPU。
4. 用户态校准与触摸屏的"手感"
4.1 evtest是最快的判断工具
驱动加载完，先别急着连Qt或写应用，直接用evtest看内核上报的事件。假设设备节点是/dev/input/event1，执行：
evtest /dev/input/event1手指点在屏幕上，你会看到类似这样的输出：
Event: time 1712345678.123456, type 3 (EV_ABS), code 0 (ABS_X), value 2304 Event: time 1712345678.123456, type 3 (EV_ABS), code 1 (ABS_Y), value 1600 Event: time 1712345678.123456, type 1 (EV_KEY), code 330 (BTN_TOUCH), value 1 Event: time 1712345678.123456, type 0 (EV_SYN), code 0 (SYN_REPORT), value 0看到这几行，说明内核驱动到input子系统整条链路是通的。如果event节点存在但没有任何事件输出，先查中断；如果事件有但只有ABS_X没有ABS_Y，查SPI/I2C读回来的数据长度对不对；如果事件里的value永远不变，多半是SPI时序的采样边沿错了。evtest是判断"问题出在驱动之前还是驱动之后"的分水岭，这个工具一定要先跑。
4.2 电阻屏不要跳过tslib校准
对于XPT2046这类电阻屏，tslib几乎是必装的，因为原始ADC值和像素坐标之间不是简单的线性缩放。7寸屏可能只用到屏幕中间一块，四个角的ADC采样值可能是(120,140)到(3850,3720)，还带着旋转和镜像。tslib的作用就是把这套非线性关系转成像素坐标。
# Debian/Ubuntu系列 apt install libts-bin export TSLIB_TSDEVICE=/dev/input/event1 ts_calibrate ts_test_mt校准完成后会生成一个/etc/pointercal文件，里面是7个浮点数系数。触摸屏不换、屏幕分辨率不改、驱动不重编的情况下，这个文件可以一直用。有一点要提醒：有些新系统把触摸事件的读取交给了libinput，tslib直接读/dev/input/eventX可能读不到事件，或者和libinput互相打架。如果你发现ts_test光标不动，检查一下系统里是否同时有libinput在消费同一个event设备。
4.3 应用层接法：Qt和X11两条路
在嵌入式Linux上接应用，老项目常走tslib，新项目基本都转向libinput。在Qt5/Qt6的嵌入式环境下，如果用了linuxfb或eglfs插件，触摸屏插件通常叫evdevtouch或tslib，平台启动参数里指定一下就行。在X11桌面环境里，用xinput命令查看设备并设置校准矩阵会更直接：
xinput list xinput set-prop "pointer:FT5x06" "libinput Calibration Matrix" 1 0 0 0 1 0 0 0 1这里的9个数字是一个3x3矩阵，对应旋转和缩放。很多人只关心"能不能点"，我建议在项目初期就顺手写一个脚本：启动时检测触摸设备、读取已有校准参数、再启动GUI。别问为什么，等你同时接了一块电阻屏和一块电容屏，就知道这套脚本能救命的次数有多频繁。
5. 实测踩坑记录：没反应、乱飞、漂移
5.1 触摸没反应：先查中断脚，别急着改驱动
最典型的故障是"设备树挂上了，event设备也有了，但点了没反应"。我的排查顺序永远是先看中断计数：
cat /proc/interrupts用笔点一下屏幕，看触摸设备对应的中断计数有没有增加。如果计数不涨，问题基本与Linux驱动无关，集中在硬件链路：PENIRQ有没有拉到FPGA引脚、排线有没有插好、引脚约束有没有外漏。如果计数狂涨甚至失控，说明中断脚在不该触发的时候一直触发，检查上拉电阻和中断类型配置，IRQ_TYPE_EDGE_FALLING和IRQ_TYPE_LEVEL_LOW要看芯片手册决定，很多国产兼容片对电平中断支持得并不好。
我还遇到过一种隐蔽的情况：中断每次都触发，但内核线程读到的坐标一直是(0,0)。查到最后是FPGA里的SPI状态机在启动复位后没有初始化bit计数寄存器，第一次读数据时少采了4位，整帧数据错位。evtest里表现就是有事件但坐标恒定，这时候不要怀疑设备树，要用逻辑分析仪去看SCLK、MOSI、MISO三根线是否符合你预期的时序。
5.2 坐标乱飞或翻转：八成是通道或极性反了
电阻屏最常见的"乱飞"原因有三个：X/Y通道对调、X/Y反方向、SPI读回来的值没有做位宽掩码。用evtest可以快速判断：手指沿屏幕水平方向慢慢滑动，如果输出的ABS_X变化但方向不对，或者变化的是ABS_Y，那就需要翻转或交换坐标。
设备树里的处理方式很直接：
touchscreen-inverted-x; touchscreen-inverted-y; touchscreen-swapped-x-y;这三个布尔属性在很多主线触摸驱动里都支持，含义字面意思。改完设备树记得重新加载overlay或重启系统。如果你更依赖tslib，也可以在pointercal上做调整，但我倾向于把这类基本映射放在设备树层解决，tslib只做非线性校准，职责分开后面好维护。
5.3 多点触摸失效：MT协议Type A和Type B的坑
电容屏的"触摸乱"和电阻屏不一样，更常见的是多指同时按下时只剩一个点，或者点住一个地方不动，屏幕上却不断出现新触点。这往往不是硬件问题，而是驱动上报的MT协议类型和应用层期待的不一致。
Linux多点触摸有两种协议：Type A用于非硬件关联的多指识别，内核只负责上报一个个触摸点；Type B使用slot机制，内核给每个触点分配一个slot，应用层能追踪同一根手指的滑动轨迹。绝大多数现代应用框架期待Type B。如果你的驱动上报的是Type A，而框架按Type B解析，就会出现触点无法关联、坐标漂移、断点。FT5x06驱动本身支持Type B，但个别老版本内核的驱动默认走Type A，需要在源码里把input_mt_init_slots的参数配成能力位正确的值。
电阻屏不存在这个烦恼，因为它物理上就只有一个触点。如果你在XPT2046方案上非要实现两点缩放手势，那是FPGA和驱动都得改的大工程，不是简单调配置能完成的，项目规划时最好想清楚。
5.4 漂移是电阻屏的宿命，但可以缓解
电阻屏用久了或者温度变化大，坐标会慢慢漂移，这是物理特性决定的，没法根治。缓解手段有几个：第一，在FPGA侧加滑动平均滤波，把连续几次采样取平均再更新寄存器；第二，在tslib里开启降采样和均值滤波插件；第三，保证触摸芯片的模拟参考电压干净，不要在同一个电源轨上给电机或继电器供电。
如果是I2C电容屏出现漂移，事情通常更麻烦。比如GT911驱动里有一些出厂参数和中断模式配置，是用固件写入的，你自己改驱动未必能生效。我遇到过一次触摸点整体向左偏移十几个像素，最后发现是屏幕贴合时玻璃微偏，不是代码问题，校准矩阵一转就解决了。所以碰到漂移，先分清楚是"面板物理量变"还是"采样值本身变了"，这两条路查起来天差地别。
6. 软核处理器上的扩展玩法
6.1 自定义寄存器设备
如果你的Linux跑在Nios II或MicroBlaze上，触摸控制器就是你自己定义的内存映射外设，内核驱动的写法会完全不一样。比如你定义一个32位寄存器，Bit[11:0]存X，Bit[23:12]存Y，Bit[24]存是否按下，Linux驱动只需要在这个外设对应的物理基址上ioremap，然后注册一个中断处理函数，在中断里读一次寄存器再上报input子系统。
这种方案的调试难点已经从驱动转移到了"FPGA侧寄存器是否按约定工作"。我在软核平台上写驱动的习惯是：先把寄存器地址、位宽、有效位写进一个头文件，HDL和C代码共用同一个定义文件。这样两边改起来才不会出现"C里读的是Bit25，Verilog里写的其实是Bit24"这种低级错误。
6.2 用DMA搬运多点坐标
单点电阻屏的采样率做到200Hz已经很高了，DMA意义不大。但电容屏一旦开始做两点缩放、多点手势，每个采样周期要搬好几个点的坐标，CPU在中断里逐字节读取会吃掉大量算力。这时候可以考虑让FPGA侧的控制器把一串坐标先写入DDR缓冲区，写完再发一个中断让Linux驱动去批量读取。
设计思路是：FPGA写一段固定大小的环形缓冲区，用AXI接口连到DDR，Linux驱动通过内存映射看到这块区域。每个样本记录格式固定，比如4字节的X加4字节的Y，再带一个标志位表示当前批次是否写完。驱动收到中断后把一批新数据一口气搬进input子系统。这个方案比普通中断驱动要稍微复杂，但在高采样率触摸场景下是值得的。
6.3 绕过input子系统，直接给应用层
还有一种特立独行的做法：如果这是封闭的工控项目，触摸数据只给一个自定义应用用，没必要走Linux input子系统。你可以把FPGA控制器注册成一个misc字符设备，应用层直接open/read/ioctl拿坐标。这样省掉了input子系统的抽象层，也绕开了tslib/libinput的校准体系，但代价是失去了标准化，换应用或换屏都得改代码。我的观点是，除非你对整个系统有绝对的控制权，并且确实有低延迟、高吞吐的硬性要求，否则还是走标准input子系统更划算——因为7寸触摸屏的瓶颈根本不在这层抽象上。
最后说一个我一直保留的调试习惯：不管问题多离谱，先看原始数据，再谈优化。触摸屏驱动这条链路，从FPGA状态机里的一个采样位，到应用层一次手势识别，中间隔了五六层。直接在最高层猜问题，大概率是在浪费一个下午；从底层原始数据一层层往上确认，往往十分钟就能把问题定位。7寸触摸屏只是个入口，这套排查方法用顺了，后面做MIPI触摸、多屏拼接、手势识别，都会快很多。
