Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A Linux userland driver for Huion Kamvas Pro devices

Project description

Python based Linux driver for Huion Kamvas Pro devices

This is a userspace python based evdev driver for Huion Kamvas Pro devices so that they can be used on Linux machines which don't have officially supported driver.

I personally own a Huion Kamvas Pro 13 and I have tested this driver successfully with that device. The driver should hopefully also be usable with other Huion Kamvas devices, but they havn't been tested.

Feel free to open an issue if you ran into trouble or write me a message if you found this useful.

Features

This script uses a simple YAML configuration file to give you control over how your graphics tablet interacts with your computer. This configuration file is located at ~/.kamvas_config.yaml.

With this driver you can:

  • Define actions for every button on your tablet, even for pen touch. Actions can be defined for the following events
    • Pen click on the screen
    • Pen Buttons
    • Tablet buttons
    • Scrollbar levels
    • Scrollbar increment
    • Scrollbar decrement
  • Manage button action profiles that you can easily switch between
  • Automatically map the driver output to a desired display if you have multiple monitors. NOTE This uses xinput so you will need to have that installed on your system for this functionality to work
  • The driver is automatically stopped when the USB device is unplugged and gets automatically started when it gets plugged in again

Setup

  • You will need to install the following packages from your distribution (Archlinux commands shown here)

    • Python 3: This script was tested with Python 3. It might run just fine on Python 2 if you can install the required python modules

      sudo pacman -S python3
      
    • xf86-input-evdev: This is the Digimend evdev package which adds X events relevant to graphics tablets and makes them available to other apps

      sudo pacman -S xf86-input-input-evdev
      
  • Install the driver module

    pip3 install kamvas-driver
    
  • Update your /etc/X11/xorg.conf file (create it if it is not already there):

    Section "InputClass"
        Identifier "evdev tablet catchall"
        MatchIsTablet "on"
        MatchDevicePath "/dev/input/event*"
        Driver "evdev"
    EndSection
    
  • You might need to make sure that the DIGImend kernel driver are not loaded. Unload them using this command

    sudo rmmod hid-uclogic
    
  • Setup a default configuration file for the driver

    kamvas -c
    

Usage

  • Start the driver

    kamvas start
    
  • Stop the driver

    kamvas stop
    

Configuration

You can create a default configuration file at ~/.kamvas_config.yaml using the following command

kamvas -c

You can edit ~/.kamvas_config.json file to define your custom settings for your graphics tablet. The config file allows you to define the following:

  • Actions that must be performed when a button is clicked
    • The script uses evdev events to perform these actions so the values for these actions can be any commands starting with KEY_ or BTN_. For example:

      • Use KEY_A to effectively simulate the presseing of the a key on your keyboard
      • You can also combine events like KEY_LEFTSHIFT+KEY_A to effectively press Shift+a when that action is fired
    • You can use the following command to observe which evdev events are fired when you press keys on your device. You will need to figure out the path of the event file for the device you are trying to test. It is usually located in /dev/input/. You can also try looking for it by name in /dev/input/by-id/ and /dev/input/by-path/

      kamvas -t <path_to_event_file>
      
    • Leave the actions field empty if you don't to perform any action for that even

      • For example: You might not want actions to be performed when you touch the pen to the screen and want it behave like a normal mouse click. But the option if available in case you do want perform an action in that case.
    • You can also define multiple action groups. See the config.json to see an example.

  • The default_display field automatically maps your driver output to a given system display name (like HDMI1, DVI1, etc)
    • This feature required xinput to be installed on your system
    • Remove this field if you do not have xinput installed or are just using a single display
    • If you have multiple displays and you do not use this field then the output from your graphics tablet will be mapped to all the displays by default
  • The default_action field defines the button actions group that will be used by the driver if kamvas start -a=<action_name> is not used to start the driver
  • Capabilies of your graphics tablet (like its resolution, pressure sensitivity, etc)
    • You will most likely not need to change this but might be useful if you are trying to adapt this driver to some other device
    • These fields are
      • xinput_name
      • vendor_id
      • product_id
      • pen
    • If you do need to redefine these values that try
      • kamvas -o to print driver output as it happens
        • You might need to dig into the code and make sure to pass in the -r or -c options to the driver subprocess
        • -r will allow you to monitor raw USB data as it comes in
        • -c will allow you to monitor the calculated values being sent to the system by the driver
      • kamvas -u which will print some USB information as the device gets plugged in or removed
      • Digimend uclogic-tools. Specifically, try using uclogic-probe | uclogic-decode

Known Issues

  • The driver is unable to survive a system suspend or hibernate event
    • On resume, it will continue to show that the driver is running but the cursor will be unresponsive if you try to use the device

    • You will have to stop the driver and start it again

      kamvas stop
      kamvas start
      

Project details


Release history Release notifications

This version

0.1.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kamvas-driver, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size kamvas_driver-0.1.2-py3-none-any.whl (11.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size kamvas-driver-0.1.2.tar.gz (12.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page