← Documents Documentation/ABI/testing/sysfs-bus-usb-lvstest GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

USB SuperSpeed Link Layer Validation test sysfs ABI

LVS driver가 제공하는 descriptor 요청, U1·U2 timeout, hot/warm reset, U3 전환과 compliance mode test node를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-bus-usb-lvstest
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Validation device and timeout controls

sysfs-bus-usb-lvstest:1-26

Root hub에 lvs driver가 bind된 경우에만 나타나는 node와 Get Device Descriptor, U1·U2 timeout test를 정의합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 Link Layer Validation Device is a standard device for testing of Super
2 Speed Link Layer tests. These nodes are available in sysfs only when lvs
3 driver is bound with root hub device.
4
5 What: /sys/bus/usb/devices/.../get_dev_desc
6 Date: March 2014
7 Contact: Pratyush Anand <pratyush.anand@gmail.com>
8 Description:
9 Write to this node to issue "Get Device Descriptor"
10 for Link Layer Validation device. It is needed for TD.7.06.
11
12 What: /sys/bus/usb/devices/.../u1_timeout
13 Date: March 2014
14 Contact: Pratyush Anand <pratyush.anand@gmail.com>
15 Description:
16 Set "U1 timeout" for the downstream port where Link Layer
17 Validation device is connected. Timeout value must be between 0
18 and 127. It is needed for TD.7.18, TD.7.19, TD.7.20 and TD.7.21.
19
20 What: /sys/bus/usb/devices/.../u2_timeout
21 Date: March 2014
22 Contact: Pratyush Anand <pratyush.anand@gmail.com>
23 Description:
24 Set "U2 timeout" for the downstream port where Link Layer
25 Validation device is connected. Timeout value must be between 0
26 and 127. It is needed for TD.7.18, TD.7.19, TD.7.20 and TD.7.21.
27
28 What: /sys/bus/usb/devices/.../hot_reset
29 Date: March 2014
30 Contact: Pratyush Anand <pratyush.anand@gmail.com>
31 Description:
32 Write to this node to issue "Reset" for Link Layer Validation
33 device. It is needed for TD.7.29, TD.7.31, TD.7.34 and TD.7.35.
34
35 What: /sys/bus/usb/devices/.../u3_entry
36 Date: March 2014
37 Contact: Pratyush Anand <pratyush.anand@gmail.com>
38 Description:
39 Write to this node to issue "U3 entry" for Link Layer
40 Validation device. It is needed for TD.7.35 and TD.7.36.
41
42 What: /sys/bus/usb/devices/.../u3_exit
43 Date: March 2014
44 Contact: Pratyush Anand <pratyush.anand@gmail.com>
45 Description:
46 Write to this node to issue "U3 exit" for Link Layer
47 Validation device. It is needed for TD.7.36.
48
49 What: /sys/bus/usb/devices/.../enable_compliance
50 Date: July 2017
51 Description:
52 Write to this node to set the port to compliance mode to test
53 with Link Layer Validation device. It is needed for TD.7.34.
54
55 What: /sys/bus/usb/devices/.../warm_reset
56 Date: July 2017
57 Description:
58 Write to this node to issue "Warm Reset" for Link Layer Validation
59 device. It may be needed to properly reset an xHCI 1.1 host port if
60 compliance mode needed to be explicitly enabled.
61

3. 한국어 전문 번역

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

Link Layer Validation Device

1-3

Link Layer Validation Device는 SuperSpeed Link Layer test를 위한 표준 장치입니다. 아래 node들은 lvs driver가 root hub device에 bind되어 있을 때만 sysfs에서 사용할 수 있습니다.

Get Device Descriptor 요청

5-10
항목한국어 전문 번역
What/sys/bus/usb/devices/.../get_dev_desc
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
Description이 node에 쓰면 Link Layer Validation device에 "Get Device Descriptor"를 요청합니다. TD.7.06에 필요합니다.

U1 timeout 설정

12-18
항목한국어 전문 번역
What/sys/bus/usb/devices/.../u1_timeout
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
DescriptionLink Layer Validation device가 연결된 downstream port의 "U1 timeout"을 설정합니다. Timeout 값은 0-127 범위여야 합니다. TD.7.18, TD.7.19, TD.7.20, TD.7.21에 필요합니다.

U2 timeout 설정

20-26
항목한국어 전문 번역
What/sys/bus/usb/devices/.../u2_timeout
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
DescriptionLink Layer Validation device가 연결된 downstream port의 "U2 timeout"을 설정합니다. Timeout 값은 0-127 범위여야 합니다. TD.7.18, TD.7.19, TD.7.20, TD.7.21에 필요합니다.

Link Layer Validation hot reset

28-33
항목한국어 전문 번역
What/sys/bus/usb/devices/.../hot_reset
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
Description이 node에 쓰면 Link Layer Validation device에 "Reset"을 요청합니다. TD.7.29, TD.7.31, TD.7.34, TD.7.35에 필요합니다.

U3 진입 요청

35-40
항목한국어 전문 번역
What/sys/bus/usb/devices/.../u3_entry
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
Description이 node에 쓰면 Link Layer Validation device에 "U3 entry"를 요청합니다. TD.7.35와 TD.7.36에 필요합니다.

U3 종료 요청

42-47
항목한국어 전문 번역
What/sys/bus/usb/devices/.../u3_exit
Date2014년 3월
ContactPratyush Anand <pratyush.anand@gmail.com>
Description이 node에 쓰면 Link Layer Validation device에 "U3 exit"를 요청합니다. TD.7.36에 필요합니다.

Port compliance mode 활성화

49-53
항목한국어 전문 번역
What/sys/bus/usb/devices/.../enable_compliance
Date2017년 7월
Description이 node에 쓰면 Link Layer Validation device를 사용한 test를 위해 port를 compliance mode로 설정합니다. TD.7.34에 필요합니다.

Link Layer Validation warm reset

55-60
항목한국어 전문 번역
What/sys/bus/usb/devices/.../warm_reset
Date2017년 7월
Description이 node에 쓰면 Link Layer Validation device에 "Warm Reset"을 요청합니다. Compliance mode를 명시적으로 활성화해야 했던 경우 xHCI 1.1 host port를 올바르게 reset하는 데 필요할 수 있습니다.