The Guide of HandDriver Linux

1. Instructions

As there are many distros of Linux, each version may have differences. The following guide takes Ubuntu as an example and is for reference only.

1.1. Prerequisites

1. This HandDriver only supports the amd64 version, not the arm64 version.

2. HandDriver does not have high requirements for the GPU. It can also run on ordinary laptops. Please make sure that your operating system has installed the correct and appropriate graphics card driver in advance. The default nouveau driver in Ubuntu is not compatible. You must install the corresponding hardware graphics card driver. Please refer to the technical support of your hardware manufacturer or search on a search engine for installation methods (Please do not remove the OpenGL capability of the graphics card during installation).

3. Currently, it is known that Ubuntu 18, 20, 22 and 24 versions can recognize the receiver, so usually there is No Need to install the receiver driver separately. In case you need to install the driver, please use the following zip file. Please follow the driver installation instructions provided by the manufacturer Qinheng for installation. If there are any problems during the installation process, please contact the manufacturer Qinheng.

13KB

CH341SER_LINUX.ZIP

archive

1. For some Ubuntu distros, there may be brltty device conflict. So it is highly recommended that when you use the glove for the 1st time, please use "sudo dmesg" after plugging in the receiver to check for such conflict. If there is such conflict, you need to disable or uninstall the brltty device (Please uninstall the brltty if disabling doesn't work), otherwise it will cause the receiver port to be occupied. Please make sure you have made relevant backup or recovery plans before uninstalling. The uninstallation method can be found on the internet.

2. Check if the receiver can be properly recognized using lsusb and dmesg.

• By "lsusb"

• If ch341-uart converter now attached to ttyUSB is displayed by "dmesg", it means that the receiver connection is successful.

1.1. Method 1

1. Run the following script first and then restart the system:

2KB

setup_usb_permissions.sh

1. Unzip the HandDriver file package, enter the HandDriver folder.

2. Add execution permission for HandDriver.x86_64.

sudo chmod +x HandDriver.x86_64

1. Plug in the receivers.

2. Double click to run HandDriver.x86_64.

3. As you have run the above script, you may double click to run HandDriver.x86_64 next time. But if you unzip a new HandDriver package, you have to add execution permission for HandDriver.x86_64 again.

4. Please plug in the receivers before you open HandDriver.

1.2. Method 2

1. Please follow these steps: Plug in the receivers first->Check dmesg information->Open HandDriver by commands->(Add Character->Bind receivers)->Turn on the gloves.

2. Please plug in the receiver first (if you open HandDrive before receiver plugging, the system will not recognize the receiver). After plugging in the receiver, use the "lsusb" and "dmesg" commands to check if the receiver is recognized.

3. Please ensure that your current user has administrator/root or "sudo" privileges. If your user cannot obtain administrator/root or "sudo" privileges, you can add read and write permissions to the device through "chmod 666 /dev/ttyUSB0" or "/dev/ttyCH341USB0" (ttyUSB0 depends on the device name assigned by the system).

4. Unzip the HandDriver file package and enter the folder where HandDriver is located.

5. Add execute permission for HandDriver.x86_64 and run it.

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

1. Next time you run the HandDriver, please plug in the receiver before opening the HandDriver. If you open the software before plugging in the receiver, the receiver may not be recognized.

2. FAQs

1. If there is a crash or black screen when opening HandDriver, please kill HandDriver process and then reopen it; if there is still a black screen, please retry or turn off the gloves and then reopen the HandDriver.

2. If the receiver cannot be recognized, be sure to plug it in first and then open the software. After plugging in the receiver, it is recommended to run dmesg to check if the receiver recognition is normal before opening the software. Sometimes you can also replug in the receiver before opening the software to check if it can be recognized.

3. When tranferring data from HandDriver, please fill in the correct IP Address. If the IP address is in the current network segment but without existing target host, it may cause software exceptions and you need to reopen the software.