← Documents Documentation/ABI/testing/sysfs-platform-hidma-mgmt GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

HIDMA management sysfs ABI

HIDMA channel scheduling priority·weight, reset timing, hardware version과 read/write transaction tuning을 정의합니다.

Source pathDocumentation/ABI/testing/sysfs-platform-hidma-mgmt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Channel scheduling과 reset timing

sysfs-platform-hidma-mgmt:1-39

Per-channel priority·round-robin weight와 platform-specific reset wait를 제어하고 instance channel count를 제공합니다.

Hardware identity와 transaction tuning

sysfs-platform-hidma-mgmt:40-97

Hardware 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 <okaya@kernel.org>"
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.
9
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 <okaya@kernel.org>"
15 Description:
16 Contains 0..15 and indicates the weight of the channel among
17 equal priority channels during round robin scheduling.
18
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 <okaya@kernel.org>"
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.
30
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 <okaya@kernel.org>"
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.
39
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 <okaya@kernel.org>"
45 Description:
46 Version number major for the hardware.
47
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 <okaya@kernel.org>"
53 Description:
54 Version number minor for the hardware.
55
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 <okaya@kernel.org>"
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.
67
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 <okaya@kernel.org>"
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.
76
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 <okaya@kernel.org>"
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.
88
89
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 <okaya@kernel.org>"
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.
98

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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
Description`chanops/chan*/priority`는 `0` 또는 `1`을 담습니다. `0`은 low-priority DMA channel, `1`은 high-priority channel입니다.
HIDMA scheduling controls
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
Description`chreset_timeout_cycles`는 reset command를 발행한 뒤 기다릴 platform-specific cycle value를 담습니다. 너무 짧게 정하면 hardware가 reset-failure interrupt를 발생시킵니다. Platform-specific value이므로 consultation 없이 변경하면 안 됩니다.
HIDMA reset timing risk
Issue reset commandWait chreset_timeout_cyclesTimeout 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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
Description`max_rd_xactions`는 `0`~`31`이며 연속해서 발행할 수 있는 maximum read transactions 수입니다. 높은 value는 성능을 높일 수 있지만 같은 bus를 공유하는 다른 peripherals의 성능을 낮출 수도 있습니다.
HIDMA transaction tuning
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
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
Date2015년 11월
KernelVersion4.4
Contact"Sinan Kaya <okaya@kernel.org>"
Description`max_write_request`는 각 write request size입니다. Value는 power of two여야 하며 `128`~`1024` 범위입니다.