Re: [PATCH v4 14/24] fpga: dfl: fme: add partial reconfiguration sub feature support

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Mon, Mar 12, 2018 at 02:36:48PM -0700, matthew.gerlach@xxxxxxxxxxxxxxx wrote:
> 
> 
> On Mon, 12 Mar 2018, Wu Hao wrote:
> 
> Hi Hao,
> 
> Please see my two comments inline.
> 
> Thanks,
> Matthew Gerlach
> 
> >On Sun, Mar 11, 2018 at 01:09:31PM -0700, matthew.gerlach@xxxxxxxxxxxxxxx wrote:
> >>
> >>
> >>On Mon, 5 Mar 2018, Alan Tull wrote:
> >>
> >>
> >>Hi Hao,
> >>
> >>I do think we should consider different hw implementations with this code
> >>because it does look like most of it is generic.  Specifically, I think
> >>we should consider DFH based fpga images that have been shipped already,
> >>and I think we need to consider new hardware implementations as well.
> >>Full disclosure, I am particularly interested in porting to a new hw
> >>implementation for partial reconfiguration.
> >
> >Hi Matthew,
> >
> >This dfl-fme-pr.c driver is developed for the PR sub feature (feature id
> >= 0x5), but we can reuse it for any cases if possible.
> >
> >>
> >>Please see some comments below.
> >
> >Thanks for the comments, please see my comments inline.
> >
> >>
> >>Matthew Gerlach
> >>
> >>>On Tue, Feb 13, 2018 at 3:24 AM, Wu Hao <hao.wu@xxxxxxxxx> wrote:
> >>>
> >>>Hi Hao,
> >>>
> >>>We are going to want to be able use different FPGA managers with this
> >>>framework.  The different manager may be part of a different FME in
> >>>fabric or it may be a hardware FPGA manager.  Fortunately, at this
> >>>point now the changes, noted below, to get there are pretty small.
> >>>
> >>>>From: Kang Luwei <luwei.kang@xxxxxxxxx>
> >>>>
> >>>>Partial Reconfiguration (PR) is the most important function for FME. It
> >>>>allows reconfiguration for given Port/Accelerated Function Unit (AFU).
> >>>>
> >>>>It creates platform devices for fpga-mgr, fpga-regions and fpga-bridges,
> >>>>and invokes fpga-region's interface (fpga_region_program_fpga) for PR
> >>>>operation once PR request received via ioctl. Below user space interface
> >>>>is exposed by this sub feature.
> >>>>
> >>>>Ioctl interface:
> >>>>* FPGA_FME_PORT_PR
> >>>> Do partial reconfiguration per information from userspace, including
> >>>> target port(AFU), buffer size and address info. It returns error code
> >>>> to userspace if failed. For detailed PR error information, user needs
> >>>> to read fpga-mgr's status sysfs interface.
> >>>>
> >>>>Signed-off-by: Tim Whisonant <tim.whisonant@xxxxxxxxx>
> >>>>Signed-off-by: Enno Luebbers <enno.luebbers@xxxxxxxxx>
> >>>>Signed-off-by: Shiva Rao <shiva.rao@xxxxxxxxx>
> >>>>Signed-off-by: Christopher Rauer <christopher.rauer@xxxxxxxxx>
> >>>>Signed-off-by: Kang Luwei <luwei.kang@xxxxxxxxx>
> >>>>Signed-off-by: Xiao Guangrong <guangrong.xiao@xxxxxxxxxxxxxxx>
> >>>>Signed-off-by: Wu Hao <hao.wu@xxxxxxxxx>
> >>>>---
> >>>>v2: moved the code to drivers/fpga folder as suggested by Alan Tull.
> >>>>   switched to GPLv2 license.
> >>>>   removed status from FPGA_FME_PORT_PR ioctl data structure.
> >>>>   added platform devices creation for fpga-mgr/fpga-region/fpga-bridge.
> >>>>   switched to fpga-region interface fpga_region_program_fpga for PR.
> >>>>   fixed comments from Alan Tull on FPGA_MGR_PARTIAL_RECONFIG flag usage.
> >>>>   fixed kbuild warnings.
> >>>>v3: rename driver files to dfl-fme-*.
> >>>>   rebase due to fpga APIs change.
> >>>>   replace bitfields.
> >>>>   switch to fpga_cdev_find_port to find port device.
> >>>>v4: rebase and correct comments for some function.
> >>>>   fix SPDX license issue.
> >>>>   remove unnecessary input parameter for destroy_bridge/region function.
> >>>>   add dfl-fme-pr.h for PR sub feature data structure and registers.
> >>>>---
> >>>>drivers/fpga/Makefile         |   2 +-
> >>>>drivers/fpga/dfl-fme-main.c   |  45 +++-
> >>>>drivers/fpga/dfl-fme-pr.c     | 497 ++++++++++++++++++++++++++++++++++++++++++
> >>>>drivers/fpga/dfl-fme-pr.h     | 113 ++++++++++
> >>>>drivers/fpga/dfl-fme.h        |  38 ++++
> >>>>include/uapi/linux/fpga-dfl.h |  27 +++
> >>>>6 files changed, 720 insertions(+), 2 deletions(-)
> >>>>create mode 100644 drivers/fpga/dfl-fme-pr.c
> >>>>create mode 100644 drivers/fpga/dfl-fme-pr.h
> >>>>create mode 100644 drivers/fpga/dfl-fme.h
> >>>>
> >>>>diff --git a/drivers/fpga/Makefile b/drivers/fpga/Makefile
> >>>>index fbd1c85..3c44fc9 100644
> >>>>--- a/drivers/fpga/Makefile
> >>>>+++ b/drivers/fpga/Makefile
> >>>>@@ -32,7 +32,7 @@ obj-$(CONFIG_OF_FPGA_REGION)          += of-fpga-region.o
> >>>>obj-$(CONFIG_FPGA_DFL)                 += dfl.o
> >>>>obj-$(CONFIG_FPGA_DFL_FME)             += dfl-fme.o
> >>>>
> >>>>-dfl-fme-objs := dfl-fme-main.o
> >>>>+dfl-fme-objs := dfl-fme-main.o dfl-fme-pr.o
> >>>>
> >>>># Drivers for FPGAs which implement DFL
> >>>>obj-$(CONFIG_FPGA_DFL_PCI)             += dfl-pci.o
> >>>>diff --git a/drivers/fpga/dfl-fme-main.c b/drivers/fpga/dfl-fme-main.c
> >>>>index 1a9929c..967a44c 100644
> >>>>--- a/drivers/fpga/dfl-fme-main.c
> >>>>+++ b/drivers/fpga/dfl-fme-main.c
> >>>>@@ -19,6 +19,7 @@
> >>>>#include <linux/fpga-dfl.h>
> >>>>
> >>>>#include "dfl.h"
> >>>>+#include "dfl-fme.h"
> >>>>
> >>>>static ssize_t ports_num_show(struct device *dev,
> >>>>                             struct device_attribute *attr, char *buf)
> >>>>@@ -111,6 +112,10 @@ static struct feature_driver fme_feature_drvs[] = {
> >>>>               .ops = &fme_hdr_ops,
> >>>>       },
> >>>>       {
> >>>>+               .id = FME_FEATURE_ID_PR_MGMT,
> >>>>+               .ops = &pr_mgmt_ops,
> >>>>+       },
> >>>>+       {
> >>>>               .ops = NULL,
> >>>>       },
> >>>>};
> >>>>@@ -194,14 +199,49 @@ static const struct file_operations fme_fops = {
> >>>>       .unlocked_ioctl = fme_ioctl,
> >>>>};
> >>>>
> >>>>+static int fme_dev_init(struct platform_device *pdev)
> >>>>+{
> >>>>+       struct feature_platform_data *pdata = dev_get_platdata(&pdev->dev);
> >>>>+       struct fpga_fme *fme;
> >>>>+
> >>>>+       fme = devm_kzalloc(&pdev->dev, sizeof(*fme), GFP_KERNEL);
> >>>>+       if (!fme)
> >>>>+               return -ENOMEM;
> >>>>+
> >>>>+       fme->pdata = pdata;
> >>>>+
> >>>>+       mutex_lock(&pdata->lock);
> >>>>+       fpga_pdata_set_private(pdata, fme);
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+
> >>>>+       return 0;
> >>>>+}
> >>>>+
> >>>>+static void fme_dev_destroy(struct platform_device *pdev)
> >>>>+{
> >>>>+       struct feature_platform_data *pdata = dev_get_platdata(&pdev->dev);
> >>>>+       struct fpga_fme *fme;
> >>>>+
> >>>>+       mutex_lock(&pdata->lock);
> >>>>+       fme = fpga_pdata_get_private(pdata);
> >>>>+       fpga_pdata_set_private(pdata, NULL);
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+
> >>>>+       devm_kfree(&pdev->dev, fme);
> >>>
> >>>Is this needed?  This is called when the device is being destroyed anyway.
> >>>
> >>>>+}
> >>>>+
> >>>>static int fme_probe(struct platform_device *pdev)
> >>>>{
> >>>>       int ret;
> >>>>
> >>>>-       ret = fpga_dev_feature_init(pdev, fme_feature_drvs);
> >>>>+       ret = fme_dev_init(pdev);
> >>>>       if (ret)
> >>>>               goto exit;
> >>>>
> >>>>+       ret = fpga_dev_feature_init(pdev, fme_feature_drvs);
> >>>>+       if (ret)
> >>>>+               goto dev_destroy;
> >>>>+
> >>>>       ret = fpga_register_dev_ops(pdev, &fme_fops, THIS_MODULE);
> >>>>       if (ret)
> >>>>               goto feature_uinit;
> >>>>@@ -210,6 +250,8 @@ static int fme_probe(struct platform_device *pdev)
> >>>>
> >>>>feature_uinit:
> >>>>       fpga_dev_feature_uinit(pdev);
> >>>>+dev_destroy:
> >>>>+       fme_dev_destroy(pdev);
> >>>>exit:
> >>>>       return ret;
> >>>>}
> >>>>@@ -218,6 +260,7 @@ static int fme_remove(struct platform_device *pdev)
> >>>>{
> >>>>       fpga_dev_feature_uinit(pdev);
> >>>>       fpga_unregister_dev_ops(pdev);
> >>>>+       fme_dev_destroy(pdev);
> >>>>
> >>>>       return 0;
> >>>>}
> >>>>diff --git a/drivers/fpga/dfl-fme-pr.c b/drivers/fpga/dfl-fme-pr.c
> >>>>new file mode 100644
> >>>>index 0000000..526e90b
> >>>>--- /dev/null
> >>>>+++ b/drivers/fpga/dfl-fme-pr.c
> >>>>@@ -0,0 +1,497 @@
> >>>>+// SPDX-License-Identifier: GPL-2.0
> >>>>+/*
> >>>>+ * Driver for FPGA Management Engine (FME) Partial Reconfiguration
> >>>>+ *
> >>>>+ * Copyright (C) 2017 Intel Corporation, Inc.
> >>>>+ *
> >>>>+ * Authors:
> >>>>+ *   Kang Luwei <luwei.kang@xxxxxxxxx>
> >>>>+ *   Xiao Guangrong <guangrong.xiao@xxxxxxxxxxxxxxx>
> >>>>+ *   Wu Hao <hao.wu@xxxxxxxxx>
> >>>>+ *   Joseph Grecco <joe.grecco@xxxxxxxxx>
> >>>>+ *   Enno Luebbers <enno.luebbers@xxxxxxxxx>
> >>>>+ *   Tim Whisonant <tim.whisonant@xxxxxxxxx>
> >>>>+ *   Ananda Ravuri <ananda.ravuri@xxxxxxxxx>
> >>>>+ *   Christopher Rauer <christopher.rauer@xxxxxxxxx>
> >>>>+ *   Henry Mitchel <henry.mitchel@xxxxxxxxx>
> >>>>+ */
> >>>>+
> >>>>+#include <linux/types.h>
> >>>>+#include <linux/device.h>
> >>>>+#include <linux/vmalloc.h>
> >>>>+#include <linux/uaccess.h>
> >>>>+#include <linux/fpga/fpga-mgr.h>
> >>>>+#include <linux/fpga/fpga-bridge.h>
> >>>>+#include <linux/fpga/fpga-region.h>
> >>>>+#include <linux/fpga-dfl.h>
> >>>>+
> >>>>+#include "dfl.h"
> >>>>+#include "dfl-fme.h"
> >>>>+#include "dfl-fme-pr.h"
> >>>>+
> >>>>+static struct fme_region *
> >>>>+find_fme_region_by_port_id(struct fpga_fme *fme, int port_id)
> >>>>+{
> >>>>+       struct fme_region *fme_region;
> >>>>+
> >>>>+       list_for_each_entry(fme_region, &fme->region_list, node)
> >>>>+               if (fme_region->port_id == port_id)
> >>>>+                       return fme_region;
> >>>>+
> >>>>+       return NULL;
> >>>>+}
> >>>>+
> >>>>+static int fpga_fme_region_match(struct device *dev, const void *data)
> >>>>+{
> >>>>+       return dev->parent == data;
> >>>>+}
> >>>>+
> >>>>+static struct fpga_region *
> >>>>+fpga_fme_region_find(struct fpga_fme *fme, int port_id)
> >>>>+{
> >>>>+       struct fme_region *fme_region;
> >>>>+       struct fpga_region *region;
> >>>>+
> >>>>+       fme_region = find_fme_region_by_port_id(fme, port_id);
> >>>>+       if (!fme_region)
> >>>>+               return NULL;
> >>>>+
> >>>>+       region = fpga_region_class_find(NULL, &fme_region->region->dev,
> >>>>+                                       fpga_fme_region_match);
> >>>>+       if (!region)
> >>>>+               return NULL;
> >>>>+
> >>>>+       return region;
> >>>>+}
> >>>>+
> >>>>+static int fme_pr(struct platform_device *pdev, unsigned long arg)
> >>>>+{
> >>>>+       void __user *argp = (void __user *)arg;
> >>>>+       struct feature_platform_data *pdata = dev_get_platdata(&pdev->dev);
> >>>>+       struct fpga_fme *fme;
> >>>>+       struct fpga_image_info *info;
> >>>>+       struct fpga_region *region;
> >>>>+       struct fpga_fme_port_pr port_pr;
> >>>>+       unsigned long minsz;
> >>>>+       void __iomem *fme_hdr;
> >>>>+       void *buf = NULL;
> >>>>+       int ret = 0;
> >>>>+       u64 v;
> >>>>+
> >>>>+       minsz = offsetofend(struct fpga_fme_port_pr, buffer_address);
> >>>>+
> >>>>+       if (copy_from_user(&port_pr, argp, minsz))
> >>>>+               return -EFAULT;
> >>>>+
> >>>>+       if (port_pr.argsz < minsz || port_pr.flags)
> >>>>+               return -EINVAL;
> >>>>+
> >>>>+       if (!IS_ALIGNED(port_pr.buffer_size, 4))
> >>>>+               return -EINVAL;
> >>>>+
> >>>>+       /* get fme header region */
> >>>>+       fme_hdr = get_feature_ioaddr_by_id(&pdev->dev,
> >>>>+                                          FME_FEATURE_ID_HEADER);
> >>>>+
> >>>>+       /* check port id */
> >>>>+       v = readq(fme_hdr + FME_HDR_CAP);
> >>>>+       if (port_pr.port_id >= FIELD_GET(FME_CAP_NUM_PORTS, v)) {
> >>>>+               dev_dbg(&pdev->dev, "port number more than maximum\n");
> >>>>+               return -EINVAL;
> >>>>+       }
> >>>>+
> >>>>+       if (!access_ok(VERIFY_READ,
> >>>>+                      (void __user *)(unsigned long)port_pr.buffer_address,
> >>>>+                      port_pr.buffer_size))
> >>>>+               return -EFAULT;
> >>>>+
> >>>>+       buf = vmalloc(port_pr.buffer_size);
> >>>>+       if (!buf)
> >>>>+               return -ENOMEM;
> >>>>+
> >>>>+       if (copy_from_user(buf,
> >>>>+                          (void __user *)(unsigned long)port_pr.buffer_address,
> >>>>+                          port_pr.buffer_size)) {
> >>>>+               ret = -EFAULT;
> >>>>+               goto free_exit;
> >>>>+       }
> >>>>+
> >>>>+       /* prepare fpga_image_info for PR */
> >>>>+       info = fpga_image_info_alloc(&pdev->dev);
> >>>>+       if (!info) {
> >>>>+               ret = -ENOMEM;
> >>>>+               goto free_exit;
> >>>>+       }
> >>>>+
> >>>>+       info->flags |= FPGA_MGR_PARTIAL_RECONFIG;
> >>>>+
> >>>>+       mutex_lock(&pdata->lock);
> >>>>+       fme = fpga_pdata_get_private(pdata);
> >>>>+       /* fme device has been unregistered. */
> >>>>+       if (!fme) {
> >>>>+               ret = -EINVAL;
> >>>>+               goto unlock_exit;
> >>>>+       }
> >>>>+
> >>>>+       region = fpga_fme_region_find(fme, port_pr.port_id);
> >>>>+       if (!region) {
> >>>>+               ret = -EINVAL;
> >>>>+               goto unlock_exit;
> >>>>+       }
> >>>>+
> >>>>+       fpga_image_info_free(region->info);
> >>>>+
> >>>>+       info->buf = buf;
> >>>>+       info->count = port_pr.buffer_size;
> >>>>+       info->region_id = port_pr.port_id;
> >>>>+       region->info = info;
> >>>>+
> >>>>+       ret = fpga_region_program_fpga(region);
> >>>>+
> >>>>+       if (region->get_bridges)
> >>>>+               fpga_bridges_put(&region->bridge_list);
> >>>>+
> >>>>+       put_device(&region->dev);
> >>>>+unlock_exit:
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+free_exit:
> >>>>+       vfree(buf);
> >>>>+       if (copy_to_user((void __user *)arg, &port_pr, minsz))
> >>>>+               return -EFAULT;
> >>>>+
> >>>>+       return ret;
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_create_mgr - create fpga mgr platform device as child device
> >>>>+ *
> >>>>+ * @pdata: fme platform_device's pdata
> >>>>+ *
> >>>>+ * Return: mgr platform device if successful, and error code otherwise.
> >>>>+ */
> >>>>+static struct platform_device *
> >>>>+fpga_fme_create_mgr(struct feature_platform_data *pdata)
> >>>>+{
> >>>>+       struct platform_device *mgr, *fme = pdata->dev;
> >>>>+       struct feature *feature;
> >>>>+       struct resource res;
> >>>>+       struct resource *pres;
> >>>>+       int ret = -ENOMEM;
> >>>>+
> >>>>+       feature = get_feature_by_id(&pdata->dev->dev, FME_FEATURE_ID_PR_MGMT);
> >>>>+       if (!feature)
> >>>>+               return ERR_PTR(-ENODEV);
> >>>>+
> >>>>+       /*
> >>>>+        * Each FME has only one fpga-mgr, so allocate platform device using
> >>>>+        * the same FME platform device id.
> >>>>+        */
> >>>>+       mgr = platform_device_alloc(FPGA_DFL_FME_MGR, fme->id);
> >>>
> >>>At this point, the framework is assuming all FME's include the same
> >>>FPGA manager device which would use the driver in dfl-fme-mgr.c.
> >>>
> >>>I'm thinking of two cases where the manager isn't the same as a
> >>>dfl-fme-mgr.c manager are a bit different:
> >>>
> >>>(1) a FME-based FPGA manager, but different implementation, different
> >>>registers.  The constraint is that the port implementation has to be
> >>>similar enough to use the rest of the base FME code.   I am wondering
> >>>if the FPGA manager can be added to the DFL.  At this point, the DFL
> >>>would drive which FPGA manager is alloc'd.   That way the user gets to
> >>>use all this code in dfl-fme-pr.c but with their FPGA manager.
> >>
> >>I am thinking of the case of porting to a new hardware implementation
> >>for Partial Reconfiguration.  Since the new hardware is completely different
> >>at the register level, we would need new a new feature id.  The
> >>fme init code for this new feature should be able to call the generic
> >>code here and pass in the fgpa_mgr_ops that are hardware specific.
> >>
> >
> >Per my understanding, if we introduced one new private feature (with a
> >different feature id), we could consider to reuse dfl-fme-pr.c firstly,
> >e.g in the init function, it could check the feature id and take different
> >code path for handling (create different fpga mgr). And for sure, we could
> >introduce another private feature driver if existing code can't be reused
> >at all. It depends the actual hardware implementation I think. : )
> 
> It sounds to me like we are in aggreement that a lot of dfl-fme-pr.c could
> be reused by another hardware implementation.  I am currently scoping
> Partial Reconfiguration for a FPGA that is not the Arria10, and I think this
> much of dfl-fme-pr.c could be reused for that different hw.

Yes, agree. : )

