全志T153开发板 USB触摸屏驱动移植指南

目录

• 平台信息
• 问题背景
• 驱动依赖分析
• 移植步骤
  • 第一步：修改内核 defconfig
  • 第二步：加载配置并编译内核
  • 第三步：确认编译产物
  • 第四步：检查版本兼容性
  • 第五步：拷贝到板子并加载测试
  • 第六步：验证设备识别
  • 第七步：测试触摸事件
• 编译 LVGL Demo 验证触摸
  • LVGL 目录结构
  • 创建编译所需的符号链接
  • 配置触摸屏输入设备
  • 修复 evdev 多点触控驱动 Bug
  • 交叉编译
  • 部署到板子并测试触摸
• 正式编译（将驱动编入内核）
• 总结

平台信息

问题背景

通过 USB 2.0 HOST 接口连接了一块 USB 多点触摸屏，插入后内核无法识别设备。分析发现当前内核缺少hid-multitouch驱动模块，该模块是 USB HID 多点触控设备所必需的。

驱动依赖分析

USB 触摸屏走 USB HID 协议栈，完整驱动链路如下：

USB 触摸屏硬件 │ ├── USB 主机控制器 (EHCI/OHCI) ── CONFIG_USB_EHCI_HCD / CONFIG_USB_OHCI_HCD │ ├── USB 核心 ── CONFIG_USB │ ├── USB HID 传输层 ── CONFIG_USB_HID │ ├── HID 核心 ── CONFIG_HID │ ├── HID 多点触控驱动 ── CONFIG_HID_MULTITOUCH ← 缺失 │ └── 用户空间事件接口 ── CONFIG_INPUT_EVDEV

通过检查当前内核.config，确认已有配置：

结论：整个 USB HID 基础设施已内建到内核中，只需编译hid-multitouch.ko一个模块即可支持 USB 触摸屏。

移植步骤

第一步：修改内核 defconfig

SDK 的内核 defconfig 文件路径取决于构建模式：

• Buildroot 模式（linux_dev选buildroot）：使用buildroot_linux_defconfig
• BSP 模式（linux_dev选bsp）：使用bsp_defconfig

本次使用 Buildroot 模式，修改的文件为：

device/config/chips/t153/configs/tlt153-minievm-nand/linux-5.10-origin/buildroot_linux_defconfig

在 USB 配置区域添加：

CONFIG_HID_MULTITOUCH=m CONFIG_HIDRAW=y

注意：设为m（模块）而非y（内建），目的是先生成.ko文件进行快速验证，无需重新烧录整个固件。

第二步：加载配置并编译内核

cd~/TLT153/Linux/LinuxSDK/aiot-t153-linux-v1.0# 重新加载 defconfig 到 .config./build.sh loadconfig# 只编译内核（含模块），不编译 rootfs/bootloader./build.sh kernel

./build.sh kernel只编译内核和模块，速度远快于完整./build.sh。

第三步：确认编译产物

# 查看编译出的内核版本catout/t153/kernel/build/include/config/kernel.release# 查找编译出的 .ko 文件findout/-name"hid-multitouch.ko"

输出示例：

out/t153/kernel/build/drivers/hid/hid-multitouch.ko out/t153/kernel/staging/lib/modules/5.10.198/hid-multitouch.ko out/t153/tlt153-minievm-nand/buildroot/lib/modules/5.10.198/hid-multitouch.ko

第四步：检查版本兼容性

# 板子上运行的内核版本sshroot@192.168.0.102"uname -r"# 输出: 5.10.198-g6a686b9# 编译出的版本catout/t153/kernel/build/include/config/kernel.release# 输出: 5.10.198

本例中版本号存在差异：板子上的内核带有 git commit 后缀-g6a686b9，而编译出的没有（因为 SDK 的.git符号链接断裂，CONFIG_LOCALVERSION_AUTO=y无法获取 commit hash）。

主版本号5.10.198一致，ABI 兼容，可以通过insmod -f强制加载。

第五步：拷贝到板子并加载测试

