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