0001 What: /sys/bus/platform/devices/dfl-fme.0/ports_num
0002 Date: June 2018
0003 KernelVersion: 4.19
0004 Contact: Wu Hao <hao.wu@intel.com>
0005 Description: Read-only. One DFL FPGA device may have more than 1
0006 port/Accelerator Function Unit (AFU). It returns the
0007 number of ports on the FPGA device when read it.
0008
0009 What: /sys/bus/platform/devices/dfl-fme.0/bitstream_id
0010 Date: June 2018
0011 KernelVersion: 4.19
0012 Contact: Wu Hao <hao.wu@intel.com>
0013 Description: Read-only. It returns Bitstream (static FPGA region)
0014 identifier number, which includes the detailed version
0015 and other information of this static FPGA region.
0016
0017 What: /sys/bus/platform/devices/dfl-fme.0/bitstream_metadata
0018 Date: June 2018
0019 KernelVersion: 4.19
0020 Contact: Wu Hao <hao.wu@intel.com>
0021 Description: Read-only. It returns Bitstream (static FPGA region) meta
0022 data, which includes the synthesis date, seed and other
0023 information of this static FPGA region.
0024
0025 What: /sys/bus/platform/devices/dfl-fme.0/cache_size
0026 Date: August 2019
0027 KernelVersion: 5.4
0028 Contact: Wu Hao <hao.wu@intel.com>
0029 Description: Read-only. It returns cache size of this FPGA device.
0030
0031 What: /sys/bus/platform/devices/dfl-fme.0/fabric_version
0032 Date: August 2019
0033 KernelVersion: 5.4
0034 Contact: Wu Hao <hao.wu@intel.com>
0035 Description: Read-only. It returns fabric version of this FPGA device.
0036 Userspace applications need this information to select
0037 best data channels per different fabric design.
0038
0039 What: /sys/bus/platform/devices/dfl-fme.0/socket_id
0040 Date: August 2019
0041 KernelVersion: 5.4
0042 Contact: Wu Hao <hao.wu@intel.com>
0043 Description: Read-only. It returns socket_id to indicate which socket
0044 this FPGA belongs to, only valid for integrated solution.
0045 User only needs this information, in case standard numa node
0046 can't provide correct information.
0047
0048 What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors
0049 Date: August 2019
0050 KernelVersion: 5.4
0051 Contact: Wu Hao <hao.wu@intel.com>
0052 Description: Read-Write. Read this file for errors detected on pcie0 link.
0053 Write this file to clear errors logged in pcie0_errors. Write
0054 fails with -EINVAL if input parsing fails or input error code
0055 doesn't match.
0056
0057 What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors
0058 Date: August 2019
0059 KernelVersion: 5.4
0060 Contact: Wu Hao <hao.wu@intel.com>
0061 Description: Read-Write. Read this file for errors detected on pcie1 link.
0062 Write this file to clear errors logged in pcie1_errors. Write
0063 fails with -EINVAL if input parsing fails or input error code
0064 doesn't match.
0065
0066 What: /sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors
0067 Date: August 2019
0068 KernelVersion: 5.4
0069 Contact: Wu Hao <hao.wu@intel.com>
0070 Description: Read-only. It returns non-fatal errors detected.
0071
0072 What: /sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors
0073 Date: August 2019
0074 KernelVersion: 5.4
0075 Contact: Wu Hao <hao.wu@intel.com>
0076 Description: Read-only. It returns catastrophic and fatal errors detected.
0077
0078 What: /sys/bus/platform/devices/dfl-fme.0/errors/inject_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 check errors injected. Write this
0083 file to inject errors for testing purpose. Write fails with
0084 -EINVAL if input parsing fails or input inject error code isn't
0085 supported.
0086
0087 What: /sys/bus/platform/devices/dfl-fme.0/errors/fme_errors
0088 Date: August 2019
0089 KernelVersion: 5.4
0090 Contact: Wu Hao <hao.wu@intel.com>
0091 Description: Read-Write. Read this file to get errors detected on FME.
0092 Write this file to clear errors logged in fme_errors. Write
0093 fials with -EINVAL if input parsing fails or input error code
0094 doesn't match.
0095
0096 What: /sys/bus/platform/devices/dfl-fme.0/errors/first_error
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 error detected by
0101 hardware.
0102
0103 What: /sys/bus/platform/devices/dfl-fme.0/errors/next_error
0104 Date: August 2019
0105 KernelVersion: 5.4
0106 Contact: Wu Hao <hao.wu@intel.com>
0107 Description: Read-only. Read this file to get the second error detected by
0108 hardware.
0109
0110 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name
0111 Date: October 2019
0112 KernelVersion: 5.5
0113 Contact: Wu Hao <hao.wu@intel.com>
0114 Description: Read-Only. Read this file to get the name of hwmon device, it
0115 supports values:
0116
0117 ================= =========================
0118 'dfl_fme_thermal' thermal hwmon device name
0119 'dfl_fme_power' power hwmon device name
0120 ================= =========================
0121
0122 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input
0123 Date: October 2019
0124 KernelVersion: 5.5
0125 Contact: Wu Hao <hao.wu@intel.com>
0126 Description: Read-Only. It returns FPGA device temperature in millidegrees
0127 Celsius.
0128
0129 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max
0130 Date: October 2019
0131 KernelVersion: 5.5
0132 Contact: Wu Hao <hao.wu@intel.com>
0133 Description: Read-Only. It returns hardware threshold1 temperature in
0134 millidegrees Celsius. If temperature rises at or above this
0135 threshold, hardware starts 50% or 90% throttling (see
0136 'temp1_max_policy').
0137
0138 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit
0139 Date: October 2019
0140 KernelVersion: 5.5
0141 Contact: Wu Hao <hao.wu@intel.com>
0142 Description: Read-Only. It returns hardware threshold2 temperature in
0143 millidegrees Celsius. If temperature rises at or above this
0144 threshold, hardware starts 100% throttling.
0145
0146 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency
0147 Date: October 2019
0148 KernelVersion: 5.5
0149 Contact: Wu Hao <hao.wu@intel.com>
0150 Description: Read-Only. It returns hardware trip threshold temperature in
0151 millidegrees Celsius. If temperature rises at or above this
0152 threshold, a fatal event will be triggered to board management
0153 controller (BMC) to shutdown FPGA.
0154
0155 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm
0156 Date: October 2019
0157 KernelVersion: 5.5
0158 Contact: Wu Hao <hao.wu@intel.com>
0159 Description: Read-only. It returns 1 if temperature is currently at or above
0160 hardware threshold1 (see 'temp1_max'), otherwise 0.
0161
0162 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm
0163 Date: October 2019
0164 KernelVersion: 5.5
0165 Contact: Wu Hao <hao.wu@intel.com>
0166 Description: Read-only. It returns 1 if temperature is currently at or above
0167 hardware threshold2 (see 'temp1_crit'), otherwise 0.
0168
0169 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy
0170 Date: October 2019
0171 KernelVersion: 5.5
0172 Contact: Wu Hao <hao.wu@intel.com>
0173 Description: Read-Only. Read this file to get the policy of hardware threshold1
0174 (see 'temp1_max'). It only supports two values (policies):
0175
0176 == ==========================
0177 0 AP2 state (90% throttling)
0178 1 AP1 state (50% throttling)
0179 == ==========================
0180
0181 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input
0182 Date: October 2019
0183 KernelVersion: 5.5
0184 Contact: Wu Hao <hao.wu@intel.com>
0185 Description: Read-Only. It returns current FPGA power consumption in uW.
0186
0187 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max
0188 Date: October 2019
0189 KernelVersion: 5.5
0190 Contact: Wu Hao <hao.wu@intel.com>
0191 Description: Read-Write. Read this file to get current hardware power
0192 threshold1 in uW. If power consumption rises at or above
0193 this threshold, hardware starts 50% throttling.
0194 Write this file to set current hardware power threshold1 in uW.
0195 As hardware only accepts values in Watts, so input value will
0196 be round down per Watts (< 1 watts part will be discarded) and
0197 clamped within the range from 0 to 127 Watts. Write fails with
0198 -EINVAL if input parsing fails.
0199
0200 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit
0201 Date: October 2019
0202 KernelVersion: 5.5
0203 Contact: Wu Hao <hao.wu@intel.com>
0204 Description: Read-Write. Read this file to get current hardware power
0205 threshold2 in uW. If power consumption rises at or above
0206 this threshold, hardware starts 90% throttling.
0207 Write this file to set current hardware power threshold2 in uW.
0208 As hardware only accepts values in Watts, so input value will
0209 be round down per Watts (< 1 watts part will be discarded) and
0210 clamped within the range from 0 to 127 Watts. Write fails with
0211 -EINVAL if input parsing fails.
0212
0213 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm
0214 Date: October 2019
0215 KernelVersion: 5.5
0216 Contact: Wu Hao <hao.wu@intel.com>
0217 Description: Read-only. It returns 1 if power consumption is currently at or
0218 above hardware threshold1 (see 'power1_max'), otherwise 0.
0219
0220 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm
0221 Date: October 2019
0222 KernelVersion: 5.5
0223 Contact: Wu Hao <hao.wu@intel.com>
0224 Description: Read-only. It returns 1 if power consumption is currently at or
0225 above hardware threshold2 (see 'power1_crit'), otherwise 0.
0226
0227 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit
0228 Date: October 2019
0229 KernelVersion: 5.5
0230 Contact: Wu Hao <hao.wu@intel.com>
0231 Description: Read-Only. It returns power limit for XEON in uW.
0232
0233 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit
0234 Date: October 2019
0235 KernelVersion: 5.5
0236 Contact: Wu Hao <hao.wu@intel.com>
0237 Description: Read-Only. It returns power limit for FPGA in uW.
0238
0239 What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr
0240 Date: October 2019
0241 KernelVersion: 5.5
0242 Contact: Wu Hao <hao.wu@intel.com>
0243 Description: Read-only. Read this file to get current Latency Tolerance
0244 Reporting (ltr) value. It returns 1 if all Accelerated
0245 Function Units (AFUs) can tolerate latency >= 40us for memory
0246 access or 0 if any AFU is latency sensitive (< 40us).
