Skip to content

About

A tutorial on how to fix ATK/VXE mice not connecting to the web UI

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

atk-mouse-udev-fix

Fix Device initialization failed in ATK Hub on Linux by granting the wireless dongle non-root HID access.

Problem

ATK Hub (web app) talks directly to the receiver over /dev/hidraw*, likely via WebHID. Default permissions are root-only, so pairing/init fails with no useful error beyond "Device initialization failed."

Fix

echo 'SUBSYSTEM=="hidraw", ATTRS{idVendor}=="373b", ATTRS{idProduct}=="1085", MODE="0666"' | sudo tee /etc/udev/rules.d/99-atk-mouse.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

Unplug and replug the dongle, then retry pairing in ATK Hub.

Find your VID/PID

lsusb

Look for the dongle (may show as ATK, CX, Compx, or similar). Swap idVendor/idProduct in the rule for your values.

Why it works

The udev rule sets hidraw device nodes matching that VID/PID to 0666 (read/write for all users) instead of root-only, so the browser/web app can open the device directly (e.g. via WebHID).

Tested on

  • VXE R1 SE+ mouse w/ ATK 1K dongle (373b:1085)
  • CachyOS (Arch-based)

License

GPL

About

A tutorial on how to fix ATK/VXE mice not connecting to the web UI

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors