← Documents Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

HiSilicon PTT sysfs ABI

HiSilicon PCIe Tune and Trace의 Tx TLP QoS weights, packet-buffer watermarks와 Root Port·Requester trace filters를 설명합니다.

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

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

1. 요약·해설

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

PCIe link tuning events

sysfs-bus-event_source-devices-hisi_ptt:1-9

tune directory의 각 file은 이름에 해당하는 PCIe link parameter event를 조정합니다.

Tx TLP QoS weights

sysfs-bus-event_source-devices-hisi_ptt:11-39

Completion, non-posted와 posted Tx TLP weights로 outbound traffic 비율을 조정하며 값은 0-2입니다.

Inbound와 outbound buffer watermarks

sysfs-bus-event_source-devices-hisi_ptt:41-61

Allocated buffer watermark에 도달하거나 timeout될 때 packets를 전송하며 inbound·outbound levels 모두 0-2를 사용합니다.

PTT Root Port filters

sysfs-bus-event_source-devices-hisi_ptt:63-87

Root Port BDF-named files는 TLP header trace filter values를 제공하고 multiselect는 다른 filters와 동시 선택 가능한지 나타냅니다.

PTT Requester filters

sysfs-bus-event_source-devices-hisi_ptt:89-113

Endpoint Requester BDF-named files와 multiselect가 requester-side TLP trace filtering을 구성합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune
2 Date: October 2022
3 KernelVersion: 6.1
4 Contact: Yicong Yang <[email protected]>
5 Description: This directory contains files for tuning the PCIe link
6 parameters(events). Each file is named after the event
7 of the PCIe link.
8
9 See Documentation/trace/hisi-ptt.rst for more information.
10
11 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_cpl
12 Date: October 2022
13 KernelVersion: 6.1
14 Contact: Yicong Yang <[email protected]>
15 Description: (RW) Controls the weight of Tx completion TLPs, which influence
16 the proportion of outbound completion TLPs on the PCIe link.
17 The available tune data is [0, 1, 2]. Writing a negative value
18 will return an error, and out of range values will be converted
19 to 2. The value indicates a probable level of the event.
20
21 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_np
22 Date: October 2022
23 KernelVersion: 6.1
24 Contact: Yicong Yang <[email protected]>
25 Description: (RW) Controls the weight of Tx non-posted TLPs, which influence
26 the proportion of outbound non-posted TLPs on the PCIe link.
27 The available tune data is [0, 1, 2]. Writing a negative value
28 will return an error, and out of range values will be converted
29 to 2. The value indicates a probable level of the event.
30
31 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_p
32 Date: October 2022
33 KernelVersion: 6.1
34 Contact: Yicong Yang <[email protected]>
35 Description: (RW) Controls the weight of Tx posted TLPs, which influence the
36 proportion of outbound posted TLPs on the PCIe link.
37 The available tune data is [0, 1, 2]. Writing a negative value
38 will return an error, and out of range values will be converted
39 to 2. The value indicates a probable level of the event.
40
41 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/rx_alloc_buf_level
42 Date: October 2022
43 KernelVersion: 6.1
44 Contact: Yicong Yang <[email protected]>
45 Description: (RW) Control the allocated buffer watermark for inbound packets.
46 The packets will be stored in the buffer first and then transmitted
47 either when the watermark reached or when timed out.
48 The available tune data is [0, 1, 2]. Writing a negative value
49 will return an error, and out of range values will be converted
50 to 2. The value indicates a probable level of the event.
51
52 What: /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/tx_alloc_buf_level
53 Date: October 2022
54 KernelVersion: 6.1
55 Contact: Yicong Yang <[email protected]>
56 Description: (RW) Control the allocated buffer watermark of outbound packets.
57 The packets will be stored in the buffer first and then transmitted
58 either when the watermark reached or when timed out.
59 The available tune data is [0, 1, 2]. Writing a negative value
60 will return an error, and out of range values will be converted
61 to 2. The value indicates a probable level of the event.
62
63 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters
64 Date: May 2023
65 KernelVersion: 6.5
66 Contact: Yicong Yang <[email protected]>
67 Description: This directory contains the files providing the PCIe Root Port filters
68 information used for PTT trace. Each file is named after the supported
69 Root Port device name <domain>:<bus>:<device>.<function>.
70
71 See the description of the "filter" in Documentation/trace/hisi-ptt.rst
72 for more information.
73
74 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/multiselect
75 Date: May 2023
76 KernelVersion: 6.5
77 Contact: Yicong Yang <[email protected]>
78 Description: (Read) Indicates if this kind of filter can be selected at the same
79 time as others filters, or must be used on it's own. 1 indicates
80 the former case and 0 indicates the latter.
81
82 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/<bdf>
83 Date: May 2023
84 KernelVersion: 6.5
85 Contact: Yicong Yang <[email protected]>
86 Description: (Read) Indicates the filter value of this Root Port filter, which
87 can be used to control the TLP headers to trace by the PTT trace.
88
89 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters
90 Date: May 2023
91 KernelVersion: 6.5
92 Contact: Yicong Yang <[email protected]>
93 Description: This directory contains the files providing the PCIe Requester filters
94 information used for PTT trace. Each file is named after the supported
95 Endpoint device name <domain>:<bus>:<device>.<function>.
96
97 See the description of the "filter" in Documentation/trace/hisi-ptt.rst
98 for more information.
99
100 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/multiselect
101 Date: May 2023
102 KernelVersion: 6.5
103 Contact: Yicong Yang <[email protected]>
104 Description: (Read) Indicates if this kind of filter can be selected at the same
105 time as others filters, or must be used on it's own. 1 indicates
106 the former case and 0 indicates the latter.
107
108 What: /sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/<bdf>
109 Date: May 2023
110 KernelVersion: 6.5
111 Contact: Yicong Yang <[email protected]>
112 Description: (Read) Indicates the filter value of this Requester filter, which
113 can be used to control the TLP headers to trace by the PTT trace.
114

