HandDriver Linux

1. 使用说明

因Linux系统版本众多，每个版本均可能存在差异，以下指南以ubuntu为例，仅供参考。

1.1. 前提条件

1. 本HandDriver仅支持amd64版本运行，不支持arm64版本。

2. HandDriver对显卡要求并不高，普通笔记本电脑也可以运行，请务必预先确保您的操作系统安装了正确且合适的显卡驱动程序，ubuntu默认自带的nouveau驱动程序是不行的，必须安装对应硬件的显卡驱动，安装方法请参考您硬件厂商的技术支持或在搜索引擎查找（安装时请不要去掉显卡的OpenGL能力）。

3. 一般情况下无需安装接收器驱动程序，目前已知ubuntu18、20、22、24版本均能识别，无需另行安装接收器驱动程序。如系统始终无法识别接收器，请使用以下驱动文件。请依照厂商沁恒的驱动安装指引进行安装，安装过程中如有问题请联系厂商沁恒。

13KB

CH341SER_LINUX.ZIP

archive

Open

1. 在某些ubuntu版本中，可能会出现brltty设备冲突，因此建议您首次使用时，插入接收器后采用sudo dmesg查看是否存在设备冲突。如果看到brltty设备冲突，此时您需要禁用或卸载brltty设备（禁用无效的话请卸载），否则将会造成接收器端口占用。卸载前请确保您做了相关备份或恢复预案，卸载方法可通过搜索引擎查找。

2. 通过lsusb和dmesg查看接收器是否正常识别。

• lsusb后

  • 一对二接收器

  

  • 一对一接收器（带有明显的CH340字样）

  
• Sudo dmesg后的显示

  • 一对二接收器：显示UDEXREAL和ttyACM等字样说明接收器被系统识别成功

  

  • 一对一接收器：显示ch341-uart converter now attached to ttyUSB字样则说明接收器连接成功

  

1.2. 方法一

1. 先运行以下脚本：

2KB

setup_usb_permissions.sh

Open

1. 运行上述脚本并重启后，解压缩HandDriver文件包，并进入HandDriver所在文件夹

2. 为HandDriver.x86_64添加执行权限

sudo chmod +x HandDriver.x86_64

1. 插入接收器

2. 直接双击运行HandDriver.x86_64

3. 由于已运行过上述脚本，下次也可以直接双击打开HandDriver。但如果解压缩一个新的HandDriver文件包后，需要再次为HandDriver.x86_64添加执行权限

4. 请先插入接收器再打开HandDriver

1.3. 方法二

1. 步骤：先插入接收器-dmesg正常-命令打开软件-（新增角色-找到并绑定接收器）-打开手套。

2. 请先插上接收器（请先插上接收器后再打开HandDriver软件，否则无法识别接收器）。插上接收器后，通过lsusb和dmesg命令了解接收器是否被识别。

3. 请确保您当前用户具有管理员或sudo权限，如果您的用户无法获得管理员或sudo权限，您可以通过chmod 666 /dev/ttyUSB0 或者 /dev/ttyCH341USB0（一对一接收器）或者/dev/ttyACM0（一对二接收器） 给设备添加读写权限（tty的序号依据系统分配的设备名而定，两个串口都要赋权）。

4. 解压缩HandDriver文件包，并进入HandDriver所在文件夹

5. 为HandDriver.x86_64添加执行权限并运行

sudo chmod +x HandDriver.x86_64
sudo ./HandDriver.x86_64

1. 下次再运行HandDriver时，请先插上接收器，再打开HandDriver。如果先开软件再插接收器，可能会识别不到接收器。

2. 常见问题

1. 软件打开后如果出现闪退或黑屏，请结束进程后重新打开软件；如果仍然黑屏，请再次尝试重新打开软件，或尝试关一下手套后再打开软件。

2. 如果识别不到接收器，注意要先插上接收器，再打开软件。插上接收器后，建议dmesg看一下接收器识别是否正常后再开软件。有时也可以拔插一下接收器后再打开软件查看是否识别。

3. 数据发送时，请填写正确的IP地址，如果输入当前所在网段但没有目标主机时可能引起软件异常，需要重新打开软件。

4. 给tty*设备添加权限时如果666后仍然无法识别，极端情况下可尝试更高的777赋权，但请注意系统安全问题。