i.MX6ULL触摸屏驱动开发全攻略：从设备树配置到tslib校准

这次我们来看 i.MX6ULL 嵌入式 Linux 开发中一个非常核心且实用的模块：触摸屏。对于任何带屏的嵌入式设备，无论是工业 HMI、智能家居中控还是便携式仪器，触摸屏的驱动和应用都是绕不开的关键技术。很多开发者拿到开发板后，面对触摸屏的校准、多点触控、事件上报等问题常常感到无从下手，这篇文章就带你从基础原理到实际驱动，彻底搞懂 i.MX6ULL 上的触摸屏开发。

这篇文章的重点不是讲空洞的理论，而是直接告诉你：在 i.MX6ULL 上，触摸屏能不能用、怎么用、驱动如何加载、事件如何读取、校准怎么做。我们会从触摸屏的基础知识讲起，涵盖电阻屏与电容屏的区别、Linux 输入子系统框架，然后深入到 i.MX6ULL 的典型触摸屏接口（如 I2C 接口的电容屏）驱动移植与调试，最后给出完整的测试验证流程。无论你是刚接触嵌入式 Linux 的新手，还是正在为项目中的触摸屏问题头疼的工程师，这篇文章都能提供清晰的路径和可操作的代码。

1. 核心能力速览

在深入细节之前，我们先快速了解在 i.MX6ULL 上开发触摸屏需要掌握的核心要点和资源门槛。

能力项	说明
核心平台	NXP i.MX6ULL 处理器，ARM Cortex-A7 架构，常用于工业控制、物联网网关等。
触摸屏类型	主要支持电阻式触摸屏和电容式触摸屏。现代项目以 I2C 接口的电容屏（如 GT911、FT5x06）为主流。
驱动框架	Linux 输入子系统 (input subsystem)。触摸屏被抽象为输入设备，上报ABS_MT等事件。
软件依赖	Linux 内核需开启CONFIG_INPUT_TOUCHSCREEN及具体触摸屏控制器驱动（如CONFIG_TOUCHSCREEN_EDT_FT5X06）。
硬件接口	常见为 I2C 接口，部分电阻屏可能使用 SPI 或直接接 ADC。i.MX6ULL 需正确配置 I2C 引脚复用和设备树。
校准工具	常用tslib库进行触摸校准和测试。
测试手段	通过evtest工具实时读取原始输入事件；通过ts_test等工具进行校准后测试。
适用场景	为 i.MX6ULL 开发板添加触摸交互功能；调试触摸屏无响应、坐标不准、多点触控异常等问题；进行触摸驱动的移植与适配。

2. 触摸屏类型与基本原理

在动手写驱动或修改设备树之前，必须清楚你用的是哪种触摸屏，这决定了整个软件栈的处理方式。

2.1 电阻式触摸屏

电阻屏是早期的主流技术，现在多用于低成本或特殊环境（如戴手套操作）的场合。

• 工作原理：由两层导电薄膜组成，按压时两层薄膜接触，通过测量 X、Y 方向的电压变化来确定触点位置。通常需要专用的触摸控制芯片（如 TSC2007）或利用处理器的 ADC 接口。
• 特点：任何物体均可触控；精度较高；但透光性较差，不支持多点触控（通常）。
• 在 i.MX6ULL 上的实现：可能需要连接至处理器的 ADC 输入引脚，并配合相应的电阻屏控制器驱动。开发相对直接，但已非主流方案。

2.2 电容式触摸屏

这是当前智能手机、平板和大多数嵌入式智能设备的绝对主流。

• 工作原理：利用人体电流感应进行工作。屏幕表面有透明导电层，当手指触摸时，会与导电层形成耦合电容，控制器通过检测电容变化来确定触摸位置。
• 特点：透光性好、支持多点触控、耐用性强。但需要皮肤或专用电容笔触控。
• 在 i.MX6ULL 上的实现：几乎都通过 I2C 接口与主机通信。触摸控制器（如 Goodix GT911, FocalTech FT5x06, Ilitek ILI2xxx）集成度高，负责扫描、滤波、坐标计算，然后通过中断和 I2C 将坐标数据上报给 CPU。

对于 i.MX6ULL 开发者而言，目前遇到的大部分都是 I2C 接口的电容触摸屏。因此，后续的讲解将重点围绕这种类型展开。