3. 한국어 전문 번역

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

HiSilicon PTT tune directory

1-9
항목전문 번역
What/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune
Date2022년 10월
KernelVersion6.1
ContactYicong Yang <[email protected]>
Description이 directory에는 PCIe link parameters(events)를 tuning하는 files가 있습니다. 각 file은 PCIe link event의 이름을 따릅니다. 자세한 내용은 Documentation/trace/hisi-ptt.rst를 참조합니다.

PTT transmit TLP QoS tuning

11-39
What공통 metadata전문 번역
/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_cpl2022년 10월 / 6.1 / Yicong Yang <[email protected]>(RW) PCIe link에서 outbound completion TLPs의 비율에 영향을 주는 Tx completion TLPs weight를 제어합니다.
/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_np2022년 10월 / 6.1 / Yicong Yang <[email protected]>(RW) PCIe link에서 outbound non-posted TLPs의 비율에 영향을 주는 Tx non-posted TLPs weight를 제어합니다.
/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_p2022년 10월 / 6.1 / Yicong Yang <[email protected]>(RW) PCIe link에서 outbound posted TLPs의 비율에 영향을 주는 Tx posted TLPs weight를 제어합니다.

세 attributes에서 사용할 수 있는 tune data는 [0, 1, 2]입니다. Negative value를 쓰면 error를 반환하고 범위를 벗어난 값은 2로 변환합니다. 값은 event의 probable level을 나타냅니다.

PTT allocated-buffer watermarks

41-61
What공통 metadata전문 번역
/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/rx_alloc_buf_level2022년 10월 / 6.1 / Yicong Yang <[email protected]>(RW) Inbound packets의 allocated buffer watermark를 제어합니다. Packets를 먼저 buffer에 저장한 뒤 watermark에 도달하거나 timeout되면 전송합니다.
/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/tx_alloc_buf_level2022년 10월 / 6.1 / Yicong Yang <[email protected]>(RW) Outbound packets의 allocated buffer watermark를 제어합니다. Packets를 먼저 buffer에 저장한 뒤 watermark에 도달하거나 timeout되면 전송합니다.

두 attributes에서 사용할 수 있는 tune data는 [0, 1, 2]입니다. Negative value를 쓰면 error를 반환하고 범위를 벗어난 값은 2로 변환합니다. 값은 event의 probable level을 나타냅니다.

PTT Root Port trace filters

63-87
WhatDate / Kernel / Contact전문 번역
/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters2023년 5월 / 6.5 / Yicong Yang <[email protected]>이 directory에는 PTT trace에 사용하는 PCIe Root Port filters information을 제공하는 files가 있습니다. 각 file은 지원되는 Root Port device name <domain>:<bus>:<device>.<function>을 따릅니다. 자세한 내용은 Documentation/trace/hisi-ptt.rst의 filter 설명을 참조합니다.
/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/multiselect2023년 5월 / 6.5 / Yicong Yang <[email protected]>(Read) 이 종류의 filter를 다른 filters와 동시에 선택할 수 있는지, 단독으로 사용해야 하는지 나타냅니다. 1은 전자, 0은 후자입니다.
/sys/devices/hisi_ptt<sicl_id>_<core_id>/root_port_filters/<bdf>2023년 5월 / 6.5 / Yicong Yang <[email protected]>(Read) PTT trace가 추적할 TLP headers를 제어하는 데 사용할 수 있는 Root Port filter value를 나타냅니다.

PTT Requester trace filters

89-113
WhatDate / Kernel / Contact전문 번역
/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters2023년 5월 / 6.5 / Yicong Yang <[email protected]>이 directory에는 PTT trace에 사용하는 PCIe Requester filters information을 제공하는 files가 있습니다. 각 file은 지원되는 Endpoint device name <domain>:<bus>:<device>.<function>을 따릅니다. 자세한 내용은 Documentation/trace/hisi-ptt.rst의 filter 설명을 참조합니다.
/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/multiselect2023년 5월 / 6.5 / Yicong Yang <[email protected]>(Read) 이 종류의 filter를 다른 filters와 동시에 선택할 수 있는지, 단독으로 사용해야 하는지 나타냅니다. 1은 전자, 0은 후자입니다.
/sys/devices/hisi_ptt<sicl_id>_<core_id>/requester_filters/<bdf>2023년 5월 / 6.5 / Yicong Yang <[email protected]>(Read) PTT trace가 추적할 TLP headers를 제어하는 데 사용할 수 있는 Requester filter value를 나타냅니다.