xref: /linux/Documentation/ABI/testing/sysfs-driver-wacom (revision c704b4ef1a819b053fd33617e861da1932077314)
1*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed
25d7e7d47SEduard HasenleithnerDate:		April 2010
35d7e7d47SEduard HasenleithnerKernel Version:	2.6.35
45d7e7d47SEduard HasenleithnerContact:	linux-bluetooth@vger.kernel.org
55d7e7d47SEduard HasenleithnerDescription:
6*c704b4efSBenjamin Tissoires		The /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed file
7*c704b4efSBenjamin Tissoires		controls reporting speed of Wacom bluetooth tablet. Reading
8*c704b4efSBenjamin Tissoires		from this file returns 1 if tablet reports in high speed mode
95d7e7d47SEduard Hasenleithner		or 0 otherwise. Writing to this file one of these values
105d7e7d47SEduard Hasenleithner		switches reporting speed.
115d7e7d47SEduard Hasenleithner
12*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/led
13*c704b4efSBenjamin TissoiresDate:		August 2014
145d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
155d7e7d47SEduard HasenleithnerDescription:
1609e7d941SPing Cheng		Attribute group for control of the status LEDs and the OLEDs.
1709e7d941SPing Cheng		This attribute group is only available for Intuos 4 M, L,
18*c704b4efSBenjamin Tissoires		and XL (with LEDs and OLEDs), Intuos 4 WL, Intuos 5 (LEDs only),
19*c704b4efSBenjamin Tissoires		Intuos Pro (LEDs only) and Cintiq 21UX2 and Cintiq 24HD
20*c704b4efSBenjamin Tissoires		(LEDs only). Therefore its presence implicitly signifies the
21*c704b4efSBenjamin Tissoires		presence of said LEDs and OLEDs on the tablet device.
225d7e7d47SEduard Hasenleithner
23*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance
24*c704b4efSBenjamin TissoiresDate:		August 2014
255d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
265d7e7d47SEduard HasenleithnerDescription:
2777e82516SPing Cheng		Writing to this file sets the status LED luminance (1..127)
285d7e7d47SEduard Hasenleithner		when the stylus does not touch the tablet surface, and no
29f4fa9a6dSPing Cheng		button is pressed on the stylus. This luminance level is
30f4fa9a6dSPing Cheng		normally lower than the level when a button is pressed.
315d7e7d47SEduard Hasenleithner
32*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance
33*c704b4efSBenjamin TissoiresDate:		August 2014
345d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
355d7e7d47SEduard HasenleithnerDescription:
3677e82516SPing Cheng		Writing to this file sets the status LED luminance (1..127)
375d7e7d47SEduard Hasenleithner		when the stylus touches the tablet surface, or any button is
385d7e7d47SEduard Hasenleithner		pressed on the stylus.
395d7e7d47SEduard Hasenleithner
40*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select
41*c704b4efSBenjamin TissoiresDate:		August 2014
425d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
435d7e7d47SEduard HasenleithnerDescription:
449b5b95ddSJason Gerecke		Writing to this file sets which one of the four (for Intuos 4
459b5b95ddSJason Gerecke		and Intuos 5) or of the right four (for Cintiq 21UX2 and Cintiq
469b5b95ddSJason Gerecke		24HD) status LEDs is active (0..3). The other three LEDs on the
479b5b95ddSJason Gerecke		same side are always inactive.
4809e7d941SPing Cheng
49*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select
50*c704b4efSBenjamin TissoiresDate:		August 2014
5109e7d941SPing ChengContact:	linux-input@vger.kernel.org
5209e7d941SPing ChengDescription:
53246835fcSJason Gerecke		Writing to this file sets which one of the left four (for Cintiq 21UX2
54246835fcSJason Gerecke		and Cintiq 24HD) status LEDs is active (0..3). The other three LEDs on
55246835fcSJason Gerecke		the left are always inactive.
565d7e7d47SEduard Hasenleithner
57*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance
58*c704b4efSBenjamin TissoiresDate:		August 2014
595d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
605d7e7d47SEduard HasenleithnerDescription:
615d7e7d47SEduard Hasenleithner		Writing to this file sets the overall luminance level (0..15)
625d7e7d47SEduard Hasenleithner		of all eight button OLED displays.
635d7e7d47SEduard Hasenleithner
64*c704b4efSBenjamin TissoiresWhat:		/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg
65*c704b4efSBenjamin TissoiresDate:		August 2014
665d7e7d47SEduard HasenleithnerContact:	linux-input@vger.kernel.org
675d7e7d47SEduard HasenleithnerDescription:
685d7e7d47SEduard Hasenleithner		When writing a 1024 byte raw image in Wacom Intuos 4
695d7e7d47SEduard Hasenleithner		interleaving format to the file, the image shows up on Button N
705d7e7d47SEduard Hasenleithner		of the device. The image is a 64x32 pixel 4-bit gray image. The
715d7e7d47SEduard Hasenleithner		1024 byte binary is split up into 16x 64 byte chunks. Each 64
725d7e7d47SEduard Hasenleithner		byte chunk encodes the image data for two consecutive lines on
735d7e7d47SEduard Hasenleithner		the display. The low nibble of each byte contains the first
745d7e7d47SEduard Hasenleithner		line, and the high nibble contains the second line.
75*c704b4efSBenjamin Tissoires		When the Wacom Intuos 4 is connected over Bluetooth, the
76*c704b4efSBenjamin Tissoires		image has to contain 256 bytes (64x32 px 1 bit colour).
77*c704b4efSBenjamin Tissoires		The format is also scrambled, like in the USB mode, and it can
78*c704b4efSBenjamin Tissoires		be summarized by converting 76543210 into GECA6420.
79*c704b4efSBenjamin Tissoires					    HGFEDCBA      HFDB7531
80