3. Linux 输入子系统与触摸屏驱动框架

Linux 内核通过“输入子系统”来统一管理键盘、鼠标、触摸屏等输入设备。理解这个框架是编写和调试触摸驱动的关键。

3.1 输入子系统核心概念

1. 输入设备 (input device)：代表一个具体的硬件，如一个触摸屏控制器。驱动需要注册一个input_dev结构体。
2. 输入处理器 (input handler)：负责处理特定类型的事件。对于触摸屏，最重要的处理器是evdev，它将事件封装后提供给用户空间/dev/input/eventX节点。
3. 事件 (event)：输入设备上报的信息。触摸屏主要上报绝对坐标事件。
   • EV_KEY: 按键事件（触摸屏的按下/抬起）。
   • EV_ABS: 绝对坐标事件（触摸点的 X, Y 坐标，压力等）。
   • ABS_MT_*:多点触控协议事件，这是现代电容屏的标准。

3.2 触摸屏驱动的工作流程（以 I2C 电容屏为例）

1. 驱动探测 (probe)：I2C 适配器根据设备树中的兼容性字符串匹配到驱动，调用驱动的probe函数。
2. 初始化与注册：在probe中：
   • 初始化硬件（复位、配置寄存器）。
   • 申请中断（触摸控制器通常在检测到触摸时，通过 INT 引脚触发中断）。
   • 分配并设置input_dev：设置能产生的事件类型 (EV_KEY,EV_ABS)，设置绝对坐标的范围 (input_set_abs_params)。
   • 注册输入设备：input_register_device。
3. 中断服务程序 (ISR)：当触摸发生时，进入中断处理函数。
   • 通过 I2C 读取触摸控制器寄存器，获取一个或多个触摸点的坐标、状态（按下/抬起）。
   • 使用input_report_abs上报ABS_MT_TRACKING_ID,ABS_MT_POSITION_X,ABS_MT_POSITION_Y等事件。
   • 对于单点触控，也可以使用input_report_key和input_report_abs上报BTN_TOUCH,ABS_X,ABS_Y。
   • 最后调用input_sync表示一个触摸点信息同步完成。
4. 用户空间访问：驱动成功后，会在/dev/input/下生成eventX节点。用户态程序（如 Qt, tslib, 或直接使用evtest）通过读取这个节点来获取触摸事件。

4. i.MX6ULL 触摸屏开发环境准备

在开始修改内核和驱动之前，请确保你的基础开发环境已经就绪。

4.1 硬件准备

• i.MX6ULL 开发板：如正点原子、野火、飞凌等厂商的开发板。
• 电容触摸屏：通常与 LCD 屏集成在一起，通过 FPC 排线连接。确认其触摸控制器型号（如 GT911）。
• 连接检查：确保触摸屏的 I2C 数据线（SDA）、时钟线（SCL）、中断线（INT）、复位线（RST）与 i.MX6ULL 的对应 GPIO 正确连接。这通常由开发板底板设计决定。

4.2 软件准备

• Linux 内核源码：获取与你开发板配套的 Linux 内核源码（如 NXP 官方内核或开发板厂商提供的 SDK）。
• 交叉编译工具链：如arm-linux-gnueabihf-。
• 根文件系统：包含必要的测试工具，如evtest,tslib。
• 串口调试工具：如minicom或picocom，用于查看内核启动和驱动打印信息。

4.3 内核配置检查

在编译内核前，需要确保相关配置已打开。进入内核源码目录，执行make menuconfig。 需要重点关注的配置项位于：

Device Drivers ---> Input device support ---> [*] Touchscreens --->

在此菜单下，根据你的触摸屏芯片型号选择对应的驱动。例如：

• <*> FocalTech FT5x06 I2C Touchscreen support
• <*> Goodix I2C touchscreen GT9xx support
• <*> Ilitek I2C Touchscreen (ILI2xxx)

务必确认驱动被编译进内核 (*)，而不是编译为模块 (M)，除非你明确知道如何动态加载模块。

5. 设备树 (Device Tree) 配置详解

设备树是嵌入式 Linux 驱动开发的“地图”，它描述了硬件资源如何与驱动绑定。触摸屏的配置主要涉及 I2C 设备节点和引脚控制。

5.1 I2C 控制器节点

