From: Alan Tull <at...@opensource.altera.com>

Add documentation under drivers/staging for new fpga manager's
sysfs interface.

Signed-off-by: Alan Tull <at...@opensource.altera.com>
---
v5  : (actually second version, but keeping version numbers
      aligned with rest of patch series)
      Move document to drivers/staging/fpga/Documentation/ABI

v6  : No change in this patch for v6 of the patch set

v7  : No change in this patch for v7 of the patch set

v8  : No change in this patch for v8 of the patch set
---
 .../Documentation/ABI/sysfs-class-fpga-manager     |   38 ++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 
drivers/staging/fpga/Documentation/ABI/sysfs-class-fpga-manager

diff --git a/drivers/staging/fpga/Documentation/ABI/sysfs-class-fpga-manager 
b/drivers/staging/fpga/Documentation/ABI/sysfs-class-fpga-manager
new file mode 100644
index 0000000..eb600f2
--- /dev/null
+++ b/drivers/staging/fpga/Documentation/ABI/sysfs-class-fpga-manager
@@ -0,0 +1,38 @@
+What:          /sys/class/fpga_manager/<fpga>/name
+Date:          October 2014
+KernelVersion: 3.18
+Contact:       Alan Tull <at...@opensource.altera.com>
+Description:   Name of low level driver.
+
+What:          /sys/class/fpga_manager/<fpga>/firmware
+Date:          October 2014
+KernelVersion: 3.18
+Contact:       Alan Tull <at...@opensource.altera.com>
+Description:   Name of the FPGA image file to load using firmware class.
+
+What:          /sys/class/fpga_manager/<fpga>/reset
+Date:          October 2014
+KernelVersion: 3.18
+Contact:       Alan Tull <at...@opensource.altera.com>
+Description:   Write 1 to reset the FPGA
+
+What:          /sys/class/fpga_manager/<fpga>/state
+Date:          October 2014
+KernelVersion: 3.18
+Contact:       Alan Tull <at...@opensource.altera.com>
+Description:   Read state of fpga framework state machine as a string.
+               Valid states may vary by manufacturer; superset is:
+               * unknown               = can't determine state
+               * power_off             = FPGA power is off
+               * power_up              = FPGA reports power is up
+               * reset                 = FPGA held in reset state
+               * firmware_request      = firmware class request in progress
+               * firmware_request_err  = firmware request failed
+               * write_init            = FPGA being prepared for programming
+               * write_init_err        = Error while preparing FPGA for
+                                         programming
+               * write                 = FPGA ready to receive image data
+               * write_err             = Error while programming
+               * write_complete        = Doing post programming steps
+               * write_complete_err    = Error while doing post programming
+               * operating             = FPGA is programmed and operating
-- 
1.7.9.5

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to