요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Hardware identity와 transaction tuning
sysfs-platform-hidma-mgmt:40-97Hardware version, outstanding read/write transaction 수와 power-of-two request size를 설정합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/platform/hidma-mgmt*/chanops/chan*/priority
2
/sys/devices/platform/QCOM8060:*/chanops/chan*/priority
3
Date: Nov 2015
4
KernelVersion: 4.4
5
Contact: "Sinan Kaya <[email protected]>"
6
Description:
7
Contains either 0 or 1 and indicates if the DMA channel is a
8
low priority (0) or high priority (1) channel.
10
What: /sys/devices/platform/hidma-mgmt*/chanops/chan*/weight
11
/sys/devices/platform/QCOM8060:*/chanops/chan*/weight
12
Date: Nov 2015
13
KernelVersion: 4.4
14
Contact: "Sinan Kaya <[email protected]>"
15
Description:
16
Contains 0..15 and indicates the weight of the channel among
17
equal priority channels during round robin scheduling.
19
What: /sys/devices/platform/hidma-mgmt*/chreset_timeout_cycles
20
/sys/devices/platform/QCOM8060:*/chreset_timeout_cycles
21
Date: Nov 2015
22
KernelVersion: 4.4
23
Contact: "Sinan Kaya <[email protected]>"
24
Description:
25
Contains the platform specific cycle value to wait after a
26
reset command is issued. If the value is chosen too short,
27
then the HW will issue a reset failure interrupt. The value
28
is platform specific and should not be changed without
29
consultance.
31
What: /sys/devices/platform/hidma-mgmt*/dma_channels
32
/sys/devices/platform/QCOM8060:*/dma_channels
33
Date: Nov 2015
34
KernelVersion: 4.4
35
Contact: "Sinan Kaya <[email protected]>"
36
Description:
37
Contains the number of dma channels supported by one instance
38
of HIDMA hardware. The value may change from chip to chip.
40
What: /sys/devices/platform/hidma-mgmt*/hw_version_major
41
/sys/devices/platform/QCOM8060:*/hw_version_major
42
Date: Nov 2015
43
KernelVersion: 4.4
44
Contact: "Sinan Kaya <[email protected]>"
45
Description:
46
Version number major for the hardware.
48
What: /sys/devices/platform/hidma-mgmt*/hw_version_minor
49
/sys/devices/platform/QCOM8060:*/hw_version_minor
50
Date: Nov 2015
51
KernelVersion: 4.4
52
Contact: "Sinan Kaya <[email protected]>"
53
Description:
54
Version number minor for the hardware.
56
What: /sys/devices/platform/hidma-mgmt*/max_rd_xactions
57
/sys/devices/platform/QCOM8060:*/max_rd_xactions
58
Date: Nov 2015
59
KernelVersion: 4.4
60
Contact: "Sinan Kaya <[email protected]>"
61
Description:
62
Contains a value between 0 and 31. Maximum number of
63
read transactions that can be issued back to back.
64
Choosing a higher number gives better performance but
65
can also cause performance reduction to other peripherals
66
sharing the same bus.
68
What: /sys/devices/platform/hidma-mgmt*/max_read_request
69
/sys/devices/platform/QCOM8060:*/max_read_request
70
Date: Nov 2015
71
KernelVersion: 4.4
72
Contact: "Sinan Kaya <[email protected]>"
73
Description:
74
Size of each read request. The value needs to be a power
75
of two and can be between 128 and 1024.
77
What: /sys/devices/platform/hidma-mgmt*/max_wr_xactions
78
/sys/devices/platform/QCOM8060:*/max_wr_xactions
79
Date: Nov 2015
80
KernelVersion: 4.4
81
Contact: "Sinan Kaya <[email protected]>"
82
Description:
83
Contains a value between 0 and 31. Maximum number of
84
write transactions that can be issued back to back.
85
Choosing a higher number gives better performance but
86
can also cause performance reduction to other peripherals
87
sharing the same bus.
90
What: /sys/devices/platform/hidma-mgmt*/max_write_request
91
/sys/devices/platform/QCOM8060:*/max_write_request
92
Date: Nov 2015
93
KernelVersion: 4.4
94
Contact: "Sinan Kaya <[email protected]>"
95
Description:
96
Size of each write request. The value needs to be a power
97
of two and can be between 128 and 1024.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
HIDMA management sysfs ABI: priority
1-9| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/chanops/chan*/priority /sys/devices/platform/QCOM8060:*/chanops/chan*/priority |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `chanops/chan*/priority`는 `0` 또는 `1`을 담습니다. `0`은 low-priority DMA channel, `1`은 high-priority channel입니다. |
AttributeRangeMeaning
priority0 / 1Low / high priority
weight0..15Weight among equal-priority channels
Priority class 안에서 weight가 round-robin share를 조정합니다.
HIDMA management sysfs ABI: weight
10-18| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/chanops/chan*/weight /sys/devices/platform/QCOM8060:*/chanops/chan*/weight |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `chanops/chan*/weight`는 `0..15`를 담으며 같은 priority channels 사이의 round-robin scheduling weight를 나타냅니다. |
HIDMA management sysfs ABI: chreset timeout cycles
19-30| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/chreset_timeout_cycles /sys/devices/platform/QCOM8060:*/chreset_timeout_cycles |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `chreset_timeout_cycles`는 reset command를 발행한 뒤 기다릴 platform-specific cycle value를 담습니다. 너무 짧게 정하면 hardware가 reset-failure interrupt를 발생시킵니다. Platform-specific value이므로 consultation 없이 변경하면 안 됩니다. |
Issue reset command→Wait chreset_timeout_cycles→Timeout too short?→Reset-failure interrupt
Reset wait가 platform requirement보다 짧으면 hardware가 failure interrupt를 냅니다.
HIDMA management sysfs ABI: dma channels
31-39| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/dma_channels /sys/devices/platform/QCOM8060:*/dma_channels |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `dma_channels`는 HIDMA hardware instance 하나가 지원하는 DMA channels 수를 담으며 chip마다 달라질 수 있습니다. |
HIDMA management sysfs ABI: hw version major
40-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/hw_version_major /sys/devices/platform/QCOM8060:*/hw_version_major |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `hw_version_major`는 hardware major version number를 담습니다. |
HIDMA management sysfs ABI: hw version minor
48-55| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/hw_version_minor /sys/devices/platform/QCOM8060:*/hw_version_minor |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `hw_version_minor`는 hardware minor version number를 담습니다. |
HIDMA management sysfs ABI: max rd xactions
56-67| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/max_rd_xactions /sys/devices/platform/QCOM8060:*/max_rd_xactions |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `max_rd_xactions`는 `0`~`31`이며 연속해서 발행할 수 있는 maximum read transactions 수입니다. 높은 value는 성능을 높일 수 있지만 같은 bus를 공유하는 다른 peripherals의 성능을 낮출 수도 있습니다. |
DirectionMax transactionsRequest size
Readmax_rd_xactions: 0..31max_read_request: 128..1024, power of two
Writemax_wr_xactions: 0..31max_write_request: 128..1024, power of two
Outstanding transaction count는 throughput·bus fairness tradeoff이고 request size는 power-of-two constraint를 가집니다.
HIDMA management sysfs ABI: max read request
68-76| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/max_read_request /sys/devices/platform/QCOM8060:*/max_read_request |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `max_read_request`는 각 read request size입니다. Value는 power of two여야 하며 `128`~`1024` 범위입니다. |
HIDMA management sysfs ABI: max wr xactions
77-89| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/max_wr_xactions /sys/devices/platform/QCOM8060:*/max_wr_xactions |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `max_wr_xactions`는 `0`~`31`이며 연속해서 발행할 수 있는 maximum write transactions 수입니다. 높은 value는 성능을 높일 수 있지만 같은 bus를 공유하는 다른 peripherals의 성능을 낮출 수도 있습니다. |
HIDMA management sysfs ABI: max write request
90-97| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/platform/hidma-mgmt*/max_write_request /sys/devices/platform/QCOM8060:*/max_write_request |
| Date | 2015년 11월 |
| KernelVersion | 4.4 |
| Contact | "Sinan Kaya <[email protected]>" |
| Description | `max_write_request`는 각 write request size입니다. Value는 power of two여야 하며 `128`~`1024` 범위입니다. |
Channel scheduling과 reset timing
sysfs-platform-hidma-mgmt:1-39Per-channel priority·round-robin weight와 platform-specific reset wait를 제어하고 instance channel count를 제공합니다.