요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Authorization, secure key, identity, and link lanes
sysfs-bus-thunderbolt:64-203장치 authorization과 secure challenge, DROM identity, UUID·UID, RX/TX lane 정보 및 NVM version을 제공합니다.
NVM validation, flush, and authentication
sysfs-bus-thunderbolt:204-245NVM image는 검증·flush·authentication을 분리하거나 결합할 수 있고 지원 장치는 disconnect 시 자동 인증을 준비할 수 있습니다.
XDomain service protocol metadata
sysfs-bus-thunderbolt:246-295XDomain service는 예약 protocol key, MODALIAS, protocol·software version과 service-specific bitmask를 제공합니다.
Type-C connector, link, offline mode, and rescan
sysfs-bus-thunderbolt:296-338USB4 port는 connector symlink와 link mode를 제공하며 cable이 없는 조건에서 onboard retimer NVM 작업용 offline/rescan을 지원합니다.
Retimer identity and NVM firmware
sysfs-bus-thunderbolt:339-370각 retimer는 hardware device·vendor ID와 NVM version, non-active image authentication 상태를 노출합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/thunderbolt/devices/.../domainX/boot_acl
2
Date: Jun 2018
3
KernelVersion: 4.17
4
Contact: Mika Westerberg <[email protected]>
5
Description: Holds a comma separated list of device unique_ids that
6
are allowed to be connected automatically during system
7
startup (e.g boot devices). The list always contains
8
maximum supported number of unique_ids where unused
9
entries are empty. This allows the userspace software
10
to determine how many entries the controller supports.
11
If there are multiple controllers, each controller has
12
its own ACL list and size may be different between the
13
controllers.
15
System BIOS may have an option "Preboot ACL" or similar
16
that needs to be selected before this list is taken into
17
consideration.
19
Software always updates a full list in each write.
21
If a device is authorized automatically during boot its
22
boot attribute is set to 1.
24
What: /sys/bus/thunderbolt/devices/.../domainX/deauthorization
25
Date: May 2021
26
KernelVersion: 5.12
27
Contact: Mika Westerberg <[email protected]>
28
Description: This attribute tells whether the system supports
29
de-authorization of devices. Value of 1 means user can
30
de-authorize PCIe tunnel by writing 0 to authorized
31
attribute under each device.
33
What: /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection
34
Date: Mar 2019
35
KernelVersion: 4.21
36
Contact: Mika Westerberg <[email protected]>
37
Description: This attribute tells whether the system uses IOMMU
38
for DMA protection. Value of 1 means IOMMU is used 0 means
39
it is not (DMA protection is solely based on Thunderbolt
40
security levels).
42
What: /sys/bus/thunderbolt/devices/.../domainX/security
43
Date: Sep 2017
44
KernelVersion: 4.13
45
Contact: Mika Westerberg <[email protected]>
46
Description: This attribute holds current Thunderbolt security level
47
set by the system BIOS. Possible values are:
49
======= ==================================================
50
none All devices are automatically authorized
51
user Devices are only authorized based on writing
52
appropriate value to the authorized attribute
53
secure Require devices that support secure connect at
54
minimum. User needs to authorize each device.
55
dponly Automatically tunnel Display port (and USB). No
56
PCIe tunnels are created.
57
usbonly Automatically tunnel USB controller of the
58
connected Thunderbolt dock (and Display Port). All
59
PCIe links downstream of the dock are removed.
60
nopcie USB4 system where PCIe tunneling is disabled from
61
the BIOS.
62
======= ==================================================
64
What: /sys/bus/thunderbolt/devices/.../authorized
65
Date: Sep 2017
66
KernelVersion: 4.13
67
Contact: Mika Westerberg <[email protected]>
68
Description: This attribute is used to authorize Thunderbolt devices
69
after they have been connected. If the device is not
70
authorized, no PCIe devices are available to the system.
72
Contents of this attribute will be 0 when the device is not
73
yet authorized.
75
Possible values are supported:
77
== ===================================================
78
0 The device will be de-authorized (only supported if
79
deauthorization attribute under domain contains 1)
80
1 The device will be authorized and connected
81
== ===================================================
83
When key attribute contains 32 byte hex string the possible
84
values are:
86
== ========================================================
87
0 The device will be de-authorized (only supported if
88
deauthorization attribute under domain contains 1)
89
1 The 32 byte hex string is added to the device NVM and
90
the device is authorized.
91
2 Send a challenge based on the 32 byte hex string. If the
92
challenge response from device is valid, the device is
93
authorized. In case of failure errno will be ENOKEY if
94
the device did not contain a key at all, and
95
EKEYREJECTED if the challenge response did not match.
96
== ========================================================
98
What: /sys/bus/thunderbolt/devices/.../boot
99
Date: Jun 2018
100
KernelVersion: 4.17
101
Contact: Mika Westerberg <[email protected]>
102
Description: This attribute contains 1 if Thunderbolt device was already
103
authorized on boot and 0 otherwise.
105
What: /sys/bus/thunderbolt/devices/.../generation
106
Date: Jan 2020
107
KernelVersion: 5.5
108
Contact: Christian Kellner <[email protected]>
109
Description: This attribute contains the generation of the Thunderbolt
110
controller associated with the device. It will contain 4
111
for USB4.
113
What: /sys/bus/thunderbolt/devices/.../key
114
Date: Sep 2017
115
KernelVersion: 4.13
116
Contact: Mika Westerberg <[email protected]>
117
Description: When a devices supports Thunderbolt secure connect it will
118
have this attribute. Writing 32 byte hex string changes
119
authorization to use the secure connection method instead.
120
Writing an empty string clears the key and regular connection
121
method can be used again.
123
What: /sys/bus/thunderbolt/devices/.../device
124
Date: Sep 2017
125
KernelVersion: 4.13
126
Contact: Mika Westerberg <[email protected]>
127
Description: This attribute contains id of this device extracted from
128
the device DROM.
130
What: /sys/bus/thunderbolt/devices/.../device_name
131
Date: Sep 2017
132
KernelVersion: 4.13
133
Contact: Mika Westerberg <[email protected]>
134
Description: This attribute contains name of this device extracted from
135
the device DROM.
137
What: /sys/bus/thunderbolt/devices/.../maxhopid
138
Date: Jul 2021
139
KernelVersion: 5.13
140
Contact: Mika Westerberg <[email protected]>
141
Description: Only set for XDomains. The maximum HopID the other host
142
supports as its input HopID.
144
What: /sys/bus/thunderbolt/devices/.../rx_speed
145
Date: Jan 2020
146
KernelVersion: 5.5
147
Contact: Mika Westerberg <[email protected]>
148
Description: This attribute reports the device RX speed per lane.
149
All RX lanes run at the same speed.
151
What: /sys/bus/thunderbolt/devices/.../rx_lanes
152
Date: Jan 2020
153
KernelVersion: 5.5
154
Contact: Mika Westerberg <[email protected]>
155
Description: This attribute reports number of RX lanes the device is
156
using simultaneously through its upstream port.
158
What: /sys/bus/thunderbolt/devices/.../tx_speed
159
Date: Jan 2020
160
KernelVersion: 5.5
161
Contact: Mika Westerberg <[email protected]>
162
Description: This attribute reports the TX speed per lane.
163
All TX lanes run at the same speed.
165
What: /sys/bus/thunderbolt/devices/.../tx_lanes
166
Date: Jan 2020
167
KernelVersion: 5.5
168
Contact: Mika Westerberg <[email protected]>
169
Description: This attribute reports number of TX lanes the device is
170
using simultaneously through its upstream port.
172
What: /sys/bus/thunderbolt/devices/.../vendor
173
Date: Sep 2017
174
KernelVersion: 4.13
175
Contact: Mika Westerberg <[email protected]>
176
Description: This attribute contains vendor id of this device extracted
177
from the device DROM.
179
What: /sys/bus/thunderbolt/devices/.../vendor_name
180
Date: Sep 2017
181
KernelVersion: 4.13
182
Contact: Mika Westerberg <[email protected]>
183
Description: This attribute contains vendor name of this device extracted
184
from the device DROM.
186
What: /sys/bus/thunderbolt/devices/.../unique_id
187
Date: Sep 2017
188
KernelVersion: 4.13
189
Contact: Mika Westerberg <[email protected]>
190
Description: This attribute contains unique_id string of this device.
191
This is either read from hardware registers (UUID on
192
newer hardware) or based on UID from the device DROM.
193
Can be used to uniquely identify particular device.
195
What: /sys/bus/thunderbolt/devices/.../nvm_version
196
Date: Sep 2017
197
KernelVersion: 4.13
198
Contact: Mika Westerberg <[email protected]>
199
Description: If the device has upgradeable firmware the version
200
number is available here. Format: %x.%x, major.minor.
201
If the device is in safe mode reading the file returns
202
-ENODATA instead as the NVM version is not available.
204
What: /sys/bus/thunderbolt/devices/.../nvm_authenticate
205
Date: Sep 2017
206
KernelVersion: 4.13
207
Contact: Mika Westerberg <[email protected]>
208
Description: When new NVM image is written to the non-active NVM
209
area (through non_activeX NVMem device), the
210
authentication procedure is started by writing to
211
this file.
212
If everything goes well, the device is
213
restarted with the new NVM firmware. If the image
214
verification fails an error code is returned instead.
216
This file will accept writing values "1", "2" or "3".
218
- Writing "1" will flush the image to the storage
219
area and authenticate the image in one action.
220
- Writing "2" will run some basic validation on the image
221
and flush it to the storage area.
222
- Writing "3" will authenticate the image that is
223
currently written in the storage area. This is only
224
supported with USB4 devices and retimers.
226
When read holds status of the last authentication
227
operation if an error occurred during the process. This
228
is directly the status value from the DMA configuration
229
based mailbox before the device is power cycled. Writing
230
0 here clears the status.
232
What: /sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect
233
Date: Oct 2020
234
KernelVersion: v5.9
235
Contact: Mario Limonciello <[email protected]>
236
Description: For supported devices, automatically authenticate the new Thunderbolt
237
image when the device is disconnected from the host system.
239
This file will accept writing values "1" or "2"
241
- Writing "1" will flush the image to the storage
242
area and prepare the device for authentication on disconnect.
243
- Writing "2" will run some basic validation on the image
244
and flush it to the storage area.
246
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/key
247
Date: Jan 2018
248
KernelVersion: 4.15
249
Contact: Mika Westerberg <[email protected]>
250
Description: This contains name of the property directory the XDomain
251
service exposes. This entry describes the protocol in
252
question. Following directories are already reserved by
253
the Apple XDomain specification:
255
======== ===============================================
256
network IP/ethernet over Thunderbolt
257
targetdm Target disk mode protocol over Thunderbolt
258
extdisp External display mode protocol over Thunderbolt
259
======== ===============================================
261
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias
262
Date: Jan 2018
263
KernelVersion: 4.15
264
Contact: Mika Westerberg <[email protected]>
265
Description: Stores the same MODALIAS value emitted by uevent for
266
the XDomain service. Format: tbtsvc:kSpNvNrN
268
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid
269
Date: Jan 2018
270
KernelVersion: 4.15
271
Contact: Mika Westerberg <[email protected]>
272
Description: This contains XDomain protocol identifier the XDomain
273
service supports.
275
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers
276
Date: Jan 2018
277
KernelVersion: 4.15
278
Contact: Mika Westerberg <[email protected]>
279
Description: This contains XDomain protocol version the XDomain
280
service supports.
282
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs
283
Date: Jan 2018
284
KernelVersion: 4.15
285
Contact: Mika Westerberg <[email protected]>
286
Description: This contains XDomain software version the XDomain
287
service supports.
289
What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns
290
Date: Jan 2018
291
KernelVersion: 4.15
292
Contact: Mika Westerberg <[email protected]>
293
Description: This contains XDomain service specific settings as
294
bitmask. Format: %x
296
What: /sys/bus/thunderbolt/devices/usb4_portX/connector
297
Date: April 2022
298
Contact: Heikki Krogerus <[email protected]>
299
Description:
300
Symlink to the USB Type-C connector. This link is only
301
created when USB Type-C Connector Class is enabled,
302
and only if the system firmware is capable of
303
describing the connection between a port and its
304
connector.
306
What: /sys/bus/thunderbolt/devices/usb4_portX/link
307
Date: Sep 2021
308
KernelVersion: v5.14
309
Contact: Mika Westerberg <[email protected]>
310
Description: Returns the current link mode. Possible values are
311
"usb4", "tbt" and "none".
313
What: /sys/bus/thunderbolt/devices/usb4_portX/offline
314
Date: Sep 2021
315
KernelVersion: v5.14
316
Contact: Rajmohan Mani <[email protected]>
317
Description: Writing 1 to this attribute puts the USB4 port into
318
offline mode. Only allowed when there is nothing
319
connected to the port (link attribute returns "none").
320
Once the port is in offline mode it does not receive any
321
hotplug events. This is used to update NVM firmware of
322
on-board retimers. Writing 0 puts the port back to
323
online mode.
325
This attribute is only visible if the platform supports
326
powering on retimers when there is no cable connected.
328
What: /sys/bus/thunderbolt/devices/usb4_portX/rescan
329
Date: Sep 2021
330
KernelVersion: v5.14
331
Contact: Rajmohan Mani <[email protected]>
332
Description: When the USB4 port is in offline mode writing 1 to this
333
attribute forces rescan of the sideband for on-board
334
retimers. Each retimer appear under the USB4 port as if
335
the USB4 link was up. These retimers act in the same way
336
as if the cable was connected so upgrading their NVM
337
firmware can be done the usual way.
339
What: /sys/bus/thunderbolt/devices/<device>:<port>.<index>/device
340
Date: Oct 2020
341
KernelVersion: v5.9
342
Contact: Mika Westerberg <[email protected]>
343
Description: Retimer device identifier read from the hardware.
345
What: /sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_authenticate
346
Date: Oct 2020
347
KernelVersion: v5.9
348
Contact: Mika Westerberg <[email protected]>
349
Description: When new NVM image is written to the non-active NVM
350
area (through non_activeX NVMem device), the
351
authentication procedure is started by writing 1 to
352
this file. If everything goes well, the device is
353
restarted with the new NVM firmware. If the image
354
verification fails an error code is returned instead.
356
When read holds status of the last authentication
357
operation if an error occurred during the process.
358
Format: %x.
360
What: /sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_version
361
Date: Oct 2020
362
KernelVersion: v5.9
363
Contact: Mika Westerberg <[email protected]>
364
Description: Holds retimer NVM version number. Format: %x.%x, major.minor.
366
What: /sys/bus/thunderbolt/devices/<device>:<port>.<index>/vendor
367
Date: Oct 2020
368
KernelVersion: v5.9
369
Contact: Mika Westerberg <[email protected]>
370
Description: Retimer vendor identifier read from the hardware.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Thunderbolt controller boot ACL
1-23| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../domainX/boot_acl |
| Date | 2018년 6월 |
| KernelVersion | 4.17 |
| Contact | Mika Westerberg <[email protected]> |
| Description | System 시작 중 자동 연결을 허용하는 장치 unique_id의 comma-separated 목록을 담습니다. 목록은 controller가 지원하는 최대 unique_id 수를 항상 유지하며 사용하지 않는 항목은 비어 있으므로 userspace가 지원 항목 수를 알 수 있습니다. Controller가 여러 개면 각 controller가 자체 ACL을 가지며 크기도 서로 다를 수 있습니다. 이 목록을 적용하려면 system BIOS의 "Preboot ACL" 또는 비슷한 option을 선택해야 할 수 있습니다. Software는 쓸 때마다 전체 목록을 갱신합니다. Boot 중 장치가 자동 authorize되면 그 장치의 boot 속성이 1로 설정됩니다. |
Thunderbolt device de-authorization 지원
24-32| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../domainX/deauthorization |
| Date | 2021년 5월 |
| KernelVersion | 5.12 |
| Contact | Mika Westerberg <[email protected]> |
| Description | System이 장치 de-authorization을 지원하는지 나타냅니다. 값이 1이면 각 장치의 authorized 속성에 0을 써서 PCIe tunnel authorization을 해제할 수 있습니다. |
IOMMU DMA protection 상태
33-41| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection |
| Date | 2019년 3월 |
| KernelVersion | 4.21 |
| Contact | Mika Westerberg <[email protected]> |
| Description | System이 DMA protection에 IOMMU를 사용하는지 나타냅니다. 1은 IOMMU를 사용함을, 0은 사용하지 않아 DMA protection이 Thunderbolt security level에만 의존함을 뜻합니다. |
Thunderbolt security level
42-63| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../domainX/security |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | System BIOS가 설정한 현재 Thunderbolt security level을 담습니다. |
값한국어 전문 번역
none모든 장치를 자동 authorize합니다.
user각 장치의 authorized 속성에 적절한 값을 쓴 경우에만 authorize합니다.
secure최소한 secure connect를 지원하는 장치를 요구하며 사용자가 각 장치를 authorize해야 합니다.
dponlyDisplayPort와 USB를 자동 tunnel하고 PCIe tunnel은 만들지 않습니다.
usbonly연결된 Thunderbolt dock의 USB controller와 DisplayPort를 자동 tunnel하고 dock downstream의 모든 PCIe link를 제거합니다.
nopcieBIOS에서 PCIe tunneling을 비활성화한 USB4 system입니다.
BIOS가 선택할 수 있는 authorization 및 tunneling 정책입니다.
Thunderbolt device authorization
64-97| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../authorized |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 연결된 Thunderbolt 장치를 authorize할 때 사용합니다. 장치가 authorize되지 않으면 system에서 PCIe 장치를 사용할 수 없습니다. 아직 authorize되지 않은 장치는 이 속성 값이 0입니다. |
쓴 값한국어 전문 번역
0장치를 de-authorize합니다. Domain의 deauthorization 속성이 1일 때만 지원됩니다.
1장치를 authorize하고 연결합니다.
Key를 사용하지 않는 장치의 authorization 및 de-authorization 동작입니다.
Key 속성에 32바이트 16진수 문자열이 들어 있는 경우에는 다음 값이 적용됩니다.
쓴 값한국어 전문 번역
0장치를 de-authorize합니다. Domain의 deauthorization 속성이 1일 때만 지원됩니다.
132바이트 16진수 문자열을 device NVM에 추가하고 장치를 authorize합니다.
232바이트 16진수 문자열에 기반한 challenge를 보냅니다. 장치의 challenge response가 유효하면 authorize합니다. 실패 시 장치에 key가 전혀 없으면 errno는 ENOKEY이고, response가 일치하지 않으면 EKEYREJECTED입니다.
32바이트 key가 있는 장치에서 key 저장 또는 challenge를 수행하는 값입니다.
Boot 중 authorization 상태
98-104| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../boot |
| Date | 2018년 6월 |
| KernelVersion | 4.17 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Thunderbolt 장치가 boot 중 이미 authorize되었으면 1, 그렇지 않으면 0을 담습니다. |
Thunderbolt controller generation
105-112| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../generation |
| Date | 2020년 1월 |
| KernelVersion | 5.5 |
| Contact | Christian Kellner <[email protected]> |
| Description | 장치와 연결된 Thunderbolt controller의 generation을 담습니다. USB4에서는 4입니다. |
Thunderbolt secure-connect key
113-122| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../key |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Thunderbolt secure connect를 지원하는 장치에 제공됩니다. 32바이트 16진수 문자열을 쓰면 authorization이 secure connection method를 사용하도록 바뀝니다. 빈 문자열을 쓰면 key를 지우고 다시 일반 connection method를 사용할 수 있습니다. |
Thunderbolt device DROM ID
123-129| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../device |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Device DROM에서 추출한 이 장치의 ID를 담습니다. |
Thunderbolt device DROM 이름
130-136| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../device_name |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Device DROM에서 추출한 이 장치의 이름을 담습니다. |
XDomain maximum input HopID
137-143| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../maxhopid |
| Date | 2021년 7월 |
| KernelVersion | 5.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain에만 설정됩니다. 다른 host가 input HopID로 지원하는 최대 HopID입니다. |
Thunderbolt RX lane speed
144-150| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../rx_speed |
| Date | 2020년 1월 |
| KernelVersion | 5.5 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 장치의 lane당 RX speed를 보고합니다. 모든 RX lane은 같은 speed로 동작합니다. |
Thunderbolt active RX lane 수
151-157| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../rx_lanes |
| Date | 2020년 1월 |
| KernelVersion | 5.5 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 장치가 upstream port를 통해 동시에 사용하는 RX lane 수를 보고합니다. |
Thunderbolt TX lane speed
158-164| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../tx_speed |
| Date | 2020년 1월 |
| KernelVersion | 5.5 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Lane당 TX speed를 보고합니다. 모든 TX lane은 같은 speed로 동작합니다. |
Thunderbolt active TX lane 수
165-171| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../tx_lanes |
| Date | 2020년 1월 |
| KernelVersion | 5.5 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 장치가 upstream port를 통해 동시에 사용하는 TX lane 수를 보고합니다. |
Thunderbolt device DROM vendor ID
172-178| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../vendor |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Device DROM에서 추출한 이 장치의 vendor ID를 담습니다. |
Thunderbolt device DROM vendor 이름
179-185| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../vendor_name |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Device DROM에서 추출한 이 장치의 vendor 이름을 담습니다. |
Thunderbolt device unique ID
186-194| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../unique_id |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 장치의 unique_id 문자열을 담습니다. 새 hardware에서는 hardware register의 UUID를 읽고, 그 밖에는 device DROM의 UID에 기반합니다. 특정 장치를 고유하게 식별하는 데 사용할 수 있습니다. |
Thunderbolt device NVM version
195-203| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../nvm_version |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 장치 firmware를 upgrade할 수 있으면 version 번호를 제공합니다. 형식은 major.minor를 뜻하는 %x.%x입니다. 장치가 safe mode이면 NVM version을 사용할 수 없으므로 읽을 때 -ENODATA를 반환합니다. |
Thunderbolt device NVM authentication
204-231| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../nvm_authenticate |
| Date | 2017년 9월 |
| KernelVersion | 4.13 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Non-active NVM 영역에 non_activeX NVMem 장치를 통해 새 NVM image를 쓴 뒤 이 file에 써서 authentication을 시작합니다. 성공하면 새 NVM firmware로 장치를 재시작하고 image verification이 실패하면 error code를 반환합니다. 읽으면 과정 중 오류가 발생한 경우 마지막 authentication operation의 status를 담습니다. 이는 장치 power cycle 전 DMA configuration-based mailbox의 status 값입니다. 0을 쓰면 status를 지웁니다. |
| 쓴 값 | 한국어 전문 번역 |
|---|---|
| 1 | Image를 storage 영역에 flush하고 한 동작으로 authenticate합니다. |
| 2 | Image를 기본 검증한 뒤 storage 영역에 flush합니다. |
| 3 | 현재 storage 영역에 쓰인 image를 authenticate합니다. USB4 장치와 retimer에서만 지원됩니다. |
Disconnect 시 Thunderbolt NVM authentication
232-245| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect |
| Date | 2020년 10월 |
| KernelVersion | v5.9 |
| Contact | Mario Limonciello <[email protected]> |
| Description | 지원 장치에서 host system과 연결이 끊길 때 새 Thunderbolt image를 자동 authenticate합니다. |
| 쓴 값 | 한국어 전문 번역 |
|---|---|
| 1 | Image를 storage 영역에 flush하고 disconnect 시 authentication하도록 장치를 준비합니다. |
| 2 | Image를 기본 검증한 뒤 storage 영역에 flush합니다. |
XDomain service property key
246-260| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/key |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service가 노출하는 property directory 이름을 담고 해당 protocol을 설명합니다. Apple XDomain specification은 다음 directory를 이미 예약했습니다. |
KeyProtocol
networkThunderbolt를 통한 IP/Ethernet
targetdmThunderbolt target disk mode protocol
extdispThunderbolt external display mode protocol
Thunderbolt XDomain specification이 예약한 protocol directory 이름입니다.
XDomain service MODALIAS
261-267| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service의 uevent가 내보내는 것과 같은 MODALIAS 값을 저장합니다. 형식은 tbtsvc:kSpNvNrN입니다. |
XDomain protocol identifier
268-274| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service가 지원하는 XDomain protocol identifier를 담습니다. |
XDomain protocol version
275-281| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service가 지원하는 XDomain protocol version을 담습니다. |
XDomain software version
282-288| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service가 지원하는 XDomain software version을 담습니다. |
XDomain service-specific settings
289-295| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns |
| Date | 2018년 1월 |
| KernelVersion | 4.15 |
| Contact | Mika Westerberg <[email protected]> |
| Description | XDomain service별 setting을 bitmask로 담습니다. 형식은 %x입니다. |
USB4 port Type-C connector link
296-305| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/usb4_portX/connector |
| Date | 2022년 4월 |
| Contact | Heikki Krogerus <[email protected]> |
| Description | USB Type-C connector로 향하는 symlink입니다. USB Type-C Connector Class가 활성화되어 있고 system firmware가 port와 connector의 연결을 설명할 수 있을 때만 생성됩니다. |
USB4 port current link mode
306-312| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/usb4_portX/link |
| Date | 2021년 9월 |
| KernelVersion | v5.14 |
| Contact | Mika Westerberg <[email protected]> |
| Description | 현재 link mode를 반환합니다. 가능한 값은 "usb4", "tbt", "none"입니다. |
USB4 port offline mode
313-327| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/usb4_portX/offline |
| Date | 2021년 9월 |
| KernelVersion | v5.14 |
| Contact | Rajmohan Mani <[email protected]> |
| Description | 1을 쓰면 USB4 port를 offline mode로 전환합니다. Port에 아무것도 연결되지 않아 link 속성이 "none"을 반환할 때만 허용됩니다. Offline mode에서는 hotplug event를 받지 않으며 onboard retimer의 NVM firmware를 update할 때 사용합니다. 0을 쓰면 다시 online mode가 됩니다. Cable이 연결되지 않았을 때도 retimer power-on을 지원하는 platform에서만 이 속성이 보입니다. |
USB4 onboard retimer sideband rescan
328-338| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/usb4_portX/rescan |
| Date | 2021년 9월 |
| KernelVersion | v5.14 |
| Contact | Rajmohan Mani <[email protected]> |
| Description | USB4 port가 offline mode일 때 1을 쓰면 onboard retimer의 sideband를 강제로 rescan합니다. 각 retimer는 USB4 link가 up인 것처럼 USB4 port 아래에 나타나고 cable이 연결된 것과 같은 방식으로 동작하므로 일반 절차로 NVM firmware를 upgrade할 수 있습니다. |
Thunderbolt retimer device ID
339-344| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<device>:<port>.<index>/device |
| Date | 2020년 10월 |
| KernelVersion | v5.9 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Hardware에서 읽은 retimer device identifier입니다. |
Thunderbolt retimer NVM authentication
345-359| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_authenticate |
| Date | 2020년 10월 |
| KernelVersion | v5.9 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Non-active NVM 영역에 non_activeX NVMem 장치를 통해 새 NVM image를 쓴 뒤 1을 쓰면 authentication을 시작합니다. 성공하면 새 NVM firmware로 장치를 재시작하고 image verification이 실패하면 error code를 반환합니다. 읽으면 과정 중 오류가 발생한 경우 마지막 authentication operation의 status를 담으며 형식은 %x입니다. |
Thunderbolt retimer NVM version
360-365| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<device>:<port>.<index>/nvm_version |
| Date | 2020년 10월 |
| KernelVersion | v5.9 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Retimer NVM version 번호를 담습니다. 형식은 major.minor를 뜻하는 %x.%x입니다. |
Thunderbolt retimer vendor ID
366-370| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/thunderbolt/devices/<device>:<port>.<index>/vendor |
| Date | 2020년 10월 |
| KernelVersion | v5.9 |
| Contact | Mika Westerberg <[email protected]> |
| Description | Hardware에서 읽은 retimer vendor identifier입니다. |
Boot ACL, de-authorization, IOMMU, and BIOS security
sysfs-bus-thunderbolt:1-63Domain은 boot ACL 크기와 BIOS 적용 조건, PCIe tunnel de-authorization, IOMMU DMA protection 및 여섯 security level을 노출합니다.