요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Per-port identity and link state
sysfs-devices-platform-kunpeng_hccs:48-90각 hccsN port는 고정 type·lane_mode·enable과 현재 lane 수, link FSM, lane mask, CRC error count를 expose하며 used_types는 platform의 HCCS type을 나열합니다.
Low-power lane-count control
sysfs-devices-platform-kunpeng_hccs:91-126지원되는 HCCS type은 root-only dec/inc interface로 모든 해당 port를 minimum lane 또는 full-lane state로 전환하며 busy port가 있으면 lane 감소가 허용되지 않습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/platform/HISI04Bx:00/chipX/all_linked
2
What: /sys/devices/platform/HISI04Bx:00/chipX/linked_full_lane
3
What: /sys/devices/platform/HISI04Bx:00/chipX/crc_err_cnt
4
Date: November 2023
5
KernelVersion: 6.6
6
Contact: Huisong Li <[email protected]>
7
Description:
8
The /sys/devices/platform/HISI04Bx:00/chipX/ directory
9
contains read-only attributes exposing some summarization
10
information of all HCCS ports under a specified chip.
11
The X in 'chipX' indicates the Xth chip on platform.
13
There are following attributes in this directory:
15
================= ==== =========================================
16
all_linked: (RO) if all enabled ports on this chip are
17
linked (bool).
18
linked_full_lane: (RO) if all linked ports on this chip are full
19
lane (bool).
20
crc_err_cnt: (RO) total CRC err count for all ports on this
21
chip.
22
================= ==== =========================================
24
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/all_linked
25
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/linked_full_lane
26
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/crc_err_cnt
27
Date: November 2023
28
KernelVersion: 6.6
29
Contact: Huisong Li <[email protected]>
30
Description:
31
The /sys/devices/platform/HISI04Bx:00/chipX/dieY/ directory
32
contains read-only attributes exposing some summarization
33
information of all HCCS ports under a specified die.
34
The Y in 'dieY' indicates the hardware id of the die on chip who
35
has chip id X.
37
There are following attributes in this directory:
39
================= ==== =========================================
40
all_linked: (RO) if all enabled ports on this die are
41
linked (bool).
42
linked_full_lane: (RO) if all linked ports on this die are full
43
lane (bool).
44
crc_err_cnt: (RO) total CRC err count for all ports on this
45
die.
46
================= ==== =========================================
48
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/type
49
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mode
50
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/enable
51
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/cur_lane_num
52
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/link_fsm
53
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mask
54
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/crc_err_cnt
55
Date: November 2023
56
KernelVersion: 6.6
57
Contact: Huisong Li <[email protected]>
58
Description:
59
The /sys/devices/platform/HISI04Bx/chipX/dieX/hccsN/ directory
60
contains read-only attributes exposing information about
61
a HCCS port. The N value in 'hccsN' indicates this port id.
62
The X in 'chipX' indicates the ID of the chip to which the
63
HCCS port belongs. For example, X ranges from to 'n - 1' if the
64
chip number on platform is n.
65
The Y in 'dieY' indicates the hardware id of the die to which
66
the hccs port belongs.
67
Note: type, lane_mode and enable are fixed attributes on running
68
platform.
70
The HCCS port have the following attributes:
72
============= ==== =============================================
73
type: (RO) port type (string), e.g. HCCS-v1 -> H32
74
lane_mode: (RO) the lane mode of this port (string), e.g. x8
75
enable: (RO) indicate if this port is enabled (bool).
76
cur_lane_num: (RO) current lane number of this port.
77
link_fsm: (RO) link finite state machine of this port.
78
lane_mask: (RO) current lane mask of this port, every bit
79
indicates a lane.
80
crc_err_cnt: (RO) CRC err count on this port.
81
============= ==== =============================================
83
What: /sys/devices/platform/HISI04Bx:00/used_types
84
Date: August 2024
85
KernelVersion: 6.12
86
Contact: Huisong Li <[email protected]>
87
Description:
88
This interface is used to show all HCCS types used on the
89
platform, like, HCCS-v1, HCCS-v2 and so on.
91
What: /sys/devices/platform/HISI04Bx:00/available_inc_dec_lane_types
92
What: /sys/devices/platform/HISI04Bx:00/dec_lane_of_type
93
What: /sys/devices/platform/HISI04Bx:00/inc_lane_of_type
94
Date: August 2024
95
KernelVersion: 6.12
96
Contact: Huisong Li <[email protected]>
97
Description:
98
These interfaces under /sys/devices/platform/HISI04Bx/ are
99
used to support the low power consumption feature of some
100
HCCS types by changing the number of lanes used. The interfaces
101
changing the number of lanes used are 'dec_lane_of_type' and
102
'inc_lane_of_type' which require root privileges. These
103
interfaces aren't exposed if no HCCS type on platform support
104
this feature. Please note that decreasing lane number is only
105
allowed if all the specified HCCS ports are not busy.
107
The low power consumption interfaces are as follows:
109
============================= ==== ================================
110
available_inc_dec_lane_types: (RO) available HCCS types (string) to
111
increase and decrease the number
112
of lane used, e.g. HCCS-v2.
113
dec_lane_of_type: (WO) input HCCS type supported
114
decreasing lane to decrease the
115
used lane number of all specified
116
HCCS type ports on platform to
117
the minimum.
118
You can query the 'cur_lane_num'
119
to get the minimum lane number
120
after executing successfully.
121
inc_lane_of_type: (WO) input HCCS type supported
122
increasing lane to increase the
123
used lane number of all specified
124
HCCS type ports on platform to
125
the full lane state.
126
============================= ==== ================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
All enabled chip ports linked
1, 4-23| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/all_linked |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | /sys/devices/platform/HISI04Bx:00/chipX/ directory는 지정한 chip 아래 모든 HCCS port의 summary 정보를 expose하는 read-only attribute를 담습니다. 'chipX'의 X는 platform에서 X번째 chip을 나타냅니다. 이 directory에는 다음 attribute가 있습니다. (RO) 이 chip에서 enable된 모든 port가 linked 상태인지 나타내는 bool 값입니다. |
Sysfs path한국어 전문 번역
/sys/devices/platform/HISI04Bx:00/chipX/all_linked(RO) 이 chip에서 enable된 모든 port가 linked 상태인지 나타내는 bool 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/linked_full_lane(RO) 이 chip에서 linked된 모든 port가 full-lane 상태인지 나타내는 bool 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/crc_err_cnt(RO) 이 chip의 모든 port에서 발생한 전체 CRC error count입니다.
원문의 chip-level ASCII attribute 표를 전체 path와 함께 구조화했습니다.
All linked chip ports at full lane
2, 4-23| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/linked_full_lane |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 chip에서 linked된 모든 port가 full-lane 상태인지 나타내는 bool 값입니다. |
Chip-wide CRC error count
3, 4-23| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/crc_err_cnt |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 chip의 모든 port에서 발생한 전체 CRC error count입니다. |
All enabled die ports linked
24, 27-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/all_linked |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | /sys/devices/platform/HISI04Bx:00/chipX/dieY/ directory는 지정한 die 아래 모든 HCCS port의 summary 정보를 expose하는 read-only attribute를 담습니다. 'dieY'의 Y는 chip ID가 X인 chip 위 die의 hardware ID입니다. 이 directory에는 다음 attribute가 있습니다. (RO) 이 die에서 enable된 모든 port가 linked 상태인지 나타내는 bool 값입니다. |
Sysfs path한국어 전문 번역
/sys/devices/platform/HISI04Bx:00/chipX/dieY/all_linked(RO) 이 die에서 enable된 모든 port가 linked 상태인지 나타내는 bool 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/linked_full_lane(RO) 이 die에서 linked된 모든 port가 full-lane 상태인지 나타내는 bool 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/crc_err_cnt(RO) 이 die의 모든 port에서 발생한 전체 CRC error count입니다.
원문의 die-level ASCII attribute 표를 전체 path와 함께 구조화했습니다.
All linked die ports at full lane
25, 27-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/linked_full_lane |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 die에서 linked된 모든 port가 full-lane 상태인지 나타내는 bool 값입니다. |
Die-wide CRC error count
26, 27-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/crc_err_cnt |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 die의 모든 port에서 발생한 전체 CRC error count입니다. |
HCCS port type
48, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/type |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | 원문 Description의 directory 표기는 /sys/devices/platform/HISI04Bx/chipX/dieX/hccsN/이며, 이 directory는 HCCS port 정보를 expose하는 read-only attribute를 담습니다. 'hccsN'의 N은 port ID입니다. 'chipX'의 X는 port가 속한 chip ID이며, platform chip 수가 n이면 예를 들어 0에서 n - 1 범위입니다. 'dieY'의 Y는 port가 속한 die의 hardware ID입니다. Running platform에서 type, lane_mode와 enable은 fixed attribute입니다. HCCS port에는 다음 attribute가 있습니다. (RO) Port type string입니다. 예: HCCS-v1 -> H32. |
Sysfs path한국어 전문 번역
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/type(RO) Port type string입니다. 예: HCCS-v1 -> H32.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mode(RO) Port의 lane-mode string입니다. 예: x8.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/enable(RO) 이 port가 enable되어 있는지 나타내는 bool 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/cur_lane_num(RO) 이 port의 현재 lane 수입니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/link_fsm(RO) 이 port의 link finite state machine 값입니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mask(RO) 이 port의 현재 lane mask이며 각 bit가 하나의 lane을 나타냅니다.
/sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/crc_err_cnt(RO) 이 port의 CRC error count입니다.
원문의 port-level ASCII attribute 표를 전체 path와 함께 구조화했습니다.
HCCS port lane mode
49, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mode |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) Port의 lane-mode string입니다. 예: x8. |
HCCS port enabled state
50, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/enable |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 port가 enable되어 있는지 나타내는 bool 값입니다. |
Current HCCS lane count
51, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/cur_lane_num |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 port의 현재 lane 수입니다. |
HCCS link finite-state machine
52, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/link_fsm |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 port의 link finite state machine 값입니다. |
Current HCCS lane mask
53, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mask |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 port의 현재 lane mask이며 각 bit가 하나의 lane을 나타냅니다. |
Per-port CRC error count
54, 55-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/crc_err_cnt |
| Date | 2023년 11월 |
| KernelVersion | 6.6 |
| Contact | Huisong Li <[email protected]> |
| Description | (RO) 이 port의 CRC error count입니다. |
HCCS types used on the platform
83-90| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/used_types |
| Date | 2024년 8월 |
| KernelVersion | 6.12 |
| Contact | Huisong Li <[email protected]> |
| Description | Platform에서 사용 중인 모든 HCCS type을 표시합니다. 예: HCCS-v1, HCCS-v2 등. |
Lane-adjustable HCCS types
91, 94-126| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/available_inc_dec_lane_types |
| Date | 2024년 8월 |
| KernelVersion | 6.12 |
| Contact | Huisong Li <[email protected]> |
| Description | 원문 Description에서는 /sys/devices/platform/HISI04Bx/ 아래 interface라고 표기합니다. 이 interface는 사용 lane 수를 바꿔 일부 HCCS type의 low-power consumption feature를 지원합니다. Lane 수를 바꾸는 dec_lane_of_type과 inc_lane_of_type에는 root privilege가 필요합니다. Platform의 어느 HCCS type도 이 feature를 지원하지 않으면 이 interface를 expose하지 않습니다. 지정된 HCCS port가 모두 busy 상태가 아닐 때만 lane 수 감소가 허용됩니다. Low-power consumption interface는 다음과 같습니다. (RO) 사용 lane 수를 늘리거나 줄일 수 있는 HCCS type string입니다. 예: HCCS-v2. |
Sysfs path한국어 전문 번역
/sys/devices/platform/HISI04Bx:00/available_inc_dec_lane_types(RO) 사용 lane 수를 늘리거나 줄일 수 있는 HCCS type string입니다. 예: HCCS-v2.
/sys/devices/platform/HISI04Bx:00/dec_lane_of_type(WO) Lane 감소를 지원하는 HCCS type을 입력하면 platform의 해당 type port 전체에서 사용 lane 수를 minimum으로 줄입니다. 성공 후 cur_lane_num을 조회해 minimum lane 수를 얻을 수 있습니다.
/sys/devices/platform/HISI04Bx:00/inc_lane_of_type(WO) Lane 증가를 지원하는 HCCS type을 입력하면 platform의 해당 type port 전체에서 사용 lane 수를 full-lane state로 늘립니다.
원문의 lane-control ASCII attribute 표와 access mode를 전체 path로 구조화했습니다.
Decrease lanes for an HCCS type
92, 94-126| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/dec_lane_of_type |
| Date | 2024년 8월 |
| KernelVersion | 6.12 |
| Contact | Huisong Li <[email protected]> |
| Description | (WO) Lane 감소를 지원하는 HCCS type을 입력하면 platform의 해당 type port 전체에서 사용 lane 수를 minimum으로 줄입니다. 성공 후 cur_lane_num을 조회해 minimum lane 수를 얻을 수 있습니다. |
Increase lanes for an HCCS type
93, 94-126| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/HISI04Bx:00/inc_lane_of_type |
| Date | 2024년 8월 |
| KernelVersion | 6.12 |
| Contact | Huisong Li <[email protected]> |
| Description | (WO) Lane 증가를 지원하는 HCCS type을 입력하면 platform의 해당 type port 전체에서 사용 lane 수를 full-lane state로 늘립니다. |
Chip and die link summaries
sysfs-devices-platform-kunpeng_hccs:1-47Chip 및 die directory는 enabled port 전체의 linked/full-lane 여부와 누적 CRC error count를 read-only summary로 제공합니다.