Loading Documentation/ABI/testing/sysfs-bus-iio +1 −1 Original line number Diff line number Diff line Loading @@ -138,7 +138,7 @@ Description: Raw capacitance measurement from channel Y. Units after application of scale and offset are nanofarads. What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_raw KernelVersion: 3.2 Contact: linux-iio@vger.kernel.org Description: Loading Documentation/ABI/testing/sysfs-class-led-multicolor 0 → 100644 +35 −0 Original line number Diff line number Diff line What: /sys/class/leds/<led>/brightness Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read/write Writing to this file will update all LEDs within the group to a calculated percentage of what each color LED intensity is set to. The percentage is calculated for each grouped LED via the equation below: led_brightness = brightness * multi_intensity/max_brightness For additional details please refer to Documentation/leds/leds-class-multicolor.rst. The value of the LED is from 0 to /sys/class/leds/<led>/max_brightness. What: /sys/class/leds/<led>/multi_index Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read The multi_index array, when read, will output the LED colors as an array of strings as they are indexed in the multi_intensity file. What: /sys/class/leds/<led>/multi_intensity Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read/write This file contains array of integers. Order of components is described by the multi_index array. The maximum intensity should not exceed /sys/class/leds/<led>/max_brightness. Documentation/arm64/silicon-errata.rst +4 −0 Original line number Diff line number Diff line Loading @@ -70,8 +70,12 @@ stable kernels. +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A57 | #834220 | ARM64_ERRATUM_834220 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A57 | #1742098 | ARM64_ERRATUM_1742098 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A72 | #853709 | N/A | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A72 | #1655431 | ARM64_ERRATUM_1742098 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A73 | #858921 | ARM64_ERRATUM_858921 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A55 | #1024718 | ARM64_ERRATUM_1024718 | Loading Documentation/leds/index.rst +1 −0 Original line number Diff line number Diff line Loading @@ -9,6 +9,7 @@ LEDs leds-class leds-class-flash leds-class-multicolor ledtrig-oneshot ledtrig-transient ledtrig-usbport Loading Documentation/leds/leds-class-multicolor.rst 0 → 100644 +86 −0 Original line number Diff line number Diff line .. 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 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. Directory Layout Example ======================== 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 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. 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 max_brightness = 255 green - intensity = 43 max_brightness = 255 blue - intensity = 226 max_brightness = 255 The user can control the brightness of that multicolor LED group by writing the global 'brightness' control. Assuming a max_brightness of 255 the user may want to dim the LED color group to half. The user would write a value of 128 to the global brightness file then the values written to each LED will be adjusted base on this value. cat /sys/class/leds/multicolor:status/max_brightness 255 echo 128 > /sys/class/leds/multicolor:status/brightness adjusted_red_value = 128 * 138/255 = 69 adjusted_green_value = 128 * 43/255 = 21 adjusted_blue_value = 128 * 226/255 = 113 Reading the global brightness file will return the current brightness value of the color LED group. cat /sys/class/leds/multicolor:status/brightness 128 Loading
Documentation/ABI/testing/sysfs-bus-iio +1 −1 Original line number Diff line number Diff line Loading @@ -138,7 +138,7 @@ Description: Raw capacitance measurement from channel Y. Units after application of scale and offset are nanofarads. What: /sys/.../iio:deviceX/in_capacitanceY-in_capacitanceZ_raw What: /sys/.../iio:deviceX/in_capacitanceY-capacitanceZ_raw KernelVersion: 3.2 Contact: linux-iio@vger.kernel.org Description: Loading
Documentation/ABI/testing/sysfs-class-led-multicolor 0 → 100644 +35 −0 Original line number Diff line number Diff line What: /sys/class/leds/<led>/brightness Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read/write Writing to this file will update all LEDs within the group to a calculated percentage of what each color LED intensity is set to. The percentage is calculated for each grouped LED via the equation below: led_brightness = brightness * multi_intensity/max_brightness For additional details please refer to Documentation/leds/leds-class-multicolor.rst. The value of the LED is from 0 to /sys/class/leds/<led>/max_brightness. What: /sys/class/leds/<led>/multi_index Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read The multi_index array, when read, will output the LED colors as an array of strings as they are indexed in the multi_intensity file. What: /sys/class/leds/<led>/multi_intensity Date: March 2020 KernelVersion: 5.9 Contact: Dan Murphy <dmurphy@ti.com> Description: read/write This file contains array of integers. Order of components is described by the multi_index array. The maximum intensity should not exceed /sys/class/leds/<led>/max_brightness.
Documentation/arm64/silicon-errata.rst +4 −0 Original line number Diff line number Diff line Loading @@ -70,8 +70,12 @@ stable kernels. +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A57 | #834220 | ARM64_ERRATUM_834220 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A57 | #1742098 | ARM64_ERRATUM_1742098 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A72 | #853709 | N/A | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A72 | #1655431 | ARM64_ERRATUM_1742098 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A73 | #858921 | ARM64_ERRATUM_858921 | +----------------+-----------------+-----------------+-----------------------------+ | ARM | Cortex-A55 | #1024718 | ARM64_ERRATUM_1024718 | Loading
Documentation/leds/index.rst +1 −0 Original line number Diff line number Diff line Loading @@ -9,6 +9,7 @@ LEDs leds-class leds-class-flash leds-class-multicolor ledtrig-oneshot ledtrig-transient ledtrig-usbport Loading
Documentation/leds/leds-class-multicolor.rst 0 → 100644 +86 −0 Original line number Diff line number Diff line .. 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 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. Directory Layout Example ======================== 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 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. 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 max_brightness = 255 green - intensity = 43 max_brightness = 255 blue - intensity = 226 max_brightness = 255 The user can control the brightness of that multicolor LED group by writing the global 'brightness' control. Assuming a max_brightness of 255 the user may want to dim the LED color group to half. The user would write a value of 128 to the global brightness file then the values written to each LED will be adjusted base on this value. cat /sys/class/leds/multicolor:status/max_brightness 255 echo 128 > /sys/class/leds/multicolor:status/brightness adjusted_red_value = 128 * 138/255 = 69 adjusted_green_value = 128 * 43/255 = 21 adjusted_blue_value = 128 * 226/255 = 113 Reading the global brightness file will return the current brightness value of the color LED group. cat /sys/class/leds/multicolor:status/brightness 128
