xref: /linux/Documentation/ABI/testing/sysfs-platform-dell-laptop (revision ac84bac4062e7fc24f5e2c61c6a414b2a00a29ad)
1What:		/sys/class/leds/dell::kbd_backlight/als_enabled
2Date:		December 2014
3KernelVersion:	3.19
4Contact:	Gabriele Mazzotta <gabriele.mzt@gmail.com>,
5		Pali Rohár <pali@kernel.org>
6Description:
7		This file allows to control the automatic keyboard
8		illumination mode on some systems that have an ambient
9		light sensor. Write 1 to this file to enable the auto
10		mode, 0 to disable it.
11
12What:		/sys/class/leds/dell::kbd_backlight/als_setting
13Date:		December 2014
14KernelVersion:	3.19
15Contact:	Gabriele Mazzotta <gabriele.mzt@gmail.com>,
16		Pali Rohár <pali@kernel.org>
17Description:
18		This file allows to specifiy the on/off threshold value,
19		as reported by the ambient light sensor.
20
21What:		/sys/class/leds/dell::kbd_backlight/start_triggers
22Date:		December 2014
23KernelVersion:	3.19
24Contact:	Gabriele Mazzotta <gabriele.mzt@gmail.com>,
25		Pali Rohár <pali@kernel.org>
26Description:
27		This file allows to control the input triggers that
28		turn on the keyboard backlight illumination that is
29		disabled because of inactivity.
30		Read the file to see the triggers available. The ones
31		enabled are preceded by '+', those disabled by '-'.
32
33		To enable a trigger, write its name preceded by '+' to
34		this file. To disable a trigger, write its name preceded
35		by '-' instead.
36
37		For example, to enable the keyboard as trigger run:
38		    echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
39		To disable it:
40		    echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
41
42		Note that not all the available triggers can be configured.
43
44What:		/sys/class/leds/dell::kbd_backlight/stop_timeout
45Date:		December 2014
46KernelVersion:	3.19
47Contact:	Gabriele Mazzotta <gabriele.mzt@gmail.com>,
48		Pali Rohár <pali@kernel.org>
49Description:
50		This file allows to specify the interval after which the
51		keyboard illumination is disabled because of inactivity.
52		The timeouts are expressed in seconds, minutes, hours and
53		days, for which the symbols are 's', 'm', 'h' and 'd'
54		respectively.
55
56		To configure the timeout, write to this file a value along
57		with any the above units. If no unit is specified, the value
58		is assumed to be expressed in seconds.
59
60		For example, to set the timeout to 10 minutes run:
61		    echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout
62
63		Note that when this file is read, the returned value might be
64		expressed in a different unit than the one used when the timeout
65		was set.
66
67		Also note that only some timeouts are supported and that
68		some systems might fall back to a specific timeout in case
69		an invalid timeout is written to this file.
70