xref: /linux/Documentation/ABI/testing/sysfs-class-led-flash (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/class/leds/<led>/flash_brightness
2Date:		March 2015
3KernelVersion:	4.0
4Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
5Description:	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
13What:		/sys/class/leds/<led>/max_flash_brightness
14Date:		March 2015
15KernelVersion:	4.0
16Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
17Description:	read only
18		Maximum brightness level for this LED in the flash strobe mode,
19		in microamperes.
20
21What:		/sys/class/leds/<led>/flash_timeout
22Date:		March 2015
23KernelVersion:	4.0
24Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
25Description:	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
31What:		/sys/class/leds/<led>/max_flash_timeout
32Date:		March 2015
33KernelVersion:	4.0
34Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
35Description:	read only
36		Maximum flash timeout for this LED, in microseconds.
37
38What:		/sys/class/leds/<led>/flash_strobe
39Date:		March 2015
40KernelVersion:	4.0
41Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
42Description:	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
49What:		/sys/class/leds/<led>/flash_fault
50Date:		March 2015
51KernelVersion:	4.0
52Contact:	Jacek Anaszewski <j.anaszewski@samsung.com>
53Description:	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
81