| 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 |
| fials 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). |
