요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Segment color and custom programs
sysfs-class-chromeos-driver-cros-ec-lightbar:26-49LED·RGB 정수 4개 tuple로 개별 또는 전체 segment를 갱신하고 custom sequence를 upload·run합니다.
Built-in sequence and userspace control
sysfs-class-chromeos-driver-cros-ec-lightbar:51-74현재 built-in sequence의 read/write, kernel normal sequence 억제와 lightbar version 정보를 제공합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/chromeos/<ec-device-name>/lightbar/brightness
2
Date: August 2015
3
KernelVersion: 4.2
4
Description:
5
Writing to this file adjusts the overall brightness of
6
the lightbar, separate from any color intensity. The
7
valid range is 0 (off) to 255 (maximum brightness).
9
What: /sys/class/chromeos/<ec-device-name>/lightbar/interval_msec
10
Date: August 2015
11
KernelVersion: 4.2
12
Description:
13
The lightbar is controlled by an embedded controller (EC),
14
which also manages the keyboard, battery charging, fans,
15
and other system hardware. To prevent unprivileged users
16
from interfering with the other EC functions, the rate at
17
which the lightbar control files can be read or written is
18
limited.
20
Reading this file will return the number of milliseconds
21
that must elapse between accessing any of the lightbar
22
functions through this interface. Going faster will simply
23
block until the necessary interval has lapsed. The interval
24
applies uniformly to all accesses of any kind by any user.
26
What: /sys/class/chromeos/<ec-device-name>/lightbar/led_rgb
27
Date: August 2015
28
KernelVersion: 4.2
29
Description:
30
This allows you to control each LED segment. If the
31
lightbar is already running one of the automatic
32
sequences, you probably won’t see anything change because
33
your color setting will be almost immediately replaced.
34
To get useful results, you should stop the lightbar
35
sequence first.
37
The values written to this file are sets of four integers,
38
indicating LED, RED, GREEN, BLUE. The LED number is 0 to 3
39
to select a single segment, or 4 to set all four segments
40
to the same value at once. The RED, GREEN, and BLUE
41
numbers should be in the range 0 (off) to 255 (maximum).
42
You can update more than one segment at a time by writing
43
more than one set of four integers.
45
What: /sys/class/chromeos/<ec-device-name>/lightbar/program
46
Date: August 2015
47
KernelVersion: 4.2
48
Description:
49
This allows you to upload and run custom lightbar sequences.
51
What: /sys/class/chromeos/<ec-device-name>/lightbar/sequence
52
Date: August 2015
53
KernelVersion: 4.2
54
Description:
55
The Pixel lightbar has a number of built-in sequences
56
that it displays under various conditions, such as at
57
power on, shut down, or while running. Reading from this
58
file displays the current sequence that the lightbar is
59
displaying. Writing to this file allows you to change the
60
sequence.
62
What: /sys/class/chromeos/<ec-device-name>/lightbar/userspace_control
63
Date: August 2015
64
KernelVersion: 4.2
65
Description:
66
This allows you to take the control of the lightbar. This
67
prevents the kernel from going through its normal
68
sequences.
70
What: /sys/class/chromeos/<ec-device-name>/lightbar/version
71
Date: August 2015
72
KernelVersion: 4.2
73
Description:
74
Show the information about the lightbar version.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Lightbar 전체 brightness
1-7| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/brightness |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | 이 file에 쓰면 color intensity와 별개로 lightbar 전체 brightness를 조정합니다. 유효 범위는 0(off)-255(maximum brightness)입니다. |
Lightbar access rate limit
9-24| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/interval_msec |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | Lightbar는 keyboard, battery charging, fan 및 다른 system hardware도 관리하는 embedded controller(EC)가 제어합니다. 권한 없는 user가 다른 EC 기능을 방해하지 못하도록 lightbar control file의 read·write rate를 제한합니다. 읽으면 이 interface를 통해 어느 lightbar function에든 접근한 뒤 다음 접근까지 지나야 하는 millisecond 수를 반환합니다. 더 빠르게 접근하면 필요한 interval이 지날 때까지 block합니다. 이 interval은 모든 user의 모든 종류 접근에 동일하게 적용됩니다. |
Lightbar segment RGB 제어
26-43| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/led_rgb |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | 각 LED segment를 제어합니다. Lightbar가 automatic sequence를 실행 중이면 color setting이 거의 즉시 대체되어 변화가 보이지 않을 가능성이 높으므로 먼저 sequence를 중지해야 합니다. 쓸 값은 LED, RED, GREEN, BLUE를 나타내는 정수 4개 묶음입니다. LED 번호 0-3은 개별 segment를 선택하고 4는 네 segment 모두를 한 번에 같은 값으로 설정합니다. RED·GREEN·BLUE는 각각 0(off)-255(maximum) 범위입니다. 정수 4개 묶음을 여러 개 쓰면 한 번에 여러 segment를 갱신할 수 있습니다. |
필드값의미
LED0-3개별 segment 선택
LED4네 segment 모두 선택
RED0-255Red intensity
GREEN0-255Green intensity
BLUE0-255Blue intensity
각 4-integer tuple의 필드와 유효 범위입니다.
Custom lightbar sequence program
45-49| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/program |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | Custom lightbar sequence를 upload하고 실행할 수 있습니다. |
Built-in lightbar sequence
51-60| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/sequence |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | Pixel lightbar에는 power-on, shutdown 또는 실행 중 같은 여러 조건에서 표시하는 built-in sequence가 있습니다. 읽으면 현재 표시 중인 sequence를 보여 주고, 쓰면 sequence를 변경할 수 있습니다. |
Userspace lightbar control
62-68| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/userspace_control |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | Lightbar control을 가져올 수 있으며 kernel이 normal sequence를 진행하지 못하게 합니다. |
Lightbar version 정보
70-74| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/chromeos/<ec-device-name>/lightbar/version |
| Date | 2015년 8월 |
| KernelVersion | 4.2 |
| Description | Lightbar version에 대한 정보를 표시합니다. |
Brightness and EC access rate
sysfs-class-chromeos-driver-cros-ec-lightbar:1-240-255 전체 brightness와 EC의 다른 기능을 보호하기 위한 모든 user·operation 공통 millisecond access interval을 정의합니다.