Re: [PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-05 Thread Kunihiko Hayashi
Hi Bjorn,

Thank you for reviewing.

On Wed, 5 Sep 2018 12:21:18 -0500  wrote:

> 
> Please follow the capitalization convention, i.e.,
> 
>   $ git log --oneline --no-merges Documentaon/devicetree/bindings/pci/ | grep 
> -i pci
>   82dfbd27c837 dt-bindings: PCI: cadence: Add DT bindings for optional PHYs
>   92f9ccca4c08 PCI: mobiveil: Add Mobiveil PCIe Host Bridge IP driver DT 
> bindings
>   71918e24cb49 dt-bindings: PCI: designware: Add support for EP in DesignWare 
> driver
>   467c7a737642 dt-bindings: PCI: designware: Example update
>   1dca7a636933 dt-bindings: PCI: rockchip: Add DT bindings for Rockchip PCIe 
> EP driver
>   2ca25bd7472f dt-bindings: PCI: rockchip: Rename rockchip-pcie.txt to 
> rockchip-pcie-host.txt
> 
> On Wed, Sep 05, 2018 at 11:32:10AM +0900, Kunihiko Hayashi wrote:
> > Add DT bindings for PCIe controller implemented in UniPhier SoCs when
> > configured in Root Complex (host) mode. This controller is based on
> > the Designware PCIe Core.
> 
> s/Designware/DesignWare/
> s/Core/core/

Okay, I'll fix capitalization conventions in all the descriptions
according to the previous commits.

> > 
> > Signed-off-by: Kunihiko Hayashi 
> > ---
> >  .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 
> > ++
> >  1 file changed, 78 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > 
> > diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
> > b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > new file mode 100644
> > index 000..ea63f78
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > @@ -0,0 +1,78 @@
> > +Socionext UniPhier PCI-express host controller bindings
> 
> s/PCI-express/PCIe/ (also in other occurrences below)
>
> > +
> > +This describes the devicetree bindings for PCI-express host controller
> > +implemented on Socionext UniPhier SoCs.
> > +
> > +UniPhier PCI-express host controller is based on the Synopsys DesignWare
> > +PCI core. It shares common functions with the PCIe DesignWare core driver
> > +and inherits common properties defined in
> > +Documentation/devicetree/bindings/pci/designware-pcie.txt.

Indeed, there are descriptions of inconsistency. I'll fix them.

Thank you,

---
Best Regards,
Kunihiko Hayashi




Re: [PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-05 Thread Kunihiko Hayashi
Hi Bjorn,

Thank you for reviewing.

On Wed, 5 Sep 2018 12:21:18 -0500  wrote:

> 
> Please follow the capitalization convention, i.e.,
> 
>   $ git log --oneline --no-merges Documentaon/devicetree/bindings/pci/ | grep 
> -i pci
>   82dfbd27c837 dt-bindings: PCI: cadence: Add DT bindings for optional PHYs
>   92f9ccca4c08 PCI: mobiveil: Add Mobiveil PCIe Host Bridge IP driver DT 
> bindings
>   71918e24cb49 dt-bindings: PCI: designware: Add support for EP in DesignWare 
> driver
>   467c7a737642 dt-bindings: PCI: designware: Example update
>   1dca7a636933 dt-bindings: PCI: rockchip: Add DT bindings for Rockchip PCIe 
> EP driver
>   2ca25bd7472f dt-bindings: PCI: rockchip: Rename rockchip-pcie.txt to 
> rockchip-pcie-host.txt
> 
> On Wed, Sep 05, 2018 at 11:32:10AM +0900, Kunihiko Hayashi wrote:
> > Add DT bindings for PCIe controller implemented in UniPhier SoCs when
> > configured in Root Complex (host) mode. This controller is based on
> > the Designware PCIe Core.
> 
> s/Designware/DesignWare/
> s/Core/core/

Okay, I'll fix capitalization conventions in all the descriptions
according to the previous commits.

> > 
> > Signed-off-by: Kunihiko Hayashi 
> > ---
> >  .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 
> > ++
> >  1 file changed, 78 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > 
> > diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
> > b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > new file mode 100644
> > index 000..ea63f78
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> > @@ -0,0 +1,78 @@
> > +Socionext UniPhier PCI-express host controller bindings
> 
> s/PCI-express/PCIe/ (also in other occurrences below)
>
> > +
> > +This describes the devicetree bindings for PCI-express host controller
> > +implemented on Socionext UniPhier SoCs.
> > +
> > +UniPhier PCI-express host controller is based on the Synopsys DesignWare
> > +PCI core. It shares common functions with the PCIe DesignWare core driver
> > +and inherits common properties defined in
> > +Documentation/devicetree/bindings/pci/designware-pcie.txt.

Indeed, there are descriptions of inconsistency. I'll fix them.

Thank you,

---
Best Regards,
Kunihiko Hayashi




Re: [PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-05 Thread Bjorn Helgaas


Please follow the capitalization convention, i.e.,

  $ git log --oneline --no-merges Documentaon/devicetree/bindings/pci/ | grep 
-i pci
  82dfbd27c837 dt-bindings: PCI: cadence: Add DT bindings for optional PHYs
  92f9ccca4c08 PCI: mobiveil: Add Mobiveil PCIe Host Bridge IP driver DT 
bindings
  71918e24cb49 dt-bindings: PCI: designware: Add support for EP in DesignWare 
driver
  467c7a737642 dt-bindings: PCI: designware: Example update
  1dca7a636933 dt-bindings: PCI: rockchip: Add DT bindings for Rockchip PCIe EP 
driver
  2ca25bd7472f dt-bindings: PCI: rockchip: Rename rockchip-pcie.txt to 
rockchip-pcie-host.txt

On Wed, Sep 05, 2018 at 11:32:10AM +0900, Kunihiko Hayashi wrote:
> Add DT bindings for PCIe controller implemented in UniPhier SoCs when
> configured in Root Complex (host) mode. This controller is based on
> the Designware PCIe Core.

s/Designware/DesignWare/
s/Core/core/

> 
> Signed-off-by: Kunihiko Hayashi 
> ---
>  .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 
> ++
>  1 file changed, 78 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> 
> diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
> b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> new file mode 100644
> index 000..ea63f78
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> @@ -0,0 +1,78 @@
> +Socionext UniPhier PCI-express host controller bindings

s/PCI-express/PCIe/ (also in other occurrences below)

> +
> +This describes the devicetree bindings for PCI-express host controller
> +implemented on Socionext UniPhier SoCs.
> +
> +UniPhier PCI-express host controller is based on the Synopsys DesignWare
> +PCI core. It shares common functions with the PCIe DesignWare core driver
> +and inherits common properties defined in
> +Documentation/devicetree/bindings/pci/designware-pcie.txt.


Re: [PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-05 Thread Bjorn Helgaas


Please follow the capitalization convention, i.e.,

  $ git log --oneline --no-merges Documentaon/devicetree/bindings/pci/ | grep 
-i pci
  82dfbd27c837 dt-bindings: PCI: cadence: Add DT bindings for optional PHYs
  92f9ccca4c08 PCI: mobiveil: Add Mobiveil PCIe Host Bridge IP driver DT 
bindings
  71918e24cb49 dt-bindings: PCI: designware: Add support for EP in DesignWare 
driver
  467c7a737642 dt-bindings: PCI: designware: Example update
  1dca7a636933 dt-bindings: PCI: rockchip: Add DT bindings for Rockchip PCIe EP 
driver
  2ca25bd7472f dt-bindings: PCI: rockchip: Rename rockchip-pcie.txt to 
rockchip-pcie-host.txt

On Wed, Sep 05, 2018 at 11:32:10AM +0900, Kunihiko Hayashi wrote:
> Add DT bindings for PCIe controller implemented in UniPhier SoCs when
> configured in Root Complex (host) mode. This controller is based on
> the Designware PCIe Core.

s/Designware/DesignWare/
s/Core/core/

> 
> Signed-off-by: Kunihiko Hayashi 
> ---
>  .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 
> ++
>  1 file changed, 78 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> 
> diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
> b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> new file mode 100644
> index 000..ea63f78
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
> @@ -0,0 +1,78 @@
> +Socionext UniPhier PCI-express host controller bindings

s/PCI-express/PCIe/ (also in other occurrences below)

> +
> +This describes the devicetree bindings for PCI-express host controller
> +implemented on Socionext UniPhier SoCs.
> +
> +UniPhier PCI-express host controller is based on the Synopsys DesignWare
> +PCI core. It shares common functions with the PCIe DesignWare core driver
> +and inherits common properties defined in
> +Documentation/devicetree/bindings/pci/designware-pcie.txt.


[PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-04 Thread Kunihiko Hayashi
Add DT bindings for PCIe controller implemented in UniPhier SoCs when
configured in Root Complex (host) mode. This controller is based on
the Designware PCIe Core.

Signed-off-by: Kunihiko Hayashi 
---
 .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 ++
 1 file changed, 78 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt

diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
new file mode 100644
index 000..ea63f78
--- /dev/null
+++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
@@ -0,0 +1,78 @@
+Socionext UniPhier PCI-express host controller bindings
+
+This describes the devicetree bindings for PCI-express host controller
+implemented on Socionext UniPhier SoCs.
+
+UniPhier PCI-express host controller is based on the Synopsys DesignWare
+PCI core. It shares common functions with the PCIe DesignWare core driver
+and inherits common properties defined in
+Documentation/devicetree/bindings/pci/designware-pcie.txt.
+
+Required properties:
+- compatible: Should be "socionext,uniphier-pcie".
+- reg: Specifies offset and length of the register set for the device.
+   According to the reg-names, appropriate register sets are required.
+- reg-names: Must include the following entries:
+"dbi"- controller configuration registers
+"link"   - SoC-specific glue layer registers
+"config" - PCIe configuration space
+- clocks: A phandle to the clock gate for PCIe glue layer including
+   the host controller.
+- resets: A phandle to the reset line for PCIe glue layer including
+   the host controller.
+- interrupts: A list of interrupt specifiers. According to the
+   interrupt-names, appropriate interrupts are required.
+- interrupt-names: Must include the following entries:
+"dma"- DMA interrupt
+"msi"- MSI interrupt
+"intx"   - Legacy INTA/B/C/D interrupt
+
+Optional properties:
+- phys: A phandle to generic PCIe PHY. According to the phy-names, appropriate
+   phys are required.
+- phy-names: Must be "pcie-phy".
+
+Required sub-node:
+- interrupt-controller: Specifies interrupt controller for legacy PCI
+   interrupts. The node name isn't important.
+
+Required properties for interrupt-controller:
+- interrupt-controller: identifies the node as an interrupt controller.
+- #interrupt-cells: specifies the number of cells needed to encode an
+   interrupt source. The value must be 1.
+
+Example:
+
+   pcie: pcie@6600 {
+   compatible = "socionext,uniphier-pcie", "snps,dw-pcie";
+   status = "disabled";
+   reg-names = "dbi", "link", "config";
+   reg = <0x6600 0x1000>, <0x6601 0x1>,
+ <0x2fff 0x1>;
+   #address-cells = <3>;
+   #size-cells = <2>;
+   clocks = <_clk 24>;
+   resets = <_rst 24>;
+   num-lanes = <1>;
+   num-viewport = <1>;
+   bus-range = <0x0 0xff>;
+   device_type = "pci";
+   ranges =
+   /* downstream I/O */
+   <0x8100 0 0x  0x2ffe  0 0x0001
+   /* non-prefetchable memory */
+0x8200 0 0x  0x2000  0 0x0ffe>;
+   #interrupt-cells = <1>;
+   interrupt-names = "dma", "msi", "intx";
+   interrupts = <0 224 4>, <0 225 4>, <0 226 4>;
+   interrupt-map-mask = <0 0 0  7>;
+   interrupt-map = <0 0 0  1  _intc 0>,   /* INTA */
+   <0 0 0  2  _intc 1>,   /* INTB */
+   <0 0 0  3  _intc 2>,   /* INTC */
+   <0 0 0  4  _intc 3>;   /* INTD */
+
+   pcie_intc: interrupt-controller {
+   interrupt-controller;
+   #interrupt-cells = <1>;
+   };
+   };
-- 
2.7.4



[PATCH 1/2] dt-bindings: pci: add UniPhier PCIe host controller description

2018-09-04 Thread Kunihiko Hayashi
Add DT bindings for PCIe controller implemented in UniPhier SoCs when
configured in Root Complex (host) mode. This controller is based on
the Designware PCIe Core.

Signed-off-by: Kunihiko Hayashi 
---
 .../devicetree/bindings/pci/uniphier-pcie.txt  | 78 ++
 1 file changed, 78 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/pci/uniphier-pcie.txt

diff --git a/Documentation/devicetree/bindings/pci/uniphier-pcie.txt 
b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
new file mode 100644
index 000..ea63f78
--- /dev/null
+++ b/Documentation/devicetree/bindings/pci/uniphier-pcie.txt
@@ -0,0 +1,78 @@
+Socionext UniPhier PCI-express host controller bindings
+
+This describes the devicetree bindings for PCI-express host controller
+implemented on Socionext UniPhier SoCs.
+
+UniPhier PCI-express host controller is based on the Synopsys DesignWare
+PCI core. It shares common functions with the PCIe DesignWare core driver
+and inherits common properties defined in
+Documentation/devicetree/bindings/pci/designware-pcie.txt.
+
+Required properties:
+- compatible: Should be "socionext,uniphier-pcie".
+- reg: Specifies offset and length of the register set for the device.
+   According to the reg-names, appropriate register sets are required.
+- reg-names: Must include the following entries:
+"dbi"- controller configuration registers
+"link"   - SoC-specific glue layer registers
+"config" - PCIe configuration space
+- clocks: A phandle to the clock gate for PCIe glue layer including
+   the host controller.
+- resets: A phandle to the reset line for PCIe glue layer including
+   the host controller.
+- interrupts: A list of interrupt specifiers. According to the
+   interrupt-names, appropriate interrupts are required.
+- interrupt-names: Must include the following entries:
+"dma"- DMA interrupt
+"msi"- MSI interrupt
+"intx"   - Legacy INTA/B/C/D interrupt
+
+Optional properties:
+- phys: A phandle to generic PCIe PHY. According to the phy-names, appropriate
+   phys are required.
+- phy-names: Must be "pcie-phy".
+
+Required sub-node:
+- interrupt-controller: Specifies interrupt controller for legacy PCI
+   interrupts. The node name isn't important.
+
+Required properties for interrupt-controller:
+- interrupt-controller: identifies the node as an interrupt controller.
+- #interrupt-cells: specifies the number of cells needed to encode an
+   interrupt source. The value must be 1.
+
+Example:
+
+   pcie: pcie@6600 {
+   compatible = "socionext,uniphier-pcie", "snps,dw-pcie";
+   status = "disabled";
+   reg-names = "dbi", "link", "config";
+   reg = <0x6600 0x1000>, <0x6601 0x1>,
+ <0x2fff 0x1>;
+   #address-cells = <3>;
+   #size-cells = <2>;
+   clocks = <_clk 24>;
+   resets = <_rst 24>;
+   num-lanes = <1>;
+   num-viewport = <1>;
+   bus-range = <0x0 0xff>;
+   device_type = "pci";
+   ranges =
+   /* downstream I/O */
+   <0x8100 0 0x  0x2ffe  0 0x0001
+   /* non-prefetchable memory */
+0x8200 0 0x  0x2000  0 0x0ffe>;
+   #interrupt-cells = <1>;
+   interrupt-names = "dma", "msi", "intx";
+   interrupts = <0 224 4>, <0 225 4>, <0 226 4>;
+   interrupt-map-mask = <0 0 0  7>;
+   interrupt-map = <0 0 0  1  _intc 0>,   /* INTA */
+   <0 0 0  2  _intc 1>,   /* INTB */
+   <0 0 0  3  _intc 2>,   /* INTC */
+   <0 0 0  4  _intc 3>;   /* INTD */
+
+   pcie_intc: interrupt-controller {
+   interrupt-controller;
+   #interrupt-cells = <1>;
+   };
+   };
-- 
2.7.4