mirror of
https://github.com/torvalds/linux
synced 2024-09-06 18:01:05 +00:00
cc087c0b13
The pattern diagram (chart) of /sys/class/leds/<led>/hw_pattern is wrapped in literal code block. However, the block indentation is interrupted by Icurr axis label, hence below warnings: Documentation/leds/leds-mt6370-rgb.rst:39: WARNING: Literal block ends without a blank line; unexpected unindent. Documentation/leds/leds-mt6370-rgb.rst:41: WARNING: Line block ends without a blank line. Documentation/leds/leds-mt6370-rgb.rst:46: WARNING: Unexpected indentation. Documentation/leds/leds-mt6370-rgb.rst:44: WARNING: Inline substitution_reference start-string without end-string. Fix the chart indentation by adding 4 more spaces so that the axis label is in the code block. Link: https://lore.kernel.org/oe-kbuild-all/202303182310.tB1mUzU7-lkp@intel.com/ Fixes: 4ba9df04b7ac66 ("docs: leds: Add MT6370 RGB LED pattern document") Reported-by: kernel test robot <lkp@intel.com> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com> Acked-by: Pavel Machek <pavel@ucw.cz> Signed-off-by: Lee Jones <lee@kernel.org> Link: https://lore.kernel.org/r/20230319074903.13075-3-bagasdotme@gmail.com
65 lines
2.5 KiB
ReStructuredText
65 lines
2.5 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
=========================================
|
|
The device for Mediatek MT6370 RGB LED
|
|
=========================================
|
|
|
|
Description
|
|
-----------
|
|
|
|
The MT6370 integrates a four-channel RGB LED driver, designed to provide a
|
|
variety of lighting effect for mobile device applications. The RGB LED devices
|
|
includes a smart LED string controller and it can drive 3 channels of LEDs with
|
|
a sink current up to 24mA and a CHG_VIN power good indicator LED with sink
|
|
current up to 6mA. It provides three operation modes for RGB LEDs:
|
|
PWM Dimming mode, breath pattern mode, and constant current mode. The device
|
|
can increase or decrease the brightness of the RGB LED via an I2C interface.
|
|
|
|
The breath pattern for a channel can be programmed using the "pattern" trigger,
|
|
using the hw_pattern attribute.
|
|
|
|
/sys/class/leds/<led>/hw_pattern
|
|
--------------------------------
|
|
|
|
Specify a hardware breath pattern for a MT6370 RGB LED.
|
|
|
|
The breath pattern is a series of timing pairs, with the hold-time expressed in
|
|
milliseconds. And the brightness is controlled by
|
|
'/sys/class/leds/<led>/brightness'. The pattern doesn't include the brightness
|
|
setting. Hardware pattern only controls the timing for each pattern stage
|
|
depending on the current brightness setting.
|
|
|
|
Pattern diagram::
|
|
|
|
"0 Tr1 0 Tr2 0 Tf1 0 Tf2 0 Ton 0 Toff" --> '0' for dummy brightness code
|
|
|
|
^
|
|
| ============
|
|
| / \ /
|
|
Icurr | / \ /
|
|
| / \ /
|
|
| / \ / .....repeat
|
|
| / \ /
|
|
| --- --- ---
|
|
|--- --- ---
|
|
+----------------------------------============------------> Time
|
|
< Tr1><Tr2>< Ton ><Tf1><Tf2 >< Toff >< Tr1><Tr2>
|
|
|
|
Timing description::
|
|
|
|
Tr1: First rising time for duty 0 to 30%.
|
|
Tr2: Second rising time for duty 31% to 100%.
|
|
Ton: On time for duty 100%.
|
|
Tf1: First falling time for duty 100% to 31%.
|
|
Tf2: Second falling time for duty 30% to 0%.
|
|
Toff: Off time for duty 0%.
|
|
|
|
Tr1/Tr2/Tf1/Tf2/Ton: 125ms to 3125ms, 200ms per step.
|
|
Toff: 250ms to 6250ms, 400ms per step.
|
|
|
|
Pattern example::
|
|
|
|
"0 125 0 125 0 125 0 125 0 625 0 1050"
|
|
|
|
This Will configure Tr1/Tr2/Tf1/Tf2 to 125m, Ton to 625ms, and Toff to 1050ms.
|