tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1What: /sys/bus/platform/devices/dfl-port.0/id
2Date: June 2018
3KernelVersion: 4.19
4Contact: Wu Hao <hao.wu@intel.com>
5Description: 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
9What: /sys/bus/platform/devices/dfl-port.0/afu_id
10Date: June 2018
11KernelVersion: 4.19
12Contact: Wu Hao <hao.wu@intel.com>
13Description: 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
18What: /sys/bus/platform/devices/dfl-port.0/power_state
19Date: August 2019
20KernelVersion: 5.4
21Contact: Wu Hao <hao.wu@intel.com>
22Description: 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
26What: /sys/bus/platform/devices/dfl-port.0/ap1_event
27Date: August 2019
28KernelVersion: 5.4
29Contact: Wu Hao <hao.wu@intel.com>
30Description: 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
34What: /sys/bus/platform/devices/dfl-port.0/ap2_event
35Date: August 2019
36KernelVersion: 5.4
37Contact: Wu Hao <hao.wu@intel.com>
38Description: 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
42What: /sys/bus/platform/devices/dfl-port.0/ltr
43Date: August 2019
44KernelVersion: 5.4
45Contact: Wu Hao <hao.wu@intel.com>
46Description: 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
50What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
51Date: August 2019
52KernelVersion: 5.4
53Contact: Wu Hao <hao.wu@intel.com>
54Description: Write-only. User writes command to this interface to set
55 userclock to AFU.
56
57What: /sys/bus/platform/devices/dfl-port.0/userclk_freqsts
58Date: August 2019
59KernelVersion: 5.4
60Contact: Wu Hao <hao.wu@intel.com>
61Description: Read-only. Read this file to get the status of issued command
62 to userclck_freqcmd.
63
64What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
65Date: August 2019
66KernelVersion: 5.4
67Contact: Wu Hao <hao.wu@intel.com>
68Description: Write-only. User writes command to this interface to set
69 userclock counter.
70
71What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
72Date: August 2019
73KernelVersion: 5.4
74Contact: Wu Hao <hao.wu@intel.com>
75Description: Read-only. Read this file to get the status of issued command
76 to userclck_freqcntrcmd.
77
78What: /sys/bus/platform/devices/dfl-port.0/errors/errors
79Date: August 2019
80KernelVersion: 5.4
81Contact: Wu Hao <hao.wu@intel.com>
82Description: 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
89What: /sys/bus/platform/devices/dfl-port.0/errors/first_error
90Date: August 2019
91KernelVersion: 5.4
92Contact: Wu Hao <hao.wu@intel.com>
93Description: Read-only. Read this file to get the first error detected by
94 hardware.
95
96What: /sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
97Date: August 2019
98KernelVersion: 5.4
99Contact: Wu Hao <hao.wu@intel.com>
100Description: Read-only. Read this file to get the first malformed request
101 captured by hardware.