首先，确认你的触摸屏连接到了哪个 I2C 总线。i.MX6ULL 通常有多个 I2C 接口（如 I2C1, I2C2）。在设备树源文件（.dts或.dtsi）中找到对应的 I2C 控制器节点，例如i2c1。

5.2 添加触摸屏设备子节点

在对应的 I2C 控制器节点下，添加你的触摸屏控制器作为子节点。这是最关键的一步。

以下是一个Goodix GT911触摸屏的配置示例，假设接在i2c1上：

&i2c1 { clock-frequency = <100000>; /* I2C 标准模式 100kHz */ pinctrl-names = "default"; pinctrl-0 = <&pinctrl_i2c1>; /* 引用引脚复用配置 */ status = "okay"; /* 触摸屏设备节点 */ gt911: touchscreen@5d { compatible = "goodix,gt911"; /* 用于匹配驱动 */ reg = <0x5d>; /* I2C 设备地址，需查阅数据手册 */ pinctrl-names = "default"; pinctrl-0 = <&pinctrl_tsc>; /* 触摸屏专用引脚（中断、复位）配置 */ interrupt-parent = <&gpio1>; /* 中断引脚所属的 GPIO 控制器 */ interrupts = <9 IRQ_TYPE_EDGE_FALLING>; /* GPIO1_IO09，下降沿触发 */ reset-gpios = <&gpio1 8 GPIO_ACTIVE_LOW>; /* 复位引脚 GPIO1_IO08，低电平有效 */ irq-gpios = <&gpio1 9 GPIO_ACTIVE_HIGH>; /* 中断引脚 GPIO1_IO09，高电平有效 */ /* 以下属性非必需，但某些驱动需要 */ touchscreen-size-x = <800>; /* X 方向分辨率，与屏幕一致 */ touchscreen-size-y = <480>; /* goodix,driver-send-cfg; */ /* 如果需要驱动发送配置寄存器，则启用 */ }; };

关键属性解释：

• compatible：驱动匹配的“身份证”，必须与内核驱动中of_device_id表里的字符串一致。
• reg：I2C 从设备地址。务必与硬件原理图和数据手册核对，地址错误会导致驱动探测失败。
• interrupts：指定中断引脚和触发方式。IRQ_TYPE_EDGE_FALLING表示下降沿触发。
• reset-gpios和irq-gpios：使用 GPIO 描述符方式指定复位和中断引脚，这是推荐的新写法。
• touchscreen-size-x/y：告知驱动屏幕的物理分辨率，用于坐标映射。

5.3 引脚控制组 (pinctrl) 配置

你需要为 I2C 引脚和触摸屏专用的中断、复位引脚配置复用功能和电气属性。这通常在pinctrl节点中完成。

&iomuxc { pinctrl_i2c1: i2c1grp { fsl,pins = < MX6UL_PAD_UART4_TX_DATA__I2C1_SCL 0x4001b8b0 MX6UL_PAD_UART4_RX_DATA__I2C1_SDA 0x4001b8b0 >; }; pinctrl_tsc: tscgrp { fsl,pins = < /* 中断引脚 INT */ MX6UL_PAD_GPIO1_IO09__GPIO1_IO09 0x1b0b0 /* 上拉，速度中等 */ /* 复位引脚 RST */ MX6UL_PAD_GPIO1_IO08__GPIO1_IO08 0x1b0b0 >; }; };

0x4001b8b0和0x1b0b0是引脚配置字，包含了上下拉、驱动强度、速度等设置。最稳妥的方法是参考开发板原有设备树中类似功能的引脚配置进行修改。

6. 驱动移植、编译与内核更新

6.1 驱动代码位置

如果你使用的触摸屏型号在内核中已有驱动（如drivers/input/touchscreen/gt9xx.c），那么通常只需要正确配置设备树即可。 如果内核中没有对应驱动，你需要从供应商或社区获取驱动源码，并将其放入drivers/input/touchscreen/目录，并修改该目录下的Kconfig和Makefile以将其纳入编译体系。

6.2 编译内核与设备树

1. 配置好内核后，保存退出menuconfig。
2. 编译内核镜像和设备树：

   # 在源码目录下，指定交叉编译器和架构 export ARCH=arm export CROSS_COMPILE=arm-linux-gnueabihf- # 编译内核 zImage make zImage -j8 # 编译设备树（假设你的设备树文件叫 imx6ull-myboard.dts） make dtbs

