Re: [PATCH v6 03/29] fpga: mgr: add status for fpga-manager

2018-06-12 Thread Alan Tull
On Tue, Jun 12, 2018 at 5:10 AM, Wu Hao  wrote:

Hi Hao,

>  Documentation/ABI/testing/sysfs-class-fpga-manager | 24 +++
>  drivers/fpga/fpga-mgr.c| 28 
> ++
>  include/linux/fpga/fpga-mgr.h  |  9 +++
>  3 files changed, 61 insertions(+)
>
> diff --git a/Documentation/ABI/testing/sysfs-class-fpga-manager 
> b/Documentation/ABI/testing/sysfs-class-fpga-manager
> index 23056c5..2aadf59 100644
> --- a/Documentation/ABI/testing/sysfs-class-fpga-manager
> +++ b/Documentation/ABI/testing/sysfs-class-fpga-manager
> @@ -35,3 +35,27 @@ Description: Read fpga manager state as a string.
> * write complete= Doing post programming steps
> * write complete error  = Error while doing post programming
> * operating = FPGA is programmed and operating
> +
> +What:  /sys/class/fpga_manager//status
> +Date:  June 2018
> +KernelVersion: 4.18

4.19

Greg is queuing new functionality for 4.19 after 4.18-rc1 is done.

> +Contact:   Wu Hao 
> +Description:   Read fpga manager status as a string.


[PATCH v6 03/29] fpga: mgr: add status for fpga-manager

2018-06-12 Thread Wu Hao
This patch adds status sysfs interface for fpga manager, it's a
read only interface which allows user to get fpga manager status,
including full/partial reconfiguration error and other status
information. It adds a status callback to fpga_manager_ops too,
allows each fpga_manager driver to define its own method to
collect latest status from hardware.

The following sysfs file is created:
* /sys/class/fpga_manager//status
  Return status of fpga manager, including reconfiguration errors.

Signed-off-by: Wu Hao 
Acked-by: Alan Tull 
Acked-by: Moritz Fischer 
---
v3: add one line description for status
add status callback function to fpga_manager_ops
update fpga-mgr status if any failure or during initialization
s/INCOMPATIBLE_BS_ERR/INCOMPATIBLE_IMAGE_ERR/
v4: simply code per suggestion from Alan.
add supported status strings (and descriptions) in sysfs document.
remove unused error code (SECURE_LOAD_ERR).
v5: fix the wrong commit message and add Acked-by from Alan and Moritz.
v6: rebase.
---
 Documentation/ABI/testing/sysfs-class-fpga-manager | 24 +++
 drivers/fpga/fpga-mgr.c| 28 ++
 include/linux/fpga/fpga-mgr.h  |  9 +++
 3 files changed, 61 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-class-fpga-manager 
b/Documentation/ABI/testing/sysfs-class-fpga-manager
index 23056c5..2aadf59 100644
--- a/Documentation/ABI/testing/sysfs-class-fpga-manager
+++ b/Documentation/ABI/testing/sysfs-class-fpga-manager
@@ -35,3 +35,27 @@ Description: Read fpga manager state as a string.
* write complete= Doing post programming steps
* write complete error  = Error while doing post programming
* operating = FPGA is programmed and operating
+
+What:  /sys/class/fpga_manager//status
+Date:  June 2018
+KernelVersion: 4.18
+Contact:   Wu Hao 
+Description:   Read fpga manager status as a string.
+   If FPGA programming operation fails, it could be caused by crc
+   error or incompatible bitstream image. The intent of this
+   interface is to provide more detailed information for FPGA
+   programming errors to userspace. This is a list of strings for
+   the supported status.
+
+   * reconfig operation error  - invalid operations detected by
+ reconfiguration hardware.
+ e.g start reconfiguration
+ with errors not cleared
+   * reconfig CRC error- CRC error detected by
+ reconfiguration hardware.
+   * reconfig incompatible image   - reconfiguration image is
+ incompatible with hardware
+   * reconfig IP protocol error- protocol errors detected by
+ reconfiguration hardware
+   * reconfig fifo overflow error  - FIFO overflow detected by
+ reconfiguration hardware
diff --git a/drivers/fpga/fpga-mgr.c b/drivers/fpga/fpga-mgr.c
index c1564cf..a41b07e 100644
--- a/drivers/fpga/fpga-mgr.c
+++ b/drivers/fpga/fpga-mgr.c
@@ -406,12 +406,40 @@ static ssize_t state_show(struct device *dev,
return sprintf(buf, "%s\n", state_str[mgr->state]);
 }
 
+static ssize_t status_show(struct device *dev,
+  struct device_attribute *attr, char *buf)
+{
+   struct fpga_manager *mgr = to_fpga_manager(dev);
+   u64 status;
+   int len = 0;
+
+   if (!mgr->mops->status)
+   return -ENOENT;
+
+   status = mgr->mops->status(mgr);
+
+   if (status & FPGA_MGR_STATUS_OPERATION_ERR)
+   len += sprintf(buf + len, "reconfig operation error\n");
+   if (status & FPGA_MGR_STATUS_CRC_ERR)
+   len += sprintf(buf + len, "reconfig CRC error\n");
+   if (status & FPGA_MGR_STATUS_INCOMPATIBLE_IMAGE_ERR)
+   len += sprintf(buf + len, "reconfig incompatible image\n");
+   if (status & FPGA_MGR_STATUS_IP_PROTOCOL_ERR)
+   len += sprintf(buf + len, "reconfig IP protocol error\n");
+   if (status & FPGA_MGR_STATUS_FIFO_OVERFLOW_ERR)
+   len += sprintf(buf + len, "reconfig fifo overflow error\n");
+
+   return len;
+}
+
 static DEVICE_ATTR_RO(name);
 static DEVICE_ATTR_RO(state);
+static DEVICE_ATTR_RO(status);
 
 static struct attribute *fpga_mgr_attrs[] = {
&dev_attr_name.attr,
&dev_attr_state.attr,
+   &dev_attr_status.attr,
NULL,
 };
 ATTRIBUTE_GROUPS(fpga_mgr);
diff --git a/include/linux/fpga/fpga-mgr.h b/include/linux/fpga/fpga-mgr.h
index 3eb6b9d..e249b72 100644
--- a/include/linux/fpga/fpga-mgr.h
+++ b/include/linux/fpga/fpga