Skip to contentSkip to conversation

FPGA Manager Framework and Simple FPGA Bus

PATCH Superseded [email protected] 3 participants 23 messages Aug 13, 2015 – Aug 19, 2015

Subsystems (3)

v10 of 14 Superseded Latest is v14 →

lore
Share & tools
lore
#0 lore raw

v10 cover FPGA Manager Framework and Simple FPGA Bus

From: Alan Tull <[email protected]>

This patch set adds two chunks plus documentation:
* FPGA manager core: exports API functions that write an image to a FPGA
* DT Overlay support: simple-fpga-bus to handle FPGA from a DT overlay

The FPGA manager core is mature enough to be in the regular kernel.

simple-fpga-bus is proposed for staging.

Changes from v9:
* Move FPGA manager core to drivers/fpga
* Move simple-fpga-bus to staging/simple-fpga-bus
* add TODO
* Improvements in fpga_manager_get/put (call module_try_get)
* Add flags parameter to .write_complete ops as requested
* Documentation improvements
* Other minor cleanup

More info:

The core's API is minimal to start with: only 6 functions. This gives a manufacturer-agnostic interface for programming FPGA's such that higher level interfaces (such as DT Overlays) can be shared.

The DT Overlays support exists for the usage where the FPGA will contain some "hardware" that will need drivers. Where that use model is not appealing, the core API can be used to add a different interface.

The bindings for the socfpga FPGA manager already are upstreamed as 1b4e119 Alan Tull : doc: add bindings document for altera fpga manager

The core FPGA manager support is standalone. The DT Overlays support is dependent on Pantelis's dtc overlay patches from
https://github.com/pantoniou/dtc.git
and his DT overlays configfs interface patches and fixes from
https://github.com/pantoniou/linux-beagle-track-mainline

efb0c04 Pantelis Antoniou : gcl: Fix resource linking
85e785e Pantelis Antoniou : ARM: DT: Enable symbols when CONFIG_OF_OVERLAY is used af0321f Pantelis Antoniou : OF: DT-Overlay configfs interface (v5) 4c1c675 Pantelis Antoniou : configfs: Implement binary attributes (v4)

Alan Tull (8):
usage documentation for FPGA manager core fpga manager: add sysfs interface document add fpga manager core
fpga manager: add driver for socfpga fpga manager
staging: usage documentation for simple fpga bus
staging: add bindings document for simple fpga bus
staging: simple-fpga-bus: add TODO document
staging: add simple-fpga-bus

 Documentation/ABI/testing/sysfs-class-fpga-manager |   37 ++
 Documentation/fpga/fpga-mgr.txt                    |  171 ++++++
 drivers/Kconfig                                    |    2 +
 drivers/Makefile                                   |    1 +
 drivers/fpga/Kconfig                               |   24 +
 drivers/fpga/Makefile                              |    9 +
 drivers/fpga/fpga-mgr.c                            |  381 ++++++++++++
 drivers/fpga/socfpga.c                             |  616 ++++++++++++++++++++
 drivers/staging/Kconfig                            |    2 +
 drivers/staging/Makefile                           |    1 +
 .../Documentation/bindings/simple-fpga-bus.txt     |   83 +++
 .../Documentation/simple-fpga-bus.txt              |   58 ++
 drivers/staging/simple-fpga-bus/Kconfig            |   14 +
 drivers/staging/simple-fpga-bus/Makefile           |    5 +
 drivers/staging/simple-fpga-bus/TODO               |   13 +
 drivers/staging/simple-fpga-bus/simple-fpga-bus.c  |  330 +++++++++++
 include/linux/fpga/fpga-mgr.h                      |  127 ++++
 17 files changed, 1874 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-manager
 create mode 100644 Documentation/fpga/fpga-mgr.txt
 create mode 100644 drivers/fpga/Kconfig
 create mode 100644 drivers/fpga/Makefile
 create mode 100644 drivers/fpga/fpga-mgr.c
 create mode 100644 drivers/fpga/socfpga.c
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/simple-fpga-bus.txt
 create mode 100644 drivers/staging/simple-fpga-bus/Kconfig
 create mode 100644 drivers/staging/simple-fpga-bus/Makefile
 create mode 100644 drivers/staging/simple-fpga-bus/TODO
 create mode 100644 drivers/staging/simple-fpga-bus/simple-fpga-bus.c
 create mode 100644 include/linux/fpga/fpga-mgr.h
Signature · 1 line
1.7.9.5
#1 lore raw

v10 cover FPGA Manager Framework and Simple FPGA Bus

From: Alan Tull <[email protected]>

This patchset adds two chunks plus documentation:
* fpga manager core: exports API functions that write an image to a FPGA
* DT Overlay support: simple-fpga-bus to handle FPGA from a DT overlay

The fpga manager core is mature enough to be in the regular kernel.

simple-fpga-bus is proposed for staging.

Changes from v9:
* Move fpga manager core to drivers/fpga
* Move simple-fpga-bus to staging/simple-fpga-bus
* add TODO
* Improvements in fpga_manager_get/put (call module_try_get)
* Add flags parameter to .write_complete ops as requested
* Documentation improvements
* Other minor cleanup

More info:

The core's API is minimal to start with: only 6 functions. This gives a manufacturer-agnostic interface for programming FPGA's such that higher level interfaces (such as DT Overlays) can be shared.

The DT Overlays support exists for the usage where the FPGA will contain some "hardware" that will need drivers. Where that use model is not appealing, the core API can be used to add a different interface.

The bindings for the socpfga fpga manager already are upstreamed as 1b4e119 Alan Tull : doc: add bindings document for altera fpga manager

The core FPGA manager support is standalone. The DT Overlays support is dependent on Pantelis's dtc overlay patches from
https://github.com/pantoniou/dtc.git
and his DT overlays configfs interface patches and fixes from
https://github.com/pantoniou/linux-beagle-track-mainline

efb0c04 Pantelis Antoniou : gcl: Fix resource linking
85e785e Pantelis Antoniou : ARM: DT: Enable symbols when CONFIG_OF_OVERLAY is used af0321f Pantelis Antoniou : OF: DT-Overlay configfs interface (v5) 4c1c675 Pantelis Antoniou : configfs: Implement binary attributes (v4)

Alan Tull (8):
usage documentation for FPGA manager core fpga manager: add sysfs interface document add fpga manager core
fpga manager: add driver for socfpga fpga manager
staging: usage documentation for simple fpga bus
staging: add bindings document for simple fpga bus
staging: simple-fpga-bus: add TODO document
staging: add simple-fpga-bus

 Documentation/ABI/testing/sysfs-class-fpga-manager |   37 ++
 Documentation/fpga/fpga-mgr.txt                    |  171 ++++++
 drivers/Kconfig                                    |    2 +
 drivers/Makefile                                   |    1 +
 drivers/fpga/Kconfig                               |   24 +
 drivers/fpga/Makefile                              |    9 +
 drivers/fpga/fpga-mgr.c                            |  381 ++++++++++++
 drivers/fpga/socfpga.c                             |  616 ++++++++++++++++++++
 drivers/staging/Kconfig                            |    2 +
 drivers/staging/Makefile                           |    1 +
 .../Documentation/bindings/simple-fpga-bus.txt     |   83 +++
 .../Documentation/simple-fpga-bus.txt              |   58 ++
 drivers/staging/simple-fpga-bus/Kconfig            |   14 +
 drivers/staging/simple-fpga-bus/Makefile           |    5 +
 drivers/staging/simple-fpga-bus/TODO               |   13 +
 drivers/staging/simple-fpga-bus/simple-fpga-bus.c  |  330 +++++++++++
 include/linux/fpga/fpga-mgr.h                      |  127 ++++
 17 files changed, 1874 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-manager
 create mode 100644 Documentation/fpga/fpga-mgr.txt
 create mode 100644 drivers/fpga/Kconfig
 create mode 100644 drivers/fpga/Makefile
 create mode 100644 drivers/fpga/fpga-mgr.c
 create mode 100644 drivers/fpga/socfpga.c
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/simple-fpga-bus.txt
 create mode 100644 drivers/staging/simple-fpga-bus/Kconfig
 create mode 100644 drivers/staging/simple-fpga-bus/Makefile
 create mode 100644 drivers/staging/simple-fpga-bus/TODO
 create mode 100644 drivers/staging/simple-fpga-bus/simple-fpga-bus.c
 create mode 100644 include/linux/fpga/fpga-mgr.h
Signature · 1 line
1.7.9.5
#2 lore raw

PATCH v10 1/8 usage documentation for FPGA manager core

In reply to [email protected]

From: Alan Tull <[email protected]>

Add a document on the new FPGA manager core.

---
v9: initial version where this patch was added

v10: requested cleanups to formatting and otherwise
s/fpga/FPGA/g
rewrite implementation section to not reference socfpga.c by name other rewrites
Moved to Documentation/fpga/

---
 Documentation/fpga/fpga-mgr.txt |  171 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 Documentation/fpga/fpga-mgr.txt
Documentation/fpga/fpga-mgr.txt new file +171 -0
new file mode 100644
index 0000000..c5259e4
@@ -0,0 +1,171 @@
+FPGA Manager Core
+
+Alan Tull 2015
+
+Overview
+========
+
+The FPGA manager core exports a set of functions for programming an FPGA with
+image.  The API is manufacturer agnostic.  All manufacturer specifics are
+hidden away in a low level driver which registers a set of ops with the core.
+The FPGA image data itself is very manufacturer specific, but for our purposes
+it's just binary data.  The FPGA manager core won't parse it.
+
+
+API Functions:
+==============
+
+To program the FPGA from a file or from a buffer:
+-------------------------------------------------
+
+	int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags,
+		              const char *buf, size_t count);
+
+Load the FPGA from an image which exists as a buffer in memory.
+
+	int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags,
+		                   const char *image_name);
+
+Load the FPGA from an image which exists as a file.  The image file must be on
+the firmware search path (see the firmware class documentation).
+
+For both these functions, flags == 0 for normal full reconfiguration or
+FPGA_MGR_PARTIAL_RECONFIG for partial reconfiguration.  If successful, the FPGA
+ends up in operating mode.  Return 0 on success or a negative error code.
+
+
+To get/put a reference to a FPGA manager:
+-----------------------------------------
+
+	struct fpga_manager *of_fpga_mgr_get(struct device_node *node);
+
+	void fpga_mgr_put(struct fpga_manager *mgr);
+
+Given a DT node, get an exclusive reference to a FPGA manager or release
+the reference.
+
+
+To register or unregister the low level FPGA-specific driver:
+-------------------------------------------------------------
+
+	int fpga_mgr_register(struct device *dev, const char *name,
+		              const struct fpga_manager_ops *mops,
+		              void *priv);
+
+	void fpga_mgr_unregister(struct device *dev);
+
+Use of these two functions is described below in "How To Support a new FPGA
+device."
+
+
+How to write an image buffer to a supported FPGA
+================================================
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this buffer.  count is size of the buffer. */
+char *buf = ...
+int count = ...
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Load the buffer to the FPGA */
+ret = fpga_mgr_buf_load(mgr, flags, buf, count);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+
+
+How to write an image file to a supported FPGA
+==============================================
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this file which is on the firmware search path */
+const char *path = "fpga-image-9.rbf"
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Get the firmware image (path) and load it to the FPGA */
+ret = fpga_mgr_firmware_load(mgr, flags, path);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+
+
+How to support a new FPGA device
+================================
+To add another FPGA manager, write a driver that implements a set of ops.  The
+probe function calls fpga_mgr_register(), such as:
+
+static const struct fpga_manager_ops socfpga_fpga_ops = {
+       .write_init = socfpga_fpga_ops_configure_init,
+       .write = socfpga_fpga_ops_configure_write,
+       .write_complete = socfpga_fpga_ops_configure_complete,
+       .state = socfpga_fpga_ops_state,
+};
+
+static int socfpga_fpga_probe(struct platform_device *pdev)
+{
+	struct device *dev = &pdev->dev;
+	struct socfpga_fpga_priv *priv;
+	int ret;
+
+	priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
+	if (!priv)
+		return -ENOMEM;
+
+	/* ... do ioremaps, get interrupts, etc. and save
+	   them in priv... */
+
+	return fpga_mgr_register(dev, "Altera SOCFPGA FPGA Manager",
+				 &socfpga_fpga_ops, priv);
+}
+
+static int socfpga_fpga_remove(struct platform_device *pdev)
+{
+	fpga_mgr_unregister(&pdev->dev);
+
+	return 0;
+}
+
+
+The ops will implement whatever device specific register writes are needed to
+do the programming sequence for this particular FPGA.  These ops return 0 for
+success or negative error codes otherwise.
+
+The programming sequence is:
+ 1. .write_init
+ 2. .write (may be called once or multiple times)
+ 3. .write_complete
+
+The .write_init function will prepare the FPGA to receive the image data.
+
+The .write function writes a buffer to the FPGA. The buffer may be contain the
+whole FPGA image or may be a smaller chunk of an FPGA image.  In the latter
+case, this function is called multiple times for successive chunks.
+
+The .write_complete function is called after all the image has been written
+to put the FPGA into operating mode.
+
+The ops include a .state function which will read the hardware FPGA manager and
+return a code of type enum fpga_mgr_states.  It doesn't result in a change in
+hardware state.
Signature · 1 line
1.7.9.5
#3 lore raw

Re: [PATCH v10 1/8] usage documentation for FPGA manager core

Hi Alan,

thanks for continuing to work on this :) A couple of minor nits ...

Quoted 24 lines · On Thu, Aug 13, 2015 at 10:37 AM, <[email protected]> wrote:

