| Message ID | 1462362857-27481-1-git-send-email-niklass@axis.com (mailing list archive) |
|---|---|
| State | New, archived |
| Delegated to: | Bjorn Helgaas |
| Headers | show |
On Wed, May 04, 2016 at 01:54:17PM +0200, Niklas Cassel wrote: > From: Niklas Cassel <niklas.cassel@axis.com> > > This commit adds the Device Tree binding documentation that allows to > describe the PCIe controller found in the Axis ARTPEC-6 SoC. > > Signed-off-by: Niklas Cassel <niklas.cassel@axis.com> > --- > .../devicetree/bindings/pci/axis,artpec6-pcie.txt | 45 ++++++++++++++++++++++ > 1 file changed, 45 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > > diff --git a/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > new file mode 100644 > index 0000000..fdac2a2 > --- /dev/null > +++ b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > @@ -0,0 +1,45 @@ > +* Axis ARTPEC-6 PCIe interface > + > +This PCIe host controller is based on the Synopsis Designware PCIe IP > +and thus inherits all the common properties defined in designware-pcie.txt. > + > +Required properties: > +- compatible: "axis,artpec6-pcie", "snps,dw-pcie" > +- reg: base addresses and lengths of the pcie controller (DBI), > + the phy controller, and configuration address space. > +- reg-names: Must include the following entries: > + - "dbi" > + - "phy" > + - "config" > +- interrupts: A list of interrupt outputs of the controller. Must contain an > + entry for each entry in the interrupt-names property. > +- interrupt-names: Must include the following entries: > + - "msi": The interrupt that is asserted when an MSI is received > +- syscon: Should contain a link to the syscon device node. What is the syscon for? Perhaps a name that reflects the purpose. Rob -- To unsubscribe from this list: send the line "unsubscribe linux-pci" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
On Thu, May 05, 2016 at 05:03:31PM -0500, Rob Herring wrote: > On Wed, May 04, 2016 at 01:54:17PM +0200, Niklas Cassel wrote: > > From: Niklas Cassel <niklas.cassel@axis.com> > > > > This commit adds the Device Tree binding documentation that allows to > > describe the PCIe controller found in the Axis ARTPEC-6 SoC. > > > > Signed-off-by: Niklas Cassel <niklas.cassel@axis.com> > > --- > > .../devicetree/bindings/pci/axis,artpec6-pcie.txt | 45 ++++++++++++++++++++++ > > 1 file changed, 45 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > > > > diff --git a/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > > new file mode 100644 > > index 0000000..fdac2a2 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt > > @@ -0,0 +1,45 @@ > > +* Axis ARTPEC-6 PCIe interface > > + > > +This PCIe host controller is based on the Synopsis Designware PCIe IP > > +and thus inherits all the common properties defined in designware-pcie.txt. > > + > > +Required properties: > > +- compatible: "axis,artpec6-pcie", "snps,dw-pcie" > > +- reg: base addresses and lengths of the pcie controller (DBI), > > + the phy controller, and configuration address space. > > +- reg-names: Must include the following entries: > > + - "dbi" > > + - "phy" > > + - "config" > > +- interrupts: A list of interrupt outputs of the controller. Must contain an > > + entry for each entry in the interrupt-names property. > > +- interrupt-names: Must include the following entries: > > + - "msi": The interrupt that is asserted when an MSI is received > > +- syscon: Should contain a link to the syscon device node. > > What is the syscon for? Perhaps a name that reflects the purpose. It's the SoC System Controller, and holds some chip-specific registers for the Synopsys IP control, clocks and some termination variables spring to mind. It was named sysctrl earlier, although that's not very much more descriptive. > Rob /^JN - Jesper Nilsson
diff --git a/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt new file mode 100644 index 0000000..fdac2a2 --- /dev/null +++ b/Documentation/devicetree/bindings/pci/axis,artpec6-pcie.txt @@ -0,0 +1,45 @@ +* Axis ARTPEC-6 PCIe interface + +This PCIe host controller is based on the Synopsis Designware PCIe IP +and thus inherits all the common properties defined in designware-pcie.txt. + +Required properties: +- compatible: "axis,artpec6-pcie", "snps,dw-pcie" +- reg: base addresses and lengths of the pcie controller (DBI), + the phy controller, and configuration address space. +- reg-names: Must include the following entries: + - "dbi" + - "phy" + - "config" +- interrupts: A list of interrupt outputs of the controller. Must contain an + entry for each entry in the interrupt-names property. +- interrupt-names: Must include the following entries: + - "msi": The interrupt that is asserted when an MSI is received +- syscon: Should contain a link to the syscon device node. + +Example: + + pcie@f8050000 { + compatible = "axis,artpec6-pcie", "snps,dw-pcie"; + reg = <0xf8050000 0x2000 + 0xf8040000 0x1000 + 0xc0000000 0x1000>; + reg-names = "dbi", "phy", "config"; + #address-cells = <3>; + #size-cells = <2>; + device_type = "pci"; + /* downstream I/O */ + ranges = <0x81000000 0 0 0xc0001000 0 0x00010000 + /* non-prefetchable memory */ + 0x82000000 0 0xc0011000 0xc0011000 0 0x1ffef000>; + num-lanes = <2>; + interrupts = <GIC_SPI 148 IRQ_TYPE_LEVEL_HIGH>; + interrupt-names = "msi"; + #interrupt-cells = <1>; + interrupt-map-mask = <0 0 0 0x7>; + interrupt-map = <0 0 0 1 &intc GIC_SPI 144 IRQ_TYPE_LEVEL_HIGH>, + <0 0 0 2 &intc GIC_SPI 145 IRQ_TYPE_LEVEL_HIGH>, + <0 0 0 3 &intc GIC_SPI 146 IRQ_TYPE_LEVEL_HIGH>, + <0 0 0 4 &intc GIC_SPI 147 IRQ_TYPE_LEVEL_HIGH>; + syscon = <&syscon>; + };