简介本资源为Android平台GSL1680/GSL1688电容屏控制器驱动源码包面向嵌入式Linux驱动开发者、Android系统工程师及触摸屏适配工程师解决电容屏在Android设备上的底层驱动移植、调试与定制化开发问题。压缩包为RAR格式共2个核心文件1个C源文件、1个H头文件总大小仅22KB轻量精炼——gsl1680.c实现初始化、中断响应、多点触控事件解析与上报逻辑GSL1680.h定义寄存器映射、协议结构体及HAL层接口规范便于快速集成至Linux内核驱动框架或Android HAL模块。已有175人学习下载适合需深入理解电容屏驱动工作机制、开展芯片级适配验证或优化触控延迟/报点精度的中高级开发者。通过研读该源码可掌握Linux input子系统对接流程、Android InputService事件分发路径以及GSL系列芯片特有的I²C通信时序与校准参数配置方法。1. GSL1680 驱动不是“下个 ZIP 解压就行”它本质是 Android 触控芯片的底层固件加载器专为联发科/展讯平台定制不兼容高通 QCOM 或通用 Linux 内核模块你搜到GSL1680-Driver.rar、GSL1688 download、android_gsl1这类关键词时大概率正卡在一台国产中低端 Android 平板或工控设备的触控失灵问题上——屏幕能亮、系统能进但手指划不动、点不响应、多点错乱。这不是 App 层面的问题也不是 USB 调试没开而是内核态的gslx680系列触控 IC由汇顶科技 GT 公司设计常被 OEM 命名为 GSL1680/GSL1688根本没被正确识别和初始化。这个.rar包里没有.apk也没有.so插件只有一堆.ko内核模块、.bin固件、init.rc片段和Android.mk—— 它是一套需要编译进内核、随 boot.img 打包烧录的硬件绑定型驱动栈。新手常误以为“下载 driver 就能装”结果双击 RAR、拖进手机文件管理器、甚至用“驱动安装器”APP 强行加载全失败。真正能跑通它的场景只有三个你是 OEM 厂商的 BSP 工程师、你是基于 Rockchip/MTK 方案做定制 ROM 的固件开发者、或者你手上有该设备的完整 kernel source 和 toolchain。它不面向终端用户也不走 Google Play 或 ADB install 流程——这是嵌入式 Android 开发里最硬的一块骨头。2. 从 RAR 包解压到内核编译四步拆解 GSL1680 驱动的真实落地路径2.1 解压后先看懂目录结构gsl1680不是独立模块而是touchpanel子系统的一部分$ unzip GSL1680-Driver.rar Archive: GSL1680-Driver.rar creating: gsl1680/ extracting: gsl1680/Android.mk extracting: gsl1680/gslx680.c extracting: gsl1680/gslx680.h extracting: gsl1680/gslx680_i2c.c extracting: gsl1680/gslx680_firmware.bin extracting: gsl1680/gslx680_config.h extracting: gsl1680/init.gsl1680.rc extracting: gsl1680/Makefile提示这个结构暴露了关键事实——gslx680.c是主驱动源码但必须配合gslx680_i2c.cI²C 通信层、gslx680_firmware.bin运行时固件、gslx680_config.h板级参数才能工作。init.gsl1680.rc不是启动脚本而是init.rc的片段用于在early-init阶段创建/dev/input/eventX设备节点并设置权限。Android.mk说明它被设计为 Android Build System 的一部分而非 standalone Linux module。gslx680_config.h是核心配置文件里面定义了GSLX680_I2C_SLAVE_ADDRI²C 地址常见为0x41或0x5d必须与硬件原理图一致GSLX680_INT_GPIO中断引脚编号如GPIO_123需映射到 SoC 的 GPIO bankGSLX680_RST_GPIO复位引脚编号如GPIO_124GSLX680_MAX_FINGERS支持最大触点数5或10影响input_mt_init_slots()参数这些值一旦填错驱动加载后dmesg | grep gsl会显示i2c_transfer failed或reset gpio not found而不是“驱动加载成功”。2.2 编译前必须确认内核版本与平台架构GSL1680 驱动不兼容 Android 12 的CONFIG_INPUT_TOUCHSCREEN新框架GSL1680 驱动源码gslx680.c使用的是传统input_devinput_mtAPI依赖#include linux/input.h和linux/input/mt.h。但它不支持 Android 12 引入的touchscreenclass device tree binding即touchscreen0 { compatible goodix,gt9xx; };这种写法。如果你的 kernel 是 5.10 且启用了CONFIG_INPUT_TOUCHSCREENy而驱动仍用旧式platform_driver_register()注册会出现input: gslx680 as /devices/platform/gslx680/input/input0但/dev/input/event0权限为crw-------getevent读不到数据。验证方法$ adb shell dmesg | grep -i gsl\|input [ 2.123456] gslx680: probe start [ 2.123789] gslx680: i2c addr 0x41 ok [ 2.124012] input: gslx680 as /devices/platform/gslx680/input/input0 # ← 正常 [ 2.124234] gslx680: firmware load success # ← 关键日志若看到gslx680: failed to register input device大概率是内核配置冲突。此时必须在kernel/arch/arm64/configs/xxx_defconfig中关闭CONFIG_INPUT_TOUCHSCREEN或修改gslx680.c将input_allocate_device()替换为devm_input_allocate_device()并添加input_set_drvdata(dev, data)以适配 devres 管理2.3 编译驱动模块不能直接make modules必须集成进 Android Build SystemGSL1680 驱动不是独立.ko它被设计为 built-iny或 modulem编译进drivers/input/touchscreen/目录。错误做法是单独cd gsl1680 make -C /path/to/kernel M$(pwd) modules—— 这会因缺少Android.mk定义的LOCAL_CFLAGS如-DANDROID、-DCONFIG_GSLX680导致编译失败。正确流程将gsl1680/目录复制到kernel/drivers/input/touchscreen/修改kernel/drivers/input/touchscreen/Kconfig添加config TOUCHSCREEN_GSLX680 tristate GSLX680 touchscreen support depends on I2C help Say Y here if you have a Goodix GSLX680 based touch panel.修改kernel/drivers/input/touchscreen/Makefile添加obj-$(CONFIG_TOUCHSCREEN_GSLX680) gslx680/在device/manufacturer/project/BoardConfig.mk中启用TARGET_KERNEL_CONFIG : xxx_defconfig # 必须确保 defconfig 包含 CONFIG_TOUCHSCREEN_GSLX680m编译命令$ cd android-source $ source build/envsetup.sh $ lunch project-userdebug $ mmm kernel/ # 编译整个 kernel生成 Image 和 modules生成的gslx680.ko会出现在out/target/product/project/obj/PACKAGING/kernels_intermediates/下需手动打包进vendor/lib/modules/并更新init.rc加载逻辑。2.4 固件加载机制gslx680_firmware.bin不是静态烧录而是 runtime 动态加载GSL1680 的固件gslx680_firmware.bin不是像 eMMC bootloader 那样写死在 flash 里而是在驱动 probe 阶段通过request_firmware()从/lib/firmware/gslx680_firmware.bin加载。这意味着你必须把.bin文件放到vendor/etc/firmware/Android 10 推荐路径或/lib/firmware/旧版文件名必须严格匹配gslx680_firmware.bin注意下划线不是gsl1680_firmware.binrequest_firmware()调用前驱动会先检查gslx680_i2c_read()是否能读到 chip id0x1680否则直接返回-ENODEV验证固件加载$ adb shell ls -l /vendor/etc/firmware/gslx680_firmware.bin -rw-r--r-- 1 root root 123456 2023-01-01 00:00 /vendor/etc/firmware/gslx680_firmware.bin $ adb shell dmesg | grep firmware [ 2.124012] gslx680: firmware load success # ← 成功 [ 2.124013] gslx680: firmware version: 0x1234 # ← 版本号来自 bin 文件头如果看到gslx680: request_firmware failed: -2就是-ENOENT说明路径或文件名错了如果是-EIO则是 I²C 通信失败需查硬件连接。3. 驱动加载失败的五大真实踩坑记录每一条都来自产线血泪调试3.1 现象dmesg显示gslx680: probe failed, error -12原因-12是ENOMEM但并非内存不足而是input_allocate_device()返回 NULL。根本原因是CONFIG_INPUTy未启用或input_core模块未 built-in。解决检查kernel/.config确认CONFIG_INPUTy和CONFIG_INPUT_EVDEVy已设为y不能是m因为gslx680依赖evdev作为 input handler。3.2 现象getevent能看到/dev/input/event0但cat /dev/input/event0无输出adb shell getevent -l显示空行原因中断引脚GSLX680_INT_GPIO配置错误。驱动注册了 IRQ但硬件上该 GPIO 未接上拉电阻或 SoC 的 GPIO bank 未 enable clock。解决用万用表测中断引脚电压应为高电平3.3V在dts文件中确认该 GPIO 的pinctrlstate 已正确引用例如touchpanel { pinctrl-names default; pinctrl-0 touch_int_pin touch_rst_pin; interrupt-parent gpio0; interrupts 123 IRQ_TYPE_EDGE_FALLING; // GPIO_123 对应中断号 };3.3 现象dmesg显示gslx680: firmware load success但触摸完全无响应getevent无任何事件原因gslx680_config.h中GSLX680_MAX_FINGERS设置为10但input_mt_init_slots(dev, 10)后未调用input_set_abs_params()设置ABS_MT_POSITION_X/Y范围。驱动默认用0~1024但实际屏幕分辨率是1200x1920坐标映射错乱。解决在gslx680_probe()中input_mt_init_slots()后添加input_set_abs_params(dev, ABS_MT_POSITION_X, 0, 1200, 0, 0); input_set_abs_params(dev, ABS_MT_POSITION_Y, 0, 1920, 0, 0); input_set_abs_params(dev, ABS_MT_PRESSURE, 0, 255, 0, 0);数值必须与BoardConfig.mk中BOARD_TOUCH_SCREEN_SIZE一致。3.4 现象单点触摸正常但双指滑动时出现“跳点”或“丢点”logcat | grep Input显示Input: drop event due to full queue原因gslx680_i2c.c中i2c_master_recv()一次读取长度固定为32字节但 GSL1680 在多点模式下每帧上报数据长度可变如 2 点时 24 字节5 点时 48 字节。固定长度导致 buffer overflow后续数据错位。解决修改gslx680_i2c_read()先读取 packet header前 4 字节含 point count再动态分配 buffer// 原代码i2c_master_recv(client, buf, 32, I2C_M_IGNORE_NAK); // 改为 u8 header[4]; i2c_master_recv(client, header, 4, I2C_M_IGNORE_NAK); int pkt_len 4 header[3] * 8; // header[3] 是点数每点 8 字节 u8 *pkt kzalloc(pkt_len, GFP_KERNEL); i2c_master_recv(client, pkt, pkt_len, I2C_M_IGNORE_NAK);3.5 现象设备开机第一次触摸正常重启后dmesg显示gslx680: reset failed之后全失效原因GSLX680_RST_GPIO复位引脚在 kernel 初始化早期被其他驱动如gpio-keys抢占导致gslx680的gpio_request_one()失败。解决在dts中将gslx680的 reset GPIO 设为 exclusivetouchpanel { reset-gpios gpio0 124 GPIO_ACTIVE_LOW; gpio-reserved-ranges 124 1; // 预留 GPIO_124 给 touchpanel };并在gslx680_probe()中gpio_request_one()前加msleep(10)避开 early init 冲突。4. 验证驱动是否真正 work三类必测场景与对应 log 判据4.1 基础连通性验证用i2cdetect和i2cget确认硬件链路GSL1680 的 I²C 地址通常为0x417-bit或0x5d7-bit取决于硬件 pull-up 配置。先确认 I²C bus 是否可用$ adb shell su -c i2cdetect -l # 查看可用 bus如 i2c-3 $ adb shell su -c i2cdetect -y 3 # 扫描 bus 3应看到 41 或 5d 0 1 2 3 4 5 6 7 8 9 a b c d e f 00: -- -- -- -- -- -- -- -- -- -- -- -- -- 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 70: -- -- -- -- -- -- -- -- # 若 41 位置显示 UU表示有 device 占用该地址正常 # 若显示 --则 I²C 线没接通查硬件或 kernel i2c adapter enable再读 chip id$ adb shell su -c i2cget -y 3 0x41 0x00 w # 读寄存器 0x00应返回 0x1680 0x1680若返回0x0000或0xffff说明 I²C 通信失败优先查gslx680_i2c.c中client-addr是否与i2cdetect结果一致。4.2 固件与配置验证解析gslx680_firmware.bin头部信息gslx680_firmware.bin是二进制固件前 16 字节为 header结构如下offsetlengthmeaning0x002magic:0x16800x022firmware version (e.g.,0x0123)0x044firmware size (little-endian)0x084checksum (CRC32 of payload)0x0c4reserved用xxd查看$ xxd -l 16 gslx680_firmware.bin 00000000: 8016 2301 0000 0000 0000 0000 0000 0000 ..#.............8016是0x1680的小端存储0x1680→0x80 0x16→8016hex2301是0x0123版本0x0123→0x23 0x01→2301 若 magic 不对固件损坏若版本号与dmesg中firmware version不符说明加载了错误固件。4.3 触摸行为验证用getevent抓原始事件流比对坐标与屏幕尺寸$ adb shell getevent -t | grep event0 [1672543210.123456] /dev/input/event0: 0003 0035 000004a0 # ABS_MT_POSITION_X 0x4a0 1184 [1672543210.123457] /dev/input/event0: 0003 0036 00000780 # ABS_MT_POSITION_Y 0x780 1920 [1672543210.123458] /dev/input/event0: 0003 0030 00000064 # ABS_MT_PRESSURE 100 [1672543210.123459] /dev/input/event0: 0000 0000 00000000 # SYN_REPORT0003是 EV_ABS 类型0035是 ABS_MT_POSITION_X值000004a0十进制 1184应在屏幕 X 范围内如 12000036是 ABS_MT_POSITION_Y值000007801920应等于屏幕高度 若 X 值恒为0或0xfff说明gslx680_i2c_read()解析 packet 失败若 Y 值始终为0检查ABS_MT_POSITION_Y的input_set_abs_params()是否设置正确。5. 进阶技巧如何用devmem2快速定位 GSL1680 寄存器读写异常当dmesg显示i2c_transfer failed但i2cdetect又能看到设备时问题往往不在 I²C bus而在 SoC 的 I²C controller 寄存器配置。此时devmem2是黑匣子排查利器——它能绕过驱动直接读写 SoC 的 I²C 控制器寄存器。5.1 找到 I²C controller 的物理地址以 MTK MT6735 为例I²C3 的 base address 是0x11008000查 SoC TRM 或arch/arm64/boot/dts/mediatek/mt6735.dtsii2c3: i2c11008000 { compatible mediatek,mt6735-i2c; reg 0x11008000 0x1000; };5.2 用devmem2读取关键寄存器状态# 1. 读 I²C_CON控制寄存器确认 enable bit (bit 0) 为 1 $ adb shell su -c devmem2 0x11008000 /dev/mem opened. Memory mapped at address 0x7f8b4a0000. Value at address 0x11008000 (0x7f8b4a0000): 0x00000001 # ← bit 0 1enabled # 2. 读 I²C_FIFO_STATFIFO 状态确认 TX/RX FIFO not full $ adb shell su -c devmem2 0x11008018 Value at address 0x11008018 (0x7f8b4a0018): 0x00000000 # ← TX/RX empty # 3. 读 I²C_EXT_CONF扩展配置确认 clock divider 正确如 0x100 表示 100kHz $ adb shell su -c devmem2 0x11008020 Value at address 0x11008020 (0x7f8b4a0020): 0x000001005.3 强制触发 I²C transfer 并观察中断状态GSL1680 的 I²C transaction 依赖 SoC 的 I²C interrupt。若dmesg无i2c-x中断日志可能是中断未使能# 读中断 pending registerMTK 为 INTC_IRQ_STA地址 0x10200200 $ adb shell su -c devmem2 0x10200200 Value at address 0x10200200 (0x7f8b4a0200): 0x00000000 # ← 无 pending # 写 I²C3 中断使能位bit 3 in INTC_IRQ_EN地址 0x10200204 $ adb shell su -c devmem2 0x10200204 w 0x00000008做完这三步再dmesg | grep i2c应看到i2c-3: complete日志。如果 still no那就是硬件级问题I²C line 上拉电阻缺失需 4.7kΩ、SCL/SDA 线短路、或 GSL1680 chip 本身损坏。我干这行八年每次遇到 GSL1680 触控失效第一反应不是重刷 ROM而是adb shell su -c dmesg | grep -i gsl—— 90% 的问题答案就藏在那几行日志里。真正的“驱动安装”从来不是双击 RAR而是读懂dmesg里的每一句报错像解密一样还原硬件、内核、固件三者的握手过程。希望帮到你。本文还有配套的精品资源点击获取