From: Alan Tull <[email protected]>

Add a document on the new FPGA manager core.

---
v9: initial version where this patch was added

v10: requested cleanups to formatting and otherwise
s/fpga/FPGA/g
rewrite implementation section to not reference socfpga.c by name other rewrites
Moved to Documentation/fpga/

---
 Documentation/fpga/fpga-mgr.txt |  171 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 Documentation/fpga/fpga-mgr.txt
Documentation/fpga/fpga-mgr.txt new file +0 -0
new file mode 100644
index 0000000..c5259e4

Documentation/fpga/fpga-mgr.txt line 9

Quoted 9 lines
Documentation/fpga/fpga-mgr.txt new file +9 -0
@@ -0,0 +1,171 @@
+FPGA Manager Core
+
+Alan Tull 2015
+
+Overview
+========
+
+The FPGA manager core exports a set of functions for programming an FPGA with
+image.  The API is manufacturer agnostic.  All manufacturer specifics are

... with an image ?

Quoted 77 lines
Documentation/fpga/fpga-mgr.txt new file +77 -0
+hidden away in a low level driver which registers a set of ops with the core.
+The FPGA image data itself is very manufacturer specific, but for our purposes
+it's just binary data.  The FPGA manager core won't parse it.
+
+
+API Functions:
+==============
+
+To program the FPGA from a file or from a buffer:
+-------------------------------------------------
+
+       int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags,
+                             const char *buf, size_t count);
+
+Load the FPGA from an image which exists as a buffer in memory.
+
+       int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags,
+                                  const char *image_name);
+
+Load the FPGA from an image which exists as a file.  The image file must be on
+the firmware search path (see the firmware class documentation).
+
+For both these functions, flags == 0 for normal full reconfiguration or
+FPGA_MGR_PARTIAL_RECONFIG for partial reconfiguration.  If successful, the FPGA
+ends up in operating mode.  Return 0 on success or a negative error code.
+
+
+To get/put a reference to a FPGA manager:
+-----------------------------------------
+
+       struct fpga_manager *of_fpga_mgr_get(struct device_node *node);
+
+       void fpga_mgr_put(struct fpga_manager *mgr);
+
+Given a DT node, get an exclusive reference to a FPGA manager or release
+the reference.
+
+
+To register or unregister the low level FPGA-specific driver:
+-------------------------------------------------------------
+
+       int fpga_mgr_register(struct device *dev, const char *name,
+                             const struct fpga_manager_ops *mops,
+                             void *priv);
+
+       void fpga_mgr_unregister(struct device *dev);
+
+Use of these two functions is described below in "How To Support a new FPGA
+device."
+
+
+How to write an image buffer to a supported FPGA
+================================================
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this buffer.  count is size of the buffer. */
+char *buf = ...
+int count = ...
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Load the buffer to the FPGA */
+ret = fpga_mgr_buf_load(mgr, flags, buf, count);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+

Documentation/fpga/fpga-mgr.txt line 96

Quoted 10 lines
Documentation/fpga/fpga-mgr.txt new file +10 -0
+
+How to write an image file to a supported FPGA
+==============================================
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this file which is on the firmware search path */

... in the firmware search path .. not sure if that's better though :)

Quoted 76 lines
Documentation/fpga/fpga-mgr.txt new file +75 -1
+const char *path = "fpga-image-9.rbf"
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Get the firmware image (path) and load it to the FPGA */
+ret = fpga_mgr_firmware_load(mgr, flags, path);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+
+
+How to support a new FPGA device
+================================
+To add another FPGA manager, write a driver that implements a set of ops.  The
+probe function calls fpga_mgr_register(), such as:
+
+static const struct fpga_manager_ops socfpga_fpga_ops = {
+       .write_init = socfpga_fpga_ops_configure_init,
+       .write = socfpga_fpga_ops_configure_write,
+       .write_complete = socfpga_fpga_ops_configure_complete,
+       .state = socfpga_fpga_ops_state,
+};
+
+static int socfpga_fpga_probe(struct platform_device *pdev)
+{
+       struct device *dev = &pdev->dev;
+       struct socfpga_fpga_priv *priv;
+       int ret;
+
+       priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
+       if (!priv)
+               return -ENOMEM;
+
+       /* ... do ioremaps, get interrupts, etc. and save
+          them in priv... */
+
+       return fpga_mgr_register(dev, "Altera SOCFPGA FPGA Manager",
+                                &socfpga_fpga_ops, priv);
+}
+
+static int socfpga_fpga_remove(struct platform_device *pdev)
+{
+       fpga_mgr_unregister(&pdev->dev);
+
+       return 0;
+}
+
+
+The ops will implement whatever device specific register writes are needed to
+do the programming sequence for this particular FPGA.  These ops return 0 for
+success or negative error codes otherwise.
+
+The programming sequence is:
+ 1. .write_init
+ 2. .write (may be called once or multiple times)
+ 3. .write_complete
+
+The .write_init function will prepare the FPGA to receive the image data.
+
+The .write function writes a buffer to the FPGA. The buffer may be contain the
+whole FPGA image or may be a smaller chunk of an FPGA image.  In the latter
+case, this function is called multiple times for successive chunks.
+
+The .write_complete function is called after all the image has been written
+to put the FPGA into operating mode.
+
+The ops include a .state function which will read the hardware FPGA manager and
+return a code of type enum fpga_mgr_states.  It doesn't result in a change in
+hardware state.
--
Quoted 2 lines

1.7.9.5

Cheers,

Moritz

author
#4 lore raw

Re: [PATCH v10 1/8] usage documentation for FPGA manager core

On Thu, 13 Aug 2015, Moritz Fischer wrote:

Hi Moritz,

Thanks for the review. Will include your two nits in v11.

Quoted 23 lines

Hi Alan,

thanks for continuing to work on this :) A couple of minor nits ...

Quoted 18 lines · On Thu, Aug 13, 2015 at 10:37 AM, <[email protected]> wrote:

From: Alan Tull <[email protected]>

Add a document on the new FPGA manager core.

---
v9: initial version where this patch was added

v10: requested cleanups to formatting and otherwise
s/fpga/FPGA/g
rewrite implementation section to not reference socfpga.c by name other rewrites
Moved to Documentation/fpga/

---
 Documentation/fpga/fpga-mgr.txt |  171 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 Documentation/fpga/fpga-mgr.txt
Quoted 16 lines
Quoted 6 lines
Documentation/fpga/fpga-mgr.txt new file +0 -0
new file mode 100644
index 0000000..c5259e4

Documentation/fpga/fpga-mgr.txt line 9

Quoted 9 lines
Documentation/fpga/fpga-mgr.txt new file +9 -0
@@ -0,0 +1,171 @@
+FPGA Manager Core
+
+Alan Tull 2015
+
+Overview
+========
+
+The FPGA manager core exports a set of functions for programming an FPGA with
+image.  The API is manufacturer agnostic.  All manufacturer specifics are

... with an image ?

Yes

Quoted 80 lines
Quoted 80 lines
Documentation/fpga/fpga-mgr.txt new file +80 -0
+hidden away in a low level driver which registers a set of ops with the core.
+The FPGA image data itself is very manufacturer specific, but for our purposes
+it's just binary data.  The FPGA manager core won't parse it.
+
+
+API Functions:
+==============
+
+To program the FPGA from a file or from a buffer:
+-------------------------------------------------
+
+       int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags,
+                             const char *buf, size_t count);
+
+Load the FPGA from an image which exists as a buffer in memory.
+
+       int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags,
+                                  const char *image_name);
+
+Load the FPGA from an image which exists as a file.  The image file must be on
+the firmware search path (see the firmware class documentation).
+
+For both these functions, flags == 0 for normal full reconfiguration or
+FPGA_MGR_PARTIAL_RECONFIG for partial reconfiguration.  If successful, the FPGA
+ends up in operating mode.  Return 0 on success or a negative error code.
+
+
+To get/put a reference to a FPGA manager:
+-----------------------------------------
+
+       struct fpga_manager *of_fpga_mgr_get(struct device_node *node);
+
+       void fpga_mgr_put(struct fpga_manager *mgr);
+
+Given a DT node, get an exclusive reference to a FPGA manager or release
+the reference.
+
+
+To register or unregister the low level FPGA-specific driver:
+-------------------------------------------------------------
+
+       int fpga_mgr_register(struct device *dev, const char *name,
+                             const struct fpga_manager_ops *mops,
+                             void *priv);
+
+       void fpga_mgr_unregister(struct device *dev);
+
+Use of these two functions is described below in "How To Support a new FPGA
+device."
+
+
+How to write an image buffer to a supported FPGA
+================================================
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this buffer.  count is size of the buffer. */
+char *buf = ...
+int count = ...
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Load the buffer to the FPGA */
+ret = fpga_mgr_buf_load(mgr, flags, buf, count);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+
+
+How to write an image file to a supported FPGA
+==============================================
Quoted 8 lines

Documentation/fpga/fpga-mgr.txt line 96

Quoted 7 lines
Documentation/fpga/fpga-mgr.txt new file +7 -0
+/* Include to get the API */
+#include <linux/fpga/fpga-mgr.h>
+
+/* device node that specifies the FPGA manager to use */
+struct device_node *mgr_node = ...
+
+/* FPGA image is in this file which is on the firmware search path */

... in the firmware search path .. not sure if that's better though :)

I think on or in are pretty equally good here, but I'll go with 'in'.

Quoted 83 lines
Quoted 76 lines
Documentation/fpga/fpga-mgr.txt new file +75 -1
+const char *path = "fpga-image-9.rbf"
+
+/* flags indicates whether to do full or partial reconfiguration */
+int flags = 0;
+
+int ret;
+
+/* Get exclusive control of FPGA manager */
+struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node);
+
+/* Get the firmware image (path) and load it to the FPGA */
+ret = fpga_mgr_firmware_load(mgr, flags, path);
+
+/* Release the FPGA manager */
+fpga_mgr_put(mgr);
+
+
+How to support a new FPGA device
+================================
+To add another FPGA manager, write a driver that implements a set of ops.  The
+probe function calls fpga_mgr_register(), such as:
+
+static const struct fpga_manager_ops socfpga_fpga_ops = {
+       .write_init = socfpga_fpga_ops_configure_init,
+       .write = socfpga_fpga_ops_configure_write,
+       .write_complete = socfpga_fpga_ops_configure_complete,
+       .state = socfpga_fpga_ops_state,
+};
+
+static int socfpga_fpga_probe(struct platform_device *pdev)
+{
+       struct device *dev = &pdev->dev;
+       struct socfpga_fpga_priv *priv;
+       int ret;
+
+       priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
+       if (!priv)
+               return -ENOMEM;
+
+       /* ... do ioremaps, get interrupts, etc. and save
+          them in priv... */
+
+       return fpga_mgr_register(dev, "Altera SOCFPGA FPGA Manager",
+                                &socfpga_fpga_ops, priv);
+}
+
+static int socfpga_fpga_remove(struct platform_device *pdev)
+{
+       fpga_mgr_unregister(&pdev->dev);
+
+       return 0;
+}
+
+
+The ops will implement whatever device specific register writes are needed to
+do the programming sequence for this particular FPGA.  These ops return 0 for
+success or negative error codes otherwise.
+
+The programming sequence is:
+ 1. .write_init
+ 2. .write (may be called once or multiple times)
+ 3. .write_complete
+
+The .write_init function will prepare the FPGA to receive the image data.
+
+The .write function writes a buffer to the FPGA. The buffer may be contain the
+whole FPGA image or may be a smaller chunk of an FPGA image.  In the latter
+case, this function is called multiple times for successive chunks.
+
+The .write_complete function is called after all the image has been written
+to put the FPGA into operating mode.
+
+The ops include a .state function which will read the hardware FPGA manager and
+return a code of type enum fpga_mgr_states.  It doesn't result in a change in
+hardware state.
--
Quoted 2 lines

1.7.9.5

Cheers,

Moritz

#5 lore raw

PATCH v10 2/8 fpga manager: add sysfs interface document

In reply to [email protected]

From: Alan Tull <[email protected]>

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

---
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

v9 : Remove 'firmware' and 'reset' files
Update state strings

v10 : Clarifications about state attribute
Move to Documentation/ABI/testing/

---
 Documentation/ABI/testing/sysfs-class-fpga-manager |   37 ++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-class-fpga-manager
Documentation/ABI/testing/sysfs-class-fpga-manager new file +37 -0
new file mode 100644
index 0000000..23056c5
@@ -0,0 +1,37 @@
+What:		/sys/class/fpga_manager/<fpga>/name
+Date:		August 2015
+KernelVersion:	4.3
+Contact:	Alan Tull <[email protected]>
+Description:	Name of low level fpga manager driver.
+
+What:		/sys/class/fpga_manager/<fpga>/state
+Date:		August 2015
+KernelVersion:	4.3
+Contact:	Alan Tull <[email protected]>
+Description:	Read fpga manager state as a string.
+		The intent is to provide enough detail that if something goes
+		wrong during FPGA programming (something that the driver can't
+		fix) then userspace can know, i.e. if the firmware request
+		fails, that could be due to not being able to find the firmware
+		file.
+
+		This is a superset of FPGA states and fpga manager driver
+		states.  The fpga manager driver is walking through these steps
+		to get the FPGA into a known operating state.  It's a sequence,
+		though some steps may get skipped.  Valid FPGA states will vary
+		by manufacturer; this is a superset.
+
+		* 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 error = firmware request failed
+		* write init		= preparing FPGA for programming
+		* write init error	= Error while preparing FPGA for
+					  programming
+		* write			= FPGA ready to receive image data
+		* write error		= Error while programming
+		* write complete	= Doing post programming steps
+		* write complete error	= Error while doing post programming
+		* operating		= FPGA is programmed and operating
Signature · 1 line
1.7.9.5
#6 lore raw

