All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH 0/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
@ 2020-10-28  2:05 Yoshihiro Shimoda
  2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
                   ` (2 more replies)
  0 siblings, 3 replies; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-28  2:05 UTC (permalink / raw)
  To: bhelgaas, marek.vasut+renesas, robh+dt
  Cc: prabhakar.mahadev-lad.rj, linux-pci, devicetree,
	linux-renesas-soc, Yoshihiro Shimoda

Convert bindings of rcar-pci.txt to json-schema. And, I realized
r8a77965 [1] and r8a774e1 [2] are not documented on rcar-pci.txt.
So, I made incremental patches to document them.

[1]
https://patchwork.kernel.org/project/linux-renesas-soc/patch/1528373494-18503-2-git-send-email-ykaneko0929@gmail.com/

This patch was old, so I didn't reuse this patch.

[2]
https://patchwork.kernel.org/project/linux-renesas-soc/patch/20200927124257.29612-1-prabhakar.mahadev-lad.rj@bp.renesas.com/

I reused this patch.


Lad Prabhakar (1):
  dt-bindings: pci: rcar-pci: Add device tree support for r8a774e1

Yoshihiro Shimoda (2):
  dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  dt-bindings: pci: rcar-pci-host: document r8a77965 bindings

 .../devicetree/bindings/pci/rcar-pci-host.yaml     | 148 +++++++++++++++++++++
 Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
 2 files changed, 148 insertions(+), 72 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
 delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt

-- 
2.7.4


^ permalink raw reply	[flat|nested] 9+ messages in thread

* [PATCH 1/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  2020-10-28  2:05 [PATCH 0/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema Yoshihiro Shimoda
@ 2020-10-28  2:05 ` Yoshihiro Shimoda
  2020-10-28 14:44   ` Rob Herring
  2020-10-28 14:48   ` Rob Herring
  2020-10-28  2:05 ` [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings Yoshihiro Shimoda
  2020-10-28  2:05 ` [PATCH 3/3] dt-bindings: pci: rcar-pci: Add device tree support for r8a774e1 Yoshihiro Shimoda
  2 siblings, 2 replies; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-28  2:05 UTC (permalink / raw)
  To: bhelgaas, marek.vasut+renesas, robh+dt
  Cc: prabhakar.mahadev-lad.rj, linux-pci, devicetree,
	linux-renesas-soc, Yoshihiro Shimoda

Convert Renesas PCIe Host controller bindings documentation to
json-schema. Note that some compatible doesn't contain on
the original documantation so that incremental patches are required
for it.

Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
---
 .../devicetree/bindings/pci/rcar-pci-host.yaml     | 146 +++++++++++++++++++++
 Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
 2 files changed, 146 insertions(+), 72 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
 delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt

