1What: /sys/bus/platform/devices/dfl-fme.0/ports_num 2Date: June 2018 3KernelVersion: 4.19 4Contact: Wu Hao <hao.wu@intel.com> 5Description: Read-only. One DFL FPGA device may have more than 1 6 port/Accelerator Function Unit (AFU). It returns the 7 number of ports on the FPGA device when read it. 8 9What: /sys/bus/platform/devices/dfl-fme.0/bitstream_id 10Date: June 2018 11KernelVersion: 4.19 12Contact: Wu Hao <hao.wu@intel.com> 13Description: Read-only. It returns Bitstream (static FPGA region) 14 identifier number, which includes the detailed version 15 and other information of this static FPGA region. 16 17What: /sys/bus/platform/devices/dfl-fme.0/bitstream_metadata 18Date: June 2018 19KernelVersion: 4.19 20Contact: Wu Hao <hao.wu@intel.com> 21Description: Read-only. It returns Bitstream (static FPGA region) meta 22 data, which includes the synthesis date, seed and other 23 information of this static FPGA region. 24 25What: /sys/bus/platform/devices/dfl-fme.0/cache_size 26Date: August 2019 27KernelVersion: 5.4 28Contact: Wu Hao <hao.wu@intel.com> 29Description: Read-only. It returns cache size of this FPGA device. 30 31What: /sys/bus/platform/devices/dfl-fme.0/fabric_version 32Date: August 2019 33KernelVersion: 5.4 34Contact: Wu Hao <hao.wu@intel.com> 35Description: Read-only. It returns fabric version of this FPGA device. 36 Userspace applications need this information to select 37 best data channels per different fabric design. 38 39What: /sys/bus/platform/devices/dfl-fme.0/socket_id 40Date: August 2019 41KernelVersion: 5.4 42Contact: Wu Hao <hao.wu@intel.com> 43Description: Read-only. It returns socket_id to indicate which socket 44 this FPGA belongs to, only valid for integrated solution. 45 User only needs this information, in case standard numa node 46 can't provide correct information. 47 48What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors 49Date: August 2019 50KernelVersion: 5.4 51Contact: Wu Hao <hao.wu@intel.com> 52Description: Read-Write. Read this file for errors detected on pcie0 link. 53 Write this file to clear errors logged in pcie0_errors. Write 54 fails with -EINVAL if input parsing fails or input error code 55 doesn't match. 56 57What: /sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors 58Date: August 2019 59KernelVersion: 5.4 60Contact: Wu Hao <hao.wu@intel.com> 61Description: Read-Write. Read this file for errors detected on pcie1 link. 62 Write this file to clear errors logged in pcie1_errors. Write 63 fails with -EINVAL if input parsing fails or input error code 64 doesn't match. 65 66What: /sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors 67Date: August 2019 68KernelVersion: 5.4 69Contact: Wu Hao <hao.wu@intel.com> 70Description: Read-only. It returns non-fatal errors detected. 71 72What: /sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors 73Date: August 2019 74KernelVersion: 5.4 75Contact: Wu Hao <hao.wu@intel.com> 76Description: Read-only. It returns catastrophic and fatal errors detected. 77 78What: /sys/bus/platform/devices/dfl-fme.0/errors/inject_errors 79Date: August 2019 80KernelVersion: 5.4 81Contact: Wu Hao <hao.wu@intel.com> 82Description: Read-Write. Read this file to check errors injected. Write this 83 file to inject errors for testing purpose. Write fails with 84 -EINVAL if input parsing fails or input inject error code isn't 85 supported. 86 87What: /sys/bus/platform/devices/dfl-fme.0/errors/fme_errors 88Date: August 2019 89KernelVersion: 5.4 90Contact: Wu Hao <hao.wu@intel.com> 91Description: Read-Write. Read this file to get errors detected on FME. 92 Write this file to clear errors logged in fme_errors. Write 93 fials with -EINVAL if input parsing fails or input error code 94 doesn't match. 95 96What: /sys/bus/platform/devices/dfl-fme.0/errors/first_error 97Date: August 2019 98KernelVersion: 5.4 99Contact: Wu Hao <hao.wu@intel.com> 100Description: Read-only. Read this file to get the first error detected by 101 hardware. 102 103What: /sys/bus/platform/devices/dfl-fme.0/errors/next_error 104Date: August 2019 105KernelVersion: 5.4 106Contact: Wu Hao <hao.wu@intel.com> 107Description: Read-only. Read this file to get the second error detected by 108 hardware. 109 110What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/name 111Date: October 2019 112KernelVersion: 5.5 113Contact: Wu Hao <hao.wu@intel.com> 114Description: Read-Only. Read this file to get the name of hwmon device, it 115 supports values: 116 117 ================= ========================= 118 'dfl_fme_thermal' thermal hwmon device name 119 'dfl_fme_power' power hwmon device name 120 ================= ========================= 121 122What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_input 123Date: October 2019 124KernelVersion: 5.5 125Contact: Wu Hao <hao.wu@intel.com> 126Description: Read-Only. It returns FPGA device temperature in millidegrees 127 Celsius. 128 129What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max 130Date: October 2019 131KernelVersion: 5.5 132Contact: Wu Hao <hao.wu@intel.com> 133Description: Read-Only. It returns hardware threshold1 temperature in 134 millidegrees Celsius. If temperature rises at or above this 135 threshold, hardware starts 50% or 90% throttling (see 136 'temp1_max_policy'). 137 138What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit 139Date: October 2019 140KernelVersion: 5.5 141Contact: Wu Hao <hao.wu@intel.com> 142Description: Read-Only. It returns hardware threshold2 temperature in 143 millidegrees Celsius. If temperature rises at or above this 144 threshold, hardware starts 100% throttling. 145 146What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_emergency 147Date: October 2019 148KernelVersion: 5.5 149Contact: Wu Hao <hao.wu@intel.com> 150Description: Read-Only. It returns hardware trip threshold temperature in 151 millidegrees Celsius. If temperature rises at or above this 152 threshold, a fatal event will be triggered to board management 153 controller (BMC) to shutdown FPGA. 154 155What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_alarm 156Date: October 2019 157KernelVersion: 5.5 158Contact: Wu Hao <hao.wu@intel.com> 159Description: Read-only. It returns 1 if temperature is currently at or above 160 hardware threshold1 (see 'temp1_max'), otherwise 0. 161 162What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_crit_alarm 163Date: October 2019 164KernelVersion: 5.5 165Contact: Wu Hao <hao.wu@intel.com> 166Description: Read-only. It returns 1 if temperature is currently at or above 167 hardware threshold2 (see 'temp1_crit'), otherwise 0. 168 169What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/temp1_max_policy 170Date: October 2019 171KernelVersion: 5.5 172Contact: Wu Hao <hao.wu@intel.com> 173Description: Read-Only. Read this file to get the policy of hardware threshold1 174 (see 'temp1_max'). It only supports two values (policies): 175 176 == ========================== 177 0 AP2 state (90% throttling) 178 1 AP1 state (50% throttling) 179 == ========================== 180 181What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_input 182Date: October 2019 183KernelVersion: 5.5 184Contact: Wu Hao <hao.wu@intel.com> 185Description: Read-Only. It returns current FPGA power consumption in uW. 186 187What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max 188Date: October 2019 189KernelVersion: 5.5 190Contact: Wu Hao <hao.wu@intel.com> 191Description: Read-Write. Read this file to get current hardware power 192 threshold1 in uW. If power consumption rises at or above 193 this threshold, hardware starts 50% throttling. 194 Write this file to set current hardware power threshold1 in uW. 195 As hardware only accepts values in Watts, so input value will 196 be round down per Watts (< 1 watts part will be discarded) and 197 clamped within the range from 0 to 127 Watts. Write fails with 198 -EINVAL if input parsing fails. 199 200What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit 201Date: October 2019 202KernelVersion: 5.5 203Contact: Wu Hao <hao.wu@intel.com> 204Description: Read-Write. Read this file to get current hardware power 205 threshold2 in uW. If power consumption rises at or above 206 this threshold, hardware starts 90% throttling. 207 Write this file to set current hardware power threshold2 in uW. 208 As hardware only accepts values in Watts, so input value will 209 be round down per Watts (< 1 watts part will be discarded) and 210 clamped within the range from 0 to 127 Watts. Write fails with 211 -EINVAL if input parsing fails. 212 213What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_max_alarm 214Date: October 2019 215KernelVersion: 5.5 216Contact: Wu Hao <hao.wu@intel.com> 217Description: Read-only. It returns 1 if power consumption is currently at or 218 above hardware threshold1 (see 'power1_max'), otherwise 0. 219 220What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_crit_alarm 221Date: October 2019 222KernelVersion: 5.5 223Contact: Wu Hao <hao.wu@intel.com> 224Description: Read-only. It returns 1 if power consumption is currently at or 225 above hardware threshold2 (see 'power1_crit'), otherwise 0. 226 227What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_xeon_limit 228Date: October 2019 229KernelVersion: 5.5 230Contact: Wu Hao <hao.wu@intel.com> 231Description: Read-Only. It returns power limit for XEON in uW. 232 233What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_fpga_limit 234Date: October 2019 235KernelVersion: 5.5 236Contact: Wu Hao <hao.wu@intel.com> 237Description: Read-Only. It returns power limit for FPGA in uW. 238 239What: /sys/bus/platform/devices/dfl-fme.0/hwmon/hwmonX/power1_ltr 240Date: October 2019 241KernelVersion: 5.5 242Contact: Wu Hao <hao.wu@intel.com> 243Description: Read-only. Read this file to get current Latency Tolerance 244 Reporting (ltr) value. It returns 1 if all Accelerated 245 Function Units (AFUs) can tolerate latency >= 40us for memory 246 access or 0 if any AFU is latency sensitive (< 40us). 247