Documentation/leds/leds-el15203000.rst GitHub 원문 ↗

Linux 6.18.37 · LEDs

Crane EL15203000 LED Driver

EL15203000 firmware가 제공하는 breathing·cascade·bounce hardware pattern과 timing입니다.

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

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약·해설

leds-el15203000.rst:1-140

EL15203000은 firmware predefined mask sequence로 screen frame breathing과 5-segment Pipe LED의 cascade·bounce pattern을 실행합니다.

각 ASCII timing diagram은 mask, segment 방향, 800ms slot 또는 4초 ramp를 보존한 구조화 흐름으로 다시 표현했습니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ==================================
4 Kernel driver for Crane EL15203000
5 ==================================
6
7 /sys/class/leds/<led>/hw_pattern
8 --------------------------------
9
10 Specify a hardware pattern for the EL15203000 LED.
11
12 The LEDs board supports only predefined patterns by firmware
13 for specific LEDs.
14
15 Breathing mode for Screen frame light tube::
16
17 "0 4000 1 4000"
18
19 ^
20 |
21 Max-| ---
22 | / \
23 | / \
24 | / \ /
25 | / \ /
26 Min-|- ---
27 |
28 0------4------8--> time (sec)
29
30 Cascade mode for Pipe LED::
31
32 "1 800 2 800 4 800 8 800 16 800"
33
34 ^
35 |
36 0 On -|----+ +----+ +---
37 | | | | |
38 Off-| +-------------------+ +-------------------+
39 |
40 1 On -| +----+ +----+
41 | | | | |
42 Off |----+ +-------------------+ +------------------
43 |
44 2 On -| +----+ +----+
45 | | | | |
46 Off-|---------+ +-------------------+ +-------------
47 |
48 3 On -| +----+ +----+
49 | | | | |
50 Off-|--------------+ +-------------------+ +--------
51 |
52 4 On -| +----+ +----+
53 | | | | |
54 Off-|-------------------+ +-------------------+ +---
55 |
56 0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)
57
58 Inverted cascade mode for Pipe LED::
59
60 "30 800 29 800 27 800 23 800 15 800"
61
62 ^
63 |
64 0 On -| +-------------------+ +-------------------+
65 | | | | |
66 Off-|----+ +----+ +---
67 |
68 1 On -|----+ +-------------------+ +------------------
69 | | | | |
70 Off | +----+ +----+
71 |
72 2 On -|---------+ +-------------------+ +-------------
73 | | | | |
74 Off-| +----+ +----+
75 |
76 3 On -|--------------+ +-------------------+ +--------
77 | | | | |
78 Off-| +----+ +----+
79 |
80 4 On -|-------------------+ +-------------------+ +---
81 | | | | |
82 Off-| +----+ +----+
83 |
84 0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)
85
86 Bounce mode for Pipe LED::
87
88 "1 800 2 800 4 800 8 800 16 800 16 800 8 800 4 800 2 800 1 800"
89
90 ^
91 |
92 0 On -|----+ +--------
93 | | |
94 Off-| +---------------------------------------+
95 |
96 1 On -| +----+ +----+
97 | | | | |
98 Off |----+ +-----------------------------+ +--------
99 |
100 2 On -| +----+ +----+
101 | | | | |
102 Off-|---------+ +-------------------+ +-------------
103 |
104 3 On -| +----+ +----+
105 | | | | |
106 Off-|--------------+ +---------+ +------------------
107 |
108 4 On -| +---------+
109 | | |
110 Off-|-------------------+ +-----------------------
111 |
112 0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)
113
114 Inverted bounce mode for Pipe LED::
115
116 "30 800 29 800 27 800 23 800 15 800 15 800 23 800 27 800 29 800 30 800"
117
118 ^
119 |
120 0 On -| +---------------------------------------+
121 | | |
122 Off-|----+ +--------
123 |
124 1 On -|----+ +-----------------------------+ +--------
125 | | | | |
126 Off | +----+ +----+
127 |
128 2 On -|---------+ +-------------------+ +-------------
129 | | | | |
130 Off-| +----+ +----+
131 |
132 3 On -|--------------+ +---------+ +------------------
133 | | | | |
134 Off-| +----+ +----+
135 |
136 4 On -|-------------------+ +-----------------------
137 | | |
138 Off-| +---------+
139 |
140 0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)
141

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Screen frame breathing pattern

