Kaya: Link to the OpenTabletDriver page instead of package

2025-11-18T21:39:32Z

Link to the OpenTabletDriver page instead of package

← Older revision		Revision as of 21:39, 18 November 2025
Line 3:		Line 3:
	==Drivers==		==Drivers==

	Most tablets are supported by existing official and unofficial drivers. ~~{{nixos:package\|~~OpenTabletDriver}}		Most tablets are supported by existing official and unofficial drivers. [[OpenTabletDriver]]

	==Configuring unsupported tablets==		==Configuring unsupported tablets==

Slips: DIGImend service and package no longer required in kernel >= 6.12, will leave its info for using legacy kernels.

2025-04-05T04:34:11Z

DIGImend service and package no longer required in kernel >= 6.12, will leave its info for using legacy kernels.

← Older revision		Revision as of 04:34, 5 April 2025
Line 20:		Line 20:

	Then enable the service.		Then enable the service.

			{{Note\|1= DIGImend is now apart of the [https://spbnick.github.io/2024/11/03/Letting-go-of-DIGImend.html kernel.]
			Adding the service and package must be skipped due to [https://github.com/NixOS/nixpkgs/issues/363873 compilation errors] in kernel >= 6.12}}

	{		{

Slips: Update Installing DIGImend Driver, can just autoselect the kernel package version. https://discourse.nixos.org/t/automatically-selecting-appropriate-version-of-a-kernel-module-package/50708/2

2024-08-26T22:50:44Z

Update Installing DIGImend Driver, can just autoselect the kernel package version. https://discourse.nixos.org/t/automatically-selecting-appropriate-version-of-a-kernel-module-package/50708/2

← Older revision		Revision as of 22:50, 26 August 2024
Line 17:		Line 17:

	==== Installing DIGImend Driver ====		==== Installing DIGImend Driver ====
	Add the Kernel package {{Nixos:package\|digimend}} ~~and~~ enable the service.		Add the specific Kernel package module {{Nixos:package\|digimend}}, or by auto-selection with <code>config.boot.kernelPackages</code>.

			Then enable the service.
	{		{

Line 23:		Line 25:

	environment.systemPackages = [		environment.systemPackages = [
	~~pkgs~~.~~'''linuxKernel~~.~~packages.linux_6_9~~.digimend~~'''~~		<code>config.boot.kernelPackages.digimend</code>
	];		];

Slips: Created the page, and filled out information for configuring unsupported tablets.

2024-06-30T09:04:09Z

Created the page, and filled out information for configuring unsupported tablets.

New page

Drawing / Graphics Tablets are external devices used for drawing and creating art on a computer.

==Drivers==

Most tablets are supported by existing official and unofficial drivers. {{nixos:package|OpenTabletDriver}}

==Configuring unsupported tablets==

Some tablets or features of tablets may not be supported by existing drivers. Bluetooth is missing support in a lot of existing drivers.

===Pairing Bluetooth Tablets===

See [[Bluetooth]] and manufacturer guides on pairing the tablet with the computer.

===Configure tablet drivers using DIGImend===
Using [https://digimend.github.io/ DIGImend] to configure which drivers are used to handle the drawing tablet.

==== Installing DIGImend Driver ====
Add the Kernel package {{Nixos:package|digimend}} and enable the service.
{

services.xserver.digimend.enable = true;

environment.systemPackages = [
pkgs.'''linuxKernel.packages.linux_6_9.digimend'''
];

}
* DIGImend already has many tablets pre-configured [https://digimend.github.io/tablets/ DIGImend tablet status], [https://github.com/DIGImend/digimend-kernel-drivers/blob/master/xorg.conf DIGImend xorg.conf], no additional setup required.

==== Custom Driver configuration ====

First device information needs to be obtained, {{nixos:package|evemu}} .

Select the device in the list. A tablet may have several listings such as a stylus, keyboard, and mouse.
sudo evemu-describe | grep -i "Input device"
Information required: input device name, input device vendor ID, and product ID.

Fill the information in the input class sections configuration.
* Replace the name
* <VID> replace with vendor ID
* <PID> replace with product ID
* For the pen / stylus device fill in as "wacom" for the driver.
* For hotkeys / keyboard on the tablet use "libinput" for the driver.
* <code>MatchIsTablet "on"</code> will be the the stylus / pen configuration.
* <code>MatchIsKeyboard "on"</code> is used for the hotkeys / keyboard configuration.
{

<nowiki> </nowiki> services.xserver.inputClassSections = [
<nowiki> </nowiki> <nowiki>''</nowiki>
<nowiki> </nowiki> Identifier "<stylus-device-name>"
<nowiki> </nowiki> MatchUSBID "<VID>:<PID>"
<nowiki> </nowiki> MatchDevicePath "/dev/input/event*"
<nowiki> </nowiki> MatchIsTablet "on"
<nowiki> </nowiki> Driver "wacom"
<nowiki> </nowiki> <nowiki>''</nowiki>
<nowiki> </nowiki> <nowiki>''</nowiki>
<nowiki> </nowiki> Identifier "<keyboard-device-name>"
<nowiki> </nowiki> MatchUSBID "<VID>:<PID>"
<nowiki> </nowiki> MatchDevicePath "/dev/input/event*"
<nowiki> </nowiki> MatchIsKeyboard "on"
<nowiki> </nowiki> Driver "libinput"
<nowiki> </nowiki> <nowiki>''</nowiki>
<nowiki> </nowiki> ];

}

'''Other Device Matches'''
MatchIsPointer
MatchIsKeyboard
MatchIsTouchpad
MatchIsTablet
MatchIsTouchscreen
They can be set to either <code>"off"</code> or <code>"on"</code>.

===Custom hotkey button mapping using udev===
The hotkeys on the tablet can be remapped to other key presses.

The udev service must be enabled in the configuration for key remapping to work.
{

<nowiki> </nowiki> services.udev.enable = true;

<nowiki> </nowiki> services.udev.extraHwdb =<nowiki>''</nowiki>
<nowiki> </nowiki> evdev:input:b''<BUS-ID>''v''<VID>''p''<PID>*''
<nowiki> </nowiki> KEYBOARD_KEY_<HOTKEY-ID>=<KEY-SCAN-CODE>
KEYBOARD_KEY_70005=h
<nowiki> </nowiki> KEYBOARD_KEY_700e0=0x1d
<nowiki> </nowiki> KEYBOARD_KEY_70057=a
<nowiki> </nowiki> KEYBOARD_KEY_70056=z
<nowiki> </nowiki> <nowiki>''</nowiki>;

}

====Making the udev device string====

First device information needs to be obtained, {{nixos:package|evemu}} .

Select the device in the list. A tablet may have several listings such as a stylus, keyboard, and mouse.
sudo evemu-describe | grep -i "Input device"
Information required: bus ID, input device vendor ID, and product ID, and version.

* The tablet may have the same set of IDs for the stylus, and keyboard.
* The Bus ID will be different for wired USB and Bluetooth.
* Bus ID is typically 0x03 for USB, and 0x05 for Bluetooth.

The general format for the device string is [https://wiki.archlinux.org/title/Map_scancodes_to_keycodes#Using_udev (Arch Linux Wiki)]:
evdev:input:b''<BUS-ID>''v''<VID>''p''<PID>''e''<VERSION>''-''<INPUT-MODALIAS>''
This can be shortened with globing / wildcard
evdev:input:b''<BUS-ID>''v''<VID>''p''<PID>*''

* Each part of the IDs are 4 characters long. Fill in with leading zeros.

Example device strings:
evdev:input:b0005v28BDp0935e0001-e0*
evdev:input:b0005v28BDp0935*

==== Getting <code>KEYBOARD_KEY</code> IDs ====

We must now run {{Nixos:package|evtest}} in order to find the hotkey IDs.
sudo evtest
* The stylus / pen may have buttons which can be in a different event ID from the tablet hotkeys / keyboard.
* The stylus / pen drawing / writing tip may also have a keyboard key ID.
* When multiple keys are listed for a single hotkey press that signifies a key combo.
* Key combos are only possible if the hotkey was configured as a key combo from the manufacturer.
* Some hotkeys may share the same <code>KEYBOARD_KEY</code> ID.

At the end of <code>(EV_MSC)</code> / <code>(MSC_SCAN)</code> lines, the value is the keyboard key ID.
Event: time 1719736502.701574, type 4 (EV_MSC), code 4 (MSC_SCAN), value 700e0

For the Stylus / Pen buttons it may be ideal to use grep to reduce the amount of information seen as the pen position moves causing many events per second.

sudo evtest | grep -i "MSC"

====Key Scan Codes====

Key press events can be remapped, they can be listed in hexadecimal or by key map name.

Hexadecimal:

* https://kbdlayout.info/KBDFR/scancodes
* https://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html

Key map name:

* https://hal.freedesktop.org/quirk/quirk-keymap-list.txt

==See Also==
*[https://www.davidrevoy.com/article842/review-xp-pen-artist-24-pro-on-linux XP-Pen On Linux Guide (David Revoy Blog)]
*[https://nek0.eu/posts/2021-06-27-Hacking-my-XP-Pen-drawing-tablets.html Hacking my XP Pen drawing tablets (nek0.eu blog)]
*[https://digimend.github.io/ DIGImend]
*[https://wiki.archlinux.org/title/Map_scancodes_to_keycodes#Using_udev Using Udev (Arch Linux Wiki)]

[[Category:Configuration]][[Category:Hardware]]

Drawing Tablet - Revision history

Kaya: Link to the OpenTabletDriver page instead of package

Slips: DIGImend service and package no longer required in kernel >= 6.12, will leave its info for using legacy kernels.

Slips: Update Installing DIGImend Driver, can just autoselect the kernel package version. https://discourse.nixos.org/t/automatically-selecting-appropriate-version-of-a-kernel-module-package/50708/2

Slips: Created the page, and filled out information for configuring unsupported tablets.