44d247534f
Error reporting is one important private feature, it reports error detected on port and accelerated function unit (AFU). It introduces several sysfs interfaces to allow userspace to check and clear errors detected by hardware. Signed-off-by: Xu Yilun <yilun.xu@intel.com> Signed-off-by: Wu Hao <hao.wu@intel.com> Acked-by: Alan Tull <atull@kernel.org> Signed-off-by: Moritz Fischer <mdf@kernel.org>
102 lines
3.7 KiB
Plaintext
102 lines
3.7 KiB
Plaintext
What: /sys/bus/platform/devices/dfl-port.0/id
|
|
Date: June 2018
|
|
KernelVersion: 4.19
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns id of this port. One DFL FPGA device
|
|
may have more than one port. Userspace could use this id to
|
|
distinguish different ports under same FPGA device.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/afu_id
|
|
Date: June 2018
|
|
KernelVersion: 4.19
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. User can program different PR bitstreams to FPGA
|
|
Accelerator Function Unit (AFU) for different functions. It
|
|
returns uuid which could be used to identify which PR bitstream
|
|
is programmed in this AFU.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/power_state
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It reports the APx (AFU Power) state, different APx
|
|
means different throttling level. When reading this file, it
|
|
returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/ap1_event
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-write. Read this file for AP1 (AFU Power State 1) event.
|
|
It's used to indicate transient AP1 state. Write 1 to this
|
|
file to clear AP1 event.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/ap2_event
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-write. Read this file for AP2 (AFU Power State 2) event.
|
|
It's used to indicate transient AP2 state. Write 1 to this
|
|
file to clear AP2 event.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/ltr
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-write. Read or set AFU latency tolerance reporting value.
|
|
Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
|
|
to 0 if it is latency sensitive.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Write-only. User writes command to this interface to set
|
|
userclock to AFU.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/userclk_freqsts
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get the status of issued command
|
|
to userclck_freqcmd.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Write-only. User writes command to this interface to set
|
|
userclock counter.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get the status of issued command
|
|
to userclck_freqcntrcmd.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/errors/errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file to get errors detected on port and
|
|
Accelerated Function Unit (AFU). Write error code to this file
|
|
to clear errors. Write fails with -EINVAL if input parsing
|
|
fails or input error code doesn't match. Write fails with
|
|
-EBUSY or -ETIMEDOUT if error can't be cleared as hardware
|
|
in low power state (-EBUSY) or not respoding (-ETIMEDOUT).
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/errors/first_error
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get the first error detected by
|
|
hardware.
|
|
|
|
What: /sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get the first malformed request
|
|
captured by hardware.
|