0001 What: /sys/bus/platform/devices/dfl-port.0/id
0002 Date: June 2018
0003 KernelVersion: 4.19
0004 Contact: Wu Hao <hao.wu@intel.com>
0005 Description: Read-only. It returns id of this port. One DFL FPGA device
0006 may have more than one port. Userspace could use this id to
0007 distinguish different ports under same FPGA device.
0008
0009 What: /sys/bus/platform/devices/dfl-port.0/afu_id
0010 Date: June 2018
0011 KernelVersion: 4.19
0012 Contact: Wu Hao <hao.wu@intel.com>
0013 Description: Read-only. User can program different PR bitstreams to FPGA
0014 Accelerator Function Unit (AFU) for different functions. It
0015 returns uuid which could be used to identify which PR bitstream
0016 is programmed in this AFU.
0017
0018 What: /sys/bus/platform/devices/dfl-port.0/power_state
0019 Date: August 2019
0020 KernelVersion: 5.4
0021 Contact: Wu Hao <hao.wu@intel.com>
0022 Description: Read-only. It reports the APx (AFU Power) state, different APx
0023 means different throttling level. When reading this file, it
0024 returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
0025
0026 What: /sys/bus/platform/devices/dfl-port.0/ap1_event
0027 Date: August 2019
0028 KernelVersion: 5.4
0029 Contact: Wu Hao <hao.wu@intel.com>
0030 Description: Read-write. Read this file for AP1 (AFU Power State 1) event.
0031 It's used to indicate transient AP1 state. Write 1 to this
0032 file to clear AP1 event.
0033
0034 What: /sys/bus/platform/devices/dfl-port.0/ap2_event
0035 Date: August 2019
0036 KernelVersion: 5.4
0037 Contact: Wu Hao <hao.wu@intel.com>
0038 Description: Read-write. Read this file for AP2 (AFU Power State 2) event.
0039 It's used to indicate transient AP2 state. Write 1 to this
0040 file to clear AP2 event.
0041
0042 What: /sys/bus/platform/devices/dfl-port.0/ltr
0043 Date: August 2019
0044 KernelVersion: 5.4
0045 Contact: Wu Hao <hao.wu@intel.com>
0046 Description: Read-write. Read or set AFU latency tolerance reporting value.
0047 Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
0048 to 0 if it is latency sensitive.
0049
0050 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
0051 Date: August 2019
0052 KernelVersion: 5.4
0053 Contact: Wu Hao <hao.wu@intel.com>
0054 Description: Write-only. User writes command to this interface to set
0055 userclock to AFU.
0056
0057 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqsts
0058 Date: August 2019
0059 KernelVersion: 5.4
0060 Contact: Wu Hao <hao.wu@intel.com>
0061 Description: Read-only. Read this file to get the status of issued command
0062 to userclck_freqcmd.
0063
0064 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
0065 Date: August 2019
0066 KernelVersion: 5.4
0067 Contact: Wu Hao <hao.wu@intel.com>
0068 Description: Write-only. User writes command to this interface to set
0069 userclock counter.
0070
0071 What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
0072 Date: August 2019
0073 KernelVersion: 5.4
0074 Contact: Wu Hao <hao.wu@intel.com>
0075 Description: Read-only. Read this file to get the status of issued command
0076 to userclck_freqcntrcmd.
0077
0078 What: /sys/bus/platform/devices/dfl-port.0/errors/errors
0079 Date: August 2019
0080 KernelVersion: 5.4
0081 Contact: Wu Hao <hao.wu@intel.com>
0082 Description: Read-Write. Read this file to get errors detected on port and
0083 Accelerated Function Unit (AFU). Write error code to this file
0084 to clear errors. Write fails with -EINVAL if input parsing
0085 fails or input error code doesn't match. Write fails with
0086 -EBUSY or -ETIMEDOUT if error can't be cleared as hardware
0087 in low power state (-EBUSY) or not respoding (-ETIMEDOUT).
0088
0089 What: /sys/bus/platform/devices/dfl-port.0/errors/first_error
0090 Date: August 2019
0091 KernelVersion: 5.4
0092 Contact: Wu Hao <hao.wu@intel.com>
0093 Description: Read-only. Read this file to get the first error detected by
0094 hardware.
0095
0096 What: /sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
0097 Date: August 2019
0098 KernelVersion: 5.4
0099 Contact: Wu Hao <hao.wu@intel.com>
0100 Description: Read-only. Read this file to get the first malformed request
0101 captured by hardware.