PATCH v10 3/8 add fpga manager core

In reply to [email protected]

From: Alan Tull <[email protected]>

API to support programming FPGA.

The following functions are exported as GPL:
* fpga_mgr_buf_load
Load fpga from image in buffer

* fpga_mgr_firmware_load
Request firmware and load it to the FPGA.

* fpga_mgr_register
* fpga_mgr_unregister
FPGA device drivers can be added by calling
fpga_mgr_register() to register a set of
fpga_manager_ops to do device specific stuff.

* of_fpga_mgr_get
* fpga_mgr_put
Get/put a reference to a fpga manager.

The following sysfs files are created:
* /sys/class/fpga_manager/<fpga>/name
Name of low level driver.

* /sys/class/fpga_manager/<fpga>/state
State of fpga manager

---
v2: s/mangager/manager/
check for invalid request_nr
add fpga reset interface
rework the state code
remove FPGA_MGR_FAIL flag
add _ERR states to fpga manager states enum low level state op now returns a state enum value initialize framework state from driver state op remove unused fpga read stuff
merge sysfs.c into fpga-mgr.c
move suspend/resume from bus.c to fpga-mgr.c

v3: Add struct device to fpga_manager (not as a pointer)
Add to_fpga_manager
Don't get irq in fpga-mgr.c (let low level driver do it) remove from struct fpga_manager: nr, np, parent get rid of fpga_mgr_get_new_minor()
simplify fpga_manager_register:
reorder parameters
use dev instead of pdev
get rid of code that used to make more sense when this
was a char driver, don't alloc_chrdev_region
use a mutex instead of flags

v4: Move to drivers/staging

v5: Make some things be static
Kconfig: add 'if FPGA'
Makefile: s/fpga-mgr-core.o/fpga-mgr.o/ clean up includes
use enum fpga_mgr_states instead of int static const char *state_str
use DEVICE_ATTR_RO/RW/WO and ATTRIBUTE_GROUPS return -EINVAL instead of BUG_ON
move ida_simple_get after kzalloc
clean up fpga_mgr_remove
fpga-mgr.h: remove '#if IS_ENABLED(CONFIG_FPGA)' add kernel-doc documentation
Move header to new include/linux/fpga folder static const struct fpga_mgr_ops dev_info msg simplified

v6: no statically allocated string for image_name
kernel doc fixes
changes regarding enabling SYSFS for fpga mgr
Makefile cleanup

v7: no change in this patch for v7 of the patchset

v8: no change in this patch for v8 of the patchset

v9: remove writable attributes 'firmware' and 'reset'
remove suspend/resume support for now
remove list of fpga managers; use class device iterators instead simplify locking by giving out only one ref exclusively add device tree support
add flags
par down API into fewer functions
update copyright year
rename some functions for clarity
clean up unnecessary #includes
add some error messages
write_init may need to look at buffer header, so add to params

v10: Make this a tristate in Kconfig
pass flags parameter to write_complete
use BIT(0) in macro
move to drivers/fpga
fpga_manager_get/put call module_try_get/module_put

---
 drivers/Kconfig               |    2 +
 drivers/Makefile              |    1 +
 drivers/fpga/Kconfig          |   14 ++
 drivers/fpga/Makefile         |    8 +
 drivers/fpga/fpga-mgr.c       |  381 +++++++++++++++++++++++++++++++++++++++++
 include/linux/fpga/fpga-mgr.h |  127 ++++++++++++++
 6 files changed, 533 insertions(+)
 create mode 100644 drivers/fpga/Kconfig
 create mode 100644 drivers/fpga/Makefile
 create mode 100644 drivers/fpga/fpga-mgr.c
 create mode 100644 include/linux/fpga/fpga-mgr.h
drivers/Kconfig +2 -0
index 6e973b8..2683346 100644
@@ -184,4 +184,6 @@ source "drivers/android/Kconfig"
 
 source "drivers/nvdimm/Kconfig"
 
+source "drivers/fpga/Kconfig"
+
 endmenu
drivers/Makefile +1 -0
index b64b49f..832a6e0 100644
@@ -165,3 +165,4 @@ obj-$(CONFIG_RAS)		+= ras/
 obj-$(CONFIG_THUNDERBOLT)	+= thunderbolt/
 obj-$(CONFIG_CORESIGHT)		+= hwtracing/coresight/
 obj-$(CONFIG_ANDROID)		+= android/
+obj-$(CONFIG_FPGA)		+= fpga/
drivers/fpga/Kconfig new file +14 -0
new file mode 100644
index 0000000..f1f1f6d
@@ -0,0 +1,14 @@
+#
+# FPGA framework configuration
+#
+
+menu "FPGA Configuration Support"
+
+config FPGA
+	tristate "FPGA Configuration Framework"
+	help
+	  Say Y here if you want support for configuring FPGAs from the
+	  kernel.  The FPGA framework adds a FPGA manager class and FPGA
+	  manager drivers.
+
+endmenu
drivers/fpga/Makefile new file +8 -0
new file mode 100644
index 0000000..3313c52
@@ -0,0 +1,8 @@
+#
+# Makefile for the fpga framework and fpga manager drivers.
+#
+
+# Core FPGA Manager Framework
+obj-$(CONFIG_FPGA)			+= fpga-mgr.o
+
+# FPGA Manager Drivers
drivers/fpga/fpga-mgr.c new file +381 -0

381 lines not on this page · raw message

include/linux/fpga/fpga-mgr.h new file +127 -0

127 lines not on this page · raw message

Signature · 1 line
1.7.9.5
#7 lore raw

Re: [PATCH v10 3/8] add fpga manager core

Hi Alan,

I've updated my Zynq driver (it can be found in an older version against your v8 in the Xilinx tree, too)

https://github.com/mfischer/linux/tree/alan-fpga-mgr-v10

to use your v10 version of the patch. Either I'm using the API wrong , or it never gets to the 'operating state'.
Comments inline below.

Quoted 251 lines · On Thu, Aug 13, 2015 at 10:37 AM, <[email protected]> wrote:

From: Alan Tull <[email protected]>

API to support programming FPGA.

The following functions are exported as GPL:
* fpga_mgr_buf_load
Load fpga from image in buffer

* fpga_mgr_firmware_load
Request firmware and load it to the FPGA.

* fpga_mgr_register
* fpga_mgr_unregister
FPGA device drivers can be added by calling
fpga_mgr_register() to register a set of
fpga_manager_ops to do device specific stuff.

* of_fpga_mgr_get
* fpga_mgr_put
Get/put a reference to a fpga manager.

The following sysfs files are created:
* /sys/class/fpga_manager/<fpga>/name
Name of low level driver.

* /sys/class/fpga_manager/<fpga>/state
State of fpga manager

---
v2: s/mangager/manager/
check for invalid request_nr
add fpga reset interface
rework the state code
remove FPGA_MGR_FAIL flag
add _ERR states to fpga manager states enum low level state op now returns a state enum value initialize framework state from driver state op remove unused fpga read stuff
merge sysfs.c into fpga-mgr.c
move suspend/resume from bus.c to fpga-mgr.c

v3: Add struct device to fpga_manager (not as a pointer)
Add to_fpga_manager
Don't get irq in fpga-mgr.c (let low level driver do it) remove from struct fpga_manager: nr, np, parent get rid of fpga_mgr_get_new_minor()
simplify fpga_manager_register:
reorder parameters
use dev instead of pdev
get rid of code that used to make more sense when this
was a char driver, don't alloc_chrdev_region
use a mutex instead of flags

v4: Move to drivers/staging

v5: Make some things be static
Kconfig: add 'if FPGA'
Makefile: s/fpga-mgr-core.o/fpga-mgr.o/ clean up includes
use enum fpga_mgr_states instead of int static const char *state_str
use DEVICE_ATTR_RO/RW/WO and ATTRIBUTE_GROUPS return -EINVAL instead of BUG_ON
move ida_simple_get after kzalloc
clean up fpga_mgr_remove
fpga-mgr.h: remove '#if IS_ENABLED(CONFIG_FPGA)' add kernel-doc documentation
Move header to new include/linux/fpga folder static const struct fpga_mgr_ops dev_info msg simplified

v6: no statically allocated string for image_name
kernel doc fixes
changes regarding enabling SYSFS for fpga mgr
Makefile cleanup

v7: no change in this patch for v7 of the patchset

v8: no change in this patch for v8 of the patchset

v9: remove writable attributes 'firmware' and 'reset'
remove suspend/resume support for now
remove list of fpga managers; use class device iterators instead simplify locking by giving out only one ref exclusively add device tree support
add flags
par down API into fewer functions
update copyright year
rename some functions for clarity
clean up unnecessary #includes
add some error messages
write_init may need to look at buffer header, so add to params

v10: Make this a tristate in Kconfig
pass flags parameter to write_complete
use BIT(0) in macro
move to drivers/fpga
fpga_manager_get/put call module_try_get/module_put

---
 drivers/Kconfig               |    2 +
 drivers/Makefile              |    1 +
 drivers/fpga/Kconfig          |   14 ++
 drivers/fpga/Makefile         |    8 +
 drivers/fpga/fpga-mgr.c       |  381 +++++++++++++++++++++++++++++++++++++++++
 include/linux/fpga/fpga-mgr.h |  127 ++++++++++++++
 6 files changed, 533 insertions(+)
 create mode 100644 drivers/fpga/Kconfig
 create mode 100644 drivers/fpga/Makefile
 create mode 100644 drivers/fpga/fpga-mgr.c
 create mode 100644 include/linux/fpga/fpga-mgr.h
drivers/Kconfig +2 -0
index 6e973b8..2683346 100644
@@ -184,4 +184,6 @@ source "drivers/android/Kconfig"
 
 source "drivers/nvdimm/Kconfig"
 
+source "drivers/fpga/Kconfig"
+
 endmenu
drivers/Makefile +1 -0
index b64b49f..832a6e0 100644
@@ -165,3 +165,4 @@ obj-$(CONFIG_RAS)           += ras/
 obj-$(CONFIG_THUNDERBOLT)      += thunderbolt/
 obj-$(CONFIG_CORESIGHT)                += hwtracing/coresight/
 obj-$(CONFIG_ANDROID)          += android/
