요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
AP endpoint IDs and monitor traffic
sysfs-devices-platform-soc-ipa:49-91Endpoint의 rx/tx는 AP 관점이며 modem traffic과 IPA ingress packet replica를 받는 monitor endpoint의 small unsigned ID를 제공합니다.
Embedded-modem endpoint aliases
sysfs-devices-platform-soc-ipa:92-114modem subtree는 embedded modem property를 담고 rx_endpoint_id·tx_endpoint_id로 endpoint_id subtree의 modem 값을 중복 제공합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/platform/soc@X/XXXXXXX.ipa/
2
Date: June 2021
3
KernelVersion: v5.14
4
Contact: Alex Elder <[email protected]>
5
Description:
6
The /sys/devices/platform/soc@X/XXXXXXX.ipa/ directory
7
contains read-only attributes exposing information about
8
an IPA device. The X values could vary, but are typically
9
"soc@0/1e40000.ipa".
11
What: .../XXXXXXX.ipa/version
12
Date: June 2021
13
KernelVersion: v5.14
14
Contact: Alex Elder <[email protected]>
15
Description:
16
The .../XXXXXXX.ipa/version file contains the IPA hardware
17
version, as a period-separated set of two or three integers
18
(e.g., "3.5.1" or "4.2").
20
What: .../XXXXXXX.ipa/feature/
21
Date: June 2021
22
KernelVersion: v5.14
23
Contact: Alex Elder <[email protected]>
24
Description:
25
The .../XXXXXXX.ipa/feature/ directory contains a set of
26
attributes describing features implemented by the IPA
27
hardware.
29
What: .../XXXXXXX.ipa/feature/rx_offload
30
Date: June 2021
31
KernelVersion: v5.14
32
Contact: Alex Elder <[email protected]>
33
Description:
34
The .../XXXXXXX.ipa/feature/rx_offload file contains a
35
string indicating the type of receive checksum offload
36
that is supported by the hardware. The possible values
37
are "MAPv4" or "MAPv5".
39
What: .../XXXXXXX.ipa/feature/tx_offload
40
Date: June 2021
41
KernelVersion: v5.14
42
Contact: Alex Elder <[email protected]>
43
Description:
44
The .../XXXXXXX.ipa/feature/tx_offload file contains a
45
string indicating the type of transmit checksum offload
46
that is supported by the hardware. The possible values
47
are "MAPv4" or "MAPv5".
49
What: .../XXXXXXX.ipa/endpoint_id/
50
Date: July 2022
51
KernelVersion: v5.19
52
Contact: Alex Elder <[email protected]>
53
Description:
54
The .../XXXXXXX.ipa/endpoint_id/ directory contains
55
attributes that define IDs associated with IPA
56
endpoints. The "rx" or "tx" in an endpoint name is
57
from the perspective of the AP. An endpoint ID is a
58
small unsigned integer.
60
What: .../XXXXXXX.ipa/endpoint_id/modem_rx
61
Date: July 2022
62
KernelVersion: v5.19
63
Contact: Alex Elder <[email protected]>
64
Description:
65
The .../XXXXXXX.ipa/endpoint_id/modem_rx file contains
66
the ID of the AP endpoint on which packets originating
67
from the embedded modem are received.
69
What: .../XXXXXXX.ipa/endpoint_id/modem_tx
70
Date: July 2022
71
KernelVersion: v5.19
72
Contact: Alex Elder <[email protected]>
73
Description:
74
The .../XXXXXXX.ipa/endpoint_id/modem_tx file contains
75
the ID of the AP endpoint on which packets destined
76
for the embedded modem are sent.
78
What: .../XXXXXXX.ipa/endpoint_id/monitor_rx
79
Date: July 2022
80
KernelVersion: v5.19
81
Contact: Alex Elder <[email protected]>
82
Description:
83
The .../XXXXXXX.ipa/endpoint_id/monitor_rx file contains
84
the ID of the AP endpoint on which IPA "monitor" data is
85
received. The monitor endpoint supplies replicas of
86
packets that enter the IPA hardware for processing.
87
Each replicated packet is preceded by a fixed-size "ODL"
88
header (see .../XXXXXXX.ipa/feature/monitor, above).
89
Large packets are truncated, to reduce the bandwidth
90
required to provide the monitor function.
92
What: .../XXXXXXX.ipa/modem/
93
Date: June 2021
94
KernelVersion: v5.14
95
Contact: Alex Elder <[email protected]>
96
Description:
97
The .../XXXXXXX.ipa/modem/ directory contains attributes
98
describing properties of the modem embedded in the SoC.
100
What: .../XXXXXXX.ipa/modem/rx_endpoint_id
101
Date: June 2021
102
KernelVersion: v5.14
103
Contact: Alex Elder <[email protected]>
104
Description:
105
The .../XXXXXXX.ipa/modem/rx_endpoint_id file duplicates
106
the value found in .../XXXXXXX.ipa/endpoint_id/modem_rx.
108
What: .../XXXXXXX.ipa/modem/tx_endpoint_id
109
Date: June 2021
110
KernelVersion: v5.14
111
Contact: Alex Elder <[email protected]>
112
Description:
113
The .../XXXXXXX.ipa/modem/tx_endpoint_id file duplicates
114
the value found in .../XXXXXXX.ipa/endpoint_id/modem_tx.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
IPA device directory
1-10| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/soc@X/XXXXXXX.ipa/ |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | /sys/devices/platform/soc@X/XXXXXXX.ipa/ directory에는 IPA device 정보를 expose하는 read-only attribute가 있습니다. X 값은 달라질 수 있지만 일반적으로 path는 "soc@0/1e40000.ipa"입니다. |
soc@X/XXXXXXX.ipa→version and feature/→endpoint_id/→modem/
Device root에서 hardware feature, endpoint ID와 embedded-modem view로 나뉩니다.
IPA hardware version
11-19| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/version |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/version file은 IPA hardware version을 period로 구분한 두 개 또는 세 개 integer 집합으로 담습니다. 예: "3.5.1" 또는 "4.2". |
IPA hardware-feature directory
20-28| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/feature/ |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/feature/ directory에는 IPA hardware가 구현한 feature를 설명하는 attribute 집합이 있습니다. |
IPA receive-checksum offload
29-38| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/feature/rx_offload |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/feature/rx_offload file은 hardware가 지원하는 receive-checksum offload type을 나타내는 string을 담습니다. 가능한 값은 "MAPv4" 또는 "MAPv5"입니다. |
IPA transmit-checksum offload
39-48| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/feature/tx_offload |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/feature/tx_offload file은 hardware가 지원하는 transmit-checksum offload type을 나타내는 string을 담습니다. 가능한 값은 "MAPv4" 또는 "MAPv5"입니다. |
AttributePossible values
feature/rx_offloadMAPv4 / MAPv5
feature/tx_offloadMAPv4 / MAPv5
Receive와 transmit 방향은 같은 MAP version vocabulary를 사용합니다.
IPA endpoint-ID directory
49-59| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/endpoint_id/ |
| Date | 2022년 7월 |
| KernelVersion | v5.19 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/endpoint_id/ directory에는 IPA endpoint와 연관된 ID를 정의하는 attribute가 있습니다. Endpoint name의 "rx" 또는 "tx"는 AP 관점입니다. Endpoint ID는 작은 unsigned integer입니다. |
Modem-to-AP receive endpoint
60-68| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/endpoint_id/modem_rx |
| Date | 2022년 7월 |
| KernelVersion | v5.19 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/endpoint_id/modem_rx file은 embedded modem에서 시작된 packet을 수신하는 AP endpoint의 ID를 담습니다. |
AP-to-modem transmit endpoint
69-77| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/endpoint_id/modem_tx |
| Date | 2022년 7월 |
| KernelVersion | v5.19 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/endpoint_id/modem_tx file은 embedded modem으로 향하는 packet을 전송하는 AP endpoint의 ID를 담습니다. |
IPA monitor receive endpoint
78-91| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/endpoint_id/monitor_rx |
| Date | 2022년 7월 |
| KernelVersion | v5.19 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/endpoint_id/monitor_rx file은 IPA "monitor" data를 수신하는 AP endpoint의 ID를 담습니다. Monitor endpoint는 processing을 위해 IPA hardware에 들어오는 packet의 replica를 제공합니다. 각 replicated packet 앞에는 fixed-size "ODL" header가 붙습니다(위의 .../XXXXXXX.ipa/feature/monitor 참조). Monitor function 제공에 필요한 bandwidth를 줄이기 위해 large packet은 truncate됩니다. |
EndpointAP 관점 traffic
modem_rxEmbedded modem -> AP
modem_txAP -> embedded modem
monitor_rxIPA ingress packet replicas -> AP
rx와 tx는 모두 application processor 관점입니다.
Packet enters IPA for processing→Monitor replica 생성→Fixed-size ODL header prepend→Large packet replica truncate→monitor_rx endpoint에서 수신
Monitor bandwidth 절감을 위해 replica의 large payload가 truncate될 수 있습니다.
Embedded-modem property directory
92-99| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/modem/ |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/modem/ directory에는 SoC에 embedded된 modem의 property를 설명하는 attribute가 있습니다. |
Modem receive-endpoint alias
100-107| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/modem/rx_endpoint_id |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/modem/rx_endpoint_id file은 .../XXXXXXX.ipa/endpoint_id/modem_rx에 있는 값을 중복 제공합니다. |
Modem transmit-endpoint alias
108-114| 항목 | 한국어 전문 번역 |
|---|---|
| What | .../XXXXXXX.ipa/modem/tx_endpoint_id |
| Date | 2021년 6월 |
| KernelVersion | v5.14 |
| Contact | Alex Elder <[email protected]> |
| Description | .../XXXXXXX.ipa/modem/tx_endpoint_id file은 .../XXXXXXX.ipa/endpoint_id/modem_tx에 있는 값을 중복 제공합니다. |
Modem pathCanonical endpoint-ID path
modem/rx_endpoint_idendpoint_id/modem_rx
modem/tx_endpoint_idendpoint_id/modem_tx
modem subtree의 두 attribute는 endpoint_id subtree 값을 그대로 duplicate합니다.
Device identity and offload features
sysfs-devices-platform-soc-ipa:1-48IPA root는 read-only hardware information을 제공하고 version과 feature subtree에서 hardware version 및 RX/TX MAP checksum-offload type을 표시합니다.