xref: /openbmc/linux/Documentation/ABI/stable/sysfs-class-backlight (revision cdd38c5f1ce4398ec58fec95904b75824daab7b5)
13c4c1b69SCorentin CharyWhat:		/sys/class/backlight/<backlight>/bl_power
23c4c1b69SCorentin CharyDate:		April 2005
33c4c1b69SCorentin CharyKernelVersion:	2.6.12
43c4c1b69SCorentin CharyContact:	Richard Purdie <rpurdie@rpsys.net>
53c4c1b69SCorentin CharyDescription:
63c4c1b69SCorentin Chary		Control BACKLIGHT power, values are FB_BLANK_* from fb.h
7*98913408SMauro Carvalho Chehab
83c4c1b69SCorentin Chary		 - FB_BLANK_UNBLANK (0)   : power on.
93c4c1b69SCorentin Chary		 - FB_BLANK_POWERDOWN (4) : power off
103c4c1b69SCorentin CharyUsers:		HAL
113c4c1b69SCorentin Chary
123c4c1b69SCorentin CharyWhat:		/sys/class/backlight/<backlight>/brightness
133c4c1b69SCorentin CharyDate:		April 2005
143c4c1b69SCorentin CharyKernelVersion:	2.6.12
153c4c1b69SCorentin CharyContact:	Richard Purdie <rpurdie@rpsys.net>
163c4c1b69SCorentin CharyDescription:
173c4c1b69SCorentin Chary		Control the brightness for this <backlight>. Values
183c4c1b69SCorentin Chary		are between 0 and max_brightness. This file will also
193c4c1b69SCorentin Chary		show the brightness level stored in the driver, which
203c4c1b69SCorentin Chary		may not be the actual brightness (see actual_brightness).
213c4c1b69SCorentin CharyUsers:		HAL
223c4c1b69SCorentin Chary
233c4c1b69SCorentin CharyWhat:		/sys/class/backlight/<backlight>/actual_brightness
243c4c1b69SCorentin CharyDate:		March 2006
253c4c1b69SCorentin CharyKernelVersion:	2.6.17
263c4c1b69SCorentin CharyContact:	Richard Purdie <rpurdie@rpsys.net>
273c4c1b69SCorentin CharyDescription:
283c4c1b69SCorentin Chary		Show the actual brightness by querying the hardware.
293c4c1b69SCorentin CharyUsers:		HAL
303c4c1b69SCorentin Chary
313c4c1b69SCorentin CharyWhat:		/sys/class/backlight/<backlight>/max_brightness
323c4c1b69SCorentin CharyDate:		April 2005
333c4c1b69SCorentin CharyKernelVersion:	2.6.12
343c4c1b69SCorentin CharyContact:	Richard Purdie <rpurdie@rpsys.net>
353c4c1b69SCorentin CharyDescription:
363c4c1b69SCorentin Chary		Maximum brightness for <backlight>.
373c4c1b69SCorentin CharyUsers:		HAL
38bb7ca747SMatthew Garrett
39bb7ca747SMatthew GarrettWhat:		/sys/class/backlight/<backlight>/type
40bb7ca747SMatthew GarrettDate:		September 2010
41bb7ca747SMatthew GarrettKernelVersion:	2.6.37
42bb7ca747SMatthew GarrettContact:	Matthew Garrett <mjg@redhat.com>
43bb7ca747SMatthew GarrettDescription:
44bb7ca747SMatthew Garrett		The type of interface controlled by <backlight>.
45bb7ca747SMatthew Garrett		"firmware": The driver uses a standard firmware interface
46bb7ca747SMatthew Garrett		"platform": The driver uses a platform-specific interface
47bb7ca747SMatthew Garrett		"raw": The driver controls hardware registers directly
48bb7ca747SMatthew Garrett
49bb7ca747SMatthew Garrett		In the general case, when multiple backlight
50bb7ca747SMatthew Garrett		interfaces are available for a single device, firmware
51bb7ca747SMatthew Garrett		control should be preferred to platform control should
52bb7ca747SMatthew Garrett		be preferred to raw control. Using a firmware
53bb7ca747SMatthew Garrett		interface reduces the probability of confusion with
54bb7ca747SMatthew Garrett		the hardware and the OS independently updating the
55bb7ca747SMatthew Garrett		backlight state. Platform interfaces are mostly a
56bb7ca747SMatthew Garrett		holdover from pre-standardisation of firmware
57bb7ca747SMatthew Garrett		interfaces.
58