+obj-$(CONFIG_FPGA)             += fpga/
drivers/fpga/Kconfig new file +14 -0
new file mode 100644
index 0000000..f1f1f6d
@@ -0,0 +1,14 @@
+#
+# FPGA framework configuration
+#
+
+menu "FPGA Configuration Support"
+
+config FPGA
+       tristate "FPGA Configuration Framework"
+       help
+         Say Y here if you want support for configuring FPGAs from the
+         kernel.  The FPGA framework adds a FPGA manager class and FPGA
+         manager drivers.
+
+endmenu
drivers/fpga/Makefile new file +8 -0
new file mode 100644
index 0000000..3313c52
@@ -0,0 +1,8 @@
+#
+# Makefile for the fpga framework and fpga manager drivers.
+#
+
+# Core FPGA Manager Framework
+obj-$(CONFIG_FPGA)                     += fpga-mgr.o
+
+# FPGA Manager Drivers
drivers/fpga/fpga-mgr.c new file +78 -0
new file mode 100644
index 0000000..5d900bf
@@ -0,0 +1,381 @@
+/*
+ * FPGA Manager Core
+ *
+ *  Copyright (C) 2013-2015 Altera Corporation
+ *
+ * With code from the mailing list:
+ * Copyright (C) 2013 Xilinx, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#include <linux/firmware.h>
+#include <linux/fpga/fpga-mgr.h>
+#include <linux/idr.h>
+#include <linux/module.h>
+#include <linux/of.h>
+#include <linux/mutex.h>
+#include <linux/slab.h>
+
+static DEFINE_IDA(fpga_mgr_ida);
+static struct class *fpga_mgr_class;
+
+/**
+ * fpga_mgr_buf_load - load fpga from image in buffer
+ * @mgr:       fpga manager
+ * @flags:     flags setting fpga confuration modes
+ * @buf:       buffer contain fpga image
+ * @count:     byte count of buf
+ *
+ * Step the low level fpga manager through the device-specific steps of getting
+ * an FPGA ready to be configured, writing the image to it, then doing whatever
+ * post-configuration steps necessary.
+ *
+ * Return: 0 on success, negative error code otherwise.
+ */
+int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags, const char *buf,
+                     size_t count)
+{
+       struct device *dev = &mgr->dev;
+       int ret;
+
+       if (!mgr)
+               return -ENODEV;
+
+       /*
+        * Call the low level driver's write_init function.  This will do the
+        * device-specific things to get the FPGA into the state where it is
+        * ready to receive an FPGA image.
+        */
+       mgr->state = FPGA_MGR_STATE_WRITE_INIT;
+       ret = mgr->mops->write_init(mgr, flags, buf, count);
+       if (ret) {
+               dev_err(dev, "Error preparing FPGA for writing\n");
+               mgr->state = FPGA_MGR_STATE_WRITE_INIT_ERR;
+               return ret;
+       }
+
+       /*
+        * Write the FPGA image to the FPGA.
+        */
+       mgr->state = FPGA_MGR_STATE_WRITE;
+       ret = mgr->mops->write(mgr, buf, count);
+       if (ret) {
+               dev_err(dev, "Error while writing image data to FPGA\n");
+               mgr->state = FPGA_MGR_STATE_WRITE_ERR;
+               return ret;
+       }
+
+       /*

drivers/fpga/fpga-mgr.c line 88

Quoted 10 lines
drivers/fpga/fpga-mgr.c new file +10 -0
+        * After all the FPGA image has been written, do the device specific
+        * steps to finish and set the FPGA into operating mode.
+        */
+       mgr->state = FPGA_MGR_STATE_WRITE_COMPLETE;
+       ret = mgr->mops->write_complete(mgr, flags);
+       if (ret) {
+               dev_err(dev, "Error after writing image data to FPGA\n");
+               mgr->state = FPGA_MGR_STATE_WRITE_COMPLETE_ERR;
+               return ret;
+       }

Maybe I'm misunderstanding something here. Shouldn't we set mgr->state = FPGA_MGR_STATE_OPERATING
here, seen that the _show function below uses the mgr->state?

Quoted 78 lines
drivers/fpga/fpga-mgr.c new file +78 -0
+
+       return 0;
+}
+EXPORT_SYMBOL_GPL(fpga_mgr_buf_load);
+
+/**
+ * fpga_mgr_firmware_load - request firmware and load to fpga
+ * @mgr:       fpga manager
+ * @flags:     flags setting fpga confuration modes
+ * @image_name:        name of image file on the firmware search path
+ *
+ * Request an FPGA image using the firmware class, then write out to the FPGA.
+ * Update the state before each step to provide info on what step failed if
+ * there is a failure.
+ *
+ * Return: 0 on success, negative error code otherwise.
+ */
+int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags,
+                          const char *image_name)
+{
+       struct device *dev = &mgr->dev;
+       const struct firmware *fw;
+       int ret;
+
+       if (!mgr)
+               return -ENODEV;
+
+       dev_info(dev, "writing %s to %s\n", image_name, mgr->name);
+
+       mgr->state = FPGA_MGR_STATE_FIRMWARE_REQ;
+
+       ret = request_firmware(&fw, image_name, dev);
+       if (ret) {
+               mgr->state = FPGA_MGR_STATE_FIRMWARE_REQ_ERR;
+               dev_err(dev, "Error requesting firmware %s\n", image_name);
+               return ret;
+       }
+
+       ret = fpga_mgr_buf_load(mgr, flags, fw->data, fw->size);
+       if (ret)
+               return ret;
+
+       release_firmware(fw);
+
+       return 0;
+}
+EXPORT_SYMBOL_GPL(fpga_mgr_firmware_load);
+
+static const char * const state_str[] = {
+       [FPGA_MGR_STATE_UNKNOWN] =              "unknown",
+       [FPGA_MGR_STATE_POWER_OFF] =            "power off",
+       [FPGA_MGR_STATE_POWER_UP] =             "power up",
+       [FPGA_MGR_STATE_RESET] =                "reset",
+
+       /* requesting FPGA image from firmware */
+       [FPGA_MGR_STATE_FIRMWARE_REQ] =         "firmware request",
+       [FPGA_MGR_STATE_FIRMWARE_REQ_ERR] =     "firmware request error",
+
+       /* Preparing FPGA to receive image */
+       [FPGA_MGR_STATE_WRITE_INIT] =           "write init",
+       [FPGA_MGR_STATE_WRITE_INIT_ERR] =       "write init error",
+
+       /* Writing image to FPGA */
+       [FPGA_MGR_STATE_WRITE] =                "write",
+       [FPGA_MGR_STATE_WRITE_ERR] =            "write error",
+
+       /* Finishing configuration after image has been written */
+       [FPGA_MGR_STATE_WRITE_COMPLETE] =       "write complete",
+       [FPGA_MGR_STATE_WRITE_COMPLETE_ERR] =   "write complete error",
+
+       /* FPGA reports to be in normal operating mode */
+       [FPGA_MGR_STATE_OPERATING] =            "operating",
+};
+
+static ssize_t name_show(struct device *dev,
+                        struct device_attribute *attr, char *buf)
+{
+       struct fpga_manager *mgr = to_fpga_manager(dev);

drivers/fpga/fpga-mgr.c line 176

Quoted 10 lines
drivers/fpga/fpga-mgr.c new file +10 -0
+
+       return sprintf(buf, "%s\n", mgr->name);
+}
+
+static ssize_t state_show(struct device *dev,
+                         struct device_attribute *attr, char *buf)
+{
+       struct fpga_manager *mgr = to_fpga_manager(dev);
+
+       return sprintf(buf, "%s\n", state_str[mgr->state]);

As mentioned above, I'm confused. How does this get into the FPGA_MGR_STATE_OPERATING ?

Quoted 339 lines
drivers/fpga/fpga-mgr.c new file +205 -0
+}
+
+static DEVICE_ATTR_RO(name);
+static DEVICE_ATTR_RO(state);
+
+static struct attribute *fpga_mgr_attrs[] = {
+       &dev_attr_name.attr,
+       &dev_attr_state.attr,
+       NULL,
+};
+ATTRIBUTE_GROUPS(fpga_mgr);
+
+static int fpga_mgr_of_node_match(struct device *dev, const void *data)
+{
+       return dev->of_node == data;
+}
+
+/**
+ * of_fpga_mgr_get - get an exclusive reference to a fpga mgr
+ * @node:      device node
+ *
+ * Given a device node, get an exclusive reference to a fpga mgr.
+ *
+ * Return: fpga manager struct or IS_ERR() condition containing error code.
+ */
+struct fpga_manager *of_fpga_mgr_get(struct device_node *node)
+{
+       struct fpga_manager *mgr;
+       struct device *dev;
+
+       if (!node)
+               return ERR_PTR(-EINVAL);
+
+       dev = class_find_device(fpga_mgr_class, NULL, node,
+                               fpga_mgr_of_node_match);
+       if (!dev)
+               return ERR_PTR(-ENODEV);
+
+       mgr = to_fpga_manager(dev);
+       put_device(dev);
+       if (!mgr)
+               return ERR_PTR(-ENODEV);
+
+       /* Get exclusive use of fpga manager */
+       if (!mutex_trylock(&mgr->ref_mutex))
+               return ERR_PTR(-EBUSY);
+
+       if (!try_module_get(THIS_MODULE)) {
+               mutex_unlock(&mgr->ref_mutex);
+               return ERR_PTR(-ENODEV);
+       }
+
+       return mgr;
+}
+EXPORT_SYMBOL_GPL(of_fpga_mgr_get);
+
+/**
+ * fpga_mgr_put - release a reference to a fpga manager
+ * @mgr:       fpga manager structure
+ */
+void fpga_mgr_put(struct fpga_manager *mgr)
+{
+       if (mgr) {
+               module_put(THIS_MODULE);
+               mutex_unlock(&mgr->ref_mutex);
+       }
+}
+EXPORT_SYMBOL_GPL(fpga_mgr_put);
+
+/**
+ * fpga_mgr_register - register a low level fpga manager driver
+ * @dev:       fpga manager device from pdev
+ * @name:      fpga manager name
+ * @mops:      pointer to structure of fpga manager ops
+ * @priv:      fpga manager private data
+ *
+ * Return: 0 on success, negative error code otherwise.
+ */
+int fpga_mgr_register(struct device *dev, const char *name,
+                     const struct fpga_manager_ops *mops,
+                     void *priv)
+{
+       struct fpga_manager *mgr;
+       const char *dt_label;
+       int id, ret;
+
+       if (!mops || !mops->write_init || !mops->write ||
+           !mops->write_complete || !mops->state) {
+               dev_err(dev, "Attempt to register without fpga_manager_ops\n");
+               return -EINVAL;
+       }
+
+       if (!name || !strlen(name)) {
+               dev_err(dev, "Attempt to register with no name!\n");
+               return -EINVAL;
+       }
+
+       mgr = kzalloc(sizeof(*mgr), GFP_KERNEL);
+       if (!mgr)
+               return -ENOMEM;
+
+       id = ida_simple_get(&fpga_mgr_ida, 0, 0, GFP_KERNEL);
+       if (id < 0) {
+               ret = id;
+               goto error_kfree;
+       }
+
+       mutex_init(&mgr->ref_mutex);
+
+       mgr->name = name;
+       mgr->mops = mops;
+       mgr->priv = priv;
+
+       /*
+        * Initialize framework state by requesting low level driver read state
+        * from device.  FPGA may be in reset mode or may have been programmed
+        * by bootloader or EEPROM.
+        */
+       mgr->state = mgr->mops->state(mgr);
+
+       device_initialize(&mgr->dev);
+       mgr->dev.class = fpga_mgr_class;
+       mgr->dev.parent = dev;
+       mgr->dev.of_node = dev->of_node;
+       mgr->dev.id = id;
+       dev_set_drvdata(dev, mgr);
+
+       dt_label = of_get_property(mgr->dev.of_node, "label", NULL);
+       if (dt_label)
+               ret = dev_set_name(&mgr->dev, "%s", dt_label);
+       else
+               ret = dev_set_name(&mgr->dev, "fpga%d", id);
+
+       ret = device_add(&mgr->dev);
+       if (ret)
+               goto error_device;
+
+       dev_info(&mgr->dev, "%s registered\n", mgr->name);
+
+       return 0;
+
+error_device:
+       ida_simple_remove(&fpga_mgr_ida, id);
+error_kfree:
+       kfree(mgr);
+
+       return ret;
+}
+EXPORT_SYMBOL_GPL(fpga_mgr_register);
+
+/**
+ * fpga_mgr_unregister - unregister a low level fpga manager driver
+ * @dev:       fpga manager device from pdev
+ */
+void fpga_mgr_unregister(struct device *dev)
+{
+       struct fpga_manager *mgr = dev_get_drvdata(dev);
+
+       dev_info(&mgr->dev, "%s %s\n", __func__, mgr->name);
+
+       /*
+        * If the low level driver provides a method for putting fpga into
+        * a desired state upon unregister, do it.
+        */
+       if (mgr->mops->fpga_remove)
+               mgr->mops->fpga_remove(mgr);
+
+       device_unregister(&mgr->dev);
+}
+EXPORT_SYMBOL_GPL(fpga_mgr_unregister);
+
+static void fpga_mgr_dev_release(struct device *dev)
+{
+       struct fpga_manager *mgr = to_fpga_manager(dev);
+
+       ida_simple_remove(&fpga_mgr_ida, mgr->dev.id);
+       kfree(mgr);
+}
+
+static int __init fpga_mgr_class_init(void)
+{
+       pr_info("FPGA manager framework\n");
+
+       fpga_mgr_class = class_create(THIS_MODULE, "fpga_manager");
+       if (IS_ERR(fpga_mgr_class))
+               return PTR_ERR(fpga_mgr_class);
+
+       fpga_mgr_class->dev_groups = fpga_mgr_groups;
+       fpga_mgr_class->dev_release = fpga_mgr_dev_release;
+
+       return 0;
+}
+
+static void __exit fpga_mgr_class_exit(void)
+{
+       class_destroy(fpga_mgr_class);
+       ida_destroy(&fpga_mgr_ida);
+}
+
+MODULE_AUTHOR("Alan Tull <[email protected]>");
+MODULE_DESCRIPTION("FPGA manager framework");
+MODULE_LICENSE("GPL v2");
+
+subsys_initcall(fpga_mgr_class_init);
+module_exit(fpga_mgr_class_exit);
include/linux/fpga/fpga-mgr.h new file +127 -1
new file mode 100644
index 0000000..0940bf4
@@ -0,0 +1,127 @@
+/*
+ * FPGA Framework
+ *
+ *  Copyright (C) 2013-2015 Altera Corporation
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#include <linux/mutex.h>
+#include <linux/platform_device.h>
+
+#ifndef _LINUX_FPGA_MGR_H
+#define _LINUX_FPGA_MGR_H
+
+struct fpga_manager;
+
+/**
+ * enum fpga_mgr_states - fpga framework states
+ * @FPGA_MGR_STATE_UNKNOWN: can't determine state
+ * @FPGA_MGR_STATE_POWER_OFF: FPGA power is off
+ * @FPGA_MGR_STATE_POWER_UP: FPGA reports power is up
+ * @FPGA_MGR_STATE_RESET: FPGA in reset state
+ * @FPGA_MGR_STATE_FIRMWARE_REQ: firmware request in progress
+ * @FPGA_MGR_STATE_FIRMWARE_REQ_ERR: firmware request failed
+ * @FPGA_MGR_STATE_WRITE_INIT: preparing FPGA for programming
+ * @FPGA_MGR_STATE_WRITE_INIT_ERR: Error during WRITE_INIT stage
+ * @FPGA_MGR_STATE_WRITE: writing image to FPGA
+ * @FPGA_MGR_STATE_WRITE_ERR: Error while writing FPGA
+ * @FPGA_MGR_STATE_WRITE_COMPLETE: Doing post programming steps
+ * @FPGA_MGR_STATE_WRITE_COMPLETE_ERR: Error during WRITE_COMPLETE
+ * @FPGA_MGR_STATE_OPERATING: FPGA is programmed and operating
+ */
+enum fpga_mgr_states {
+       /* default FPGA states */
+       FPGA_MGR_STATE_UNKNOWN,
+       FPGA_MGR_STATE_POWER_OFF,
+       FPGA_MGR_STATE_POWER_UP,
+       FPGA_MGR_STATE_RESET,
+
+       /* getting an image for loading */
+       FPGA_MGR_STATE_FIRMWARE_REQ,
+       FPGA_MGR_STATE_FIRMWARE_REQ_ERR,
+
+       /* write sequence: init, write, complete */
+       FPGA_MGR_STATE_WRITE_INIT,
+       FPGA_MGR_STATE_WRITE_INIT_ERR,
+       FPGA_MGR_STATE_WRITE,
+       FPGA_MGR_STATE_WRITE_ERR,
+       FPGA_MGR_STATE_WRITE_COMPLETE,
+       FPGA_MGR_STATE_WRITE_COMPLETE_ERR,
+
+       /* fpga is programmed and operating */
+       FPGA_MGR_STATE_OPERATING,
+};
+
+/*
+ * FPGA Manager flags
+ * FPGA_MGR_PARTIAL_RECONFIG: do partial reconfiguration if supported
+ */
+#define FPGA_MGR_PARTIAL_RECONFIG      BIT(0)
+
+/**
+ * struct fpga_manager_ops - ops for low level fpga manager drivers
+ * @state: returns an enum value of the FPGA's state
+ * @write_init: prepare the FPGA to receive confuration data
+ * @write: write count bytes of configuration data to the FPGA
+ * @write_complete: set FPGA to operating state after writing is done
+ * @fpga_remove: optional: Set FPGA into a specific state during driver remove
+ *
+ * fpga_manager_ops are the low level functions implemented by a specific
+ * fpga manager driver.  The optional ones are tested for NULL before being
+ * called, so leaving them out is fine.
+ */
+struct fpga_manager_ops {
+       enum fpga_mgr_states (*state)(struct fpga_manager *mgr);
+       int (*write_init)(struct fpga_manager *mgr, u32 flags,
+                         const char *buf, size_t count);
+       int (*write)(struct fpga_manager *mgr, const char *buf, size_t count);
+       int (*write_complete)(struct fpga_manager *mgr, u32 flags);
+       void (*fpga_remove)(struct fpga_manager *mgr);
+};
+
+/**
+ * struct fpga_manager - fpga manager structure
+ * @name: name of low level fpga manager
+ * @dev: fpga manager device
+ * @ref_mutex: only allows one reference to fpga manager
+ * @state: state of fpga manager
+ * @mops: pointer to struct of fpga manager ops
+ * @priv: low level driver private date
+ */
+struct fpga_manager {
+       const char *name;
+       struct device dev;
+       struct mutex ref_mutex;
+       enum fpga_mgr_states state;
+       const struct fpga_manager_ops *mops;
+       void *priv;
+};
+
+#define to_fpga_manager(d) container_of(d, struct fpga_manager, dev)
+
+int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags,
+                     const char *buf, size_t count);
+
+int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags,
+                          const char *image_name);
+
+struct fpga_manager *of_fpga_mgr_get(struct device_node *node);
+
+void fpga_mgr_put(struct fpga_manager *mgr);
+
+int fpga_mgr_register(struct device *dev, const char *name,
+                     const struct fpga_manager_ops *mops, void *priv);
+
+void fpga_mgr_unregister(struct device *dev);
+
+#endif /*_LINUX_FPGA_MGR_H */
--
Quoted 2 lines

