← Documents Documentation/ABI/testing/sysfs-driver-toshiba_acpi GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Toshiba laptop ACPI sysfs ABI

Toshiba laptop의 keyboard backlight·hotkeys, accelerometer·touchpad, USB sleep/rapid charging, fan·panel·USB3와 cooling method controls를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-driver-toshiba_acpi
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Keyboard-backlight mode and timeout

sysfs-driver-toshiba_acpi:1-32

kbd_backlight_mode는 FN-Z·AUTO/TIMER·ON·OFF를 선택하고 timeout은 keyboard type과 kernel version에 따라 0~60 또는 1~60 범위를 사용합니다.

Accelerometer, touchpad and keyboard type

sysfs-driver-toshiba_acpi:33-78

position은 built-in accelerometer를 읽고 touchpad는 pointing stick까지 함께 제어하며, available_kbd_modes와 kbd_type이 지원 backlight capabilities를 설명합니다.

USB sleep-charge and battery policy

sysfs-driver-toshiba_acpi:79-142

USB Sleep & Charge mode, battery threshold, Rapid Charge와 Sleep & Music을 제어하며 일부 기능은 AC power 또는 reboot 조건이 있습니다.

Driver, fan, hotkey and panel controls

sysfs-driver-toshiba_acpi:143-191

Driver version을 읽고 internal fan, F-key hotkey behavior와 lid-open panel power-on을 제어합니다.

USB 3 and cooling method

sysfs-driver-toshiba_acpi:192-223

