xref: /linux/Documentation/ABI/testing/sysfs-driver-wacom (revision 4413e16d9d21673bb5048a2e542f1aaa00015c2e)
1WWhat:		/sys/class/hidraw/hidraw*/device/oled*_img
2Date:		June 2012
3Contact:	linux-bluetooth@vger.kernel.org
4Description:
5		The /sys/class/hidraw/hidraw*/device/oled*_img files control
6		OLED mocro displays on Intuos4 Wireless tablet. Accepted image
7		has to contain 256 bytes (64x32 px 1 bit colour). The format
8		is the same as PBM image 62x32px without header (64 bits per
9		horizontal line, 32 lines). An example of setting OLED No. 0:
10		dd bs=256 count=1 if=img_file of=[path to oled0_img]/oled0_img
11		The attribute is read only and no local copy of the image is
12		stored.
13
14What:		/sys/class/hidraw/hidraw*/device/speed
15Date:		April 2010
16Kernel Version:	2.6.35
17Contact:	linux-bluetooth@vger.kernel.org
18Description:
19		The /sys/class/hidraw/hidraw*/device/speed file controls
20		reporting speed of Wacom bluetooth tablet. Reading from
21		this file returns 1 if tablet reports in high speed mode
22		or 0 otherwise. Writing to this file one of these values
23		switches reporting speed.
24
25What:		/sys/class/leds/0005\:056A\:00BD.0001\:selector\:*/
26Date:		May 2012
27Kernel Version:	3.5
28Contact:	linux-bluetooth@vger.kernel.org
29Description:
30		LED selector for Intuos4 WL. There are 4 leds, but only one LED
31		can be lit at a time. Max brightness is 127.
32
33What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/led
34Date:		August 2011
35Contact:	linux-input@vger.kernel.org
36Description:
37		Attribute group for control of the status LEDs and the OLEDs.
38		This attribute group is only available for Intuos 4 M, L,
39		and XL (with LEDs and OLEDs), Intuos 5 (LEDs only), and Cintiq
40		21UX2 and Cintiq 24HD (LEDs only). Therefore its presence
41		implicitly signifies the presence of said LEDs and OLEDs on the
42		tablet device.
43
44What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status0_luminance
45Date:		August 2011
46Contact:	linux-input@vger.kernel.org
47Description:
48		Writing to this file sets the status LED luminance (1..127)
49		when the stylus does not touch the tablet surface, and no
50		button is pressed on the stylus. This luminance level is
51		normally lower than the level when a button is pressed.
52
53What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status1_luminance
54Date:		August 2011
55Contact:	linux-input@vger.kernel.org
56Description:
57		Writing to this file sets the status LED luminance (1..127)
58		when the stylus touches the tablet surface, or any button is
59		pressed on the stylus.
60
61What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status_led0_select
62Date:		August 2011
63Contact:	linux-input@vger.kernel.org
64Description:
65		Writing to this file sets which one of the four (for Intuos 4
66		and Intuos 5) or of the right four (for Cintiq 21UX2 and Cintiq
67		24HD) status LEDs is active (0..3). The other three LEDs on the
68		same side are always inactive.
69
70What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status_led1_select
71Date:		September 2011
72Contact:	linux-input@vger.kernel.org
73Description:
74		Writing to this file sets which one of the left four (for Cintiq 21UX2
75		and Cintiq 24HD) status LEDs is active (0..3). The other three LEDs on
76		the left are always inactive.
77
78What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/buttons_luminance
79Date:		August 2011
80Contact:	linux-input@vger.kernel.org
81Description:
82		Writing to this file sets the overall luminance level (0..15)
83		of all eight button OLED displays.
84
85What:		/sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/button<n>_rawimg
86Date:		August 2011
87Contact:	linux-input@vger.kernel.org
88Description:
89		When writing a 1024 byte raw image in Wacom Intuos 4
90		interleaving format to the file, the image shows up on Button N
91		of the device. The image is a 64x32 pixel 4-bit gray image. The
92		1024 byte binary is split up into 16x 64 byte chunks. Each 64
93		byte chunk encodes the image data for two consecutive lines on
94		the display. The low nibble of each byte contains the first
95		line, and the high nibble contains the second line.
96