1.7.9.5

Cheers,

Moritz

author
#8 lore raw

Re: [PATCH v10 3/8] add fpga manager core

Quoted 6 lines · Moritz Fischer

Hi Alan,

I've updated my Zynq driver (it can be found in an older version against your v8 in the Xilinx tree, too)

https://github.com/mfischer/linux/tree/alan-fpga-mgr-v10

Since we are both already using this and have been for a while now, I hope it can go up into the mainstream instead of continuing to exist only in Altera and Xilinx's git trees.

Quoted 3 lines

to use your v10 version of the patch. Either I'm using the API wrong , or it never gets to the 'operating state'.

I'm sure you are doing it right.

Quoted 13 lines

drivers/fpga/fpga-mgr.c line 88

Quoted 13 lines
drivers/fpga/fpga-mgr.c new file +13 -0
+       }
+
+       /*
+        * After all the FPGA image has been written, do the device specific
+        * steps to finish and set the FPGA into operating mode.
+        */
+       mgr->state = FPGA_MGR_STATE_WRITE_COMPLETE;
+       ret = mgr->mops->write_complete(mgr, flags);
+       if (ret) {
+               dev_err(dev, "Error after writing image data to FPGA\n");
+               mgr->state = FPGA_MGR_STATE_WRITE_COMPLETE_ERR;
+               return ret;
+       }
Quoted 3 lines

Maybe I'm misunderstanding something here. Shouldn't we set mgr->state = FPGA_MGR_STATE_OPERATING
here, seen that the _show function below uses the mgr->state?

The FPGA gets programmed, but state wasn't getting updated. Should have "mgr->state = FPGA_MGR_STATE_OPERATING" here. Will add in v11.

Thanks for the review and the ack. If you see anything else that seems wrong, please let me know.

Alan

author
#9 lore raw

Re: [PATCH v10 3/8] add fpga manager core

Quoted 4 lines · atull
Quoted 2 lines · Moritz Fischer

Hi Alan,

Quoted 9 lines
Quoted 4 lines

I've updated my Zynq driver (it can be found in an older version against your v8 in the Xilinx tree, too)

https://github.com/mfischer/linux/tree/alan-fpga-mgr-v10

Since we are both already using this and have been for a while now, I hope it can go up into the mainstream instead of continuing to exist only in Altera and Xilinx's git trees.

Hi Moritz,

I fetched your git tree and took a look at your low level driver.

I had a some feedback. write_complete() is a blocking call, waiting for the FPGA to go into operating state and timing out (ETIMEDOUT) if necessary. The fpga-mgr.c framework is assuming that when write_complete exits with status 0, that means that the FPGA is in operating state. That's why it's proper for us to add "mgr->state = FPGA_MGR_STATE_OPERATING" after write_complete returns success as you noted. My suggestion is that your write_complete() should check status in this way. Whatever error codes it returns will get propagated.

Also, I'm wondering how the simple-fpga-bus stuff looks to you now that you've had it for a little while.

Thank,
Alan

#10 lore raw

Re: [PATCH v10 3/8] add fpga manager core

Hi Alan,

Quoted 6 lines · atull
Quoted 4 lines · atull
Quoted 2 lines · Moritz Fischer

Hi Alan,

Quoted 8 lines
Quoted 8 lines
Quoted 4 lines

I've updated my Zynq driver (it can be found in an older version against your v8 in the Xilinx tree, too)

https://github.com/mfischer/linux/tree/alan-fpga-mgr-v10

Since we are both already using this and have been for a while now, I hope it can go up into the mainstream instead of continuing to exist only in Altera and Xilinx's git trees.

Yeah, that was definitely my intention. I just held off submitting my driver for mainline,
because your patchset was still sort of a moving target. And that would be like the 3rd layer of dependencies :-)

The reason for inclusion into the Xilinx tree was so people can play around with it already.

Quoted 6 lines
Quoted 1 line

Hi Moritz,

I fetched your git tree and took a look at your low level driver.

Quoted 7 lines

I had a some feedback. write_complete() is a blocking call, waiting for the FPGA to go into operating state and timing out (ETIMEDOUT) if necessary. The fpga-mgr.c framework is assuming that when write_complete exits with status 0, that means that the FPGA is in operating state. That's why it's proper for us to add "mgr->state = FPGA_MGR_STATE_OPERATING" after write_complete returns success as you noted. My suggestion is that your write_complete() should check status in this way. Whatever error codes it returns will get propagated.

Fair enough, I had misunderstood the API then :-) Another option would have been to have the sysfs
function actually query the state function instead of using the cached mgr->state value.
I'll fix my driver ;-) I'll probably do something like

#define zynq_fpga_poll_timeout(priv, addr, val, cond, sleep_us, timeout_us) \
       readl_poll_timeout(priv->io_base + addr, val, cond, sleep_us, \
                          timeout_us)
Quoted 3 lines

Also, I'm wondering how the simple-fpga-bus stuff looks to you now that you've had it for a little while.

To be honest I haven't played much with it aside from making sure it works. I had to submit another patchset for
the Zynq's reset controller to make it work. The whole dt overlay is pretty cool, but the syntax took some getting used to.

Quoted 3 lines

Thank,
Alan

Thanks for your feedback,

Moritz

Acked-by on v10 3/8
#11 lore raw

Re: [PATCH v10 3/8] add fpga manager core

In reply to [email protected]
Quoted 3 lines · On Thu 2015-08-13 12:37:27, [email protected]…

From: Alan Tull <[email protected]>

API to support programming FPGA.

I'd do s/fpga/FPGA/ in the comments, too. Otherwise looks ok to me.

Signature · 6 lines
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
#12 lore raw

PATCH v10 4/8 fpga manager: add driver for socfpga fpga manager

In reply to [email protected]

From: Alan Tull <[email protected]>

Add driver to fpga manager framework to allow configuration of FPGA in Altera SoCFPGA parts.

---
v2: fpga_manager struct now contains struct device
fpga_manager_register parameters now take device

v3: skip a version to align versions

v4: move to drivers/staging

v5: fix array_size.cocci warnings
fix platform_no_drv_owner.cocci warnings
Remove .owner = THIS_MODULE
include asm/irq.h
clean up list of includes
use altera_fpga_reset for ops
use enum fpga_mgr_states or u32 as needed
use devm_request_irq
check irq <= 0 instead of == NO_IRQ
Use ARRAY_SIZE
rename altera -> socfpga
static const socfpga_fpga_ops
header moved to linux/fpga/ folder
remove ifdef'ed code
use platform_get_resource and platform_get_irq move .probe and .remove lines adjacent
use module_platform_driver
use __maybe_unused
only need to 'if (IS_ENABLED(CONFIG_REGULATOR))' in one fn fix "unsigned 'mode' is never < 0"

v6: return error for (unused) default of case statement

v7: PTR_ERR should access the value just tested by IS_ERR

v8: change compatible string to be more chip specific

v9: update copyright year
remove suspend/resume support and regulators use updated fn names for register/unregister use updated params for write_init
check for partial reconfiguration request

v10: make tristate in Kconfig
clean up include
add flags param to write_complete()
move do drivers/fpga

---
 drivers/fpga/Kconfig   |   10 +
 drivers/fpga/Makefile  |    1 +
 drivers/fpga/socfpga.c |  616 ++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 627 insertions(+)
 create mode 100644 drivers/fpga/socfpga.c
drivers/fpga/Kconfig +10 -0
index f1f1f6d..dfc1f1e 100644
@@ -11,4 +11,14 @@ config FPGA
 	  kernel.  The FPGA framework adds a FPGA manager class and FPGA
 	  manager drivers.
 
+if FPGA
+
+config FPGA_MGR_SOCFPGA
+	tristate "Altera SOCFPGA FPGA Manager"
+	depends on ARCH_SOCFPGA
+	help
+	  FPGA manager driver support for Altera SOCFPGA.
+
+endif # FPGA
+
 endmenu
drivers/fpga/Makefile +1 -0
index 3313c52..ba6c5c5 100644
@@ -6,3 +6,4 @@
 obj-$(CONFIG_FPGA)			+= fpga-mgr.o
 
 # FPGA Manager Drivers
+obj-$(CONFIG_FPGA_MGR_SOCFPGA)		+= socfpga.o
drivers/fpga/socfpga.c new file +616 -0

616 lines not on this page · raw message

Signature · 1 line
1.7.9.5
Acked-by on v10 4/8
#13 lore raw

Re: [PATCH v10 4/8] fpga manager: add driver for socfpga fpga manager

Quoted 710 lines · On Thu, Aug 13, 2015 at 10:37 AM, <atull-yzvPICuk2ABMcg4IHK0kFoH6Mc4MB0Vx@publ…

From: Alan Tull <[email protected]>

Add driver to fpga manager framework to allow configuration of FPGA in Altera SoCFPGA parts.

---
v2: fpga_manager struct now contains struct device
fpga_manager_register parameters now take device

v3: skip a version to align versions

v4: move to drivers/staging

v5: fix array_size.cocci warnings
fix platform_no_drv_owner.cocci warnings
Remove .owner = THIS_MODULE
include asm/irq.h
clean up list of includes
use altera_fpga_reset for ops
use enum fpga_mgr_states or u32 as needed
use devm_request_irq
check irq <= 0 instead of == NO_IRQ
Use ARRAY_SIZE
rename altera -> socfpga
static const socfpga_fpga_ops
header moved to linux/fpga/ folder
remove ifdef'ed code
use platform_get_resource and platform_get_irq move .probe and .remove lines adjacent
use module_platform_driver
use __maybe_unused
only need to 'if (IS_ENABLED(CONFIG_REGULATOR))' in one fn fix "unsigned 'mode' is never < 0"

v6: return error for (unused) default of case statement

v7: PTR_ERR should access the value just tested by IS_ERR

v8: change compatible string to be more chip specific

v9: update copyright year
remove suspend/resume support and regulators
use updated fn names for register/unregister
use updated params for write_init
check for partial reconfiguration request

v10: make tristate in Kconfig
clean up include
add flags param to write_complete()
move do drivers/fpga

---
 drivers/fpga/Kconfig   |   10 +
 drivers/fpga/Makefile  |    1 +
 drivers/fpga/socfpga.c |  616 ++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 627 insertions(+)
 create mode 100644 drivers/fpga/socfpga.c
drivers/fpga/Kconfig +10 -0
index f1f1f6d..dfc1f1e 100644
@@ -11,4 +11,14 @@ config FPGA
          kernel.  The FPGA framework adds a FPGA manager class and FPGA
          manager drivers.
 
+if FPGA
+
+config FPGA_MGR_SOCFPGA
+       tristate "Altera SOCFPGA FPGA Manager"
+       depends on ARCH_SOCFPGA
+       help
+         FPGA manager driver support for Altera SOCFPGA.
+
+endif # FPGA
+
 endmenu
