1What: /sys/bus/platform/devices/dfl-fme.0/ports_num 2Date: June 2018 3KernelVersion: 4.19 4Contact: Wu Hao <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 fails 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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