← Documents Documentation/leds/leds-cht-wcove.rst GitHub 원문 ↗

Linux 6.18.37 · LEDs

Intel Cherry Trail Whiskey Cove PMIC LEDs

Whiskey Cove PMIC LED의 hardware breathing pattern과 brightness 변경 동작입니다.

Source pathDocumentation/leds/leds-cht-wcove.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

leds-cht-wcove.rst:1-38

Whiskey Cove LED는 같은 rise·fall time을 갖는 hardware breathing mode를 지원하며 `brightness`는 breathing 중에도 바꿀 수 있습니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ===========================================================
4 Kernel driver for Intel Cherry Trail Whiskey Cove PMIC LEDs
5 ===========================================================
6
7 /sys/class/leds/<led>/hw_pattern
8 --------------------------------
9
10 Specify a hardware pattern for the Whiskey Cove PMIC LEDs.
11
12 The only supported pattern is hardware breathing mode::
13
14 "0 2000 1 2000"
15
16 ^
17 |
18 Max-| ---
19 | / \
20 | / \
21 | / \ /
22 | / \ /
23 Min-|- ---
24 |
25 0------2------4--> time (sec)
26
27 The rise and fall times must be the same value.
28 Supported values are 2000, 1000, 500 and 250 for
29 breathing frequencies of 1/4, 1/2, 1 and 2 Hz.
30
31 The set pattern only controls the timing. For max brightness the last
32 set brightness is used and the max brightness can be changed
33 while breathing by writing the brightness attribute.
34
35 This is just like how blinking works in the LED subsystem,
36 for both sw and hw blinking the brightness can also be changed
37 while blinking. Breathing on this hw really is just a variant
38 mode of blinking.
39

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Whiskey Cove hardware breathing pattern

1-38

Intel Cherry Trail Whiskey Cove PMIC LED driver는 `/sys/class/leds/<led>/hw_pattern` attribute로 hardware pattern을 설정합니다. 지원되는 유일한 pattern은 hardware breathing mode입니다.

Pattern 문자열은 `0 2000 1 2000`이며 최소 밝기에서 최대 밝기까지 2초 동안 상승하고, 같은 2초 동안 다시 최소 밝기로 하강하는 주기를 표현합니다. 상승 시간과 하강 시간은 반드시 같은 값이어야 합니다.

Breathing 밝기 파형
`t=0`: 최소 밝기에서 시작지정한 rise time 동안 선형으로 최대 밝기까지 상승지정한 fall time 동안 선형으로 최소 밝기까지 하강같은 주기를 hardware가 반복

원문의 삼각 파형과 같은 최소→최대→최소 반복입니다.

Breathing timing
Rise/Fall timeFrequency한 주기
`2000 ms``1/4 Hz``4 s`
`1000 ms``1/2 Hz``2 s`
`500 ms``1 Hz``1 s`
`250 ms``2 Hz``0.5 s`

Rise와 fall에 같은 값을 쓰며 값에 따라 breathing frequency가 정해집니다.

Pattern은 timing만 제어합니다. 최대 밝기는 마지막으로 설정한 `brightness` 값을 사용하며 breathing 중에도 `brightness` attribute를 써서 변경할 수 있습니다.

이 동작은 LED subsystem의 software·hardware blink와 같습니다. Blink 중에도 밝기를 바꿀 수 있으며, 이 hardware의 breathing은 실질적으로 blink의 변형 mode입니다.

.. SPDX-License-Identifier: GPL-2.0

===========================================================
Kernel driver for Intel Cherry Trail Whiskey Cove PMIC LEDs
===========================================================

/sys/class/leds/<led>/hw_pattern
--------------------------------

Specify a hardware pattern for the Whiskey Cove PMIC LEDs.

The only supported pattern is hardware breathing mode::

    "0 2000 1 2000"

        ^
        |
    Max-|     ---
        |    /   \
        |   /     \
        |  /       \     /
        | /         \   /
    Min-|-           ---
        |
        0------2------4--> time (sec)

The rise and fall times must be the same value.
Supported values are 2000, 1000, 500 and 250 for
breathing frequencies of 1/4, 1/2, 1 and 2 Hz.

The set pattern only controls the timing. For max brightness the last
set brightness is used and the max brightness can be changed
while breathing by writing the brightness attribute.

This is just like how blinking works in the LED subsystem,
for both sw and hw blinking the brightness can also be changed
while blinking. Breathing on this hw really is just a variant
mode of blinking.