← Documents Documentation/ABI/testing/sysfs-platform-dfl-port GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

DFL FPGA port sysfs ABI

DFL FPGA port와 AFU의 identity, APx power state, latency tolerance, user clock commands와 port errors를 정의합니다.

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

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

1. 요약·해설

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

Port·AFU identity와 APx state

sysfs-platform-dfl-port:1-49

Port ID와 loaded PR bitstream UUID, current·transient APx throttling state와 per-AFU 40us latency tolerance를 제공합니다.

User clock commands와 error capture

sysfs-platform-dfl-port:50-101

User clock 및 counter command/status pairs와 port·AFU error clear, first error와 malformed request 기록을 노출합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/platform/devices/dfl-port.0/id
2 Date: June 2018
3 KernelVersion: 4.19
4 Contact: Wu Hao <[email protected]>
5 Description: Read-only. It returns id of this port. One DFL FPGA device
6 may have more than one port. Userspace could use this id to
7 distinguish different ports under same FPGA device.
8
9 What: /sys/bus/platform/devices/dfl-port.0/afu_id
10 Date: June 2018
11 KernelVersion: 4.19
12 Contact: Wu Hao <[email protected]>
13 Description: Read-only. User can program different PR bitstreams to FPGA
14 Accelerator Function Unit (AFU) for different functions. It
15 returns uuid which could be used to identify which PR bitstream
16 is programmed in this AFU.
17
18 What: /sys/bus/platform/devices/dfl-port.0/power_state
19 Date: August 2019
20 KernelVersion: 5.4
21 Contact: Wu Hao <[email protected]>
22 Description: Read-only. It reports the APx (AFU Power) state, different APx
23 means different throttling level. When reading this file, it
24 returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
25
26 What: /sys/bus/platform/devices/dfl-port.0/ap1_event
27 Date: August 2019
28 KernelVersion: 5.4
29 Contact: Wu Hao <[email protected]>
30 Description: Read-write. Read this file for AP1 (AFU Power State 1) event.
31 It's used to indicate transient AP1 state. Write 1 to this
32 file to clear AP1 event.
33
34 What: /sys/bus/platform/devices/dfl-port.0/ap2_event
35 Date: August 2019
36 KernelVersion: 5.4
37 Contact: Wu Hao <[email protected]>
38 Description: Read-write. Read this file for AP2 (AFU Power State 2) event.
39 It's used to indicate transient AP2 state. Write 1 to this
40 file to clear AP2 event.
41
42 What: /sys/bus/platform/devices/dfl-port.0/ltr
43 Date: August 2019
44 KernelVersion: 5.4
45 Contact: Wu Hao <[email protected]>
46 Description: Read-write. Read or set AFU latency tolerance reporting value.
47 Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
48 to 0 if it is latency sensitive.
49
50 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
51 Date: August 2019
52 KernelVersion: 5.4
53 Contact: Wu Hao <[email protected]>
54 Description: Write-only. User writes command to this interface to set
55 userclock to AFU.
56
57 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqsts
58 Date: August 2019
59 KernelVersion: 5.4
60 Contact: Wu Hao <[email protected]>
61 Description: Read-only. Read this file to get the status of issued command
62 to userclck_freqcmd.
63
64 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
65 Date: August 2019
66 KernelVersion: 5.4
67 Contact: Wu Hao <[email protected]>
68 Description: Write-only. User writes command to this interface to set
69 userclock counter.
70
71 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
72 Date: August 2019
73 KernelVersion: 5.4
74 Contact: Wu Hao <[email protected]>
75 Description: Read-only. Read this file to get the status of issued command
76 to userclck_freqcntrcmd.
77
78 What: /sys/bus/platform/devices/dfl-port.0/errors/errors
79 Date: August 2019
80 KernelVersion: 5.4
81 Contact: Wu Hao <[email protected]>
82 Description: Read-Write. Read this file to get errors detected on port and
83 Accelerated Function Unit (AFU). Write error code to this file
84 to clear errors. Write fails with -EINVAL if input parsing
85 fails or input error code doesn't match. Write fails with
86 -EBUSY or -ETIMEDOUT if error can't be cleared as hardware
87 in low power state (-EBUSY) or not respoding (-ETIMEDOUT).
88
89 What: /sys/bus/platform/devices/dfl-port.0/errors/first_error
90 Date: August 2019
91 KernelVersion: 5.4
92 Contact: Wu Hao <[email protected]>
93 Description: Read-only. Read this file to get the first error detected by
94 hardware.
95
96 What: /sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
97 Date: August 2019
98 KernelVersion: 5.4
99 Contact: Wu Hao <[email protected]>
100 Description: Read-only. Read this file to get the first malformed request
101 captured by hardware.
102