drivers/fpga/Makefile +1 -0
index 3313c52..ba6c5c5 100644
@@ -6,3 +6,4 @@
 obj-$(CONFIG_FPGA)                     += fpga-mgr.o
 
 # FPGA Manager Drivers
+obj-$(CONFIG_FPGA_MGR_SOCFPGA)         += socfpga.o
drivers/fpga/socfpga.c new file +616 -1
new file mode 100644
index 0000000..706b80d
@@ -0,0 +1,616 @@
+/*
+ * FPGA Manager Driver for Altera SOCFPGA
+ *
+ *  Copyright (C) 2013-2015 Altera Corporation
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#include <linux/completion.h>
+#include <linux/delay.h>
+#include <linux/fpga/fpga-mgr.h>
+#include <linux/interrupt.h>
+#include <linux/io.h>
+#include <linux/module.h>
+#include <linux/of_address.h>
+#include <linux/of_irq.h>
+#include <linux/pm.h>
+
+/* Register offsets */
+#define SOCFPGA_FPGMGR_STAT_OFST                               0x0
+#define SOCFPGA_FPGMGR_CTL_OFST                                        0x4
+#define SOCFPGA_FPGMGR_DCLKCNT_OFST                            0x8
+#define SOCFPGA_FPGMGR_DCLKSTAT_OFST                           0xc
+#define SOCFPGA_FPGMGR_GPIO_INTEN_OFST                         0x830
+#define SOCFPGA_FPGMGR_GPIO_INTMSK_OFST                                0x834
+#define SOCFPGA_FPGMGR_GPIO_INTTYPE_LEVEL_OFST                 0x838
+#define SOCFPGA_FPGMGR_GPIO_INT_POL_OFST                       0x83c
+#define SOCFPGA_FPGMGR_GPIO_INTSTAT_OFST                       0x840
+#define SOCFPGA_FPGMGR_GPIO_RAW_INTSTAT_OFST                   0x844
+#define SOCFPGA_FPGMGR_GPIO_PORTA_EOI_OFST                     0x84c
+#define SOCFPGA_FPGMGR_GPIO_EXT_PORTA_OFST                     0x850
+
+/* Register bit defines */
+/* SOCFPGA_FPGMGR_STAT register mode field values */
+#define SOCFPGA_FPGMGR_STAT_POWER_UP                           0x0 /*ramping*/
+#define SOCFPGA_FPGMGR_STAT_RESET                              0x1
+#define SOCFPGA_FPGMGR_STAT_CFG                                        0x2
+#define SOCFPGA_FPGMGR_STAT_INIT                               0x3
+#define SOCFPGA_FPGMGR_STAT_USER_MODE                          0x4
+#define SOCFPGA_FPGMGR_STAT_UNKNOWN                            0x5
+#define SOCFPGA_FPGMGR_STAT_STATE_MASK                         0x7
+/* This is a flag value that doesn't really happen in this register field */
+#define SOCFPGA_FPGMGR_STAT_POWER_OFF                          0x0
+
+#define MSEL_PP16_FAST_NOAES_NODC                              0x0
+#define MSEL_PP16_FAST_AES_NODC                                        0x1
+#define MSEL_PP16_FAST_AESOPT_DC                               0x2
+#define MSEL_PP16_SLOW_NOAES_NODC                              0x4
+#define MSEL_PP16_SLOW_AES_NODC                                        0x5
+#define MSEL_PP16_SLOW_AESOPT_DC                               0x6
+#define MSEL_PP32_FAST_NOAES_NODC                              0x8
+#define MSEL_PP32_FAST_AES_NODC                                        0x9
+#define MSEL_PP32_FAST_AESOPT_DC                               0xa
+#define MSEL_PP32_SLOW_NOAES_NODC                              0xc
+#define MSEL_PP32_SLOW_AES_NODC                                        0xd
+#define MSEL_PP32_SLOW_AESOPT_DC                               0xe
+#define SOCFPGA_FPGMGR_STAT_MSEL_MASK                          0x000000f8
+#define SOCFPGA_FPGMGR_STAT_MSEL_SHIFT                         3
+
+/* SOCFPGA_FPGMGR_CTL register */
+#define SOCFPGA_FPGMGR_CTL_EN                                  0x00000001
+#define SOCFPGA_FPGMGR_CTL_NCE                                 0x00000002
+#define SOCFPGA_FPGMGR_CTL_NCFGPULL                            0x00000004
+
+#define CDRATIO_X1                                             0x00000000
+#define CDRATIO_X2                                             0x00000040
+#define CDRATIO_X4                                             0x00000080
+#define CDRATIO_X8                                             0x000000c0
+#define SOCFPGA_FPGMGR_CTL_CDRATIO_MASK                                0x000000c0
+
+#define SOCFPGA_FPGMGR_CTL_AXICFGEN                            0x00000100
+
+#define CFGWDTH_16                                             0x00000000
+#define CFGWDTH_32                                             0x00000200
+#define SOCFPGA_FPGMGR_CTL_CFGWDTH_MASK                                0x00000200
+
+/* SOCFPGA_FPGMGR_DCLKSTAT register */
+#define SOCFPGA_FPGMGR_DCLKSTAT_DCNTDONE_E_DONE                        0x1
+
+/* SOCFPGA_FPGMGR_GPIO_* registers share the same bit positions */
+#define SOCFPGA_FPGMGR_MON_NSTATUS                             0x0001
+#define SOCFPGA_FPGMGR_MON_CONF_DONE                           0x0002
+#define SOCFPGA_FPGMGR_MON_INIT_DONE                           0x0004
+#define SOCFPGA_FPGMGR_MON_CRC_ERROR                           0x0008
+#define SOCFPGA_FPGMGR_MON_CVP_CONF_DONE                       0x0010
+#define SOCFPGA_FPGMGR_MON_PR_READY                            0x0020
+#define SOCFPGA_FPGMGR_MON_PR_ERROR                            0x0040
+#define SOCFPGA_FPGMGR_MON_PR_DONE                             0x0080
+#define SOCFPGA_FPGMGR_MON_NCONFIG_PIN                         0x0100
+#define SOCFPGA_FPGMGR_MON_NSTATUS_PIN                         0x0200
+#define SOCFPGA_FPGMGR_MON_CONF_DONE_PIN                       0x0400
+#define SOCFPGA_FPGMGR_MON_FPGA_POWER_ON                       0x0800
+#define SOCFPGA_FPGMGR_MON_STATUS_MASK                         0x0fff
+
+#define SOCFPGA_FPGMGR_NUM_SUPPLIES 3
+#define SOCFPGA_RESUME_TIMEOUT 3
+
+/* In power-up order. Reverse for power-down. */
+static const char *supply_names[SOCFPGA_FPGMGR_NUM_SUPPLIES] __maybe_unused = {
+       "FPGA-1.5V",
+       "FPGA-1.1V",
+       "FPGA-2.5V",
+};
+
+struct socfpga_fpga_priv {
+       void __iomem *fpga_base_addr;
+       void __iomem *fpga_data_addr;
+       struct completion status_complete;
+       int irq;
+};
+
+struct cfgmgr_mode {
+       /* Values to set in the CTRL register */
+       u32 ctrl;
+
+       /* flag that this table entry is a valid mode */
+       bool valid;
+};
+
+/* For SOCFPGA_FPGMGR_STAT_MSEL field */
+static struct cfgmgr_mode cfgmgr_modes[] = {
+       [MSEL_PP16_FAST_NOAES_NODC] = { CFGWDTH_16 | CDRATIO_X1, 1 },
+       [MSEL_PP16_FAST_AES_NODC] =   { CFGWDTH_16 | CDRATIO_X2, 1 },
+       [MSEL_PP16_FAST_AESOPT_DC] =  { CFGWDTH_16 | CDRATIO_X4, 1 },
+       [MSEL_PP16_SLOW_NOAES_NODC] = { CFGWDTH_16 | CDRATIO_X1, 1 },
+       [MSEL_PP16_SLOW_AES_NODC] =   { CFGWDTH_16 | CDRATIO_X2, 1 },
+       [MSEL_PP16_SLOW_AESOPT_DC] =  { CFGWDTH_16 | CDRATIO_X4, 1 },
+       [MSEL_PP32_FAST_NOAES_NODC] = { CFGWDTH_32 | CDRATIO_X1, 1 },
+       [MSEL_PP32_FAST_AES_NODC] =   { CFGWDTH_32 | CDRATIO_X4, 1 },
+       [MSEL_PP32_FAST_AESOPT_DC] =  { CFGWDTH_32 | CDRATIO_X8, 1 },
+       [MSEL_PP32_SLOW_NOAES_NODC] = { CFGWDTH_32 | CDRATIO_X1, 1 },
+       [MSEL_PP32_SLOW_AES_NODC] =   { CFGWDTH_32 | CDRATIO_X4, 1 },
+       [MSEL_PP32_SLOW_AESOPT_DC] =  { CFGWDTH_32 | CDRATIO_X8, 1 },
+};
+
+static u32 socfpga_fpga_readl(struct socfpga_fpga_priv *priv, u32 reg_offset)
+{
+       return readl(priv->fpga_base_addr + reg_offset);
+}
+
+static void socfpga_fpga_writel(struct socfpga_fpga_priv *priv, u32 reg_offset,
+                               u32 value)
+{
+       writel(value, priv->fpga_base_addr + reg_offset);
+}
+
+static u32 socfpga_fpga_raw_readl(struct socfpga_fpga_priv *priv,
+                                 u32 reg_offset)
+{
+       return __raw_readl(priv->fpga_base_addr + reg_offset);
+}
+
+static void socfpga_fpga_raw_writel(struct socfpga_fpga_priv *priv,
+                                   u32 reg_offset, u32 value)
+{
+       __raw_writel(value, priv->fpga_base_addr + reg_offset);
+}
+
+static void socfpga_fpga_data_writel(struct socfpga_fpga_priv *priv, u32 value)
+{
+       writel(value, priv->fpga_data_addr);
+}
+
+static inline void socfpga_fpga_set_bitsl(struct socfpga_fpga_priv *priv,
+                                         u32 offset, u32 bits)
+{
+       u32 val;
+
+       val = socfpga_fpga_readl(priv, offset);
+       val |= bits;
+       socfpga_fpga_writel(priv, offset, val);
+}
+
+static inline void socfpga_fpga_clr_bitsl(struct socfpga_fpga_priv *priv,
+                                         u32 offset, u32 bits)
+{
+       u32 val;
+
+       val = socfpga_fpga_readl(priv, offset);
+       val &= ~bits;
+       socfpga_fpga_writel(priv, offset, val);
+}
+
+static u32 socfpga_fpga_mon_status_get(struct socfpga_fpga_priv *priv)
+{
+       return socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_GPIO_EXT_PORTA_OFST) &
+               SOCFPGA_FPGMGR_MON_STATUS_MASK;
+}
+
+static u32 socfpga_fpga_state_get(struct socfpga_fpga_priv *priv)
+{
+       u32 status = socfpga_fpga_mon_status_get(priv);
+
+       if ((status & SOCFPGA_FPGMGR_MON_FPGA_POWER_ON) == 0)
+               return SOCFPGA_FPGMGR_STAT_POWER_OFF;
+
+       return socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_STAT_OFST) &
+               SOCFPGA_FPGMGR_STAT_STATE_MASK;
+}
+
+static void socfpga_fpga_clear_done_status(struct socfpga_fpga_priv *priv)
+{
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_DCLKSTAT_OFST,
+                           SOCFPGA_FPGMGR_DCLKSTAT_DCNTDONE_E_DONE);
+}
+
+/*
+ * Set the DCLKCNT, wait for DCLKSTAT to report the count completed, and clear
+ * the complete status.
+ */
+static int socfpga_fpga_dclk_set_and_wait_clear(struct socfpga_fpga_priv *priv,
+                                               u32 count)
+{
+       int timeout = 2;
+       u32 done;
+
+       /* Clear any existing DONE status. */
+       if (socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_DCLKSTAT_OFST))
+               socfpga_fpga_clear_done_status(priv);
+
+       /* Issue the DCLK count. */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_DCLKCNT_OFST, count);
+
+       /* Poll DCLKSTAT to see if it completed in the timeout period. */
+       do {
+               done = socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_DCLKSTAT_OFST);
+               if (done == SOCFPGA_FPGMGR_DCLKSTAT_DCNTDONE_E_DONE) {
+                       socfpga_fpga_clear_done_status(priv);
+                       return 0;
+               }
+               udelay(1);
+       } while (timeout--);
+
+       return -ETIMEDOUT;
+}
+
+static int socfpga_fpga_wait_for_state(struct socfpga_fpga_priv *priv,
+                                      u32 state)
+{
+       int timeout = 2;
+
+       /*
+        * HW doesn't support an interrupt for changes in state, so poll to see
+        * if it matches the requested state within the timeout period.
+        */
+       do {
+               if ((socfpga_fpga_state_get(priv) & state) != 0)
+                       return 0;
+               msleep(20);
+       } while (timeout--);
+
+       return -ETIMEDOUT;
+}
+
+static void socfpga_fpga_enable_irqs(struct socfpga_fpga_priv *priv, u32 irqs)
+{
+       /* set irqs to level sensitive */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_INTTYPE_LEVEL_OFST, 0);
+
+       /* set interrupt polarity */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_INT_POL_OFST, irqs);
+
+       /* clear irqs */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_PORTA_EOI_OFST, irqs);
+
+       /* unmask interrupts */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_INTMSK_OFST, 0);
+
+       /* enable interrupts */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_INTEN_OFST, irqs);
+}
+
+static void socfpga_fpga_disable_irqs(struct socfpga_fpga_priv *priv)
+{
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_INTEN_OFST, 0);
+}
+
+static irqreturn_t socfpga_fpga_isr(int irq, void *dev_id)
+{
+       struct socfpga_fpga_priv *priv = dev_id;
+       u32 irqs, st;
+       bool conf_done, nstatus;
+
+       /* clear irqs */
+       irqs = socfpga_fpga_raw_readl(priv, SOCFPGA_FPGMGR_GPIO_INTSTAT_OFST);
+
+       socfpga_fpga_raw_writel(priv, SOCFPGA_FPGMGR_GPIO_PORTA_EOI_OFST, irqs);
+
+       st = socfpga_fpga_raw_readl(priv, SOCFPGA_FPGMGR_GPIO_EXT_PORTA_OFST);
+       conf_done = (st & SOCFPGA_FPGMGR_MON_CONF_DONE) != 0;
+       nstatus = (st & SOCFPGA_FPGMGR_MON_NSTATUS) != 0;
+
+       /* success */
+       if (conf_done && nstatus) {
+               /* disable irqs */
+               socfpga_fpga_raw_writel(priv,
+                                       SOCFPGA_FPGMGR_GPIO_INTEN_OFST, 0);
+               complete(&priv->status_complete);
+       }
+
+       return IRQ_HANDLED;
+}
+
+static int socfpga_fpga_wait_for_config_done(struct socfpga_fpga_priv *priv)
+{
+       int timeout, ret = 0;
+
+       socfpga_fpga_disable_irqs(priv);
+       init_completion(&priv->status_complete);
+       socfpga_fpga_enable_irqs(priv, SOCFPGA_FPGMGR_MON_CONF_DONE);
+
+       timeout = wait_for_completion_interruptible_timeout(
+                                               &priv->status_complete,
+                                               msecs_to_jiffies(10));
+       if (timeout == 0)
+               ret = -ETIMEDOUT;
+
+       socfpga_fpga_disable_irqs(priv);
+       return ret;
+}
+
+static int socfpga_fpga_cfg_mode_get(struct socfpga_fpga_priv *priv)
+{
+       u32 msel;
+
+       msel = socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_STAT_OFST);
+       msel &= SOCFPGA_FPGMGR_STAT_MSEL_MASK;
+       msel >>= SOCFPGA_FPGMGR_STAT_MSEL_SHIFT;
+
+       /* Check that this MSEL setting is supported */
+       if ((msel >= ARRAY_SIZE(cfgmgr_modes)) || !cfgmgr_modes[msel].valid)
+               return -EINVAL;
+
+       return msel;
+}
+
+static int socfpga_fpga_cfg_mode_set(struct socfpga_fpga_priv *priv)
+{
+       u32 ctrl_reg;
+       int mode;
+
+       /* get value from MSEL pins */
+       mode = socfpga_fpga_cfg_mode_get(priv);
+       if (mode < 0)
+               return mode;
+
+       /* Adjust CTRL for the CDRATIO */
+       ctrl_reg = socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_CTL_OFST);
+       ctrl_reg &= ~SOCFPGA_FPGMGR_CTL_CDRATIO_MASK;
+       ctrl_reg &= ~SOCFPGA_FPGMGR_CTL_CFGWDTH_MASK;
+       ctrl_reg |= cfgmgr_modes[mode].ctrl;
+
+       /* Set NCE to 0. */
+       ctrl_reg &= ~SOCFPGA_FPGMGR_CTL_NCE;
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_CTL_OFST, ctrl_reg);
+
+       return 0;
+}
+
+static int socfpga_fpga_reset(struct fpga_manager *mgr)
+{
+       struct socfpga_fpga_priv *priv = mgr->priv;
+       u32 ctrl_reg, status;
+       int ret;
+
+       /*
+        * Step 1:
+        *  - Set CTRL.CFGWDTH, CTRL.CDRATIO to match cfg mode
+        *  - Set CTRL.NCE to 0
+        */
+       ret = socfpga_fpga_cfg_mode_set(priv);
+       if (ret)
+               return ret;
+
+       /* Step 2: Set CTRL.EN to 1 */
+       socfpga_fpga_set_bitsl(priv, SOCFPGA_FPGMGR_CTL_OFST,
+                              SOCFPGA_FPGMGR_CTL_EN);
+
+       /* Step 3: Set CTRL.NCONFIGPULL to 1 to put FPGA in reset */
+       ctrl_reg = socfpga_fpga_readl(priv, SOCFPGA_FPGMGR_CTL_OFST);
+       ctrl_reg |= SOCFPGA_FPGMGR_CTL_NCFGPULL;
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_CTL_OFST, ctrl_reg);
+
+       /* Step 4: Wait for STATUS.MODE to report FPGA is in reset phase */
+       status = socfpga_fpga_wait_for_state(priv, SOCFPGA_FPGMGR_STAT_RESET);
+
+       /* Step 5: Set CONTROL.NCONFIGPULL to 0 to release FPGA from reset */
+       ctrl_reg &= ~SOCFPGA_FPGMGR_CTL_NCFGPULL;
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_CTL_OFST, ctrl_reg);
+
+       /* Timeout waiting for reset */
+       if (status)
+               return -ETIMEDOUT;
+
+       return 0;
+}
+
+/*
+ * Prepare the FPGA to receive the configuration data.
+ */
+static int socfpga_fpga_ops_configure_init(struct fpga_manager *mgr, u32 flags,
+                                          const char *buf, size_t count)
+{
+       struct socfpga_fpga_priv *priv = mgr->priv;
+       int ret;
+
+       if (flags & FPGA_MGR_PARTIAL_RECONFIG) {
+               dev_err(&mgr->dev, "Partial reconfiguration not supported.\n");
+               return -EINVAL;
+       }
+       /* Steps 1 - 5: Reset the FPGA */
+       ret = socfpga_fpga_reset(mgr);
+       if (ret)
+               return ret;
+
+       /* Step 6: Wait for FPGA to enter configuration phase */
+       if (socfpga_fpga_wait_for_state(priv, SOCFPGA_FPGMGR_STAT_CFG))
+               return -ETIMEDOUT;
+
+       /* Step 7: Clear nSTATUS interrupt */
+       socfpga_fpga_writel(priv, SOCFPGA_FPGMGR_GPIO_PORTA_EOI_OFST,
+                           SOCFPGA_FPGMGR_MON_NSTATUS);
+
+       /* Step 8: Set CTRL.AXICFGEN to 1 to enable transfer of config data */
+       socfpga_fpga_set_bitsl(priv, SOCFPGA_FPGMGR_CTL_OFST,
+                              SOCFPGA_FPGMGR_CTL_AXICFGEN);
+
+       return 0;
+}
+
+/*
+ * Step 9: write data to the FPGA data register
+ */
+static int socfpga_fpga_ops_configure_write(struct fpga_manager *mgr,
+                                           const char *buf, size_t count)
+{
+       struct socfpga_fpga_priv *priv = mgr->priv;
+       u32 *buffer_32 = (u32 *)buf;
+       size_t i = 0;
+
+       if (count <= 0)
+               return -EINVAL;
+
+       /* Write out the complete 32-bit chunks. */
+       while (count >= sizeof(u32)) {
+               socfpga_fpga_data_writel(priv, buffer_32[i++]);
+               count -= sizeof(u32);
+       }
+
+       /* Write out remaining non 32-bit chunks. */
+       switch (count) {
+       case 3:
+               socfpga_fpga_data_writel(priv, buffer_32[i++] & 0x00ffffff);
+               break;
+       case 2:
+               socfpga_fpga_data_writel(priv, buffer_32[i++] & 0x0000ffff);
+               break;
+       case 1:
+               socfpga_fpga_data_writel(priv, buffer_32[i++] & 0x000000ff);
+               break;
+       case 0:
+               break;
+       default:
+               /* This will never happen. */
+               return -EFAULT;
+       }
+
+       return 0;
+}
+
+static int socfpga_fpga_ops_configure_complete(struct fpga_manager *mgr,
+                                              u32 flags)
+{
+       struct socfpga_fpga_priv *priv = mgr->priv;
+       u32 status;
+
+       /*
+        * Step 10:
+        *  - Observe CONF_DONE and nSTATUS (active low)
+        *  - if CONF_DONE = 1 and nSTATUS = 1, configuration was successful
+        *  - if CONF_DONE = 0 and nSTATUS = 0, configuration failed
+        */
+       status = socfpga_fpga_wait_for_config_done(priv);
+       if (status)
+               return status;
+
+       /* Step 11: Clear CTRL.AXICFGEN to disable transfer of config data */
+       socfpga_fpga_clr_bitsl(priv, SOCFPGA_FPGMGR_CTL_OFST,
+                              SOCFPGA_FPGMGR_CTL_AXICFGEN);
+
+       /*
+        * Step 12:
+        *  - Write 4 to DCLKCNT
+        *  - Wait for STATUS.DCNTDONE = 1
+        *  - Clear W1C bit in STATUS.DCNTDONE
+        */
+       if (socfpga_fpga_dclk_set_and_wait_clear(priv, 4))
+               return -ETIMEDOUT;
+
+       /* Step 13: Wait for STATUS.MODE to report USER MODE */
+       if (socfpga_fpga_wait_for_state(priv, SOCFPGA_FPGMGR_STAT_USER_MODE))
+               return -ETIMEDOUT;
+
+       /* Step 14: Set CTRL.EN to 0 */
+       socfpga_fpga_clr_bitsl(priv, SOCFPGA_FPGMGR_CTL_OFST,
+                              SOCFPGA_FPGMGR_CTL_EN);
+
+       return 0;
+}
+
+/* Translate state register values to FPGA framework state */
+static const enum fpga_mgr_states socfpga_state_to_framework_state[] = {
+       [SOCFPGA_FPGMGR_STAT_POWER_OFF] = FPGA_MGR_STATE_POWER_OFF,
+       [SOCFPGA_FPGMGR_STAT_RESET] = FPGA_MGR_STATE_RESET,
+       [SOCFPGA_FPGMGR_STAT_CFG] = FPGA_MGR_STATE_WRITE_INIT,
+       [SOCFPGA_FPGMGR_STAT_INIT] = FPGA_MGR_STATE_WRITE_INIT,
+       [SOCFPGA_FPGMGR_STAT_USER_MODE] = FPGA_MGR_STATE_OPERATING,
+       [SOCFPGA_FPGMGR_STAT_UNKNOWN] = FPGA_MGR_STATE_UNKNOWN,
+};
+
+static enum fpga_mgr_states socfpga_fpga_ops_state(struct fpga_manager *mgr)
+{
+       struct socfpga_fpga_priv *priv = mgr->priv;
+       enum fpga_mgr_states ret;
+       u32 state;
+
+       state = socfpga_fpga_state_get(priv);
+
+       if (state < ARRAY_SIZE(socfpga_state_to_framework_state))
+               ret = socfpga_state_to_framework_state[state];
+       else
+               ret = FPGA_MGR_STATE_UNKNOWN;
+
+       return ret;
+}
+
+static const struct fpga_manager_ops socfpga_fpga_ops = {
+       .state = socfpga_fpga_ops_state,
+       .write_init = socfpga_fpga_ops_configure_init,
+       .write = socfpga_fpga_ops_configure_write,
+       .write_complete = socfpga_fpga_ops_configure_complete,
+};
+
+static int socfpga_fpga_probe(struct platform_device *pdev)
+{
+       struct device *dev = &pdev->dev;
+       struct socfpga_fpga_priv *priv;
+       struct resource *res;
+       int ret;
+
+       priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL);
+       if (!priv)
+               return -ENOMEM;
+
+       res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
+       priv->fpga_base_addr = devm_ioremap_resource(dev, res);
+       if (IS_ERR(priv->fpga_base_addr))
+               return PTR_ERR(priv->fpga_base_addr);
+
+       res = platform_get_resource(pdev, IORESOURCE_MEM, 1);
+       priv->fpga_data_addr = devm_ioremap_resource(dev, res);
+       if (IS_ERR(priv->fpga_data_addr))
+               return PTR_ERR(priv->fpga_data_addr);
+
+       priv->irq = platform_get_irq(pdev, 0);
+       if (priv->irq < 0)
+               return priv->irq;
+
+       ret = devm_request_irq(dev, priv->irq, socfpga_fpga_isr, 0,
+                              dev_name(dev), priv);
+       if (IS_ERR_VALUE(ret))
+               return ret;
+
+       return fpga_mgr_register(dev, "Altera SOCFPGA FPGA Manager",
+                                &socfpga_fpga_ops, priv);
+}
+
+static int socfpga_fpga_remove(struct platform_device *pdev)
+{
+       fpga_mgr_unregister(&pdev->dev);
+
+       return 0;
+}
+
+#ifdef CONFIG_OF
+static const struct of_device_id socfpga_fpga_of_match[] = {
+       { .compatible = "altr,socfpga-fpga-mgr", },
+       {},
+};
+
+MODULE_DEVICE_TABLE(of, socfpga_fpga_of_match);
+#endif
+
+static struct platform_driver socfpga_fpga_driver = {
+       .probe = socfpga_fpga_probe,
+       .remove = socfpga_fpga_remove,
+       .driver = {
+               .name   = "socfpga_fpga_manager",
+               .of_match_table = of_match_ptr(socfpga_fpga_of_match),
+       },
+};
+
+module_platform_driver(socfpga_fpga_driver);
+
+MODULE_AUTHOR("Alan Tull <[email protected]>");
+MODULE_DESCRIPTION("Altera SOCFPGA FPGA Manager");
+MODULE_LICENSE("GPL v2");
--
Quoted 2 lines

