sysfs-platform-dfl-port 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. What: /sys/bus/platform/devices/dfl-port.0/id
  2. Date: June 2018
  3. KernelVersion: 4.19
  4. Contact: Wu Hao <hao.wu@intel.com>
  5. Description: Read-only. It returns id of this port. One DFL FPGA device
  6. may have more than one port. Userspace could use this id to
  7. distinguish different ports under same FPGA device.
  8. What: /sys/bus/platform/devices/dfl-port.0/afu_id
  9. Date: June 2018
  10. KernelVersion: 4.19
  11. Contact: Wu Hao <hao.wu@intel.com>
  12. Description: Read-only. User can program different PR bitstreams to FPGA
  13. Accelerator Function Unit (AFU) for different functions. It
  14. returns uuid which could be used to identify which PR bitstream
  15. is programmed in this AFU.
  16. What: /sys/bus/platform/devices/dfl-port.0/power_state
  17. Date: August 2019
  18. KernelVersion: 5.4
  19. Contact: Wu Hao <hao.wu@intel.com>
  20. Description: Read-only. It reports the APx (AFU Power) state, different APx
  21. means different throttling level. When reading this file, it
  22. returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
  23. What: /sys/bus/platform/devices/dfl-port.0/ap1_event
  24. Date: August 2019
  25. KernelVersion: 5.4
  26. Contact: Wu Hao <hao.wu@intel.com>
  27. Description: Read-write. Read this file for AP1 (AFU Power State 1) event.
  28. It's used to indicate transient AP1 state. Write 1 to this
  29. file to clear AP1 event.
  30. What: /sys/bus/platform/devices/dfl-port.0/ap2_event
  31. Date: August 2019
  32. KernelVersion: 5.4
  33. Contact: Wu Hao <hao.wu@intel.com>
  34. Description: Read-write. Read this file for AP2 (AFU Power State 2) event.
  35. It's used to indicate transient AP2 state. Write 1 to this
  36. file to clear AP2 event.
  37. What: /sys/bus/platform/devices/dfl-port.0/ltr
  38. Date: August 2019
  39. KernelVersion: 5.4
  40. Contact: Wu Hao <hao.wu@intel.com>
  41. Description: Read-write. Read or set AFU latency tolerance reporting value.
  42. Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
  43. to 0 if it is latency sensitive.
  44. What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
  45. Date: August 2019
  46. KernelVersion: 5.4
  47. Contact: Wu Hao <hao.wu@intel.com>
  48. Description: Write-only. User writes command to this interface to set
  49. userclock to AFU.
  50. What: /sys/bus/platform/devices/dfl-port.0/userclk_freqsts
  51. Date: August 2019
  52. KernelVersion: 5.4
  53. Contact: Wu Hao <hao.wu@intel.com>
  54. Description: Read-only. Read this file to get the status of issued command
  55. to userclck_freqcmd.
  56. What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
  57. Date: August 2019
  58. KernelVersion: 5.4
  59. Contact: Wu Hao <hao.wu@intel.com>
  60. Description: Write-only. User writes command to this interface to set
  61. userclock counter.
  62. What: /sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
  63. Date: August 2019
  64. KernelVersion: 5.4
  65. Contact: Wu Hao <hao.wu@intel.com>
  66. Description: Read-only. Read this file to get the status of issued command
  67. to userclck_freqcntrcmd.
  68. What: /sys/bus/platform/devices/dfl-port.0/errors/errors
  69. Date: August 2019
  70. KernelVersion: 5.4
  71. Contact: Wu Hao <hao.wu@intel.com>
  72. Description: Read-Write. Read this file to get errors detected on port and
  73. Accelerated Function Unit (AFU). Write error code to this file
  74. to clear errors. Write fails with -EINVAL if input parsing
  75. fails or input error code doesn't match. Write fails with
  76. -EBUSY or -ETIMEDOUT if error can't be cleared as hardware
  77. in low power state (-EBUSY) or not respoding (-ETIMEDOUT).
  78. What: /sys/bus/platform/devices/dfl-port.0/errors/first_error
  79. Date: August 2019
  80. KernelVersion: 5.4
  81. Contact: Wu Hao <hao.wu@intel.com>
  82. Description: Read-only. Read this file to get the first error detected by
  83. hardware.
  84. What: /sys/bus/platform/devices/dfl-port.0/errors/first_malformed_req
  85. Date: August 2019
  86. KernelVersion: 5.4
  87. Contact: Wu Hao <hao.wu@intel.com>
  88. Description: Read-only. Read this file to get the first malformed request
  89. captured by hardware.