> 
> >
> >>>
> >>>(2) a FPGA manager that can be added by device tree in the case of a
> >>>platform that is using device tree.  I think this will be pretty
> >>>simple and can be done later when someone is actually bringing this
> >>>framework up on a FPGA running under device tree.  I'm thinking that
> >>>the base DFL device that reads the dfl data from hardware can have a
> >>>DT property that points to the FPGA manager.  That manager can be
> >>>saved somewhere handy like the pdata and passed down to this code,
> >>>which realizes it can use that existing device and doesn't need to
> >>>alloc a platform device.  But again, that's probably best done later.
> >>>
> >>>>+       if (!mgr)
> >>>>+               return ERR_PTR(ret);
> >>>>+
> >>>>+       mgr->dev.parent = &fme->dev;
> >>>>+
> >>>>+       pres = platform_get_resource(fme, IORESOURCE_MEM,
> >>>>+                                    feature->resource_index);
> >>>>+       if (!pres) {
> >>>>+               ret = -ENODEV;
> >>>>+               goto create_mgr_err;
> >>>>+       }
> >>>>+
> >>>>+       memset(&res, 0, sizeof(struct resource));
> >>>>+
> >>>>+       res.start = pres->start;
> >>>>+       res.end = pres->end;
> >>>>+       res.name = pres->name;
> >>>>+       res.flags = IORESOURCE_MEM;
> >>>>+
> >>>>+       ret = platform_device_add_resources(mgr, &res, 1);
> >>>>+       if (ret)
> >>>>+               goto create_mgr_err;
> >>>>+
> >>>>+       ret = platform_device_add(mgr);
> >>>>+       if (ret)
> >>>>+               goto create_mgr_err;
> >>>>+
> >>>>+       return mgr;
> >>>>+
> >>>>+create_mgr_err:
> >>>>+       platform_device_put(mgr);
> >>>>+       return ERR_PTR(ret);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_destroy_mgr - destroy fpga mgr platform device
> >>>>+ * @pdata: fme platform device's pdata
> >>>>+ */
> >>>>+static void fpga_fme_destroy_mgr(struct feature_platform_data *pdata)
> >>>>+{
> >>>>+       struct fpga_fme *priv = fpga_pdata_get_private(pdata);
> >>>>+
> >>>>+       platform_device_unregister(priv->mgr);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_create_bridge - create fme fpga bridge platform device as child
> >>>>+ *
> >>>>+ * @pdata: fme platform device's pdata
> >>>>+ * @port_id: port id for the bridge to be created.
> >>>>+ *
> >>>>+ * Return: bridge platform device if successful, and error code otherwise.
> >>>>+ */
> >>>>+static struct fme_bridge *
> >>>>+fpga_fme_create_bridge(struct feature_platform_data *pdata, int port_id)
> >>>>+{
> >>>>+       struct device *dev = &pdata->dev->dev;
> >>>>+       struct fme_br_pdata br_pdata;
> >>>>+       struct fme_bridge *fme_br;
> >>>>+       int ret = -ENOMEM;
> >>>>+
> >>>>+       fme_br = devm_kzalloc(dev, sizeof(*fme_br), GFP_KERNEL);
> >>>>+       if (!fme_br)
> >>>>+               return ERR_PTR(ret);
> >>>>+
> >>>>+       br_pdata.port = fpga_cdev_find_port(fpga_pdata_to_fpga_cdev(pdata),
> >>>>+                                           &port_id, fpga_port_check_id);
> >>>>+       if (!br_pdata.port)
> >>>>+               return ERR_PTR(-ENODEV);
> >>>>+
> >>>>+       /*
> >>>>+        * Each FPGA device may have more than one port, so allocate platform
> >>>>+        * device using the same port platform device id.
> >>>>+        */
> >>>>+       fme_br->br = platform_device_alloc(FPGA_DFL_FME_BRIDGE,
> >>>>+                                          br_pdata.port->id);
> >>>>+       if (!fme_br->br) {
> >>>>+               ret = -ENOMEM;
> >>>>+               goto create_br_err;
> >>>>+       }
> >>>>+
> >>>>+       fme_br->br->dev.parent = dev;
> >>>>+
> >>>>+       ret = platform_device_add_data(fme_br->br, &br_pdata, sizeof(br_pdata));
> >>>>+       if (ret)
> >>>>+               goto create_br_err;
> >>>>+
> >>>>+       ret = platform_device_add(fme_br->br);
> >>>>+       if (ret)
> >>>>+               goto create_br_err;
> >>>>+
> >>>>+       return fme_br;
> >>>>+
> >>>>+create_br_err:
> >>>>+       platform_device_put(fme_br->br);
> >>>>+       put_device(&br_pdata.port->dev);
> >>>>+       return ERR_PTR(ret);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_destroy_bridge - destroy fpga bridge platform device
> >>>>+ * @fme_br: fme bridge to destroy
> >>>>+ */
> >>>>+static void fpga_fme_destroy_bridge(struct fme_bridge *fme_br)
> >>>>+{
> >>>>+       struct fme_br_pdata *br_pdata = dev_get_platdata(&fme_br->br->dev);
> >>>>+
> >>>>+       put_device(&br_pdata->port->dev);
> >>>>+       platform_device_unregister(fme_br->br);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_destroy_bridge - destroy all fpga bridge platform device
> >>>>+ * @pdata: fme platform device's pdata
> >>>>+ */
> >>>>+static void fpga_fme_destroy_bridges(struct feature_platform_data *pdata)
> >>>>+{
> >>>>+       struct fpga_fme *priv = fpga_pdata_get_private(pdata);
> >>>>+       struct fme_bridge *fbridge, *tmp;
> >>>>+
> >>>>+       list_for_each_entry_safe(fbridge, tmp, &priv->bridge_list, node) {
> >>>>+               list_del(&fbridge->node);
> >>>>+               fpga_fme_destroy_bridge(fbridge);
> >>>>+       }
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_create_region - create fpga region platform device as child
> >>>>+ *
> >>>>+ * @pdata: fme platform device's pdata
> >>>>+ * @mgr: mgr platform device needed for region
> >>>>+ * @br: br platform device needed for region
> >>>>+ * @port_id: port id
> >>>>+ *
> >>>>+ * Return: fme region if successful, and error code otherwise.
> >>>>+ */
> >>>>+static struct fme_region *
> >>>>+fpga_fme_create_region(struct feature_platform_data *pdata,
> >>>>+                      struct platform_device *mgr,
> >>>>+                      struct platform_device *br, int port_id)
> >>>>+{
> >>>>+       struct device *dev = &pdata->dev->dev;
> >>>>+       struct fme_region_pdata region_pdata;
> >>>>+       struct fme_region *fme_region;
> >>>>+       int ret = -ENOMEM;
> >>>>+
> >>>>+       fme_region = devm_kzalloc(dev, sizeof(*fme_region), GFP_KERNEL);
> >>>>+       if (!fme_region)
> >>>>+               return ERR_PTR(ret);
> >>>>+
> >>>>+       region_pdata.mgr = mgr;
> >>>>+       region_pdata.br = br;
> >>>>+
> >>>>+       /*
> >>>>+        * Each FPGA device may have more than one port, so allocate platform
> >>>>+        * device using the same port platform device id.
> >>>>+        */
> >>>>+       fme_region->region = platform_device_alloc(FPGA_DFL_FME_REGION, br->id);
> >>>>+       if (!fme_region->region)
> >>>>+               return ERR_PTR(ret);
> >>>>+
> >>>>+       fme_region->region->dev.parent = dev;
> >>>>+
> >>>>+       ret = platform_device_add_data(fme_region->region, &region_pdata,
> >>>>+                                      sizeof(region_pdata));
> >>>>+       if (ret)
> >>>>+               goto create_region_err;
> >>>>+
> >>>>+       ret = platform_device_add(fme_region->region);
> >>>>+       if (ret)
> >>>>+               goto create_region_err;
> >>>>+
> >>>>+       fme_region->port_id = port_id;
> >>>>+
> >>>>+       return fme_region;
> >>>>+
> >>>>+create_region_err:
> >>>>+       platform_device_put(fme_region->region);
> >>>>+       return ERR_PTR(ret);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_destroy_region - destroy fme region
> >>>>+ * @fme_region: fme region to destroy
> >>>>+ */
> >>>>+static void fpga_fme_destroy_region(struct fme_region *fme_region)
> >>>>+{
> >>>>+       platform_device_unregister(fme_region->region);
> >>>>+}
> >>>>+
> >>>>+/**
> >>>>+ * fpga_fme_destroy_regions - destroy all fme regions
> >>>>+ * @pdata: fme platform device's pdata
> >>>>+ */
> >>>>+static void fpga_fme_destroy_regions(struct feature_platform_data *pdata)
> >>>>+{
> >>>>+       struct fpga_fme *priv = fpga_pdata_get_private(pdata);
> >>>>+       struct fme_region *fme_region, *tmp;
> >>>>+
> >>>>+       list_for_each_entry_safe(fme_region, tmp, &priv->region_list, node) {
> >>>>+               list_del(&fme_region->node);
> >>>>+               fpga_fme_destroy_region(fme_region);
> >>>>+       }
> >>>>+}
> >>>>+
> >>>>+static int pr_mgmt_init(struct platform_device *pdev, struct feature *feature)
> >>>>+{
> >>>>+       struct feature_platform_data *pdata = dev_get_platdata(&pdev->dev);
> >>>>+       void __iomem *fme_hdr;
> >>>>+       struct platform_device *mgr;
> >>>>+       struct fme_region *fme_region;
> >>>>+       struct fme_bridge *fme_br;
> >>>>+       struct fpga_fme *priv;
> >>>>+       int ret = -ENODEV, i = 0;
> >>>>+       u64 fme_cap, port_offset;
> >>>>+
> >>>>+       fme_hdr = get_feature_ioaddr_by_id(&pdev->dev,
> >>>>+                                          FME_FEATURE_ID_HEADER);
> >>>>+
> >>>>+       mutex_lock(&pdata->lock);
> >>>>+       priv = fpga_pdata_get_private(pdata);
> >>>>+
> >>>>+       /* Initialize the region and bridge sub device list */
> >>>>+       INIT_LIST_HEAD(&priv->region_list);
> >>>>+       INIT_LIST_HEAD(&priv->bridge_list);
> >>>>+
> >>>>+       /* Create fpga mgr platform device */
> >>>>+       mgr = fpga_fme_create_mgr(pdata);
> >>>>+       if (IS_ERR(mgr)) {
> >>>>+               dev_err(&pdev->dev, "fail to create fpga mgr pdev\n");
> >>>>+               goto unlock;
> >>>>+       }
> >>>>+
> >>>>+       priv->mgr = mgr;
> >>>>+
> >>>>+       /* Read capability register to check number of regions and bridges */
> >>>>+       fme_cap = readq(fme_hdr + FME_HDR_CAP);
> >>
> >>I don't think this capability field exists in currently deployed FPGA images
> >>using DFH.  I believe this difference requires a new feature id
> >>to differentiate between deployed FPGA images and images with this new
> >>"feature".
> >
> >I'm not sure about the "currently deployed FPGA images using DFH", this feature
> >driver is only for FME PR private feature (Yes, FME's private feature with
> >id = 0x5). But if they use DFH, so they must have their own feature ids as that
> >field is in the DFH, isn't it? Then we should be able to distinguish them based
> >on that.
> >
> >Thanks
> >Hao
> 
> I am specifically thinking of the FPGA images associated with DCP 1.0.
> Should this driver work with those images?  It looks to me that this
> capability register is not in the DCP 1.0.

Sure, I verified this patchset on DCP 1.0, PR function works fine. This cap
register is from FME header register set for the number of implemented ports.

Thanks
Hao

> 
> >
> >>
> >>>>+       for (; i < FIELD_GET(FME_CAP_NUM_PORTS, fme_cap); i++) {
> >>>>+               port_offset = readq(fme_hdr + FME_HDR_PORT_OFST(i));
> >>>>+               if (!(port_offset & FME_PORT_OFST_IMP))
> >>>>+                       continue;
> >>>>+
> >>>>+               /* Create bridge for each port */
> >>>>+               fme_br = fpga_fme_create_bridge(pdata, i);
> >>>>+               if (IS_ERR(fme_br)) {
> >>>>+                       ret = PTR_ERR(fme_br);
> >>>>+                       goto destroy_region;
> >>>>+               }
> >>>>+
> >>>>+               list_add(&fme_br->node, &priv->bridge_list);
> >>>>+
> >>>>+               /* Create region for each port */
> >>>>+               fme_region = fpga_fme_create_region(pdata, mgr, fme_br->br, i);
> >>>>+               if (!fme_region) {
> >>>>+                       ret = PTR_ERR(fme_region);
> >>>>+                       goto destroy_region;
> >>>>+               }
> >>>>+
> >>>>+               list_add(&fme_region->node, &priv->region_list);
> >>>>+       }
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+
> >>>>+       return 0;
> >>>>+
> >>>>+destroy_region:
> >>>>+       fpga_fme_destroy_regions(pdata);
> >>>>+       fpga_fme_destroy_bridges(pdata);
> >>>>+       fpga_fme_destroy_mgr(pdata);
> >>>>+unlock:
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+       return ret;
> >>>>+}
> >>>>+
> >>>>+static void pr_mgmt_uinit(struct platform_device *pdev, struct feature *feature)
> >>>>+{
> >>>>+       struct feature_platform_data *pdata = dev_get_platdata(&pdev->dev);
> >>>>+       struct fpga_fme *priv;
> >>>>+
> >>>>+       mutex_lock(&pdata->lock);
> >>>>+       priv = fpga_pdata_get_private(pdata);
> >>>>+
> >>>>+       fpga_fme_destroy_regions(pdata);
> >>>>+       fpga_fme_destroy_bridges(pdata);
> >>>>+       fpga_fme_destroy_mgr(pdata);
> >>>>+       mutex_unlock(&pdata->lock);
> >>>>+}
> >>>>+
> >>>>+static long fme_pr_ioctl(struct platform_device *pdev, struct feature *feature,
> >>>>+                        unsigned int cmd, unsigned long arg)
> >>>>+{
> >>>>+       long ret;
> >>>>+
> >>>>+       switch (cmd) {
> >>>>+       case FPGA_FME_PORT_PR:
> >>>>+               ret = fme_pr(pdev, arg);
> >>>>+               break;
> >>>>+       default:
> >>>>+               ret = -ENODEV;
> >>>>+       }
> >>>>+
> >>>>+       return ret;
> >>>>+}
> >>>>+
> >>>>+const struct feature_ops pr_mgmt_ops = {
> >>>>+       .init = pr_mgmt_init,
> >>>>+       .uinit = pr_mgmt_uinit,
> >>>>+       .ioctl = fme_pr_ioctl,
> >>>>+};
> >>>>diff --git a/drivers/fpga/dfl-fme-pr.h b/drivers/fpga/dfl-fme-pr.h
> >>>>new file mode 100644
> >>>>index 0000000..11bd001
> >>>>--- /dev/null
> >>>>+++ b/drivers/fpga/dfl-fme-pr.h
> >>>>@@ -0,0 +1,113 @@
> >>>>+/* SPDX-License-Identifier: GPL-2.0 */
> >>>>+/*
> >>>>+ * Header file for FPGA Management Engine (FME) Partial Reconfiguration Driver
> >>>>+ *
> >>>>+ * Copyright (C) 2017 Intel Corporation, Inc.
> >>>>+ *
> >>>>+ * Authors:
> >>>>+ *   Kang Luwei <luwei.kang@xxxxxxxxx>
> >>>>+ *   Xiao Guangrong <guangrong.xiao@xxxxxxxxxxxxxxx>
> >>>>+ *   Wu Hao <hao.wu@xxxxxxxxx>
> >>>>+ *   Joseph Grecco <joe.grecco@xxxxxxxxx>
> >>>>+ *   Enno Luebbers <enno.luebbers@xxxxxxxxx>
> >>>>+ *   Tim Whisonant <tim.whisonant@xxxxxxxxx>
> >>>>+ *   Ananda Ravuri <ananda.ravuri@xxxxxxxxx>
> >>>>+ *   Henry Mitchel <henry.mitchel@xxxxxxxxx>
> >>>>+ */
> >>>>+
> >>>>+#ifndef __DFL_FME_PR_H
> >>>>+#define __DFL_FME_PR_H
> >>>>+
> >>>>+#include <linux/platform_device.h>
> >>>>+
> >>>>+/**
> >>>>+ * struct fme_region - FME fpga region data structure
> >>>>+ *
> >>>>+ * @region: platform device of the FPGA region.
> >>>>+ * @node: used to link fme_region to a list.
> >>>>+ * @port_id: indicate which port this region connected to.
> >>>>+ */
> >>>>+struct fme_region {
> >>>>+       struct platform_device *region;
> >>>>+       struct list_head node;
> >>>>+       int port_id;
> >>>>+};
> >>>>+
> >>>>+/**
> >>>>+ * struct fme_region_pdata - platform data for FME region platform device.
> >>>>+ *
> >>>>+ * @mgr: platform device of the FPGA manager.
> >>>>+ * @br: platform device of the FPGA bridge.
> >>>>+ * @region_id: region id (same as port_id).
> >>>>+ */
> >>>>+struct fme_region_pdata {
> >>>>+       struct platform_device *mgr;
> >>>>+       struct platform_device *br;
> >>>>+       int region_id;
> >>>>+};
> >>>>+
> >>>>+/**
> >>>>+ * struct fme_bridge - FME fpga bridge data structure
> >>>>+ *
> >>>>+ * @br: platform device of the FPGA bridge.
> >>>>+ * @node: used to link fme_bridge to a list.
> >>>>+ */
> >>>>+struct fme_bridge {
> >>>>+       struct platform_device *br;
> >>>>+       struct list_head node;
> >>>>+};
> >>>>+
> >>>>+/**
> >>>>+ * struct fme_bridge_pdata - platform data for FME bridge platform device.
> >>>>+ *
> >>>>+ * @port: platform device of the port feature dev.
> >>>>+ */
> >>>>+struct fme_br_pdata {
> >>>>+       struct platform_device *port;
> >>>>+};
> >>>>+
> >>>>+#define FPGA_DFL_FME_MGR       "dfl-fme-mgr"
> >>>>+#define FPGA_DFL_FME_BRIDGE    "dfl-fme-bridge"
> >>>>+#define FPGA_DFL_FME_REGION    "dfl-fme-region"
> >>>>+
> >>>
> >>>Everything in dfl-fme-pr.h up to this point is good and general and
> >>>should remain in dfl-fme-pr.h.  The register #defines for this FME's
> >>>FPGA manager device below should be associated with the FPGA manager
> >>>driver.  Sorry if the way I stated that in the v3 review wasn't clear.
> >>>
> >>>>+/* FME Partial Reconfiguration Sub Feature Register Set */
> >>>>+#define FME_PR_DFH             0x0
> >>>>+#define FME_PR_CTRL            0x8
> >>>>+#define FME_PR_STS             0x10
> >>>>+#define FME_PR_DATA            0x18
> >>>>+#define FME_PR_ERR             0x20
> >>>>+#define FME_PR_INTFC_ID_H      0xA8
> >>>>+#define FME_PR_INTFC_ID_L      0xB0
> >>>>+
> >>>>+/* FME PR Control Register Bitfield */
> >>>>+#define FME_PR_CTRL_PR_RST     BIT(0)  /* Reset PR engine */
> >>>>+#define FME_PR_CTRL_PR_RSTACK  BIT(4)  /* Ack for PR engine reset */
> >>>>+#define FME_PR_CTRL_PR_RGN_ID  GENMASK_ULL(9, 7)       /* PR Region ID */
> >>>>+#define FME_PR_CTRL_PR_START   BIT(12) /* Start to request for PR service */
> >>>>+#define FME_PR_CTRL_PR_COMPLETE        BIT(13) /* PR data push complete notification */
> >>>>+
> >>>>+/* FME PR Status Register Bitfield */
> >>>>+/* Number of available entries in HW queue inside the PR engine. */
> >>>>+#define FME_PR_STS_PR_CREDIT   GENMASK_ULL(8, 0)
> >>>>+#define FME_PR_STS_PR_STS      BIT(16) /* PR operation status */
> >>>>+#define FME_PR_STS_PR_STS_IDLE 0
> >>>>+#define FME_PR_STS_PR_CTRLR_STS        GENMASK_ULL(22, 20)     /* Controller status */
> >>>>+#define FME_PR_STS_PR_HOST_STS GENMASK_ULL(27, 24)     /* PR host status */
> >>>>+
> >>>>+/* FME PR Data Register Bitfield */
> >>>>+/* PR data from the raw-binary file. */
> >>>>+#define FME_PR_DATA_PR_DATA_RAW        GENMASK_ULL(32, 0)
> >>>>+
> >>>>+/* FME PR Error Register */
> >>>>+/* PR Operation errors detected. */
> >>>>+#define FME_PR_ERR_OPERATION_ERR       BIT(0)
> >>>>+/* CRC error detected. */
> >>>>+#define FME_PR_ERR_CRC_ERR             BIT(1)
> >>>>+/* Incompatible PR bitstream detected. */
> >>>>+#define FME_PR_ERR_INCOMPATIBLE_BS     BIT(2)
> >>>>+/* PR data push protocol violated. */
> >>>>+#define FME_PR_ERR_PROTOCOL_ERR                BIT(3)
> >>>>+/* PR data fifo overflow error detected */
> >>>>+#define FME_PR_ERR_FIFO_OVERFLOW       BIT(4)
> >>>
> >>>This stuff is specific to this FPGA manager device, so it should
> >>>either be in the dfl-fme-mgr.c or in a dfl-fme-mgr.h
> >>>
> >>>>+
> >>>>+#endif /* __DFL_FME_PR_H */
> >>>>diff --git a/drivers/fpga/dfl-fme.h b/drivers/fpga/dfl-fme.h
> >>>>new file mode 100644
> >>>>index 0000000..c8bd48a
> >>>>--- /dev/null
> >>>>+++ b/drivers/fpga/dfl-fme.h
> >>>>@@ -0,0 +1,38 @@
> >>>>+/* SPDX-License-Identifier: GPL-2.0 */
> >>>>+/*
> >>>>+ * Header file for FPGA Management Engine (FME) Driver
> >>>>+ *
> >>>>+ * Copyright (C) 2017 Intel Corporation, Inc.
> >>>>+ *
> >>>>+ * Authors:
> >>>>+ *   Kang Luwei <luwei.kang@xxxxxxxxx>
> >>>>+ *   Xiao Guangrong <guangrong.xiao@xxxxxxxxxxxxxxx>
> >>>>+ *   Wu Hao <hao.wu@xxxxxxxxx>
> >>>>+ *   Joseph Grecco <joe.grecco@xxxxxxxxx>
> >>>>+ *   Enno Luebbers <enno.luebbers@xxxxxxxxx>
> >>>>+ *   Tim Whisonant <tim.whisonant@xxxxxxxxx>
> >>>>+ *   Ananda Ravuri <ananda.ravuri@xxxxxxxxx>
> >>>>+ *   Henry Mitchel <henry.mitchel@xxxxxxxxx>
> >>>>+ */
> >>>>+
> >>>>+#ifndef __DFL_FME_H
> >>>>+#define __DFL_FME_H
> >>>>+
> >>>>+/**
> >>>>+ * struct fpga_fme - fpga fme private data
> >>>>+ *
> >>>>+ * @mgr: FME's FPGA manager platform device.
> >>>>+ * @region_list: link list of FME's FPGA regions.
> >>>>+ * @bridge_list: link list of FME's FPGA bridges.
> >>>>+ * @pdata: fme platform device's pdata.
> >>>>+ */
> >>>>+struct fpga_fme {
> >>>>+       struct platform_device *mgr;
> >>>>+       struct list_head region_list;
> >>>>+       struct list_head bridge_list;
> >>>>+       struct feature_platform_data *pdata;
> >>>>+};
> >>>>+
> >>>>+extern const struct feature_ops pr_mgmt_ops;
> >>>>+
> >>>>+#endif /* __DFL_FME_H */
> >>>>diff --git a/include/uapi/linux/fpga-dfl.h b/include/uapi/linux/fpga-dfl.h
> >>>>index 9321ee9..50ee831 100644
> >>>>--- a/include/uapi/linux/fpga-dfl.h
> >>>>+++ b/include/uapi/linux/fpga-dfl.h
> >>>>@@ -14,6 +14,8 @@
> >>>>#ifndef _UAPI_LINUX_FPGA_DFL_H
> >>>>#define _UAPI_LINUX_FPGA_DFL_H
> >>>>
> >>>>+#include <linux/types.h>
> >>>>+
> >>>>#define FPGA_API_VERSION 0
> >>>>
> >>>>/*
> >>>>@@ -26,6 +28,7 @@
> >>>>#define FPGA_MAGIC 0xB6
> >>>>
> >>>>#define FPGA_BASE 0
> >>>>+#define FME_BASE 0x80
> >>>>
> >>>>/**
> >>>> * FPGA_GET_API_VERSION - _IO(FPGA_MAGIC, FPGA_BASE + 0)
> >>>>@@ -45,4 +48,28 @@
> >>>>
> >>>>#define FPGA_CHECK_EXTENSION   _IO(FPGA_MAGIC, FPGA_BASE + 1)
> >>>>
> >>>>+/* IOCTLs for FME file descriptor */
> >>>>+
> >>>>+/**
> >>>>+ * FPGA_FME_PORT_PR - _IOW(FPGA_MAGIC, FME_BASE + 0, struct fpga_fme_port_pr)
> >>>>+ *
> >>>>+ * Driver does Partial Reconfiguration based on Port ID and Buffer (Image)
> >>>>+ * provided by caller.
> >>>>+ * Return: 0 on success, -errno on failure.
> >>>>+ * If FPGA_FME_PORT_PR returns -EIO, that indicates the HW has detected
> >>>>+ * some errors during PR, under this case, the user can fetch HW error info
> >>>>+ * from the status of FME's fpga manager.
> >>>>+ */
> >>>>+
> >>>>+struct fpga_fme_port_pr {
> >>>>+       /* Input */
> >>>>+       __u32 argsz;            /* Structure length */
> >>>>+       __u32 flags;            /* Zero for now */
> >>>>+       __u32 port_id;
> >>>>+       __u32 buffer_size;
> >>>>+       __u64 buffer_address;   /* Userspace address to the buffer for PR */
> >>>>+};
> >>>>+
> >>>>+#define FPGA_FME_PORT_PR       _IO(FPGA_MAGIC, FME_BASE + 0)
> >>>>+
> >>>>#endif /* _UAPI_LINUX_FPGA_DFL_H */
> >>>>--
> >>>>2.7.4
> >>>>
> >>>
> >>>Thanks,
> >>>Alan
> >>>--
> >>>To unsubscribe from this list: send the line "unsubscribe linux-fpga" in
> >>>the body of a message to majordomo@xxxxxxxxxxxxxxx
> >>>More majordomo info at  http://vger.kernel.org/majordomo-info.html
> >>>
> >
> --
> To unsubscribe from this list: send the line "unsubscribe linux-fpga" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe linux-api" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux