UDEV CONFIGURATION¶

wdaemon requires a tablet to have a predictable unique device file. This is usually accomplished through udev rules. For example, on modern systems, a tablet may appear as

/dev/input/by-id/usb-Tablet_PTZ-630-event-mouse

which will point to the event device of a Intuos3 6x8. The wdaemon package provides udev rules to create symlinks to known tablet models in the form of

/dev/input/wacomX,
/dev/input/wacom-tablets/wacom-<model>-tabletX and
/dev/input/wacom-tablets/wacom-<model>-tablet-<phys path>

The last link provides unique type per USB port. Once a tablet reliably appears at a given device path, wdaemon may be configured to use it.

The second step consists in creating a persistent name for uinput devices created by wdaemon, so you can configure your xorg.conf right. An example udev rule to do this:

KERNEL="event*", PROGRAM="/lib/udev/wdaemon_is_uinput.sh", \


        RESULT="056a-0000", \


        SYMLINK="input/uinput-devices/uinput-wacom-penpartner-tablet%e"

This will create a symbolic link for penpartner tablets. Notice it needs wdaemon_is_uinput.sh script (included in this package). Also included in this package, 11-uinput-wacom.rules has these rules done for most tablets. With the rule in place, a wdaemon-created device will have predictable device files. This makes xorg.conf configuration simpler.

XORG.CONF CONFIGURATION¶

The X server should be configured to use the devices by wdaemon instead of the actual physical devices. An xorg.conf(5) section may look like this:

Section "InputDevice"


        Identifier "cursor"


        Driver "wacom"


        Option "Type" "cursor"


        Option "Device" "/dev/input/uinput-devices/uinput-wacom-intuos3-6x8-tablet"


        Option "Mode" "relative"


        Option "Tilt" "on"


        Option "Threshold" "20"


        Option "Suppress" "6"


        Option "USB"    "On"
EndSection

Note that if the X server is configured to hotplug devices, it must ignore physical devices in use by wdaemon. Example xorg.conf.d(5) and fdi files are provided with this package.

WDAEMON CONFIGURATION¶

Now wdaemon must be configured to monitor the physical tablet and create matching uinput device. A /etc/wdaemon.conf for two devices may look like this:

device = 36,/dev/input/wacom-tablets/intuos3-6x8-tablet
device = 6,/dev/input/wacom-tablets/graphire4-4x5-tablet

Notice the spaces. The wdaemon parser is very rudimentary at this point and can get easily confused. The device types 36 and 6 can be determined by running

wdaemon -w

When wdaemon is started, it will create devices of the types specified in the wdaemon.conf configuration file and monitor the device path. Whenever the physical tablet appears, wdaemon will forward events from the device to the uinput device.

If the device type is unknown to wdaemon, see SAVING AND LOADING DEVICES below.

AUTO-CONFIGURATION¶

The -a option was added in 0.14 to generate a wdaemon.conf based on the currently plugged-in tablets. First, plug in all tablets that should be emulated by wdaemon in the future. Then run

wdaemon -a

This command prints a configuration file that can then be used for wdaemon.

Auto-configuration only works with device types known to wdaemon.

SAVING AND LOADING DEVICES¶

wdaemon has the device descriptions for a number of devices built-in. For devices that are unknown to wdaemon the device description must be gathered from the physical device and loaded on startup.

A device description may be extracted with the -x option:

wdaemon -p /dev/input/by-id/usb-Tablet_PTZ-630-event-mouse -x Intuos3_6x8.desc

The resulting device file is a description of the device currently available as /dev/input/event12. The description may be loaded again with the -l option:

wdaemon -p /dev/input/by-id/usb-Tablet_PTZ-630-event-mouse -l Intuos3_6x8.desc

wdaemon will initialize a device based on the description file and forward events from the specified device path.