huion-switcher - Man Page

huion-switcher [--help|--version] --all|<path>

huion-switcher switches Huion tablet devices from the default firmware reporting mode to the vendor reporting mode. In vendor mode the device uses a HID vendor collection to report input data in a more precise and device-specific manner than firmware mode. Some device features may only be available in vendor mode.  However, vendor mode requires either a kernel driver or a HID eBPF program to interpret the vendor-specific HID reports.

If you intend to use HID eBPF programs (see udev-hid-bpf(1)) for Huion tablets, you will need the tablet in vendor reporting mode.

huion-switcher prints several strings in the KEY=VALUE format. These strings should be passed to the HID eBPF program to allow for device-specific behavior. Use the udev rule provided in the huion-switcher repository to ensure the properties are passed correctly.

--all

Attempt to switch all connected Huion devices to vendor reporting mode. Note that Huion's USB Vendor ID (0x256C) is re-used by other vendors (e.g. Gaomon) and thus any such devices will also be switched.

--help

Print help and exit

--version

Print version and exit

path

A sysfs path to the device. Typically this invocation is used with a udev rule. It is possible to use a hidraw path via the /sys/class/hidraw/hidraw*.

The recommended way to use huion-switcher is to install it in /usr/lib/udev and invoke it automatically via the 80-huion-switcher.rules udev rule on device plug. The udev rule can be found in the huion-switcher repository.

huion-switcher's git repository: https://github.com/whot/huion-switcher/

udev-hid-bpf: https://gitlab.freedesktop.org/libevdev/udev-hid-bpf