# 从编译主机传到板子scpout/t153/kernel/build/drivers/hid/hid-multitouch.ko root@192.168.0.102:/tmp/# SSH 登录板子sshroot@192.168.0.102# 强制加载模块（-f 跳过 vermagic 版本校验）insmod-f/tmp/hid-multitouch.ko

第六步：验证设备识别

插入 USB 触摸屏后查看内核日志：

dmesg|tail-20

成功识别的日志输出：

usb 2-1: New USB device found, idVendor=222a, idProduct=0001, bcdDevice= 1.00 usb 2-1: Product: Multi-Touch-V5000 usb 2-1: Manufacturer: OpenWare usb 2-1: SerialNumber: 8B649A7B1338 input: OpenWare Multi-Touch-V5000 as /devices/.../input/input13 hid-multitouch 0003:222A:0001.0004: input: USB HID v1.11 Device [OpenWare Multi-Touch-V5000] on usb-sunxi-ohci-1/input0

设备被识别为三个 HID 接口：

查看 input 设备列表：

cat/proc/bus/input/devices

关键输出：

I: Bus=0003 Vendor=222a Product=0001 Version=0111 N: Name="OpenWare Multi-Touch-V5000" P: Phys=usb-sunxi-ohci-1/input0 H: Handlers=event9 B: PROP=2 B: EV=b B: KEY=400 0 0 0 0 0 0 0 0 0 0 B: ABS=2608000 3

第七步：测试触摸事件

hexdump /dev/input/event9

触摸屏幕时输出数据流：

0000000 7c4f 69a0 175b 000d 0003 0039 0000 0000 ← 触摸按下 (tracking ID = 0) 0000010 7c4f 69a0 175b 000d 0003 0035 0109 0000 ← X 坐标 = 0x109 (265) 0000020 7c4f 69a0 175b 000d 0003 0036 00de 0000 ← Y 坐标 = 0xDE (222) ... 0000070 7c50 69a0 6534 0000 0003 0039 ffff ffff ← 触摸抬起 (tracking ID = -1)

事件码含义：

测试确认触摸功能正常。

编译 LVGL Demo 验证触摸

内核驱动验证通过后，使用 SDK 自带的 LVGL 8.3.2 Demo 进一步验证触摸屏在 GUI 应用中的表现。

LVGL 目录结构

SDK 中 LVGL 相关文件位于：

platform/thirdparty/gui/lvgl-8/ ├── lvgl/ # LVGL 核心库 (v8.3.2) ├── lv_drivers/ # 显示/输入驱动 (sunxifb, evdev 等) ├── lv_examples/ # Demo 应用 │ └── src/ │ ├── main.c # Demo 入口，初始化显示和触摸 │ ├── Makefile # 编译脚本 │ ├── lv_conf.h # LVGL 核心配置 │ └── lv_drv_conf.h # 驱动配置（触摸设备路径、校准等） ├── lv_conf.h -> lv_examples/src/lv_conf.h # 符号链接 └── lv_drv_conf.h -> lv_examples/src/lv_drv_conf.h # 符号链接

main.c中触摸相关的初始化流程：

evdev_init();staticlv_indev_drv_tindev_drv;lv_indev_drv_init(&indev_drv);indev_drv.type=LV_INDEV_TYPE_POINTER;indev_drv.read_cb=evdev_read;lv_indev_t*evdev_indev=lv_indev_drv_register(&indev_drv);

创建编译所需的符号链接

Makefile通过include $(LVGL_DIR)/lvgl/lvgl.mk和include $(LVGL_DIR)/lv_drivers/lv_drivers.mk引入源文件列表，其中LVGL_DIR默认为当前目录（lv_examples/src/）。因此需要在src/下创建指向上层库目录的符号链接：

cdplatform/thirdparty/gui/lvgl-8/lv_examples/src/# Makefile 需要在当前目录找到 lvgl/ 和 lv_drivers/ln-s../../lvgl lvglln-s../../lv_drivers lv_drivers

同时，lv_drivers/下的源文件通过相对路径#include "../lv_drv_conf.h"查找配置头文件，需要在 LVGL 根目录创建配置文件的符号链接：

cdplatform/thirdparty/gui/lvgl-8/# 让 lv_drivers/ 下的 #include "../lv_conf.h" 和 "../lv_drv_conf.h" 能找到文件ln-slv_examples/src/lv_conf.h lv_conf.hln-slv_examples/src/lv_drv_conf.h lv_drv_conf.h

完整的符号链接关系：

lvgl-8/ ├── lv_conf.h -> lv_examples/src/lv_conf.h # lv_drivers/*.c 的 "../lv_conf.h" 解析到此 ├── lv_drv_conf.h -> lv_examples/src/lv_drv_conf.h # lv_drivers/*.c 的 "../lv_drv_conf.h" 解析到此 └── lv_examples/src/ ├── lvgl -> ../../lvgl # Makefile include 路径 └── lv_drivers -> ../../lv_drivers # Makefile include 路径

配置触摸屏输入设备

修改lv_examples/src/lv_drv_conf.h，将 evdev 设备路径指向 USB 触摸屏：

- # define EVDEV_NAME "/dev/input/event3" + # define EVDEV_NAME "/dev/input/event9" /*USB touchscreen: OpenWare Multi-Touch-V5000*/

设备节点编号取决于板子上的实际枚举顺序，以cat /proc/bus/input/devices输出为准。

修复 evdev 多点触控驱动 Bug

SDK 自带的lv_drivers/indev/evdev.c中，处理ABS_MT_TRACKING_ID的逻辑存在 Bug：

// 原始代码（有 Bug）elseif(in.code==ABS_MT_TRACKING_ID){if(in.value==-1)evdev_button=LV_INDEV_STATE_REL;elseif(in.value==0)// 只认 ID=0 为按下evdev_button=LV_INDEV_STATE_PR;}

问题在于in.value == 0这个判断：Linux 多点触控协议中，ABS_MT_TRACKING_ID是递增分配的（0, 1, 2, …），只有-1表示手指抬起，任何 >= 0 的值都表示触摸按下。原代码只认 ID=0 为按下，导致第二次及之后的触摸无响应。

修复方法——修改lv_drivers/indev/evdev.c：

else if(in.code == ABS_MT_TRACKING_ID) { if(in.value == -1) evdev_button = LV_INDEV_STATE_REL; - else if(in.value == 0) + else if(in.value >= 0) evdev_button = LV_INDEV_STATE_PR; }

交叉编译

使用 SDK 自带的交叉编译工具链编译 LVGL Demo：

cdplatform/thirdparty/gui/lvgl-8/lv_examples/src/# CC 需要指定完整路径，覆盖 Makefile 中默认的 gccmakeCC=<SDK_ROOT>/out/toolchain/gcc-linaro-11.3.1-2022.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc -j$(nproc)

编译产物为当前目录下的lv_examples可执行文件。

部署到板子并测试触摸

# 传到板子scplv_examples root@192.168.0.102:/tmp/# 在板子上运行 widgets demosshroot@192.168.0.102 /tmp/lv_examples0

运行后屏幕显示 LVGL Widgets Demo 界面，触摸屏幕可正常交互（点击按钮、拖动滑块等）。

可用的 Demo 编号：

正式编译（将驱动编入内核）

验证通过后，将CONFIG_HID_MULTITOUCH从m改为y：

CONFIG_HID_MULTITOUCH=y CONFIG_HIDRAW=y

重新完整编译并打包固件：

./build.sh loadconfig ./build.sh ./build.sh pack

烧录固件后，USB 触摸屏开机即可自动识别，无需手动insmod。

总结

关键经验：

1. 全志 T153 SDK 的 Buildroot 模式下，内核默认已内建HID、USB_HID、HID_GENERIC、INPUT_EVDEV，只缺HID_MULTITOUCH
2. 先编译为模块（m）进行快速验证，避免完整编译烧录的长周期
3. 内核版本号带 git 后缀不一致时，insmod -f可以强制加载（主版本一致即可）
4. 构建系统实际使用的 defconfig 取决于BoardConfig.mk中LICHEE_KERN_DEFCONF的定义，Buildroot 模式用的是buildroot_linux_defconfig而非bsp_defconfig