hc
2023-12-11 d2ccde1c8e90d38cee87a1b0309ad2827f3fd30d
kernel/Documentation/ABI/testing/sysfs-platform-dfl-port
....@@ -14,3 +14,88 @@
1414 Accelerator Function Unit (AFU) for different functions. It
1515 returns uuid which could be used to identify which PR bitstream
1616 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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
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 <hao.wu@intel.com>
100
+Description: Read-only. Read this file to get the first malformed request
101
+ captured by hardware.