usb_three은 USB2 fallback과 full USB3를 선택하고 cooling_method는 maximum capability에 따라 performance·battery-optimized levels를 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_mode
2 Date: June 8, 2014
3 KernelVersion: 3.15
4 Contact: Azael Avalos <coproscefalo@gmail.com>
5 Description: This file controls the keyboard backlight operation mode, valid
6 values are:
7
8 * 0x1 -> FN-Z
9 * 0x2 -> AUTO (also called TIMER)
10 * 0x8 -> ON
11 * 0x10 -> OFF
12
13 Note that from kernel 3.16 onwards this file accepts all listed
14 parameters, kernel 3.15 only accepts the first two (FN-Z and
15 AUTO).
16 Also note that toggling this value on type 1 devices, requires
17 a reboot for changes to take effect.
18 Users: KToshiba
19
20 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_timeout
21 Date: June 8, 2014
22 KernelVersion: 3.15
23 Contact: Azael Avalos <coproscefalo@gmail.com>
24 Description: This file controls the timeout of the keyboard backlight
25 whenever the operation mode is set to AUTO (or TIMER),
26 valid values range from 0-60.
27 Note that the kernel 3.15 only had support for the first
28 keyboard type, the kernel 3.16 added support for the second
29 type and the range accepted for type 2 is 1-60.
30 See the entry named "kbd_type"
31 Users: KToshiba
32
33 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/position
34 Date: June 8, 2014
35 KernelVersion: 3.15
36 Contact: Azael Avalos <coproscefalo@gmail.com>
37 Description: This file shows the absolute position of the built-in
38 accelereometer.
39
40 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/touchpad
41 Date: June 8, 2014
42 KernelVersion: 3.15
43 Contact: Azael Avalos <coproscefalo@gmail.com>
44 Description: This files controls the status of the touchpad and pointing
45 stick (if available), valid values are:
46
47 * 0 -> OFF
48 * 1 -> ON
49
50 Users: KToshiba
51
52 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/available_kbd_modes
53 Date: August 3, 2014
54 KernelVersion: 3.16
55 Contact: Azael Avalos <coproscefalo@gmail.com>
56 Description: This file shows the supported keyboard backlight modes
57 the system supports, which can be:
58
59 * 0x1 -> FN-Z
60 * 0x2 -> AUTO (also called TIMER)
61 * 0x8 -> ON
62 * 0x10 -> OFF
63
64 Note that not all keyboard types support the listed modes.
65 See the entry named "available_kbd_modes"
66 Users: KToshiba
67
68 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_type
69 Date: August 3, 2014
70 KernelVersion: 3.16
71 Contact: Azael Avalos <coproscefalo@gmail.com>
72 Description: This file shows the current keyboard backlight type,
73 which can be:
74
75 * 1 -> Type 1, supporting modes FN-Z and AUTO
76 * 2 -> Type 2, supporting modes TIMER, ON and OFF
77 Users: KToshiba
78
79 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_charge
80 Date: January 23, 2015
81 KernelVersion: 4.0
82 Contact: Azael Avalos <coproscefalo@gmail.com>
83 Description: This file controls the USB Sleep & Charge charging mode, which
84 can be:
85
86 * 0 -> Disabled (0x00)
87 * 1 -> Alternate (0x09)
88 * 2 -> Auto (0x21)
89 * 3 -> Typical (0x11)
90
91 Note that from kernel 4.1 onwards this file accepts all listed
92 values, kernel 4.0 only supports the first three.
93 Note that this feature only works when connected to power, if
94 you want to use it under battery, see the entry named
95 "sleep_functions_on_battery"
96 Users: KToshiba
97
98 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/sleep_functions_on_battery
99 Date: January 23, 2015
100 KernelVersion: 4.0
101 Contact: Azael Avalos <coproscefalo@gmail.com>
102 Description: This file controls the USB Sleep Functions under battery, and
103 set the level at which point they will be disabled, accepted
104 values can be:
105
106 * 0 -> Disabled
107 * 1-100 -> Battery level to disable sleep functions
108
109 Currently it prints two values, the first one indicates if the
110 feature is enabled or disabled, while the second one shows the
111 current battery level set.
112 Note that when the value is set to disabled, the sleep function
113 will only work when connected to power.
114 Users: KToshiba
115
116 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_rapid_charge
117 Date: January 23, 2015
118 KernelVersion: 4.0
119 Contact: Azael Avalos <coproscefalo@gmail.com>
120 Description: This file controls the USB Rapid Charge state, which can be:
121
122 * 0 -> Disabled
123 * 1 -> Enabled
124
125 Note that toggling this value requires a reboot for changes to
126 take effect.
127 Users: KToshiba
128
129 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_music
130 Date: January 23, 2015
131 KernelVersion: 4.0
132 Contact: Azael Avalos <coproscefalo@gmail.com>
133 Description: This file controls the Sleep & Music state, which values can be:
134
135 * 0 -> Disabled
136 * 1 -> Enabled
137
138 Note that this feature only works when connected to power, if
139 you want to use it under battery, see the entry named
140 "sleep_functions_on_battery"
141 Users: KToshiba
142
143 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/version
144 Date: February 12, 2015
145 KernelVersion: 4.0
146 Contact: Azael Avalos <coproscefalo@gmail.com>
147 Description: This file shows the current version of the driver
148 Users: KToshiba
149
150 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/fan
151 Date: February 12, 2015
152 KernelVersion: 4.0
153 Contact: Azael Avalos <coproscefalo@gmail.com>
154 Description: This file controls the state of the internal fan, valid
155 values are:
156
157 * 0 -> OFF
158 * 1 -> ON
159
160 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_function_keys
161 Date: February 12, 2015
162 KernelVersion: 4.0
163 Contact: Azael Avalos <coproscefalo@gmail.com>
164 Description: This file controls the Special Functions (hotkeys) operation
165 mode, valid values are:
166
167 * 0 -> Normal Operation
168 * 1 -> Special Functions
169
170 In the "Normal Operation" mode, the F{1-12} keys are as usual
171 and the hotkeys are accessed via FN-F{1-12}.
172 In the "Special Functions" mode, the F{1-12} keys trigger the
173 hotkey and the F{1-12} keys are accessed via FN-F{1-12}.
174 Note that toggling this value requires a reboot for changes to
175 take effect.
176 Users: KToshiba
177
178 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/panel_power_on
179 Date: February 12, 2015
180 KernelVersion: 4.0
181 Contact: Azael Avalos <coproscefalo@gmail.com>
182 Description: This file controls whether the laptop should turn ON whenever
183 the LID is opened, valid values are:
184
185 * 0 -> Disabled
186 * 1 -> Enabled
187
188 Note that toggling this value requires a reboot for changes to
189 take effect.
190 Users: KToshiba
191
192 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_three
193 Date: February 12, 2015
194 KernelVersion: 4.0
195 Contact: Azael Avalos <coproscefalo@gmail.com>
196 Description: This file controls the USB 3 functionality, valid values are:
197
198 * 0 -> Disabled (Acts as a regular USB 2)
199 * 1 -> Enabled (Full USB 3 functionality)
200
201 Note that toggling this value requires a reboot for changes to
202 take effect.
203 Users: KToshiba
204
205 What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/cooling_method
206 Date: 2016
207 KernelVersion: 4.6
208 Contact: Azael Avalos <coproscefalo@gmail.com>
209 Description: This file controls the Cooling Method feature.
210 Reading this file prints two values, the first is the actual cooling method
211 and the second is the maximum cooling method supported.
212 When the maximum cooling method is ONE, valid values are:
213
214 * 0 -> Maximum Performance
215 * 1 -> Battery Optimized
216
217 When the maximum cooling method is TWO, valid values are:
218
219 * 0 -> Maximum Performance
220 * 1 -> Performance
221 * 2 -> Battery Optimized
222
223 Users: KToshiba
224

