← Documents 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 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

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

요약·해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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)