Debian 13 友基 XP-Pen 数位板官方驱动与内核冲突排查固化
主机 dev(Debian 13 + GNOME X11)安装 ugeetablet 4.3 后画笔失效:内核争用、uinput 权限,以及随后 HVUG STYLUS 变成 floating 导致有压感无位移。结论与配置均来自本机命令与日志。
环境
采集时间:2026-10-07。主机名 dev。
| 项 | 值 | 依据 |
|---|---|---|
| 系统 | Debian GNU/Linux 13 (trixie),DEBIAN_VERSION_FULL=13.7 |
/etc/os-release |
| 内核 | 6.12.111+deb13-amd64 |
uname -r |
| 机型 | HP ProBook 450 15.6 inch G9 Notebook PC | /sys/class/dmi/id/product_name |
| 会话 | XDG_SESSION_TYPE=x11,DISPLAY=:0,XDG_CURRENT_DESKTOP=GNOME,GDMSESSION=gnome-xorg |
环境变量 |
| 数位板 USB | Bus 003 Device 022: ID 28bd:0905 XP-Pen 10 inch PenTablet |
lsusb |
| sysfs | /sys/bus/usb/devices/3-4,manufacturer=UGTABLET,product=10 inch PenTablet |
sysfs |
| 驱动包 | ugeetablet 4.3(Maintainer: tech@xp-pen.com) |
dpkg -l / apt-cache show |
| 安装包文件 | /home/charlie/Downloads/ugeeTablet4.3.5-241031.deb(约 22MB,mtime 2026-10-07 19:36) |
ls |
| 驱动路径 | /usr/lib/ugeeTablet/{ugeeTabletDriver,ugeeTablet,ugeeTabletDriver.sh} |
文件系统 |
| 驱动配置目录 | ~/.config/Hanvon Ugee/ugee.conf(仅 LocalSocket 时间戳) |
文件系统 |
| 相关已装包 | xserver-xorg-input-wacom 1.2.3-1,libwacom9,libwacom-common |
dpkg -l |
| 其它输入设备(配置未改) | 内置键盘 AT Translated Set 2 keyboard;Newmen ... 2.4G Keyboard Mouse;SEMICO USB Gaming Keyboard;触控板 SYNA30E5:00 06CB:CEAC |
/sys/class/input/*/name |
驱动 journal(2026-10-07 19:39:11)中的设备标识:
现象与目标:
- 安装
ugeetablet(安装包名 ugeeTablet / PenTable)后画笔不可用。 - 仅走内核输入栈时压感不可用。
- 采用官方驱动独占该板;内核对该 VID:PID 的接管需去掉,且不影响其它键鼠与触控板。
- 修复需开机持久化。
- 第一阶段修复后出现第二现象:有压感,但笔位置(光标)不动;根因为
HVUG STYLUS stylus处于 floating,已 reattach 并固化。
故障现象(本机观测)
1. 官方驱动与内核争用同一设备
驱动启动后 journal:
同一时段 ~/.local/share/xorg/Xorg.0.log 先出现笔设备,随后被移除:
因此:系统曾出现过带 maxZ=8191 的 UGTABLET ... Pen stylus 节点;该节点在官方驱动介入过程中被 remove。未在绘图软件内对内核该节点做压感功能实测。
2. 冲突高峰:仅剩 Mouse
冲突期间输入节点曾只剩:
capabilities:abs=0(无绝对坐标/压感位),仅为相对鼠标。HID 绑定为 uclogic(lsmod 有 hid_uclogic,udevadm 为 DRIVER=uclogic)。
ugeeTabletDriver 仍打开 /dev/bus/usb/003/022。journal 有 PenKey 1 down/up,同时有:
3. /dev/uinput 权限阻止虚拟笔创建
解绑内核 HID 后,驱动日志仍有 Uinput Init,但 /sys/class/input 无 HVUG*。当时:
账户 charlie 无法写入。将 uinput 改为可写并重启驱动后,虚拟设备出现(见「修复后状态」)。charlie 随后加入 input 组。
4. 包装未提供登录自启桌面文件
桌面入口仅存在于 /usr/share/applications/ugeetablet.desktop。不另加 autostart 时,登录后驱动不会自动启动。
5. 排查过程中的其它本机事实
/sys/module/usbhid/parameters/quirks权限为-r--r--r--,运行中写入得到Permission denied;需 modprobe 配置(并打进 initramfs)或对接口unbind。pkill -f '/usr/lib/ugeeTablet/'会匹配到含该路径的当前 shell 命令行,曾误杀排查进程。- 辅助脚本曾误执行会覆盖
/dev/uinput的操作,节点一度变成普通空文件;已用modprobe uinput/mknod c 10 223恢复为字符设备。
修复过程
策略:官方驱动独占 28bd:0905;其它键鼠与触控板配置不动。
步骤
blacklist hid_uclogic,并对 仅0x28bd:0x0905设置usbhid quirks=...:0x4(HID_QUIRK_IGNORE)。- 将该板 USB 接口从
usbhidunbind(本机为3-4:1.0/3-4:1.1/3-4:1.2)。 - 保证
/dev/uinput为字符设备,且 mode 允许驱动进程写入。 - Xorg 对
MatchUSBID "28bd:0905"的内核节点设置Ignore(虚拟HVUG*无 USBID,不受影响)。 - 重启
/usr/lib/ugeeTablet/ugeeTabletDriver.sh。 - 写入 udev、systemd、autostart,并执行
update-initramfs -u。
修复后状态(2026-10-07 20:03 复查)
此时 HVUG* 虚拟设备与压感轴已具备;随后又出现「有压感、光标位置不动」,见下一节。
第二阶段:有压感但笔位置不动(2026-10-07 21:43)
观测
环境仍为官方独占方案:28bd:0905 无内核 HID 绑定;ugeeTabletDriver 在跑;存在 HVUG STYLUS / HVUG MOUSE / HVUG ERASER。
对 /dev/input/event6(HVUG STYLUS)采样约 6 秒:
说明 evdev 层 X/Y 坐标在变化,问题不在板子停报位置。
xinput list(本机随后安装 xinput 1.6.4-1)显示:
同时 HVUG MOUSE、HVUG ERASER eraser 等挂在 Virtual core pointer 下。
HVUG STYLUS stylus 为 floating slave:未挂到核心指针,故桌面光标不跟笔走;部分软件仍可读到压感。
同设备属性(挂接前)摘要:
处理
挂接后:
并对干扰项执行(会话内):
(该节点常被识别为多余 touch slave。)
固化
新增登录自启脚本,在设备出现后若仍为 floating 则重新挂接。
固化配置(照抄自本机磁盘)
/etc/modprobe.d/ugee-official-only.conf
已执行 update-initramfs -u。复查:
/usr/local/sbin/ugee-exclusive-tablet.sh
权限:755,属主 root。
/etc/udev/rules.d/99-ugee-official-only.rules
/etc/udev/rules.d/60-uinput-ugee.rules
包装自带 /lib/udev/rules.d/ugee4-1.rules 内容相近,但本机曾出现 uinput 仍为 600,故在 /etc 另置一份。
/etc/X11/xorg.conf.d/80-ugee-ignore-kernel.conf
/etc/systemd/system/ugee-exclusive-tablet.service
状态:enabled,active (exited)。
登录自启
/etc/xdg/autostart/ugeetablet.desktop 与 /home/charlie/.config/autostart/ugeetablet.desktop:
账户组
/usr/local/bin/ugee-reattach-stylus.sh
依赖包:xinput 1.6.4-1(本机 apt 安装)。
权限:755。
配套 autostart:/etc/xdg/autostart/ugee-reattach-stylus.desktop 与 ~/.config/autostart/ugee-reattach-stylus.desktop:
2026-10-07 21:52 复查 xinput list 中 HVUG STYLUS stylus 为 slave pointer(非 floating);HVUG ERASER touch 可为 floating(已 disable)。
重启后核对
期望:
- 无
28BDHID 绑定;存在ugeeTabletDriver;存在HVUG STYLUS/MOUSE/ERASER /dev/uinput为 character special fileHVUG STYLUS stylus为 slave pointer,不是[floating slave]- Newmen / SEMICO / SYNA / AT Translated 仍在
若再次出现 floating:
回滚
结论
在主机 dev(Debian 13,GNOME X11)上,设备 28bd:0905(lsusb:XP-Pen 10 inch PenTablet;驱动标识:「绘影 EX08」/ BPU1002)安装 ugeetablet 4.3 后画笔问题分两阶段:
- 驱动与内核争用 + uinput 权限:
hid_uclogic/usbhid与ugeeTabletDriver争用设备,Xorg 中UGTABLET ... Pen stylus被移除;/dev/uinput不可写时建不出HVUG*。处理为仅对28bd:0905做内核忽略、usbhid unbind、uinput 权限与官方驱动自启(modprobe / udev / systemd / autostart / initramfs)。 - X 输入挂接:
HVUG STYLUS已有 X/Y/压感事件,但HVUG STYLUS stylus处于[floating slave],光标不跟随。处理为xinput reattach到Virtual core pointer,并增加登录自启/usr/local/bin/ugee-reattach-stylus.sh。
其它输入设备配置未改,复查仍在。