3. 한국어 전문 번역

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

Keyboard-backlight operation mode

1-19
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_mode
Date2014년 6월 8일
KernelVersion3.15
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionKeyboard backlight operation mode를 제어합니다. Valid values는 0x1=FN-Z, 0x2=AUTO(TIMER라고도 함), 0x8=ON, 0x10=OFF입니다. Kernel 3.16부터는 이 values를 모두 받아들이지만 kernel 3.15는 처음 두 값인 FN-Z와 AUTO만 받습니다. Type 1 devices에서 이 값을 toggle하면 change가 적용되기 위해 reboot가 필요합니다.
AccessRead-write
UsersKToshiba
Toshiba keyboard-backlight modes
ValueModeAvailability
0x1FN-ZKernel 3.15+
0x2AUTO / TIMERKernel 3.15+
0x8ONKernel 3.16+
0x10OFFKernel 3.16+

Mode values와 kernel·keyboard-type restrictions를 정리했습니다.

Keyboard-backlight timeout

20-32
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_timeout
Date2014년 6월 8일
KernelVersion3.15
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionOperation mode가 AUTO 또는 TIMER일 때 keyboard backlight timeout을 제어합니다. Valid range는 0~60입니다. Kernel 3.15는 첫 번째 keyboard type만 지원했고 kernel 3.16은 두 번째 type 지원을 추가했으며 type 2가 받는 범위는 1~60입니다. "kbd_type" entry를 참조하십시오.
AccessRead-write
Values0..60; type 2 accepts 1..60
UsersKToshiba

Built-in accelerometer position

33-39
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/position
Date2014년 6월 8일
KernelVersion3.15
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionBuilt-in accelerometer의 absolute position을 표시합니다.
AccessRead-only

Touchpad and pointing-stick state

40-51
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/touchpad
Date2014년 6월 8일
KernelVersion3.15
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionTouchpad와 available한 경우 pointing stick의 status를 제어합니다. 0은 OFF, 1은 ON입니다.
AccessRead-write
Values0 = OFF; 1 = ON
UsersKToshiba
Toshiba binary platform controls
Attribute01Reboot noted
touchpadOFFONNo
usb_rapid_chargeDisabledEnabledYes
usb_sleep_musicDisabledEnabledNo
fanOFFONNo
panel_power_onDisabledEnabledYes
usb_threeUSB 2 modeFull USB 3Yes

0/1 값을 사용하는 input, charging, fan, panel과 USB controls입니다.

Available keyboard-backlight modes

52-67
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/available_kbd_modes
Date2014년 8월 3일
KernelVersion3.16
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionSystem이 지원하는 keyboard backlight modes를 표시합니다. 가능한 값은 0x1=FN-Z, 0x2=AUTO(TIMER라고도 함), 0x8=ON, 0x10=OFF입니다. 모든 keyboard type이 나열된 modes를 전부 지원하는 것은 아닙니다. 원문은 "available_kbd_modes"라는 entry를 참조하라고 명시합니다.
AccessRead-only
UsersKToshiba

Keyboard-backlight hardware type

68-78
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_type
Date2014년 8월 3일
KernelVersion3.16
ContactAzael Avalos <coproscefalo@gmail.com>
Description현재 keyboard backlight type을 표시합니다. 1은 FN-Z와 AUTO modes를 지원하는 Type 1이고, 2는 TIMER, ON, OFF modes를 지원하는 Type 2입니다.
AccessRead-only
UsersKToshiba
Toshiba keyboard-backlight types
TypeSupported modesTimeout range
1FN-Z, AUTO0..60
2TIMER, ON, OFF1..60

두 hardware types의 mode와 timeout support를 비교합니다.

USB Sleep & Charge mode

79-97
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_charge
Date2015년 1월 23일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionUSB Sleep & Charge charging mode를 제어합니다. 값은 0=Disabled(0x00), 1=Alternate(0x09), 2=Auto(0x21), 3=Typical(0x11)입니다. Kernel 4.1부터는 모든 값을 받지만 kernel 4.0은 처음 세 값만 지원합니다. 이 feature는 power에 연결된 경우에만 동작합니다. Battery에서 사용하려면 "sleep_functions_on_battery" entry를 참조하십시오.
AccessRead-write
UsersKToshiba
USB Sleep & Charge modes
ValueModeFirmware valueKernel support
0Disabled0x004.0+
1Alternate0x094.0+
2Auto0x214.0+
3Typical0x114.1+

User value, firmware value와 kernel-version support를 대응시켰습니다.

USB sleep functions on battery

