Documentation/leds/leds-class-multicolor.rst

Source file repositories/reference/linux-study-clean/Documentation/leds/leds-class-multicolor.rst

File Facts

System
Linux kernel
Corpus path
Documentation/leds/leds-class-multicolor.rst
Extension
.rst
Size
4086 bytes
Lines
126
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. SPDX-License-Identifier: GPL-2.0

====================================
Multicolor LED handling under Linux
====================================

Description
===========
The multicolor class groups monochrome LEDs and allows controlling two
aspects of the final combined color: hue and lightness. The former is
controlled via the multi_intensity array file and the latter is controlled
via brightness file.

Multicolor Class Control
========================
The multicolor class presents files that groups the colors as indexes in an
array.  These files are children under the LED parent node created by the
led_class framework.  The led_class framework is documented in led-class.rst
within this documentation directory.

Each colored LED will be indexed under the ``multi_*`` files. The order of the
colors will be arbitrary. The ``multi_index`` file can be read to determine the
color name to indexed value.

The ``multi_index`` file is an array that contains the string list of the colors as
they are defined in each ``multi_*`` array file.

The ``multi_intensity`` file is an array that can be read or written to for the
individual color intensities.  All elements within this array must be written in
order for the color LED intensities to be updated.

The ``multi_max_intensity`` file is an array that contains the maximum intensity
value supported by each color intensity. Intensity values above this will be
automatically clamped into the supported range.

Directory Layout Example
========================
.. code-block:: console

    root:/sys/class/leds/multicolor:status# ls -lR
    -rw-r--r--    1 root     root          4096 Oct 19 16:16 brightness
    -r--r--r--    1 root     root          4096 Oct 19 16:16 max_brightness
    -r--r--r--    1 root     root          4096 Oct 19 16:16 multi_index
    -rw-r--r--    1 root     root          4096 Oct 19 16:16 multi_intensity
    -r--r--r--    1 root     root          4096 Oct 19 16:16 multi_max_intensity

..

Multicolor Class Brightness Control
===================================
The brightness level for each LED is calculated based on the color LED
intensity setting divided by the global max_brightness setting multiplied by
the requested brightness.

``led_brightness = brightness * multi_intensity/max_brightness``

Example:
A user first writes the multi_intensity file with the brightness levels
for each LED that are necessary to achieve a certain color output from a
multicolor LED group.

.. code-block:: console

    # cat /sys/class/leds/multicolor:status/multi_index
    green blue red

    # echo 43 226 138 > /sys/class/leds/multicolor:status/multi_intensity

    red -
    	intensity = 138

Annotation

Implementation Notes