sysfs-class-fpga-manager 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. What: /sys/class/fpga_manager/<fpga>/name
  2. Date: August 2015
  3. KernelVersion: 4.3
  4. Contact: Alan Tull <atull@opensource.altera.com>
  5. Description: Name of low level fpga manager driver.
  6. What: /sys/class/fpga_manager/<fpga>/state
  7. Date: August 2015
  8. KernelVersion: 4.3
  9. Contact: Alan Tull <atull@opensource.altera.com>
  10. Description: Read fpga manager state as a string.
  11. The intent is to provide enough detail that if something goes
  12. wrong during FPGA programming (something that the driver can't
  13. fix) then userspace can know, i.e. if the firmware request
  14. fails, that could be due to not being able to find the firmware
  15. file.
  16. This is a superset of FPGA states and fpga manager driver
  17. states. The fpga manager driver is walking through these steps
  18. to get the FPGA into a known operating state. It's a sequence,
  19. though some steps may get skipped. Valid FPGA states will vary
  20. by manufacturer; this is a superset.
  21. * unknown = can't determine state
  22. * power off = FPGA power is off
  23. * power up = FPGA reports power is up
  24. * reset = FPGA held in reset state
  25. * firmware request = firmware class request in progress
  26. * firmware request error = firmware request failed
  27. * write init = preparing FPGA for programming
  28. * write init error = Error while preparing FPGA for
  29. programming
  30. * write = FPGA ready to receive image data
  31. * write error = Error while programming
  32. * write complete = Doing post programming steps
  33. * write complete error = Error while doing post programming
  34. * operating = FPGA is programmed and operating
  35. What: /sys/class/fpga_manager/<fpga>/status
  36. Date: June 2018
  37. KernelVersion: 4.19
  38. Contact: Wu Hao <hao.wu@intel.com>
  39. Description: Read fpga manager status as a string.
  40. If FPGA programming operation fails, it could be caused by crc
  41. error or incompatible bitstream image. The intent of this
  42. interface is to provide more detailed information for FPGA
  43. programming errors to userspace. This is a list of strings for
  44. the supported status.
  45. * reconfig operation error - invalid operations detected by
  46. reconfiguration hardware.
  47. e.g. start reconfiguration
  48. with errors not cleared
  49. * reconfig CRC error - CRC error detected by
  50. reconfiguration hardware.
  51. * reconfig incompatible image - reconfiguration image is
  52. incompatible with hardware
  53. * reconfig IP protocol error - protocol errors detected by
  54. reconfiguration hardware
  55. * reconfig fifo overflow error - FIFO overflow detected by
  56. reconfiguration hardware