3. 编译完成后，在arch/arm/boot/下找到zImage，在arch/arm/boot/dts/下找到imx6ull-myboard.dtb。

6.3 更新开发板系统

将编译好的zImage和.dtb文件替换到开发板启动分区（如 SD 卡或 eMMC 的 FAT 分区），然后重启开发板。

7. 功能测试与效果验证

开发板启动后，需要通过一系列工具来验证触摸屏驱动是否正常工作。

7.1 查看内核启动日志

通过串口查看启动信息，搜索触摸屏相关关键词：

dmesg | grep -E “goodix|ft5x|i2c|input|touch”

如果驱动加载成功，你应该能看到类似下面的信息：

[ 2.345678] input: goodix-ts as /devices/platform/soc/2100000.i2c/i2c-1/1-005d/input/input0 [ 2.345789] goodix-ts 1-005d: gt911 probed, fw_ver: 1060, id: 911

这表示 Goodix 驱动已成功探测到设备，并将其注册为输入设备input0。

7.2 查看输入设备节点

登录开发板终端，查看/dev/input目录和/proc/bus/input/devices文件：

ls /dev/input/ # 通常能看到 event0, event1... 其中一个是触摸屏 cat /proc/bus/input/devices

在devices文件中，找到你的触摸屏设备，记下其对应的eventX编号（例如event1）。

7.3 使用evtest进行原始事件测试

evtest是一个强大的工具，可以实时打印输入设备上报的所有原始事件。

# 假设触摸屏是 event1 evtest /dev/input/event1

运行后，用手或触笔点击屏幕。如果驱动工作正常，你会在终端看到源源不断的坐标事件输出，类似：

Event: time 123456.123456, type 3 (EV_ABS), code 57 (ABS_MT_TRACKING_ID), value 0 Event: time 123456.123457, type 3 (EV_ABS), code 53 (ABS_MT_POSITION_X), value 320 Event: time 123456.123458, type 3 (EV_ABS), code 54 (ABS_MT_POSITION_Y), value 240 Event: time 123456.123459, type 0 (EV_SYN), code 0 (SYN_REPORT), value 0

如果运行evtest后触摸屏幕没有任何输出，说明驱动没有正确上报事件，需要返回检查驱动和设备树配置。

7.4 使用tslib进行校准与功能测试

tslib是嵌入式 Linux 上通用的触摸屏校准和测试库。很多图形界面（如 Qt）都依赖它。

1. 确保开发板根文件系统中已安装tslib。
2. 配置环境变量：

   export TSLIB_TSDEVICE=/dev/input/event1 # 指定触摸屏设备节点 export TSLIB_CALIBFILE=/etc/pointercal # 校准文件存放位置 export TSLIB_CONFFILE=/etc/ts.conf # 配置文件位置 export TSLIB_PLUGINDIR=/usr/lib/ts # 插件目录 export TSLIB_FBDEVICE=/dev/fb0 # 帧缓冲设备，通常是 LCD

3. 执行校准：

   ts_calibrate

   屏幕上会依次在五个点显示十字，你需要依次准确点击。完成后，校准参数会保存到TSLIB_CALIBFILE指定的文件中。
4. 测试校准效果：

   ts_test

   运行后，你可以在屏幕上画线、点击按钮，观察光标是否准确跟随。这是验证触摸屏功能是否完好的最终标准。

8. 常见问题与排查方法

在调试触摸屏时，你可能会遇到以下典型问题。

