PCI: Provide common functions for ECAM mapping
authorJayachandran C <jchandra@broadcom.com>
Tue, 10 May 2016 15:19:51 +0000 (17:19 +0200)
committerBjorn Helgaas <bhelgaas@google.com>
Wed, 11 May 2016 22:34:41 +0000 (17:34 -0500)
Add config option PCI_ECAM and file drivers/pci/ecam.c to provide generic
functions for accessing memory-mapped PCI config space.

The API is defined in drivers/pci/ecam.h and is written to replace the API
in drivers/pci/host/pci-host-common.h.  The file defines a new 'struct
pci_config_window' to hold the information related to a PCI config area and
its mapping.  This structure is expected to be used as sysdata for
controllers that have ECAM based mapping.

Helper functions are provided to setup the mapping, free the mapping and to
implement the map_bus method in 'struct pci_ops'

Signed-off-by: Jayachandran C <jchandra@broadcom.com>
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
drivers/pci/Kconfig
drivers/pci/Makefile
drivers/pci/ecam.c [new file with mode: 0644]
drivers/pci/ecam.h [new file with mode: 0644]

index 209292e067d248c7cdd140b1eb788c7551317e1d..56389be5d08b666f9a5e57da836a709421c4237b 100644 (file)
@@ -83,6 +83,9 @@ config HT_IRQ
 config PCI_ATS
        bool
 
+config PCI_ECAM
+       bool
+
 config PCI_IOV
        bool "PCI IOV support"
        depends on PCI
index 2154092ddee8dd1137905eeabcb82afcdfd8399a..1fa6925733d31bacc6118fc20f36e65c12ad3f8c 100644 (file)
@@ -55,6 +55,8 @@ obj-$(CONFIG_PCI_SYSCALL) += syscall.o
 
 obj-$(CONFIG_PCI_STUB) += pci-stub.o
 
+obj-$(CONFIG_PCI_ECAM) += ecam.o
+
 obj-$(CONFIG_XEN_PCIDEV_FRONTEND) += xen-pcifront.o
 
 obj-$(CONFIG_OF) += of.o