3. 한국어 전문 번역

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

DFL FPGA port sysfs ABI: id

1-8
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/id
Date2018년 6월
KernelVersion4.19
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/id`는 read-only이며 이 port의 ID를 반환합니다. 하나의 DFL FPGA device에는 여러 ports가 있을 수 있고 userspace는 이 ID로 같은 FPGA 아래의 ports를 구분합니다.

DFL FPGA port sysfs ABI: afu id

9-17
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/afu_id
Date2018년 6월
KernelVersion4.19
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/afu_id`는 read-only입니다. User는 서로 다른 functions를 위해 서로 다른 partial-reconfiguration(PR) bitstreams를 FPGA Accelerator Function Unit(AFU)에 program할 수 있습니다. 이 file은 현재 AFU에 program된 PR bitstream을 식별하는 UUID를 반환합니다.

DFL FPGA port sysfs ABI: power state

18-25
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/power_state
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/power_state`는 read-only이며 APx(AFU Power) state를 보고합니다. APx마다 throttling level이 다릅니다. Read value `0`은 Normal, `1`은 AP1, `2`는 AP2, `6`은 AP6입니다.
DFL AFU power states
ValueState
0Normal
1AP1
2AP2
6AP6

Read value가 current AFU APx throttling state를 나타냅니다.

DFL FPGA port sysfs ABI: ap1 event

26-33
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/ap1_event
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/ap1_event`는 read/write이며 transient AP1(AFU Power State 1) event를 나타냅니다. Read하면 AP1 event를 확인하고 `1`을 write하면 clear합니다.

DFL FPGA port sysfs ABI: ap2 event

34-41
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/ap2_event
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/ap2_event`는 read/write이며 transient AP2(AFU Power State 2) event를 나타냅니다. Read하면 AP2 event를 확인하고 `1`을 write하면 clear합니다.

DFL FPGA port sysfs ABI: ltr

42-49
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/ltr
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/ltr`은 read/write이며 AFU latency tolerance reporting value를 읽거나 설정합니다. AFU가 `>= 40us` latency를 견딜 수 있으면 `1`, latency-sensitive이면 `0`으로 설정합니다.

DFL FPGA port sysfs ABI: userclk freqcmd

50-56
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/userclk_freqcmd`는 write-only이며 AFU user clock을 설정하는 command를 받습니다.
DFL user-clock command pairs
Command attributeStatus attributePurpose
userclk_freqcmduserclk_freqstsSet AFU user clock
userclk_freqcntrcmduserclk_freqcntrstsSet user-clock counter

각 write-only command에는 결과를 읽는 read-only status attribute가 대응합니다.

DFL FPGA port sysfs ABI: userclk freqsts

57-63
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/userclk_freqsts
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/userclk_freqsts`는 read-only이며 `userclk_freqcmd`로 발행한 command의 status를 반환합니다.

DFL FPGA port sysfs ABI: userclk freqcntrcmd

64-70
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd`는 write-only이며 user clock counter를 설정하는 command를 받습니다.

DFL FPGA port sysfs ABI: userclk freqcntrsts

71-77
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts`는 read-only이며 `userclk_freqcntrcmd`로 발행한 command의 status를 반환합니다.

DFL FPGA port sysfs ABI: errors

78-88
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/errors/errors
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/errors/errors`는 read/write입니다. Read하면 port와 AFU에서 감지된 errors를 반환하고 matching error code를 write하면 clear합니다. Parsing 실패 또는 code mismatch는 `-EINVAL`, hardware가 low-power state라 clear할 수 없으면 `-EBUSY`, hardware가 응답하지 않으면 `-ETIMEDOUT`으로 실패합니다.
DFL port error-clear failures
ErrorCondition
-EINVALParsing failed or error code did not match
-EBUSYHardware is in low-power state
-ETIMEDOUTHardware did not respond

Error code write는 exact match와 responsive hardware를 요구합니다.

DFL FPGA port sysfs ABI: first error

89-95
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/errors/first_error
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/errors/first_error`는 read-only이며 hardware가 처음 감지한 error를 반환합니다.

DFL FPGA port sysfs ABI: first malformed req

96-101
항목한국어 전문 번역
What/sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
Date2019년 8월
KernelVersion5.4
ContactWu Hao <[email protected]>
Description`/sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req`는 read-only이며 hardware가 capture한 첫 malformed request를 반환합니다.