1.7.9.5

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

#14 lore raw

PATCH v10 5/8 staging: usage documentation for simple fpga bus

In reply to [email protected]

From: Alan Tull <[email protected]>

Add a document spelling out usage of the simple fpga bus.

---
v9: Initial version of this patch in patchset

v10: s/fpga/FPGA/g
improve formatting
some rewriting
move to staging/simple-fpga-bus

---
 .../Documentation/simple-fpga-bus.txt              |   58 ++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/simple-fpga-bus.txt
drivers/staging/simple-fpga-bus/Documentation/simple-fpga-bus.txt new file +58 -0
new file mode 100644
index 0000000..c96d705
@@ -0,0 +1,58 @@
+Simple FPGA Bus
+
+Alan Tull 2015
+
+Overview
+========
+
+The simple FPGA bus adds device tree overlay support for FPGA's.  Loading a
+DT overlay will result in the FPGA getting an image loaded, its bridges will
+be released, and the DT populated for nodes below the simple-fpga-bus.  This
+results in drivers getting probed for the hardware that just got added.  This
+is intended to support the FPGA usage where the FPGA has hardware that
+requires drivers.  Removing the overlay will result in the drivers getting
+removed and the bridges being disabled.
+
+The simple FPGA bus will need to disable and enable bridges that will only
+affect the child devices that are below the bus.  These are pointed to by
+phandles to their resets.  If partial reconfiguration is to be done, then
+bridges will need to be added within the FPGA design to protect the rest of the
+bus when one part of the FPGA design is being reconfigured.
+
+
+Sequence
+========
+
+Load the DT overlay.  One way to do that from user space is to use Pantelis'
+DT-Overlay configfs interface.
+
+This causes the simple FPGA bus go be probed and will do the following:
+ 1. Disable the FPGA bridges.
+ 2. Call the FPGA manager core to program the FPGA.
+ 3. Release the FPGA bridges.
+ 4. Call of_platform_populate resulting in device drivers getting probed.
+
+
+Requirements
+============
+
+ 1. An FPGA image that has a hardware block or blocks that use drivers that are
+    supported in the kernel.
+ 2. A device tree overlay (example is in the simple-fpga-bus bindings document).
+ 3. A FPGA manager driver supporting writing the FPGA.
+ 4. FPGA bridge resets supported as reset controllers.
+
+The DT overlay includes bindings (documented in bindings/simple-fpga-bus.txt)
+that specify:
+ * Which FPGA manager to use.
+ * Which image file to load.
+ * Flags indicating whether this this image is for full reconfiguration or
+   partial.
+ * A list of resets that control the FPGA bridges.
+ * Child nodes specifying the devices that will be added with appropriate
+   compatible strings, etc.
+
+Since this code uses the firmware interface to get the image and DT overlay,
+they currently have to be files on the file system.  It doesn't have to be that
+way forever as DT bindings could be added to point to other sources for the
+image.
Signature · 1 line
1.7.9.5
Acked-by on v10 5/8
#15 lore raw