1-30

Crane EL15203000 LED board는 `/sys/class/leds/<led>/hw_pattern`으로 hardware pattern을 지정합니다. Firmware가 특정 LED용으로 미리 정의한 pattern만 지원합니다.

Screen frame light tube의 breathing mode는 `0 4000 1 4000`입니다. 최소 밝기에서 4초 동안 최대 밝기로 상승하고 다시 4초 동안 최소로 하강해 8초 주기를 반복합니다.

Screen frame breathing
`0 s`: 최소 밝기`0~4 s`: 최대 밝기까지 점진적 상승`4~8 s`: 최소 밝기까지 점진적 하강`8 s`부터 cycle 반복

원문의 삼각 파형과 동일한 8초 밝기 cycle입니다.

.. SPDX-License-Identifier: GPL-2.0

==================================
Kernel driver for Crane EL15203000
==================================

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

Specify a hardware pattern for the EL15203000 LED.

The LEDs board supports only predefined patterns by firmware
for specific LEDs.

Breathing mode for Screen frame light tube::

    "0 4000 1 4000"

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

Cascade mode for Pipe LED::

Pipe LED cascade pattern

31-77

Pipe LED의 cascade mode는 `1 800 2 800 4 800 8 800 16 800`입니다. 다섯 bit가 0.8초 간격으로 하나씩 이동하며 LED 0부터 LED 4까지 순서대로 켜집니다.

Cascade
`0.0~0.8 s`: LED 0 on, mask `1``0.8~1.6 s`: LED 1 on, mask `2``1.6~2.4 s`: LED 2 on, mask `4``2.4~3.2 s`: LED 3 on, mask `8``3.2~4.0 s`: LED 4 on, mask `16`4초 이후 같은 순서 반복

한 개의 켜진 segment가 낮은 index에서 높은 index로 이동합니다.

Inverted cascade는 `30 800 29 800 27 800 23 800 15 800`입니다. 전체 5-bit mask `31`에서 한 bit씩 끄는 complement pattern으로, 각 단계에서 한 LED만 꺼진 상태가 LED 0부터 LED 4까지 이동합니다.

Inverted cascade
`0.0~0.8 s`: LED 0 off, mask `30``0.8~1.6 s`: LED 1 off, mask `29``1.6~2.4 s`: LED 2 off, mask `27``2.4~3.2 s`: LED 3 off, mask `23``3.2~4.0 s`: LED 4 off, mask `15`4초 이후 같은 순서 반복

한 개의 꺼진 segment가 이동하고 나머지 네 segment는 켜집니다.


    "1 800 2 800 4 800 8 800 16 800"

        ^
        |
  0 On -|----+                   +----+                   +---
        |    |                   |    |                   |
    Off-|    +-------------------+    +-------------------+
        |
  1 On -|    +----+                   +----+
        |    |    |                   |    |
    Off |----+    +-------------------+    +------------------
        |
  2 On -|         +----+                   +----+
        |         |    |                   |    |
    Off-|---------+    +-------------------+    +-------------
        |
  3 On -|              +----+                   +----+
        |              |    |                   |    |
    Off-|--------------+    +-------------------+    +--------
        |
  4 On -|                   +----+                   +----+
        |                   |    |                   |    |
    Off-|-------------------+    +-------------------+    +---
        |
        0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)

