leds: class: Add new optional brightness_hw_changed attribute
authorHans de Goede <hdegoede@redhat.com>
Sun, 29 Jan 2017 13:42:52 +0000 (14:42 +0100)
committerJacek Anaszewski <jacek.anaszewski@gmail.com>
Sun, 29 Jan 2017 18:59:42 +0000 (19:59 +0100)
commit0cb8eb30d425d2d2ae28ab630596c44a158784c4
tree8f715703e9e929f615160d3b326f5fff2708d670
parentcbe99c538d1776009e8710755bb6e726f7fffa9b
leds: class: Add new optional brightness_hw_changed attribute

Some LEDs may have their brightness level changed autonomously
(outside of kernel control) by hardware / firmware. This commit
adds support for an optional brightness_hw_changed attribute to
signal such changes to userspace (if a driver can detect them):

What: /sys/class/leds/<led>/brightness_hw_changed
Date: January 2017
KernelVersion: 4.11
Description:
Last hardware set brightness level for this LED. Some LEDs
may be changed autonomously by hardware/firmware. Only LEDs
where this happens and the driver can detect this, will
have this file.

This file supports poll() to detect when the hardware
changes the brightness.

Reading this file will return the last brightness level set
by the hardware, this may be different from the current
brightness.

Drivers which want to support this, simply add LED_BRIGHT_HW_CHANGED to
their flags field and call led_classdev_notify_brightness_hw_changed()
with the hardware set brightness when they detect a hardware / firmware
triggered brightness change.

Signed-off-by: Hans de Goede <hdegoede@redhat.com>
Acked-by: Pavel Machek <pavel@ucw.cz>
Signed-off-by: Jacek Anaszewski <jacek.anaszewski@gmail.com>
Documentation/ABI/testing/sysfs-class-led
Documentation/leds/leds-class.txt
drivers/leds/Kconfig
drivers/leds/led-class.c
include/linux/leds.h