问题现象	可能原因	排查方式	解决方案
内核启动无触摸屏相关打印	1. 设备树compatible不匹配。 2. I2C 地址reg错误。 3. 驱动未编译进内核。	1.dmesg | grep -i i2c看 I2C 总线是否识别到设备。 2. 使用i2cdetect工具扫描 I2C 总线。	1. 核对芯片手册，修正compatible和reg。 2. 确认内核配置中对应驱动已启用 (*)。
evtest无任何输出	1. 驱动探测成功但中断未正确工作。 2. 驱动内部数据读取失败。	1. 检查设备树中interrupts和irq-gpios配置。 2. 查看驱动源码，在中断函数和 I2C 读写处增加打印。	1. 用万用表或示波器确认中断引脚是否有电平变化。 2. 检查 I2C 通信时序，确认上拉电阻和电源正常。
触摸坐标反向或偏移	1. X, Y 坐标轴方向反了。 2. 屏幕物理分辨率与驱动内定义不符。	1. 观察evtest输出的坐标范围。 2. 对比evtest原始坐标与屏幕边界。	1. 在设备树中尝试添加touchscreen-inverted-x,touchscreen-swapped-x-y等属性。 2. 确保touchscreen-size-x/y设置正确。
多点触控失效	1. 驱动仅实现了单点协议。 2. 硬件或固件不支持多点。	1.evtest查看是否有ABS_MT_*事件。 2. 查阅触摸芯片数据手册。	1. 确认驱动支持并正确上报多点触控事件。 2. 升级触摸控制器固件（如果支持）。
ts_calibrate点击无反应	1.TSLIB_TSDEVICE环境变量设置错误。 2.ts.conf配置错误。	1. 确认eventX编号正确。 2. 检查ts.conf中是否去除了module_raw input的注释。	1. 重新设置环境变量。 2. 编辑/etc/ts.conf，确保有module_raw input一行。
触摸反应迟钝或跳点	1. 中断处理函数耗时太长。 2. 有电磁干扰或屏幕表面脏污。 3. 采样率设置过低。	1. 检查系统负载和中断频率。 2. 清洁屏幕，远离干扰源。	1. 优化驱动中断服务程序，快速读取坐标后退出。 2. 在驱动或设备树中调整滤波参数或采样率。

9. 进阶：将触摸屏集成到 Qt 应用程序

对于大多数带 GUI 的应用，最终目标是让 Qt 能够正确响应触摸事件。

1. 确保tslib已正确安装和校准。这是 Qt 通过linuxfb或eglfs后端使用触摸屏的基础。
2. 配置 Qt 编译选项：在交叉编译 Qt 时，需要配置-tslib选项，并指定tslib的头文件和库路径。

   ./configure -prefix /opt/qt5-arm \ -opensource \ -confirm-license \ -release \ -linuxfb \ -no-opengl \ -no-xcb \ -tslib \ -I /opt/tslib/include \ -L /opt/tslib/lib \ ...

3. 设置 Qt 运行环境：在开发板上运行 Qt 程序前，除了tslib的环境变量，还需要设置 Qt 的插件路径和指定平台。

   export QT_QPA_GENERIC_PLUGINS=evdevtouch:/dev/input/event1 export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0 # 或者使用 eglfs (如果支持GPU) # export QT_QPA_PLATFORM=eglfs export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event1:rotate=0

4. 运行测试：运行一个简单的 Qt 示例程序（如widgets例子），测试触摸是否流畅、准确。

10. 最佳实践与使用建议

• 从已知可用的配置开始：如果你使用的是主流开发板，优先使用厂商提供的、已验证过的内核和设备树配置。在此基础上修改，成功率更高。
• 善用调试工具链：i2cdetect,i2cdump,i2cget/set是调试 I2C 通信的利器。evtest是验证输入事件的黄金标准。示波器或逻辑分析仪是解决硬件疑难杂症的终极手段。
• 分步验证：不要期望一次成功。按照“I2C 通信正常 -> 驱动探测成功 -> 中断触发 -> 事件上报 -> 坐标校准 -> 应用集成”的顺序，一步步验证。
• 关注设备树细节：设备树中一个引脚的配置错误、一个电平有效性的设置反了，都可能导致整个功能失效。务必与硬件原理图反复核对。
• 备份工作环境：在开始修改内核和设备树前，对能正常启动的原始系统进行备份。每次修改后，保留一份可回退的版本。
• 查阅官方文档与社区：NXP 官方提供的 Linux 内核移植指南、数据手册以及芯片 errata（勘误表）是宝贵的一手资料。积极在相应的开发者社区（如厂商论坛、Stack Overflow）搜索和提问。

通过本文的梳理，你应该对 i.MX6ULL 上的触摸屏开发有了一个从硬件到软件、从驱动到应用的全景认识。核心流程就是：确认硬件连接 -> 配置设备树 -> 启用内核驱动 -> 使用evtest验证原始事件 -> 使用tslib校准 -> 集成到上层应用。这个过程虽然涉及环节较多，但每一步都有明确的工具和方法进行验证。建议你准备好开发环境，亲手操作一遍，遇到的具体问题往往就是加深理解的最好机会。