blob: 5f67f7ab277bc51af0bdb8ccb94ae03f6936ad6c [file] [log] [blame]
Corentin Chary5f634c62009-08-28 12:56:45 +00001What: /sys/class/leds/<led>/brightness
2Date: March 2006
3KernelVersion: 2.6.17
4Contact: Richard Purdie <rpurdie@rpsys.net>
5Description:
6 Set the brightness of the LED. Most LEDs don't
Pavel Macheked25e9c2016-10-03 10:10:50 +02007 have hardware brightness support, so will just be turned on for
Corentin Chary5f634c62009-08-28 12:56:45 +00008 non-zero brightness settings. The value is between 0 and
9 /sys/class/leds/<led>/max_brightness.
10
Pavel Macheked25e9c2016-10-03 10:10:50 +020011 Writing 0 to this file clears active trigger.
12
13 Writing non-zero to this file while trigger is active changes the
14 top brightness trigger is going to use.
15
Corentin Chary5f634c62009-08-28 12:56:45 +000016What: /sys/class/leds/<led>/max_brightness
17Date: March 2006
18KernelVersion: 2.6.17
19Contact: Richard Purdie <rpurdie@rpsys.net>
20Description:
Pavel Macheked25e9c2016-10-03 10:10:50 +020021 Maximum brightness level for this LED, default is 255 (LED_FULL).
22
23 If the LED does not support different brightness levels, this
24 should be 1.
Corentin Chary5f634c62009-08-28 12:56:45 +000025
Hans de Goede0cb8eb32017-01-29 14:42:52 +010026What: /sys/class/leds/<led>/brightness_hw_changed
27Date: January 2017
28KernelVersion: 4.11
29Description:
30 Last hardware set brightness level for this LED. Some LEDs
31 may be changed autonomously by hardware/firmware. Only LEDs
32 where this happens and the driver can detect this, will have
33 this file.
34
35 This file supports poll() to detect when the hardware changes
36 the brightness.
37
38 Reading this file will return the last brightness level set
39 by the hardware, this may be different from the current
40 brightness. Reading this file when no hw brightness change
41 event has happened will return an ENODATA error.
42
Corentin Chary5f634c62009-08-28 12:56:45 +000043What: /sys/class/leds/<led>/trigger
44Date: March 2006
45KernelVersion: 2.6.17
46Contact: Richard Purdie <rpurdie@rpsys.net>
47Description:
48 Set the trigger for this LED. A trigger is a kernel based source
Pavel Macheked25e9c2016-10-03 10:10:50 +020049 of LED events.
Corentin Chary5f634c62009-08-28 12:56:45 +000050 You can change triggers in a similar manner to the way an IO
51 scheduler is chosen. Trigger specific parameters can appear in
Rafał Miłecki1f70cb42016-08-26 16:19:36 +020052 /sys/class/leds/<led> once a given trigger is selected. For
53 their documentation see sysfs-class-led-trigger-*.
Corentin Chary5f634c62009-08-28 12:56:45 +000054
Janusz Krzysztofik9f9455a2011-01-12 16:59:20 -080055What: /sys/class/leds/<led>/inverted
56Date: January 2011
57KernelVersion: 2.6.38
58Contact: Richard Purdie <rpurdie@rpsys.net>
59Description:
60 Invert the LED on/off state. This parameter is specific to
61 gpio and backlight triggers. In case of the backlight trigger,
Lucas De Marchi25985ed2011-03-30 22:57:33 -030062 it is useful when driving a LED which is intended to indicate
Janusz Krzysztofik9f9455a2011-01-12 16:59:20 -080063 a device in a standby like state.