GNU Linux-libre 4.4.294-gnu1
[releases.git] / Documentation / ABI / testing / sysfs-class-led-flash
1 What:           /sys/class/leds/<led>/flash_brightness
2 Date:           March 2015
3 KernelVersion:  4.0
4 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
5 Description:    read/write
6                 Set the brightness of this LED in the flash strobe mode, in
7                 microamperes. The file is created only for the flash LED devices
8                 that support setting flash brightness.
9
10                 The value is between 0 and
11                 /sys/class/leds/<led>/max_flash_brightness.
12
13 What:           /sys/class/leds/<led>/max_flash_brightness
14 Date:           March 2015
15 KernelVersion:  4.0
16 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
17 Description:    read only
18                 Maximum brightness level for this LED in the flash strobe mode,
19                 in microamperes.
20
21 What:           /sys/class/leds/<led>/flash_timeout
22 Date:           March 2015
23 KernelVersion:  4.0
24 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
25 Description:    read/write
26                 Hardware timeout for flash, in microseconds. The flash strobe
27                 is stopped after this period of time has passed from the start
28                 of the strobe. The file is created only for the flash LED
29                 devices that support setting flash timeout.
30
31 What:           /sys/class/leds/<led>/max_flash_timeout
32 Date:           March 2015
33 KernelVersion:  4.0
34 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
35 Description:    read only
36                 Maximum flash timeout for this LED, in microseconds.
37
38 What:           /sys/class/leds/<led>/flash_strobe
39 Date:           March 2015
40 KernelVersion:  4.0
41 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
42 Description:    read/write
43                 Flash strobe state. When written with 1 it triggers flash strobe
44                 and when written with 0 it turns the flash off.
45
46                 On read 1 means that flash is currently strobing and 0 means
47                 that flash is off.
48
49 What:           /sys/class/leds/<led>/flash_fault
50 Date:           March 2015
51 KernelVersion:  4.0
52 Contact:        Jacek Anaszewski <j.anaszewski@samsung.com>
53 Description:    read only
54                 Space separated list of flash faults that may have occurred.
55                 Flash faults are re-read after strobing the flash. Possible
56                 flash faults:
57
58                 * led-over-voltage - flash controller voltage to the flash LED
59                         has exceeded the limit specific to the flash controller
60                 * flash-timeout-exceeded - the flash strobe was still on when
61                         the timeout set by the user has expired; not all flash
62                         controllers may set this in all such conditions
63                 * controller-over-temperature - the flash controller has
64                         overheated
65                 * controller-short-circuit - the short circuit protection
66                         of the flash controller has been triggered
67                 * led-power-supply-over-current - current in the LED power
68                         supply has exceeded the limit specific to the flash
69                         controller
70                 * indicator-led-fault - the flash controller has detected
71                         a short or open circuit condition on the indicator LED
72                 * led-under-voltage - flash controller voltage to the flash
73                         LED has been below the minimum limit specific to
74                         the flash
75                 * controller-under-voltage - the input voltage of the flash
76                         controller is below the limit under which strobing the
77                         flash at full current will not be possible;
78                         the condition persists until this flag is no longer set
79                 * led-over-temperature - the temperature of the LED has exceeded
80                         its allowed upper limit