Re: [PATCH v10 5/8] staging: usage documentation for simple fpga bus

Quoted 5 lines · On Thu 2015-08-13 12:37:29, [email protected]…

From: Alan Tull <[email protected]>

Add a document spelling out usage of the simple fpga bus.

Pavel

Signature · 6 lines
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
author
#16 lore raw

Re: [PATCH v10 5/8] staging: usage documentation for simple fpga bus

Quoted 9 lines · Pavel Machek
Quoted 5 lines · On Thu 2015-08-13 12:37:29, [email protected] wrote:

From: Alan Tull <[email protected]>

Add a document spelling out usage of the simple fpga bus.

Pavel

Hi Pavel,

Thanks!

Alan

Quoted 4 lines
Signature · 2 lines
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
#17 lore raw

Re: [PATCH v10 5/8] staging: usage documentation for simple fpga bus

Quoted 21 lines · atull
Quoted 9 lines · Pavel Machek
Quoted 5 lines · On Thu 2015-08-13 12:37:29, [email protected] wrote:

From: Alan Tull <[email protected]>

Add a document spelling out usage of the simple fpga bus.

Pavel

Hi Pavel,

Thanks!

Alan

Quoted 4 lines

--
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html

#18 lore raw

PATCH v10 6/8 staging: add bindings document for simple fpga bus

In reply to [email protected]

From: Alan Tull <[email protected]>

New bindings document for simple fpga bus.

---
v9: initial version added to this patchset

v10: s/fpga/FPGA/g
replace DT overlay example with slightly more complicated example move to staging/simple-fpga-bus

---
 .../Documentation/bindings/simple-fpga-bus.txt     |   83 ++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt
drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt new file +83 -0
new file mode 100644
index 0000000..5a55fb2
@@ -0,0 +1,83 @@
+Simple FPGA Bus
+===============
+
+A Simple FPGA Bus is a bus that handles configuring an FPGA and its bridges
+before populating the devices below its node.  All this happens when a device
+tree overlay is added to the live tree.  This document describes that device
+tree overlay.
+
+Required properties:
+- compatible : should contain "simple-fpga-bus"
+- #address-cells, #size-cells, ranges: must be present to handle address space
+  mapping for children.
+
+Optional properties:
+- fpga-mgr : should contain a phandle to a FPGA manager.
+- fpga-firmware : should contain the name of a FPGA image file located on the
+  firmware search path.
+- partial-reconfig : boolean property should be defined if partial
+  reconfiguration is to be done.
+- resets : should contain a list of resets that the bus will assert before
+  programming the FPGA and then deassert after the FPGA has been programmed
+  i.e. FPGA bridges.
+- reset-names : should contain a list of the names of the resets.
+
+Example:
+
+/dts-v1/;
+/plugin/;
+/ {
+	fragment@0 {
+		target-path="/soc";
+		__overlay__ {
+			#address-cells = <1>;
+	                #size-cells = <1>;
+
+			bridge@0xff200000 {
+				compatible = "simple-fpga-bus";
+				reg = <0xc0000000 0x20000000>,
+				      <0xff200000 0x00200000>;
+				reg-names = "axi_h2f", "axi_h2f_lw";
+
+				#address-cells = <0x2>;
+				#size-cells = <0x1>;
+
+				ranges = <0x00000000 0x00000000 0xc0000000 0x00010000>,
+					 <0x00000001 0x00020000 0xff220000 0x00000008>,
+					 <0x00000001 0x00010040 0xff210040 0x00000020>;
+
+				clocks = <0x2 0x2>;
+				clock-names = "h2f_lw_axi_clock", "f2h_sdram0_clock";
+
+				fpga-mgr = <&hps_0_fpgamgr>;
+				fpga-firmware = "soc_system.rbf";
+
+				resets = <&hps_fpgabridge0 0>, <&hps_fpgabridge1 0>, <&hps_fpgabridge2 0>;
+				reset-names = "hps2fpga", "lwhps2fpga", "fpga2hps";
+
+				onchip_memory2_0: memory@0x000000000 {
+					device_type = "memory";
+					compatible = "ALTR,onchipmem-15.1";
+					reg = <0x00000000 0x00000000 0x00010000>;
+				};
+
+				jtag_uart: serial@0x100020000 {
+					compatible = "altr,juart-15.1", "altr,juart-1.0";
+					reg = <0x00000001 0x00020000 0x00000008>;
+					interrupt-parent = <&intc>;
+					interrupts = <0 42 4>;
+				};
+
+				led_pio: gpio@0x100010040 {
+					compatible = "altr,pio-15.1", "altr,pio-1.0";
+					reg = <0x00000001 0x00010040 0x00000020>;
+					altr,gpio-bank-width = <4>;
+					resetvalue = <0>;
+					#gpio-cells = <2>;
+					gpio-controller;
+				};
+			};
+		};
+	};
+};
+
Signature · 1 line
1.7.9.5
Acked-by on v10 6/8
#19 lore raw

Re: [PATCH v10 6/8] staging: add bindings document for simple fpga bus

Quoted 5 lines · On Thu 2015-08-13 12:37:30, [email protected] wrote:

From: Alan Tull <[email protected]>

New bindings document for simple fpga bus.

drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt line 60

Quoted 3 lines
drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt new file +3 -0
+				onchip_memory2_0: memory@0x000000000 {
+					device_type = "memory";
+					compatible = "ALTR,onchipmem-15.1";

I guess this should be "altr," .

drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt line 67

Quoted 4 lines
drivers/staging/simple-fpga-bus/Documentation/bindings/simple-fpga-bus.txt new file +4 -0
+				jtag_uart: serial@0x100020000 {
+					compatible = "altr,juart-15.1", "altr,juart-1.0";
+					reg = <0x00000001 0x00020000 0x00000008>;
+					interrupt-parent = <&intc>;

Best regards,
Pavel

Signature · 2 lines
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
#20 lore raw

PATCH v10 7/8 staging: simple-fpga-bus: add TODO document

In reply to [email protected]

From: Alan Tull <[email protected]>

Add a TODO document for the simple fpga bus.

---
v10: This patch added in v10 of the patch set

---
 drivers/staging/simple-fpga-bus/TODO |   13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 drivers/staging/simple-fpga-bus/TODO
drivers/staging/simple-fpga-bus/TODO new file +13 -0
new file mode 100644
index 0000000..c218a57
@@ -0,0 +1,13 @@
+TODO:
+
+This simple-fpga-bus design avoids adding a new FPGA bridge framework as
+another dependency.  FPGA bridges are seen as phandles to resets.  I'd like
+to see if this will work for people.
+
+	- Waiting on configfs interface for DT Overlays
+	- Are the simple-fpga-bus bindings acceptable?
+	- Children don't get populated if FPGA manager is a module. Not a
+	  problem if FPGA manager is built in.
+
+Patches to:
+	Alan Tull <[email protected]>
Signature · 1 line
1.7.9.5
#21 lore raw

PATCH v10 8/8 staging: add simple-fpga-bus

In reply to [email protected]

From: Alan Tull <[email protected]>

Add simple fpga bus. This is a bus that configures an fpga and its bridges before populating the devices below it. This is intended for use with device tree overlays.

Note that FPGA bridges are seen as reset controllers so no special framework for FPGA bridges will need to be added.

This supports fpga use where hardware blocks on a fpga will need drivers (as opposed to fpga used as an acceleration without drivers.)

---
v9: initial version (this patch added during rest of patchset's v9)

v10: request deferral if fpga mgr or bridges not available yet
cleanup as fpga manager core goes into the real kernel Don't assume bridges are disabled before programming FPGA Don't hang onto reference for fpga manager
Move to staging/simple-fpga-bus

---
 drivers/staging/Kconfig                           |    2 +
 drivers/staging/Makefile                          |    1 +
 drivers/staging/simple-fpga-bus/Kconfig           |   14 +
 drivers/staging/simple-fpga-bus/Makefile          |    5 +
 drivers/staging/simple-fpga-bus/simple-fpga-bus.c |  330 +++++++++++++++++++++
 5 files changed, 352 insertions(+)
 create mode 100644 drivers/staging/simple-fpga-bus/Kconfig
 create mode 100644 drivers/staging/simple-fpga-bus/Makefile
 create mode 100644 drivers/staging/simple-fpga-bus/simple-fpga-bus.c
drivers/staging/Kconfig +2 -0
index 7f6cae5..e655799 100644
@@ -112,4 +112,6 @@ source "drivers/staging/fsl-mc/Kconfig"
 
 source "drivers/staging/wilc1000/Kconfig"
 
+source "drivers/staging/simple-fpga-bus/Kconfig"
+
 endif # STAGING
drivers/staging/Makefile +1 -0
index 347f647..6b5472e 100644
@@ -48,3 +48,4 @@ obj-$(CONFIG_COMMON_CLK_XLNX_CLKWZRD)	+= clocking-wizard/
 obj-$(CONFIG_FB_TFT)		+= fbtft/
 obj-$(CONFIG_FSL_MC_BUS)	+= fsl-mc/
 obj-$(CONFIG_WILC1000)		+= wilc1000/
+obj-$(CONFIG_FPGA)		+= simple-fpga-bus/
drivers/staging/simple-fpga-bus/Kconfig new file +14 -0
new file mode 100644
index 0000000..1c46be5
@@ -0,0 +1,14 @@
+#
+# FPGA framework configuration
+#
+
+if FPGA
+
+config SIMPLE_FPGA_BUS
+       bool "Simple FPGA Bus"
+       depends on OF
+       help
+         Simple FPGA Bus allows loading FPGA images under control of
+	 Device Tree.
+
+endif # FPGA
drivers/staging/simple-fpga-bus/Makefile new file +5 -0
new file mode 100644
index 0000000..ee4844b
@@ -0,0 +1,5 @@
+#
+# Makefile for staging/fpga/
+#
+
+obj-$(CONFIG_SIMPLE_FPGA_BUS)		+= simple-fpga-bus.o
drivers/staging/simple-fpga-bus/simple-fpga-bus.c new file +330 -0

330 lines not on this page · raw message

Signature · 1 line
1.7.9.5
#22 lore raw

Re: [PATCH v10 8/8] staging: add simple-fpga-bus

Quoted 6 lines · On Thu 2015-08-13 12:37:32, [email protected] wrote:

From: Alan Tull <[email protected]>

Add simple fpga bus. This is a bus that configures an fpga and its bridges before populating the devices below it. This is intended for use with device tree overlays.

Quoted 7 lines

Note that FPGA bridges are seen as reset controllers so no special framework for FPGA bridges will need to be added.

This supports fpga use where hardware blocks on a fpga will need drivers (as opposed to fpga used as an acceleration without drivers.)

7,8: Acked-by: Pavel Machek <[email protected]>

Signature · 2 lines
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html