← Documents Documentation/ABI/testing/sysfs-platform-dell-laptop GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Dell keyboard backlight sysfs ABI

Dell keyboard backlight의 ambient-light auto mode, threshold, activity triggers와 inactivity timeout을 제어합니다.

Source pathDocumentation/ABI/testing/sysfs-platform-dell-laptop
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Ambient-light 자동 조명

sysfs-platform-dell-laptop:1-20

Ambient light sensor 기반 auto mode와 on/off threshold를 별도로 설정합니다.

Activity triggers와 timeout

sysfs-platform-dell-laptop:21-73

Backlight를 다시 켜는 input source와 inactivity 후 끄는 시간 단위를 명시적으로 제어합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/class/leds/dell::kbd_backlight/als_enabled
2 Date: December 2014
3 KernelVersion: 3.19
4 Contact: Gabriele Mazzotta <[email protected]>,
5 Pali Rohár <[email protected]>
6 Description:
7 This file allows to control the automatic keyboard
8 illumination mode on some systems that have an ambient
9 light sensor. Write 1 to this file to enable the auto
10 mode, 0 to disable it.
11
12 What: /sys/class/leds/dell::kbd_backlight/als_setting
13 Date: December 2014
14 KernelVersion: 3.19
15 Contact: Gabriele Mazzotta <[email protected]>,
16 Pali Rohár <[email protected]>
17 Description:
18 This file allows to specify the on/off threshold value,
19 as reported by the ambient light sensor.
20
21 What: /sys/class/leds/dell::kbd_backlight/start_triggers
22 Date: December 2014
23 KernelVersion: 3.19
24 Contact: Gabriele Mazzotta <[email protected]>,
25 Pali Rohár <[email protected]>
26 Description:
27 This file allows to control the input triggers that
28 turn on the keyboard backlight illumination that is
29 disabled because of inactivity.
30 Read the file to see the triggers available. The ones
31 enabled are preceded by '+', those disabled by '-'.
32
33 To enable a trigger, write its name preceded by '+' to
34 this file. To disable a trigger, write its name preceded
35 by '-' instead.
36
37 For example, to enable the keyboard as trigger run::
38
39 echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
40
41 To disable it::
42
43 echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
44
45 Note that not all the available triggers can be configured.
46
47 What: /sys/class/leds/dell::kbd_backlight/stop_timeout
48 Date: December 2014
49 KernelVersion: 3.19
50 Contact: Gabriele Mazzotta <[email protected]>,
51 Pali Rohár <[email protected]>
52 Description:
53 This file allows to specify the interval after which the
54 keyboard illumination is disabled because of inactivity.
55 The timeouts are expressed in seconds, minutes, hours and
56 days, for which the symbols are 's', 'm', 'h' and 'd'
57 respectively.
58
59 To configure the timeout, write to this file a value along
60 with any the above units. If no unit is specified, the value
61 is assumed to be expressed in seconds.
62
63 For example, to set the timeout to 10 minutes run::
64
65 echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout
66
67 Note that when this file is read, the returned value might be
68 expressed in a different unit than the one used when the timeout
69 was set.
70
71 Also note that only some timeouts are supported and that
72 some systems might fall back to a specific timeout in case
73 an invalid timeout is written to this file.
74

3. 한국어 전문 번역

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

Dell keyboard backlight sysfs ABI: als enabled

1-11
항목한국어 전문 번역
What/sys/class/leds/dell::kbd_backlight/als_enabled
Date2014년 12월
KernelVersion3.19
ContactGabriele Mazzotta <[email protected]>, Pali Rohár <[email protected]>
Description`/sys/class/leds/dell::kbd_backlight/als_enabled`는 ambient light sensor가 있는 일부 systems의 automatic keyboard illumination mode를 제어합니다. `1`을 write하면 auto mode가 enable되고 `0`을 write하면 disable됩니다.

Dell keyboard backlight sysfs ABI: als setting

12-20
항목한국어 전문 번역
What/sys/class/leds/dell::kbd_backlight/als_setting
Date2014년 12월
KernelVersion3.19
ContactGabriele Mazzotta <[email protected]>, Pali Rohár <[email protected]>
Description`/sys/class/leds/dell::kbd_backlight/als_setting`은 ambient light sensor가 보고하는 on/off threshold value를 지정합니다.

Dell keyboard backlight sysfs ABI: start triggers

21-46
항목한국어 전문 번역
What/sys/class/leds/dell::kbd_backlight/start_triggers
Date2014년 12월
KernelVersion3.19
ContactGabriele Mazzotta <[email protected]>, Pali Rohár <[email protected]>
Description`/sys/class/leds/dell::kbd_backlight/start_triggers`는 inactivity 때문에 꺼진 keyboard backlight를 다시 켜는 input triggers를 제어합니다. Read하면 available triggers가 표시되고 enable된 trigger 앞에는 `+`, disable된 trigger 앞에는 `-`가 붙습니다. Enable하려면 trigger name 앞에 `+`를 붙여 write하고 disable하려면 `-`를 붙여 write합니다. 예를 들어 keyboard trigger enable은 `echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers`, disable은 `echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers`입니다. Available triggers가 모두 configurable한 것은 아닙니다.
Keyboard backlight trigger syntax
PrefixRead meaningWrite action
+Trigger enabledEnable named trigger
-Trigger disabledDisable named trigger

Read 표시와 write command에서 `+`와 `-`가 같은 enable state를 나타냅니다.

echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers

Dell keyboard backlight sysfs ABI: stop timeout

47-73
항목한국어 전문 번역
What/sys/class/leds/dell::kbd_backlight/stop_timeout
Date2014년 12월
KernelVersion3.19
ContactGabriele Mazzotta <[email protected]>, Pali Rohár <[email protected]>
Description`/sys/class/leds/dell::kbd_backlight/stop_timeout`은 inactivity 때문에 keyboard illumination을 disable할 때까지의 interval을 지정합니다. Seconds, minutes, hours, days의 symbols는 각각 `s`, `m`, `h`, `d`입니다. Value와 unit을 함께 write하며 unit이 없으면 seconds로 간주합니다. 10 minutes는 `echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout`으로 설정합니다. Read할 때 반환되는 unit은 설정에 사용한 unit과 다를 수 있습니다. 일부 timeouts만 지원되며 invalid timeout을 write하면 특정 timeout으로 fallback하는 systems도 있습니다.
Keyboard backlight timeout units
SymbolUnit
sSeconds
mMinutes
hHours
dDays
No suffixSeconds

Unit을 생략하면 seconds로 해석하며 readback unit은 write 때와 달라질 수 있습니다.

echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout