Greg Kroah-Hartman
598cf27219
Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
38 lines
1.2 KiB
ReStructuredText
38 lines
1.2 KiB
ReStructuredText
==============
|
|
Userspace LEDs
|
|
==============
|
|
|
|
The uleds driver supports userspace LEDs. This can be useful for testing
|
|
triggers and can also be used to implement virtual LEDs.
|
|
|
|
|
|
Usage
|
|
=====
|
|
|
|
When the driver is loaded, a character device is created at /dev/uleds. To
|
|
create a new LED class device, open /dev/uleds and write a uleds_user_dev
|
|
structure to it (found in kernel public header file linux/uleds.h)::
|
|
|
|
#define LED_MAX_NAME_SIZE 64
|
|
|
|
struct uleds_user_dev {
|
|
char name[LED_MAX_NAME_SIZE];
|
|
};
|
|
|
|
A new LED class device will be created with the name given. The name can be
|
|
any valid sysfs device node name, but consider using the LED class naming
|
|
convention of "devicename:color:function".
|
|
|
|
The current brightness is found by reading a single byte from the character
|
|
device. Values are unsigned: 0 to 255. Reading will block until the brightness
|
|
changes. The device node can also be polled to notify when the brightness value
|
|
changes.
|
|
|
|
The LED class device will be removed when the open file handle to /dev/uleds
|
|
is closed.
|
|
|
|
Multiple LED class devices are created by opening additional file handles to
|
|
/dev/uleds.
|
|
|
|
See tools/leds/uledmon.c for an example userspace program.
|