98-115
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/sleep_functions_on_battery
Date2015년 1월 23일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionBattery 사용 중 USB Sleep Functions를 제어하고 이를 disable할 battery level을 설정합니다. 0은 Disabled, 1~100은 sleep functions를 disable할 battery level입니다. 현재 두 값을 출력하며 첫 번째는 feature enabled/disabled state, 두 번째는 설정된 current battery level입니다. Disabled로 설정하면 sleep function은 power에 연결된 경우에만 동작합니다.
AccessRead-write
Values0 = disabled; 1..100 = disable threshold
UsersKToshiba
USB sleep-function power policy
Write 0 to disable battery operationSleep function then works only while connected to powerOr write threshold from 1 to 100Feature works on battery until configured disable levelRead enabled state and current threshold as two values

AC-only mode와 battery threshold mode의 동작을 구분합니다.

USB Rapid Charge state

116-128
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_rapid_charge
Date2015년 1월 23일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionUSB Rapid Charge state를 제어합니다. 0은 Disabled, 1은 Enabled입니다. 이 값을 toggle한 뒤 change를 적용하려면 reboot가 필요합니다.
AccessRead-write
Values0 = Disabled; 1 = Enabled
UsersKToshiba

USB Sleep & Music state

129-142
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_sleep_music
Date2015년 1월 23일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionSleep & Music state를 제어합니다. 0은 Disabled, 1은 Enabled입니다. 이 feature는 power에 연결된 경우에만 동작합니다. Battery에서 사용하려면 "sleep_functions_on_battery" entry를 참조하십시오.
AccessRead-write
Values0 = Disabled; 1 = Enabled
UsersKToshiba

Toshiba ACPI driver version

143-149
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/version
Date2015년 2월 12일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionDriver의 current version을 표시합니다.
AccessRead-only
UsersKToshiba

Internal fan state

150-159
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/fan
Date2015년 2월 12일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionInternal fan의 state를 제어합니다. 0은 OFF, 1은 ON입니다.
AccessRead-write
Values0 = OFF; 1 = ON

Keyboard function-key mode

160-177
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_function_keys
Date2015년 2월 12일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionSpecial Functions(hotkeys) operation mode를 제어합니다. 0은 Normal Operation, 1은 Special Functions입니다. Normal Operation에서는 F{1-12} keys가 평소처럼 동작하고 FN-F{1-12}로 hotkeys에 접근합니다. Special Functions에서는 F{1-12} keys가 hotkey를 trigger하고 FN-F{1-12}로 원래 F{1-12} keys에 접근합니다. 이 값을 toggle한 뒤 change를 적용하려면 reboot가 필요합니다.
AccessRead-write
UsersKToshiba
Toshiba function-key modes
ValueModeF1..F12FN-F1..F12
0Normal OperationNormal F-keyHotkey
1Special FunctionsHotkeyNormal F-key

F-key와 FN-F-key가 normal functions와 hotkeys에 매핑되는 방식입니다.

Power on when lid opens

178-191
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/panel_power_on
Date2015년 2월 12일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionLID를 열 때 laptop이 ON으로 켜질지를 제어합니다. 0은 Disabled, 1은 Enabled입니다. 이 값을 toggle한 뒤 change를 적용하려면 reboot가 필요합니다.
AccessRead-write
Values0 = Disabled; 1 = Enabled
UsersKToshiba

USB 3 functionality

192-204
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_three
Date2015년 2월 12일
KernelVersion4.0
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionUSB 3 functionality를 제어합니다. 0은 Disabled이며 regular USB 2로 동작하고, 1은 Enabled이며 full USB 3 functionality를 제공합니다. 이 값을 toggle한 뒤 change를 적용하려면 reboot가 필요합니다.
AccessRead-write
Values0 = USB 2 mode; 1 = full USB 3
UsersKToshiba

Cooling-method policy

205-223
항목한국어 전문 번역
What/sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/cooling_method
Date2016년
KernelVersion4.6
ContactAzael Avalos <coproscefalo@gmail.com>
DescriptionCooling Method feature를 제어합니다. 이 file을 읽으면 두 값을 출력하며 첫 번째는 actual cooling method, 두 번째는 지원되는 maximum cooling method입니다. Maximum cooling method가 ONE이면 0=Maximum Performance, 1=Battery Optimized입니다. Maximum cooling method가 TWO이면 0=Maximum Performance, 1=Performance, 2=Battery Optimized입니다.
AccessRead-write
UsersKToshiba
Toshiba cooling-method values
Maximum methodValue 0Value 1Value 2
ONEMaximum PerformanceBattery OptimizedNot valid
TWOMaximum PerformancePerformanceBattery Optimized

Maximum supported method에 따라 valid policy values가 달라집니다.