diff --git a/drivers/pci/ecam.c b/drivers/pci/ecam.c
new file mode 100644 (file)
index 0000000..f9832ad
--- /dev/null
@@ -0,0 +1,164 @@
+/*
+ * Copyright 2016 Broadcom
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License, version 2, as
+ * published by the Free Software Foundation (the "GPL").
+ *
+ * This program is distributed in the hope that 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 version 2 (GPLv2) for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * version 2 (GPLv2) along with this source code.
+ */
+
+#include <linux/device.h>
+#include <linux/io.h>
+#include <linux/kernel.h>
+#include <linux/module.h>
+#include <linux/pci.h>
+#include <linux/slab.h>
+
+#include "ecam.h"
+
+/*
+ * On 64-bit systems, we do a single ioremap for the whole config space
+ * since we have enough virtual address range available.  On 32-bit, we
+ * ioremap the config space for each bus individually.
+ */
+static const bool per_bus_mapping = !config_enabled(CONFIG_64BIT);
+
+/*
+ * Create a PCI config space window
+ *  - reserve mem region
+ *  - alloc struct pci_config_window with space for all mappings
+ *  - ioremap the config space
+ */
+struct pci_config_window *pci_ecam_create(struct device *dev,
+               struct resource *cfgres, struct resource *busr,
+               struct pci_ecam_ops *ops)
+{
+       struct pci_config_window *cfg;
+       unsigned int bus_range, bus_range_max, bsz;
+       struct resource *conflict;
+       int i, err;
+
+       if (busr->start > busr->end)
+               return ERR_PTR(-EINVAL);
+
+       cfg = kzalloc(sizeof(*cfg), GFP_KERNEL);
+       if (!cfg)
+               return ERR_PTR(-ENOMEM);
+
+       cfg->ops = ops;
+       cfg->busr.start = busr->start;
+       cfg->busr.end = busr->end;
+       cfg->busr.flags = IORESOURCE_BUS;
+       bus_range = resource_size(&cfg->busr);
+       bus_range_max = resource_size(cfgres) >> ops->bus_shift;
+       if (bus_range > bus_range_max) {
+               bus_range = bus_range_max;
+               cfg->busr.end = busr->start + bus_range - 1;
+               dev_warn(dev, "ECAM area %pR can only accommodate %pR (reduced from %pR desired)\n",
+                        cfgres, &cfg->busr, busr);
+       }
+       bsz = 1 << ops->bus_shift;
+
+       cfg->res.start = cfgres->start;
+       cfg->res.end = cfgres->end;
+       cfg->res.flags = IORESOURCE_MEM | IORESOURCE_BUSY;
+       cfg->res.name = "PCI ECAM";
+
+       conflict = request_resource_conflict(&iomem_resource, &cfg->res);
+       if (conflict) {
+               err = -EBUSY;
+               dev_err(dev, "can't claim ECAM area %pR: address conflict with %s %pR\n",
+                       &cfg->res, conflict->name, conflict);
+               goto err_exit;
+       }
+
+       if (per_bus_mapping) {
+               cfg->winp = kcalloc(bus_range, sizeof(*cfg->winp), GFP_KERNEL);
+               if (!cfg->winp)
+                       goto err_exit_malloc;
+               for (i = 0; i < bus_range; i++) {
+                       cfg->winp[i] = ioremap(cfgres->start + i * bsz, bsz);
+                       if (!cfg->winp[i])
+                               goto err_exit_iomap;
+               }
+       } else {
+               cfg->win = ioremap(cfgres->start, bus_range * bsz);
+               if (!cfg->win)
+                       goto err_exit_iomap;
+       }
+
+       if (ops->init) {
+               err = ops->init(dev, cfg);
+               if (err)
+                       goto err_exit;
+       }
+       dev_info(dev, "ECAM at %pR for %pR\n", &cfg->res, &cfg->busr);
+       return cfg;
+
+err_exit_iomap:
+       dev_err(dev, "ECAM ioremap failed\n");
+err_exit_malloc:
+       err = -ENOMEM;
+err_exit:
+       pci_ecam_free(cfg);
+       return ERR_PTR(err);
+}
+
+void pci_ecam_free(struct pci_config_window *cfg)
+{
+       int i;
+
+       if (per_bus_mapping) {
+               if (cfg->winp) {
+                       for (i = 0; i < resource_size(&cfg->busr); i++)
+                               if (cfg->winp[i])
+                                       iounmap(cfg->winp[i]);
+                       kfree(cfg->winp);
+               }
+       } else {
+               if (cfg->win)
+                       iounmap(cfg->win);
+       }
+       if (cfg->res.parent)
+               release_resource(&cfg->res);
+       kfree(cfg);
+}
+
+/*
+ * Function to implement the pci_ops ->map_bus method
+ */
+void __iomem *pci_ecam_map_bus(struct pci_bus *bus, unsigned int devfn,
+                              int where)
+{
+       struct pci_config_window *cfg = bus->sysdata;
+       unsigned int devfn_shift = cfg->ops->bus_shift - 8;
+       unsigned int busn = bus->number;
+       void __iomem *base;
+
+       if (busn < cfg->busr.start || busn > cfg->busr.end)
+               return NULL;
+
+       busn -= cfg->busr.start;
+       if (per_bus_mapping)
+               base = cfg->winp[busn];
+       else
+               base = cfg->win + (busn << cfg->ops->bus_shift);
+       return base + (devfn << devfn_shift) + where;
+}
+
+/* ECAM ops */
+struct pci_ecam_ops pci_generic_ecam_ops = {
+       .bus_shift      = 20,
+       .pci_ops        = {
+               .map_bus        = pci_ecam_map_bus,
+               .read           = pci_generic_config_read,
+               .write          = pci_generic_config_write,
+       }
+};
diff --git a/drivers/pci/ecam.h b/drivers/pci/ecam.h
new file mode 100644 (file)
index 0000000..9124219
--- /dev/null
@@ -0,0 +1,62 @@
+/*
+ * Copyright 2016 Broadcom
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License, version 2, as
+ * published by the Free Software Foundation (the "GPL").
+ *
+ * This program is distributed in the hope that 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 version 2 (GPLv2) for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * version 2 (GPLv2) along with this source code.
+ */
+#ifndef DRIVERS_PCI_ECAM_H
+#define DRIVERS_PCI_ECAM_H
+
+#include <linux/kernel.h>
+#include <linux/platform_device.h>
+
+/*
+ * struct to hold pci ops and bus shift of the config window
+ * for a PCI controller.
+ */
+struct pci_config_window;
+struct pci_ecam_ops {
+       unsigned int                    bus_shift;
+       struct pci_ops                  pci_ops;
+       int                             (*init)(struct device *,
+                                               struct pci_config_window *);
+};
+
+/*
+ * struct to hold the mappings of a config space window. This
+ * is expected to be used as sysdata for PCI controllers that
+ * use ECAM.
+ */
+struct pci_config_window {
+       struct resource                 res;
+       struct resource                 busr;
+       void                            *priv;
+       struct pci_ecam_ops             *ops;
+       union {
+               void __iomem            *win;   /* 64-bit single mapping */
+               void __iomem            **winp; /* 32-bit per-bus mapping */
+       };
+};
+
+/* create and free pci_config_window */
+struct pci_config_window *pci_ecam_create(struct device *dev,
+               struct resource *cfgres, struct resource *busr,
+               struct pci_ecam_ops *ops);
+void pci_ecam_free(struct pci_config_window *cfg);
+
+/* map_bus when ->sysdata is an instance of pci_config_window */
+void __iomem *pci_ecam_map_bus(struct pci_bus *bus, unsigned int devfn,
+                              int where);
+/* default ECAM ops */
+extern struct pci_ecam_ops pci_generic_ecam_ops;
+
+#endif