xref: /freebsd/share/man/man4/hidwacom.4 (revision 4085d1991e2a9e155e3d928955ce8ba53512b8da)
1.\"
2.\" Copyright (c) 2026 Abdelkader Boudih <freebsd@seuros.com>
3.\"
4.\" SPDX-License-Identifier: BSD-2-Clause
5.\"
6.Dd April 18, 2026
7.Dt HIDWACOM 4
8.Os
9.Sh NAME
10.Nm hidwacom
11.Nd Wacom ExpressKey Remote driver
12.Sh SYNOPSIS
13To compile this driver into the kernel,
14place the following lines in your
15kernel configuration file:
16.Bd -ragged -offset indent
17.Cd "device hidwacom"
18.Cd "device hidbus"
19.Cd "device hid"
20.Cd "device evdev"
21.Ed
22.Pp
23Alternatively, to load the driver as a
24module at boot time, place the following line in
25.Xr loader.conf 5 :
26.Bd -literal -offset indent
27hidwacom_load="YES"
28.Ed
29.Sh DESCRIPTION
30The
31.Nm
32driver provides support for the Wacom ExpressKey Remote, a wireless
33button pad with 18 programmable buttons and a touch ring.
34The device communicates via a USB wireless receiver using vendor-specific
35HID reports.
36.Pp
37The driver exposes the following inputs through
38.Xr evdev 4 :
39.Bl -tag -width "MSC_PULSELED"
40.It Dv BTN_0 Ns \(en Ns Dv BTN_Z , Dv BTN_BASE , Dv BTN_BASE2
4118 buttons.
42.It Dv ABS_WHEEL
43Touch ring position (0\(en71).
44Reports 0 when the ring is not being touched.
45.It Dv ABS_MISC
46Touch ring mode (0\(en3), as reported by the device.
47Reports 0 when the ring is not being touched.
48.It Dv MSC_PULSELED
49Battery charge level as a percentage (0\(en100).
50.It Dv MSC_SERIAL
51Remote serial number, identifying which physical remote generated the event.
52.El
53.Pp
54Only a single paired remote is supported.
55The multi-remote pairing protocol (up to 5 remotes) is not implemented.
56.Sh HARDWARE
57The
58.Nm
59driver supports the following device:
60.Pp
61.Bl -bullet -compact
62.It
63Wacom ExpressKey Remote (ACK-411050), connected via the Wacom USB
64wireless receiver
65.El
66.Sh FILES
67.Bl -tag -width "/dev/input/eventX" -compact
68.It Pa /dev/input/eventX
69evdev input device
70.El
71.Sh SEE ALSO
72.Xr evdev 4 ,
73.Xr hidbus 4 ,
74.Xr usbhid 4
75.Sh HISTORY
76The
77.Nm
78driver first appeared in
79.Fx 16.0 .
80.Sh BUGS
81Only a single paired remote is fully supported.
82When multiple remotes are paired, button state may be corrupted as all
83remotes share a single evdev device.
84.Sh AUTHORS
85.An Abdelkader Boudih Aq Mt freebsd@seuros.com
86.Pp
87Protocol decoded from USB traffic analysis.
88