xref: /linux/Documentation/ABI/testing/sysfs-platform-dell-laptop (revision 2a6b6c9a226279b4f6668450ddb21ae655558087)
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 specify 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
39		    echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
40
41		To disable it::
42
43		    echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
44
45		Note that not all the available triggers can be configured.
46
47What:		/sys/class/leds/dell::kbd_backlight/stop_timeout
48Date:		December 2014
49KernelVersion:	3.19
50Contact:	Gabriele Mazzotta <gabriele.mzt@gmail.com>,
51		Pali Rohár <pali@kernel.org>
52Description:
53		This file allows to specify the interval after which the
54		keyboard illumination is disabled because of inactivity.
55		The timeouts are expressed in seconds, minutes, hours and
56		days, for which the symbols are 's', 'm', 'h' and 'd'
57		respectively.
58
59		To configure the timeout, write to this file a value along
60		with any the above units. If no unit is specified, the value
61		is assumed to be expressed in seconds.
62
63		For example, to set the timeout to 10 minutes run::
64
65		    echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout
66
67		Note that when this file is read, the returned value might be
68		expressed in a different unit than the one used when the timeout
69		was set.
70
71		Also note that only some timeouts are supported and that
72		some systems might fall back to a specific timeout in case
73		an invalid timeout is written to this file.
74