diff --git a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
new file mode 100644
index 0000000..d286454
--- /dev/null
+++ b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
@@ -0,0 +1,146 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+# Copyright (C) 2020 Renesas Electronics Corp.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pci/rcar-pci-host.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Renesas R-Car PCIe Host
+
+maintainers:
+  - Marek Vasut <marek.vasut+renesas@gmail.com>
+  - Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
+
+properties:
+  compatible:
+    oneOf:
+      - items:
+        - enum:
+            - renesas,pcie-r8a7742      # RZ/G1H
+            - renesas,pcie-r8a7743      # RZ/G1M
+            - renesas,pcie-r8a7744      # RZ/G1N
+            - renesas,pcie-r8a7790      # R-Car H2
+            - renesas,pcie-r8a7791      # R-Car M2-W
+            - renesas,pcie-r8a7793      # R-Car M2-N
+        - const: renesas,pcie-rcar-gen2 # R-Car Gen2 and RZ/G1
+      - items:
+        - enum:
+            - renesas,pcie-r8a774a1     # RZ/G2M
+            - renesas,pcie-r8a774b1     # RZ/G2N
+            - renesas,pcie-r8a774c0     # RZ/G2E
+            - renesas,pcie-r8a7795      # R-Car H3
+            - renesas,pcie-r8a7796      # R-Car M3-W
+            - renesas,pcie-r8a77961     # R-Car M3-W+
+            - renesas,pcie-r8a77980     # R-Car V3H
+            - renesas,pcie-r8a77990     # R-Car E3
+        - const: renesas,pcie-rcar-gen3 # R-Car Gen3 and RZ/G2
+
+  reg:
+    maxItems: 1
+
+  '#address-cells':
+    const: 3
+
+  '#size-cells':
+    const: 2
+
+  bus-range: true
+
+  device_type:
+    const: pci
+
+  ranges:
+    minItems: 4
+    maxItems: 4
+
+  dma-ranges:
+    minItems: 1
+    maxItems: 2
+
+  interrupts:
+    minItems: 3
+    maxItems: 3
+
+  '#interrupt-cells':
+    const: 1
+
+  interrupt-map-mask: true
+
+  interrupt-map: true
+
+  clocks:
+    maxItems: 2
+
+  clock-names:
+    items:
+      - const: pcie
+      - const: pcie_bus
+
+  power-domains:
+    maxItems: 1
+
+  resets:
+    maxItems: 1
+
+  phys:
+    maxItems: 1
+
+  phy-names:
+    const: pcie
+
+required:
+  - compatible
+  - reg
+  - '#address-cells'
+  - '#size-cells'
+  - bus-range
+  - device_type
+  - ranges
+  - dma-ranges
+  - interrupts
+  - '#interrupt-cells'
+  - interrupt-map-mask
+  - interrupt-map
+  - clocks
+  - clock-names
+  - power-domains
+  - resets
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/r8a7791-cpg-mssr.h>
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/power/r8a7791-sysc.h>
+
+    soc {
+        #address-cells = <2>;
+        #size-cells = <2>;
+
+        pcie: pcie@fe000000 {
+            compatible = "renesas,pcie-r8a7791", "renesas,pcie-rcar-gen2";
+            reg = <0 0xfe000000 0 0x80000>;
+             #address-cells = <3>;
+             #size-cells = <2>;
+             bus-range = <0x00 0xff>;
+             device_type = "pci";
+             ranges = <0x01000000 0 0x00000000 0 0xfe100000 0 0x00100000>,
+                      <0x02000000 0 0xfe200000 0 0xfe200000 0 0x00200000>,
+                      <0x02000000 0 0x30000000 0 0x30000000 0 0x08000000>,
+                      <0x42000000 0 0x38000000 0 0x38000000 0 0x08000000>;
+             dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 0 0x40000000>,
+                          <0x42000000 2 0x00000000 2 0x00000000 0 0x40000000>;
+             interrupts = <GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>,
+                          <GIC_SPI 117 IRQ_TYPE_LEVEL_HIGH>,
+                          <GIC_SPI 118 IRQ_TYPE_LEVEL_HIGH>;
+             #interrupt-cells = <1>;
+             interrupt-map-mask = <0 0 0 0>;
+             interrupt-map = <0 0 0 0 &gic GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>;
+             clocks = <&cpg CPG_MOD 319>, <&pcie_bus_clk>;
+             clock-names = "pcie", "pcie_bus";
+             power-domains = <&sysc R8A7791_PD_ALWAYS_ON>;
+             resets = <&cpg 319>;
+             status = "disabled";
+         };
+    };
diff --git a/Documentation/devicetree/bindings/pci/rcar-pci.txt b/Documentation/devicetree/bindings/pci/rcar-pci.txt
deleted file mode 100644
index 14d307d..0000000
--- a/Documentation/devicetree/bindings/pci/rcar-pci.txt
+++ /dev/null
@@ -1,72 +0,0 @@
-* Renesas R-Car PCIe interface
-
-Required properties:
-compatible: "renesas,pcie-r8a7742" for the R8A7742 SoC;
-	    "renesas,pcie-r8a7743" for the R8A7743 SoC;
-	    "renesas,pcie-r8a7744" for the R8A7744 SoC;
-	    "renesas,pcie-r8a774a1" for the R8A774A1 SoC;
-	    "renesas,pcie-r8a774b1" for the R8A774B1 SoC;
-	    "renesas,pcie-r8a774c0" for the R8A774C0 SoC;
-	    "renesas,pcie-r8a7779" for the R8A7779 SoC;
-	    "renesas,pcie-r8a7790" for the R8A7790 SoC;
-	    "renesas,pcie-r8a7791" for the R8A7791 SoC;
-	    "renesas,pcie-r8a7793" for the R8A7793 SoC;
-	    "renesas,pcie-r8a7795" for the R8A7795 SoC;
-	    "renesas,pcie-r8a7796" for the R8A77960 SoC;
-	    "renesas,pcie-r8a77961" for the R8A77961 SoC;
-	    "renesas,pcie-r8a77980" for the R8A77980 SoC;
-	    "renesas,pcie-r8a77990" for the R8A77990 SoC;
-	    "renesas,pcie-rcar-gen2" for a generic R-Car Gen2 or
-				     RZ/G1 compatible device.
-	    "renesas,pcie-rcar-gen3" for a generic R-Car Gen3 or
-				     RZ/G2 compatible device.
-
-	    When compatible with the generic version, nodes must list the
-	    SoC-specific version corresponding to the platform first
-	    followed by the generic version.
-
-- reg: base address and length of the PCIe controller registers.
-- #address-cells: set to <3>
-- #size-cells: set to <2>
-- bus-range: PCI bus numbers covered
-- device_type: set to "pci"
-- ranges: ranges for the PCI memory and I/O regions.
-- dma-ranges: ranges for the inbound memory regions.
-- interrupts: two interrupt sources for MSI interrupts, followed by interrupt
-	source for hardware related interrupts (e.g. link speed change).
-- #interrupt-cells: set to <1>
-- interrupt-map-mask and interrupt-map: standard PCI properties
-	to define the mapping of the PCIe interface to interrupt numbers.
-- clocks: from common clock binding: clock specifiers for the PCIe controller
-	and PCIe bus clocks.
-- clock-names: from common clock binding: should be "pcie" and "pcie_bus".
-
-Optional properties:
-- phys: from common PHY binding: PHY phandle and specifier (only make sense
-	for R-Car gen3 SoCs where the PCIe PHYs have their own register blocks).
-- phy-names: from common PHY binding: should be "pcie".
-
-Example:
-
-SoC-specific DT Entry:
-
-	pcie: pcie@fe000000 {
-		compatible = "renesas,pcie-r8a7791", "renesas,pcie-rcar-gen2";
-		reg = <0 0xfe000000 0 0x80000>;
-		#address-cells = <3>;
-		#size-cells = <2>;
-		bus-range = <0x00 0xff>;
-		device_type = "pci";
-		ranges = <0x01000000 0 0x00000000 0 0xfe100000 0 0x00100000
-			  0x02000000 0 0xfe200000 0 0xfe200000 0 0x00200000
-			  0x02000000 0 0x30000000 0 0x30000000 0 0x08000000
-			  0x42000000 0 0x38000000 0 0x38000000 0 0x08000000>;
-		dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 0 0x40000000
-			      0x42000000 2 0x00000000 2 0x00000000 0 0x40000000>;
-		interrupts = <0 116 4>, <0 117 4>, <0 118 4>;
-		#interrupt-cells = <1>;
-		interrupt-map-mask = <0 0 0 0>;
-		interrupt-map = <0 0 0 0 &gic 0 116 4>;
-		clocks = <&mstp3_clks R8A7791_CLK_PCIE>, <&pcie_bus_clk>;
-		clock-names = "pcie", "pcie_bus";
-	};
-- 
2.7.4


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings
  2020-10-28  2:05 [PATCH 0/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema Yoshihiro Shimoda
  2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
@ 2020-10-28  2:05 ` Yoshihiro Shimoda
  2020-10-29 13:48   ` Geert Uytterhoeven
  2020-10-28  2:05 ` [PATCH 3/3] dt-bindings: pci: rcar-pci: Add device tree support for r8a774e1 Yoshihiro Shimoda
  2 siblings, 1 reply; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-28  2:05 UTC (permalink / raw)
  To: bhelgaas, marek.vasut+renesas, robh+dt
  Cc: prabhakar.mahadev-lad.rj, linux-pci, devicetree,
	linux-renesas-soc, Yoshihiro Shimoda

Document the R-Car M3-N (R8A77965) SoC in the R-Car PCIe bindings.

Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
---
 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
index d286454..1c6a03b 100644
--- a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
+++ b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
@@ -31,6 +31,7 @@ properties:
             - renesas,pcie-r8a7795      # R-Car H3
             - renesas,pcie-r8a7796      # R-Car M3-W
             - renesas,pcie-r8a77961     # R-Car M3-W+
+            - renesas,pcie-r8a77965     # R-Car M3-N
             - renesas,pcie-r8a77980     # R-Car V3H
             - renesas,pcie-r8a77990     # R-Car E3
         - const: renesas,pcie-rcar-gen3 # R-Car Gen3 and RZ/G2
-- 
2.7.4


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* [PATCH 3/3] dt-bindings: pci: rcar-pci: Add device tree support for r8a774e1
  2020-10-28  2:05 [PATCH 0/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema Yoshihiro Shimoda
  2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
  2020-10-28  2:05 ` [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings Yoshihiro Shimoda
@ 2020-10-28  2:05 ` Yoshihiro Shimoda
  2 siblings, 0 replies; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-28  2:05 UTC (permalink / raw)
  To: bhelgaas, marek.vasut+renesas, robh+dt
  Cc: prabhakar.mahadev-lad.rj, linux-pci, devicetree,
	linux-renesas-soc, Yoshihiro Shimoda

From: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

Add PCIe support for the RZ/G2H (a.k.a. R8A774E1).

Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
Reviewed-by: Marian-Cristian Rotariu <marian-cristian.rotariu.rb@bp.renesas.com>
Acked-by: Rob Herring <robh@kernel.org>
Reviewed-by: Wolfram Sang <wsa+renesas@sang-engineering.com>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
---
 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
index 1c6a03b..48dfec9 100644
--- a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
+++ b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
@@ -28,6 +28,7 @@ properties:
             - renesas,pcie-r8a774a1     # RZ/G2M
             - renesas,pcie-r8a774b1     # RZ/G2N
             - renesas,pcie-r8a774c0     # RZ/G2E
+            - renesas,pcie-r8a774e1     # RZ/G2H
             - renesas,pcie-r8a7795      # R-Car H3
             - renesas,pcie-r8a7796      # R-Car M3-W
             - renesas,pcie-r8a77961     # R-Car M3-W+
-- 
2.7.4


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* Re: [PATCH 1/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
@ 2020-10-28 14:44   ` Rob Herring
  2020-10-30  4:46     ` Yoshihiro Shimoda
  2020-10-28 14:48   ` Rob Herring
  1 sibling, 1 reply; 9+ messages in thread
From: Rob Herring @ 2020-10-28 14:44 UTC (permalink / raw)
  To: Yoshihiro Shimoda
  Cc: prabhakar.mahadev-lad.rj, marek.vasut+renesas, linux-renesas-soc,
	linux-pci, bhelgaas, robh+dt, devicetree

On Wed, 28 Oct 2020 11:05:49 +0900, Yoshihiro Shimoda wrote:
> Convert Renesas PCIe Host controller bindings documentation to
> json-schema. Note that some compatible doesn't contain on
> the original documantation so that incremental patches are required
> for it.
> 
> Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
> ---
>  .../devicetree/bindings/pci/rcar-pci-host.yaml     | 146 +++++++++++++++++++++
>  Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
>  2 files changed, 146 insertions(+), 72 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
>  delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt
> 


My bot found errors running 'make dt_binding_check' on your patch:

yamllint warnings/errors:
./Documentation/devicetree/bindings/pci/rcar-pci-host.yaml:18:9: [warning] wrong indentation: expected 10 but found 8 (indentation)
./Documentation/devicetree/bindings/pci/rcar-pci-host.yaml:27:9: [warning] wrong indentation: expected 10 but found 8 (indentation)

dtschema/dtc warnings/errors:


See https://patchwork.ozlabs.org/patch/1389094

The base for the patch is generally the last rc1. Any dependencies
should be noted.

If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:

pip3 install dtschema --upgrade

Please check and re-submit.


^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH 1/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
  2020-10-28 14:44   ` Rob Herring
@ 2020-10-28 14:48   ` Rob Herring
  2020-10-30  5:04     ` Yoshihiro Shimoda
  1 sibling, 1 reply; 9+ messages in thread
From: Rob Herring @ 2020-10-28 14:48 UTC (permalink / raw)
  To: Yoshihiro Shimoda
  Cc: bhelgaas, marek.vasut+renesas, prabhakar.mahadev-lad.rj,
	linux-pci, devicetree, linux-renesas-soc

On Wed, Oct 28, 2020 at 11:05:49AM +0900, Yoshihiro Shimoda wrote:
> Convert Renesas PCIe Host controller bindings documentation to
> json-schema. Note that some compatible doesn't contain on
> the original documantation so that incremental patches are required
> for it.
> 
> Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
> ---
>  .../devicetree/bindings/pci/rcar-pci-host.yaml     | 146 +++++++++++++++++++++
>  Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
>  2 files changed, 146 insertions(+), 72 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
>  delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt
> 
> diff --git a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> new file mode 100644
> index 0000000..d286454
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> @@ -0,0 +1,146 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +# Copyright (C) 2020 Renesas Electronics Corp.
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/pci/rcar-pci-host.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Renesas R-Car PCIe Host
> +
> +maintainers:
> +  - Marek Vasut <marek.vasut+renesas@gmail.com>
> +  - Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>

allOf:
  - $ref: pci-bus.yaml#

> +
> +properties:
> +  compatible:
> +    oneOf:
> +      - items:
> +        - enum:
> +            - renesas,pcie-r8a7742      # RZ/G1H
> +            - renesas,pcie-r8a7743      # RZ/G1M
> +            - renesas,pcie-r8a7744      # RZ/G1N
> +            - renesas,pcie-r8a7790      # R-Car H2
> +            - renesas,pcie-r8a7791      # R-Car M2-W
> +            - renesas,pcie-r8a7793      # R-Car M2-N
> +        - const: renesas,pcie-rcar-gen2 # R-Car Gen2 and RZ/G1
> +      - items:
> +        - enum:
> +            - renesas,pcie-r8a774a1     # RZ/G2M
> +            - renesas,pcie-r8a774b1     # RZ/G2N
> +            - renesas,pcie-r8a774c0     # RZ/G2E
> +            - renesas,pcie-r8a7795      # R-Car H3
> +            - renesas,pcie-r8a7796      # R-Car M3-W
> +            - renesas,pcie-r8a77961     # R-Car M3-W+
> +            - renesas,pcie-r8a77980     # R-Car V3H
> +            - renesas,pcie-r8a77990     # R-Car E3
> +        - const: renesas,pcie-rcar-gen3 # R-Car Gen3 and RZ/G2
> +
> +  reg:
> +    maxItems: 1
> +

> +  '#address-cells':
> +    const: 3
> +
> +  '#size-cells':
> +    const: 2

No need to define these here as pci-bus.yaml does.

> +
> +  bus-range: true
> +
> +  device_type:
> +    const: pci

Same here.

> +
> +  ranges:
> +    minItems: 4
> +    maxItems: 4
> +
> +  dma-ranges:
> +    minItems: 1
> +    maxItems: 2
> +
> +  interrupts:
> +    minItems: 3
> +    maxItems: 3
> +
> +  '#interrupt-cells':
> +    const: 1

And this.

> +
> +  interrupt-map-mask: true
> +
> +  interrupt-map: true
> +
> +  clocks:
> +    maxItems: 2
> +
> +  clock-names:
> +    items:
> +      - const: pcie
> +      - const: pcie_bus
> +
> +  power-domains:
> +    maxItems: 1
> +
> +  resets:
> +    maxItems: 1
> +
> +  phys:
> +    maxItems: 1
> +
> +  phy-names:
> +    const: pcie
> +
> +required:
> +  - compatible
> +  - reg

> +  - '#address-cells'
> +  - '#size-cells'

Already required by pci-bus.yaml

> +  - bus-range

This generally shouldn't be required if 0-255 is supported.

> +  - device_type
> +  - ranges

Both already required by pci-bus.yaml

> +  - dma-ranges
> +  - interrupts

> +  - '#interrupt-cells'
> +  - interrupt-map-mask
> +  - interrupt-map

And these.

> +  - clocks
> +  - clock-names
> +  - power-domains
> +  - resets
> +
> +additionalProperties: false

Use unevaluatedProperties instead.

> +
> +examples:
> +  - |
> +    #include <dt-bindings/clock/r8a7791-cpg-mssr.h>
> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
> +    #include <dt-bindings/power/r8a7791-sysc.h>
> +
> +    soc {
> +        #address-cells = <2>;
> +        #size-cells = <2>;
> +
> +        pcie: pcie@fe000000 {
> +            compatible = "renesas,pcie-r8a7791", "renesas,pcie-rcar-gen2";
> +            reg = <0 0xfe000000 0 0x80000>;
> +             #address-cells = <3>;
> +             #size-cells = <2>;
> +             bus-range = <0x00 0xff>;
> +             device_type = "pci";
> +             ranges = <0x01000000 0 0x00000000 0 0xfe100000 0 0x00100000>,
> +                      <0x02000000 0 0xfe200000 0 0xfe200000 0 0x00200000>,
> +                      <0x02000000 0 0x30000000 0 0x30000000 0 0x08000000>,
> +                      <0x42000000 0 0x38000000 0 0x38000000 0 0x08000000>;
> +             dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 0 0x40000000>,
> +                          <0x42000000 2 0x00000000 2 0x00000000 0 0x40000000>;
> +             interrupts = <GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>,
> +                          <GIC_SPI 117 IRQ_TYPE_LEVEL_HIGH>,
> +                          <GIC_SPI 118 IRQ_TYPE_LEVEL_HIGH>;
> +             #interrupt-cells = <1>;
> +             interrupt-map-mask = <0 0 0 0>;
> +             interrupt-map = <0 0 0 0 &gic GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>;
> +             clocks = <&cpg CPG_MOD 319>, <&pcie_bus_clk>;
> +             clock-names = "pcie", "pcie_bus";
> +             power-domains = <&sysc R8A7791_PD_ALWAYS_ON>;
> +             resets = <&cpg 319>;
> +             status = "disabled";

Don't show status in examples.

> +         };
> +    };
> diff --git a/Documentation/devicetree/bindings/pci/rcar-pci.txt b/Documentation/devicetree/bindings/pci/rcar-pci.txt
> deleted file mode 100644
> index 14d307d..0000000
> --- a/Documentation/devicetree/bindings/pci/rcar-pci.txt
> +++ /dev/null
> @@ -1,72 +0,0 @@
> -* Renesas R-Car PCIe interface
> -
> -Required properties:
> -compatible: "renesas,pcie-r8a7742" for the R8A7742 SoC;
> -	    "renesas,pcie-r8a7743" for the R8A7743 SoC;
> -	    "renesas,pcie-r8a7744" for the R8A7744 SoC;
> -	    "renesas,pcie-r8a774a1" for the R8A774A1 SoC;
> -	    "renesas,pcie-r8a774b1" for the R8A774B1 SoC;
> -	    "renesas,pcie-r8a774c0" for the R8A774C0 SoC;
> -	    "renesas,pcie-r8a7779" for the R8A7779 SoC;
> -	    "renesas,pcie-r8a7790" for the R8A7790 SoC;
> -	    "renesas,pcie-r8a7791" for the R8A7791 SoC;
> -	    "renesas,pcie-r8a7793" for the R8A7793 SoC;
> -	    "renesas,pcie-r8a7795" for the R8A7795 SoC;
> -	    "renesas,pcie-r8a7796" for the R8A77960 SoC;
> -	    "renesas,pcie-r8a77961" for the R8A77961 SoC;
> -	    "renesas,pcie-r8a77980" for the R8A77980 SoC;
> -	    "renesas,pcie-r8a77990" for the R8A77990 SoC;
> -	    "renesas,pcie-rcar-gen2" for a generic R-Car Gen2 or
> -				     RZ/G1 compatible device.
> -	    "renesas,pcie-rcar-gen3" for a generic R-Car Gen3 or
> -				     RZ/G2 compatible device.
> -
> -	    When compatible with the generic version, nodes must list the
> -	    SoC-specific version corresponding to the platform first
> -	    followed by the generic version.
> -
> -- reg: base address and length of the PCIe controller registers.
> -- #address-cells: set to <3>
> -- #size-cells: set to <2>
> -- bus-range: PCI bus numbers covered
> -- device_type: set to "pci"
> -- ranges: ranges for the PCI memory and I/O regions.
> -- dma-ranges: ranges for the inbound memory regions.
> -- interrupts: two interrupt sources for MSI interrupts, followed by interrupt
> -	source for hardware related interrupts (e.g. link speed change).
> -- #interrupt-cells: set to <1>
> -- interrupt-map-mask and interrupt-map: standard PCI properties
> -	to define the mapping of the PCIe interface to interrupt numbers.
> -- clocks: from common clock binding: clock specifiers for the PCIe controller
> -	and PCIe bus clocks.
> -- clock-names: from common clock binding: should be "pcie" and "pcie_bus".
> -
> -Optional properties:
> -- phys: from common PHY binding: PHY phandle and specifier (only make sense
> -	for R-Car gen3 SoCs where the PCIe PHYs have their own register blocks).
> -- phy-names: from common PHY binding: should be "pcie".
> -
> -Example:
> -
> -SoC-specific DT Entry:
> -
> -	pcie: pcie@fe000000 {
> -		compatible = "renesas,pcie-r8a7791", "renesas,pcie-rcar-gen2";
> -		reg = <0 0xfe000000 0 0x80000>;
> -		#address-cells = <3>;
> -		#size-cells = <2>;
> -		bus-range = <0x00 0xff>;
> -		device_type = "pci";
> -		ranges = <0x01000000 0 0x00000000 0 0xfe100000 0 0x00100000
> -			  0x02000000 0 0xfe200000 0 0xfe200000 0 0x00200000
> -			  0x02000000 0 0x30000000 0 0x30000000 0 0x08000000
> -			  0x42000000 0 0x38000000 0 0x38000000 0 0x08000000>;
> -		dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 0 0x40000000
> -			      0x42000000 2 0x00000000 2 0x00000000 0 0x40000000>;
> -		interrupts = <0 116 4>, <0 117 4>, <0 118 4>;
> -		#interrupt-cells = <1>;
> -		interrupt-map-mask = <0 0 0 0>;
> -		interrupt-map = <0 0 0 0 &gic 0 116 4>;
> -		clocks = <&mstp3_clks R8A7791_CLK_PCIE>, <&pcie_bus_clk>;
> -		clock-names = "pcie", "pcie_bus";
> -	};
> -- 
> 2.7.4
> 

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings
  2020-10-28  2:05 ` [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings Yoshihiro Shimoda
@ 2020-10-29 13:48   ` Geert Uytterhoeven
  0 siblings, 0 replies; 9+ messages in thread
From: Geert Uytterhoeven @ 2020-10-29 13:48 UTC (permalink / raw)
  To: Yoshihiro Shimoda
  Cc: Bjorn Helgaas, Marek Vasut, Rob Herring, Lad, Prabhakar,
	linux-pci,
	open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS,
	Linux-Renesas

On Wed, Oct 28, 2020 at 10:41 PM Yoshihiro Shimoda
<yoshihiro.shimoda.uh@renesas.com> wrote:
> Document the R-Car M3-N (R8A77965) SoC in the R-Car PCIe bindings.
>
> Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>

Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

Gr{oetje,eeting}s,

                        Geert

-- 
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
                                -- Linus Torvalds

^ permalink raw reply	[flat|nested] 9+ messages in thread

* RE: [PATCH 1/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  2020-10-28 14:44   ` Rob Herring
@ 2020-10-30  4:46     ` Yoshihiro Shimoda
  0 siblings, 0 replies; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-30  4:46 UTC (permalink / raw)
  To: Rob Herring
  Cc: Prabhakar Mahadev Lad, marek.vasut+renesas, linux-renesas-soc,
	linux-pci, bhelgaas, robh+dt, devicetree

Hi Rob,

> From: Rob Herring, Sent: Wednesday, October 28, 2020 11:45 PM
> 
> On Wed, 28 Oct 2020 11:05:49 +0900, Yoshihiro Shimoda wrote:
> > Convert Renesas PCIe Host controller bindings documentation to
> > json-schema. Note that some compatible doesn't contain on
> > the original documantation so that incremental patches are required
> > for it.
> >
> > Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
> > ---
> >  .../devicetree/bindings/pci/rcar-pci-host.yaml     | 146 +++++++++++++++++++++
> >  Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
> >  2 files changed, 146 insertions(+), 72 deletions(-)
> >  create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt
> >
> 
> 
> My bot found errors running 'make dt_binding_check' on your patch:
> 
> yamllint warnings/errors:
> ./Documentation/devicetree/bindings/pci/rcar-pci-host.yaml:18:9: [warning] wrong indentation: expected 10 but found 8
> (indentation)
> ./Documentation/devicetree/bindings/pci/rcar-pci-host.yaml:27:9: [warning] wrong indentation: expected 10 but found 8
> (indentation)
> 
> dtschema/dtc warnings/errors:
> 
> 
> See
> https://patchwork.ozlabs.org/project/devicetree-bindings/patch/1603850751-32762-2-git-send-email-yoshihiro.shimoda.uh@renesas.com/
> 
> The base for the patch is generally the last rc1. Any dependencies
> should be noted.
> 
> If you already ran 'make dt_binding_check' and didn't see the above
> error(s), then make sure 'yamllint' is installed and dt-schema is up to
> date:
> 
> pip3 install dtschema --upgrade
> 
> Please check and re-submit.

Thank you for the information. I already ran 'make dt_binding_check',
but didn't install yamllint so I didn't see the errors.
I'll fix it.

Best regards,
Yoshihiro Shimoda


^ permalink raw reply	[flat|nested] 9+ messages in thread

* RE: [PATCH 1/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema
  2020-10-28 14:48   ` Rob Herring
@ 2020-10-30  5:04     ` Yoshihiro Shimoda
  0 siblings, 0 replies; 9+ messages in thread
From: Yoshihiro Shimoda @ 2020-10-30  5:04 UTC (permalink / raw)
  To: Rob Herring
  Cc: bhelgaas, marek.vasut+renesas, Prabhakar Mahadev Lad, linux-pci,
	devicetree, linux-renesas-soc

Hi Rob,

Thank you for your review!

> From: Rob Herring, Sent: Wednesday, October 28, 2020 11:49 PM
> 
> On Wed, Oct 28, 2020 at 11:05:49AM +0900, Yoshihiro Shimoda wrote:
> > Convert Renesas PCIe Host controller bindings documentation to
> > json-schema. Note that some compatible doesn't contain on
> > the original documantation so that incremental patches are required
> > for it.
> >
> > Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
> > ---
> >  .../devicetree/bindings/pci/rcar-pci-host.yaml     | 146 +++++++++++++++++++++
> >  Documentation/devicetree/bindings/pci/rcar-pci.txt |  72 ----------
> >  2 files changed, 146 insertions(+), 72 deletions(-)
> >  create mode 100644 Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/pci/rcar-pci.txt
> >
> > diff --git a/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> > new file mode 100644
> > index 0000000..d286454
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/pci/rcar-pci-host.yaml
> > @@ -0,0 +1,146 @@
<snip>
> > +maintainers:
> > +  - Marek Vasut <marek.vasut+renesas@gmail.com>
> > +  - Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
> 
> allOf:
>   - $ref: pci-bus.yaml#

I got it.

<snip>
> > +  '#address-cells':
> > +    const: 3
> > +
> > +  '#size-cells':
> > +    const: 2
> 
> No need to define these here as pci-bus.yaml does.

I'll remove these.

> > +
> > +  bus-range: true
> > +
> > +  device_type:
> > +    const: pci
> 
> Same here.

I got it.

> > +
> > +  ranges:
> > +    minItems: 4
> > +    maxItems: 4
> > +
> > +  dma-ranges:
> > +    minItems: 1
> > +    maxItems: 2
> > +
> > +  interrupts:
> > +    minItems: 3
> > +    maxItems: 3
> > +
> > +  '#interrupt-cells':
> > +    const: 1
> 
> And this.

I got it. I'll remove it.

> > +
> > +  interrupt-map-mask: true
> > +
> > +  interrupt-map: true
> > +
> > +  clocks:
> > +    maxItems: 2
> > +
> > +  clock-names:
> > +    items:
> > +      - const: pcie
> > +      - const: pcie_bus
> > +
> > +  power-domains:
> > +    maxItems: 1
> > +
> > +  resets:
> > +    maxItems: 1
> > +
> > +  phys:
> > +    maxItems: 1
> > +
> > +  phy-names:
> > +    const: pcie
> > +
> > +required:
> > +  - compatible
> > +  - reg
> 
> > +  - '#address-cells'
> > +  - '#size-cells'
> 
> Already required by pci-bus.yaml

I'll remove it.

> > +  - bus-range
> 
> This generally shouldn't be required if 0-255 is supported.

I got it.

> > +  - device_type
> > +  - ranges
> 
> Both already required by pci-bus.yaml

I'll remove it.

> > +  - dma-ranges
> > +  - interrupts
> 
> > +  - '#interrupt-cells'
> > +  - interrupt-map-mask
> > +  - interrupt-map
> 
> And these.

I got it.

> > +  - clocks
> > +  - clock-names
> > +  - power-domains
> > +  - resets
> > +
> > +additionalProperties: false
> 
> Use unevaluatedProperties instead.

I'll fix it.

> > +
> > +examples:
> > +  - |
> > +    #include <dt-bindings/clock/r8a7791-cpg-mssr.h>
> > +    #include <dt-bindings/interrupt-controller/arm-gic.h>
> > +    #include <dt-bindings/power/r8a7791-sysc.h>
> > +
> > +    soc {
> > +        #address-cells = <2>;
> > +        #size-cells = <2>;
> > +
> > +        pcie: pcie@fe000000 {
> > +            compatible = "renesas,pcie-r8a7791", "renesas,pcie-rcar-gen2";
> > +            reg = <0 0xfe000000 0 0x80000>;
> > +             #address-cells = <3>;
> > +             #size-cells = <2>;
> > +             bus-range = <0x00 0xff>;
> > +             device_type = "pci";
> > +             ranges = <0x01000000 0 0x00000000 0 0xfe100000 0 0x00100000>,
> > +                      <0x02000000 0 0xfe200000 0 0xfe200000 0 0x00200000>,
> > +                      <0x02000000 0 0x30000000 0 0x30000000 0 0x08000000>,
> > +                      <0x42000000 0 0x38000000 0 0x38000000 0 0x08000000>;
> > +             dma-ranges = <0x42000000 0 0x40000000 0 0x40000000 0 0x40000000>,
> > +                          <0x42000000 2 0x00000000 2 0x00000000 0 0x40000000>;
> > +             interrupts = <GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>,
> > +                          <GIC_SPI 117 IRQ_TYPE_LEVEL_HIGH>,
> > +                          <GIC_SPI 118 IRQ_TYPE_LEVEL_HIGH>;
> > +             #interrupt-cells = <1>;
> > +             interrupt-map-mask = <0 0 0 0>;
> > +             interrupt-map = <0 0 0 0 &gic GIC_SPI 116 IRQ_TYPE_LEVEL_HIGH>;
> > +             clocks = <&cpg CPG_MOD 319>, <&pcie_bus_clk>;
> > +             clock-names = "pcie", "pcie_bus";
> > +             power-domains = <&sysc R8A7791_PD_ALWAYS_ON>;
> > +             resets = <&cpg 319>;
> > +             status = "disabled";
> 
> Don't show status in examples.

Oops. I'll remove it.

Best regards,
Yoshihiro Shimoda


^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2020-10-30  5:05 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-10-28  2:05 [PATCH 0/3] dt-bindings: pci: rcar-pci-host: convert bindings to json-schema Yoshihiro Shimoda
2020-10-28  2:05 ` [PATCH 1/3] " Yoshihiro Shimoda
2020-10-28 14:44   ` Rob Herring
2020-10-30  4:46     ` Yoshihiro Shimoda
2020-10-28 14:48   ` Rob Herring
2020-10-30  5:04     ` Yoshihiro Shimoda
2020-10-28  2:05 ` [PATCH 2/3] dt-bindings: pci: rcar-pci-host: document r8a77965 bindings Yoshihiro Shimoda
2020-10-29 13:48   ` Geert Uytterhoeven
2020-10-28  2:05 ` [PATCH 3/3] dt-bindings: pci: rcar-pci: Add device tree support for r8a774e1 Yoshihiro Shimoda

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.