Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/viro/vfs
[linux/fpc-iii.git] / Documentation / ABI / testing / sysfs-driver-wacom
blob7fc781048b799a2f32bed2775d2f1fc97e8534ec
1 WWhat:          /sys/class/hidraw/hidraw*/device/oled*_img
2 Date:           June 2012
3 Contact:        linux-bluetooth@vger.kernel.org
4 Description:
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.
14 What:           /sys/class/hidraw/hidraw*/device/speed
15 Date:           April 2010
16 Kernel Version: 2.6.35
17 Contact:        linux-bluetooth@vger.kernel.org
18 Description:
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.
25 What:           /sys/class/leds/0005\:056A\:00BD.0001\:selector\:*/
26 Date:           May 2012
27 Kernel Version: 3.5
28 Contact:        linux-bluetooth@vger.kernel.org
29 Description:
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.
33 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/led
34 Date:           August 2011
35 Contact:        linux-input@vger.kernel.org
36 Description:
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.
44 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status0_luminance
45 Date:           August 2011
46 Contact:        linux-input@vger.kernel.org
47 Description:
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.
53 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status1_luminance
54 Date:           August 2011
55 Contact:        linux-input@vger.kernel.org
56 Description:
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.
61 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status_led0_select
62 Date:           August 2011
63 Contact:        linux-input@vger.kernel.org
64 Description:
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.
70 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/status_led1_select
71 Date:           September 2011
72 Contact:        linux-input@vger.kernel.org
73 Description:
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.
78 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/buttons_luminance
79 Date:           August 2011
80 Contact:        linux-input@vger.kernel.org
81 Description:
82                 Writing to this file sets the overall luminance level (0..15)
83                 of all eight button OLED displays.
85 What:           /sys/bus/usb/devices/<busnum>-<devnum>:<cfg>.<intf>/wacom_led/button<n>_rawimg
86 Date:           August 2011
87 Contact:        linux-input@vger.kernel.org
88 Description:
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.