Inverted cascade mode for Pipe LED::

    "30 800 29 800 27 800 23 800 15 800"

        ^
        |
  0 On -|    +-------------------+    +-------------------+
        |    |                   |    |                   |
    Off-|----+                   +----+                   +---
        |
  1 On -|----+    +-------------------+    +------------------
        |    |    |                   |    |
    Off |    +----+                   +----+
        |
  2 On -|---------+    +-------------------+    +-------------
        |         |    |                   |    |
    Off-|         +----+                   +----+
        |
  3 On -|--------------+    +-------------------+    +--------
        |              |    |                   |    |

Pipe LED bounce pattern

78-140

Bounce mode는 `1 800 2 800 4 800 8 800 16 800 16 800 8 800 4 800 2 800 1 800`입니다. 켜진 segment가 LED 0에서 LED 4로 이동한 뒤 반대 방향으로 돌아옵니다. 끝점 mask를 두 번 유지해 0.8초 slot이 양방향 전환에서 보존됩니다.

Bounce
LED 0 → LED 1 → LED 2 → LED 3 → LED 4LED 4에서 방향 전환LED 4 → LED 3 → LED 2 → LED 1 → LED 0각 상태는 `800 ms` 유지

한 개의 켜진 segment가 왕복합니다.

Inverted bounce는 `30 800 29 800 27 800 23 800 15 800 15 800 23 800 27 800 29 800 30 800`입니다. 꺼진 segment 하나가 LED 0에서 LED 4로 이동한 뒤 되돌아오고, 나머지 segment는 켜진 상태를 유지합니다.

Inverted bounce
LED 0 off → LED 1 off → LED 2 off → LED 3 off → LED 4 offLED 4에서 방향 전환LED 4 off → LED 3 off → LED 2 off → LED 1 off → LED 0 off각 상태는 `800 ms` 유지

한 개의 꺼진 segment가 왕복합니다.

EL15203000 predefined pattern
Mode대상동작
BreathingScreen frame light tube4초 상승 + 4초 하강
CascadePipe LED켜진 segment가 0→4 이동
Inverted cascadePipe LED꺼진 segment가 0→4 이동
BouncePipe LED켜진 segment가 0↔4 왕복
Inverted bouncePipe LED꺼진 segment가 0↔4 왕복

Firmware가 인식하는 mask sequence와 대상 LED입니다.

    Off-|              +----+                   +----+
        |
  4 On -|-------------------+    +-------------------+    +---
        |                   |    |                   |    |
    Off-|                   +----+                   +----+
        |
        0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)

Bounce mode for Pipe LED::

    "1 800 2 800 4 800 8 800 16 800 16 800 8 800 4 800 2 800 1 800"

        ^
        |
  0 On -|----+                                       +--------
        |    |                                       |
    Off-|    +---------------------------------------+
        |
  1 On -|    +----+                             +----+
        |    |    |                             |    |
    Off |----+    +-----------------------------+    +--------
        |
  2 On -|         +----+                   +----+
        |         |    |                   |    |
    Off-|---------+    +-------------------+    +-------------
        |
  3 On -|              +----+         +----+
        |              |    |         |    |
    Off-|--------------+    +---------+    +------------------
        |
  4 On -|                   +---------+
        |                   |         |
    Off-|-------------------+         +-----------------------
        |
        0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)

Inverted bounce mode for Pipe LED::

    "30 800 29 800 27 800 23 800 15 800 15 800 23 800 27 800 29 800 30 800"

        ^
        |
  0 On -|    +---------------------------------------+
        |    |                                       |
    Off-|----+                                       +--------
        |
  1 On -|----+    +-----------------------------+    +--------
        |    |    |                             |    |
    Off |    +----+                             +----+
        |
  2 On -|---------+    +-------------------+    +-------------
        |         |    |                   |    |
    Off-|         +----+                   +----+
        |
  3 On -|--------------+    +---------+    +------------------
        |              |    |         |    |
    Off-|              +----+         +----+
        |
  4 On -|-------------------+         +-----------------------
        |                   |         |
    Off-|                   +---------+
        |
        0---0.8--1.6--2.4--3.2---4---4.8--5.6--6.4--7.2---8--> time (sec)