0001 What: /sys/class/fpga_manager/<fpga>/name
0002 Date: August 2015
0003 KernelVersion: 4.3
0004 Contact: Alan Tull <atull@opensource.altera.com>
0005 Description: Name of low level fpga manager driver.
0006
0007 What: /sys/class/fpga_manager/<fpga>/state
0008 Date: August 2015
0009 KernelVersion: 4.3
0010 Contact: Alan Tull <atull@opensource.altera.com>
0011 Description: Read fpga manager state as a string.
0012 The intent is to provide enough detail that if something goes
0013 wrong during FPGA programming (something that the driver can't
0014 fix) then userspace can know, i.e. if the firmware request
0015 fails, that could be due to not being able to find the firmware
0016 file.
0017
0018 This is a superset of FPGA states and fpga manager driver
0019 states. The fpga manager driver is walking through these steps
0020 to get the FPGA into a known operating state. It's a sequence,
0021 though some steps may get skipped. Valid FPGA states will vary
0022 by manufacturer; this is a superset.
0023
0024 * unknown = can't determine state
0025 * power off = FPGA power is off
0026 * power up = FPGA reports power is up
0027 * reset = FPGA held in reset state
0028 * firmware request = firmware class request in progress
0029 * firmware request error = firmware request failed
0030 * write init = preparing FPGA for programming
0031 * write init error = Error while preparing FPGA for programming
0032 * write = FPGA ready to receive image data
0033 * write error = Error while programming
0034 * write complete = Doing post programming steps
0035 * write complete error = Error while doing post programming
0036 * operating = FPGA is programmed and operating
0037
0038 What: /sys/class/fpga_manager/<fpga>/status
0039 Date: June 2018
0040 KernelVersion: 4.19
0041 Contact: Wu Hao <hao.wu@intel.com>
0042 Description: Read fpga manager status as a string.
0043 If FPGA programming operation fails, it could be caused by crc
0044 error or incompatible bitstream image. The intent of this
0045 interface is to provide more detailed information for FPGA
0046 programming errors to userspace. This is a list of strings for
0047 the supported status.
0048
0049 * reconfig operation error - invalid operations detected by
0050 reconfiguration hardware.
0051 e.g. start reconfiguration
0052 with errors not cleared
0053 * reconfig CRC error - CRC error detected by
0054 reconfiguration hardware.
0055 * reconfig incompatible image - reconfiguration image is
0056 incompatible with hardware
0057 * reconfig IP protocol error - protocol errors detected by
0058 reconfiguration hardware
0059 * reconfig fifo overflow error - FIFO overflow detected by
0060 reconfiguration hardware
