mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-14 15:54:15 +08:00
ebab9426cd
Fix typos in Documentation/ABI. The changes are in descriptions or comments where they shouldn't affect use of the ABIs. Signed-off-by: Bjorn Helgaas <bhelgaas@google.com> Reviewed-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20230814212822.193684-2-helgaas@kernel.org Signed-off-by: Jonathan Corbet <corbet@lwn.net>
247 lines
9.4 KiB
Plaintext
247 lines
9.4 KiB
Plaintext
What: /sys/bus/platform/devices/dfl-fme.0/ports_num
|
|
Date: June 2018
|
|
KernelVersion: 4.19
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. One DFL FPGA device may have more than 1
|
|
port/Accelerator Function Unit (AFU). It returns the
|
|
number of ports on the FPGA device when read it.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/bitstream_id
|
|
Date: June 2018
|
|
KernelVersion: 4.19
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns Bitstream (static FPGA region)
|
|
identifier number, which includes the detailed version
|
|
and other information of this static FPGA region.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/bitstream_metadata
|
|
Date: June 2018
|
|
KernelVersion: 4.19
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns Bitstream (static FPGA region) meta
|
|
data, which includes the synthesis date, seed and other
|
|
information of this static FPGA region.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/cache_size
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns cache size of this FPGA device.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/fabric_version
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns fabric version of this FPGA device.
|
|
Userspace applications need this information to select
|
|
best data channels per different fabric design.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/socket_id
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns socket_id to indicate which socket
|
|
this FPGA belongs to, only valid for integrated solution.
|
|
User only needs this information, in case standard numa node
|
|
can't provide correct information.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file for errors detected on pcie0 link.
|
|
Write this file to clear errors logged in pcie0_errors. Write
|
|
fails with -EINVAL if input parsing fails or input error code
|
|
doesn't match.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file for errors detected on pcie1 link.
|
|
Write this file to clear errors logged in pcie1_errors. Write
|
|
fails with -EINVAL if input parsing fails or input error code
|
|
doesn't match.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns non-fatal errors detected.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns catastrophic and fatal errors detected.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/inject_errors
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file to check errors injected. Write this
|
|
file to inject errors for testing purpose. Write fails with
|
|
-EINVAL if input parsing fails or input inject error code isn't
|
|
supported.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/errors/fme_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 FME.
|
|
Write this file to clear errors logged in fme_errors. Write
|
|
fails with -EINVAL if input parsing fails or input error code
|
|
doesn't match.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.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-fme.0/errors/next_error
|
|
Date: August 2019
|
|
KernelVersion: 5.4
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get the second error detected by
|
|
hardware.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. Read this file to get the name of hwmon device, it
|
|
supports values:
|
|
|
|
================= =========================
|
|
'dfl_fme_thermal' thermal hwmon device name
|
|
'dfl_fme_power' power hwmon device name
|
|
================= =========================
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns FPGA device temperature in millidegrees
|
|
Celsius.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns hardware threshold1 temperature in
|
|
millidegrees Celsius. If temperature rises at or above this
|
|
threshold, hardware starts 50% or 90% throttling (see
|
|
'temp1_max_policy').
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns hardware threshold2 temperature in
|
|
millidegrees Celsius. If temperature rises at or above this
|
|
threshold, hardware starts 100% throttling.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns hardware trip threshold temperature in
|
|
millidegrees Celsius. If temperature rises at or above this
|
|
threshold, a fatal event will be triggered to board management
|
|
controller (BMC) to shutdown FPGA.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns 1 if temperature is currently at or above
|
|
hardware threshold1 (see 'temp1_max'), otherwise 0.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns 1 if temperature is currently at or above
|
|
hardware threshold2 (see 'temp1_crit'), otherwise 0.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. Read this file to get the policy of hardware threshold1
|
|
(see 'temp1_max'). It only supports two values (policies):
|
|
|
|
== ==========================
|
|
0 AP2 state (90% throttling)
|
|
1 AP1 state (50% throttling)
|
|
== ==========================
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns current FPGA power consumption in uW.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file to get current hardware power
|
|
threshold1 in uW. If power consumption rises at or above
|
|
this threshold, hardware starts 50% throttling.
|
|
Write this file to set current hardware power threshold1 in uW.
|
|
As hardware only accepts values in Watts, so input value will
|
|
be round down per Watts (< 1 watts part will be discarded) and
|
|
clamped within the range from 0 to 127 Watts. Write fails with
|
|
-EINVAL if input parsing fails.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Write. Read this file to get current hardware power
|
|
threshold2 in uW. If power consumption rises at or above
|
|
this threshold, hardware starts 90% throttling.
|
|
Write this file to set current hardware power threshold2 in uW.
|
|
As hardware only accepts values in Watts, so input value will
|
|
be round down per Watts (< 1 watts part will be discarded) and
|
|
clamped within the range from 0 to 127 Watts. Write fails with
|
|
-EINVAL if input parsing fails.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns 1 if power consumption is currently at or
|
|
above hardware threshold1 (see 'power1_max'), otherwise 0.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. It returns 1 if power consumption is currently at or
|
|
above hardware threshold2 (see 'power1_crit'), otherwise 0.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns power limit for XEON in uW.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-Only. It returns power limit for FPGA in uW.
|
|
|
|
What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr
|
|
Date: October 2019
|
|
KernelVersion: 5.5
|
|
Contact: Wu Hao <hao.wu@intel.com>
|
|
Description: Read-only. Read this file to get current Latency Tolerance
|
|
Reporting (ltr) value. It returns 1 if all Accelerated
|
|
Function Units (AFUs) can tolerate latency >= 40us for memory
|
|
access or 0 if any AFU is latency sensitive (< 40us).
|