dt-bindings: PCI: Convert v3,v360epc-pci to DT schema

Convert the v3,v360epc-pci binding to DT schema format.

Add "clocks" which was not documented and is required. Drop "syscon"
which was documented, but is not used.

Drop the "v3,v360epc-pci" compatible by itself as this device is only
used on the Arm Integrator/AP and not likely going to be used anywhere
else at this point.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Link: https://patch.msgid.link/20250505220139.2202164-1-robh@kernel.org

diff --git a/Documentation/devicetree/bindings/pci/v3,v360epc-pci.yaml b/Documentation/devicetree/bindings/pci/v3,v360epc-pci.yaml
new file mode 100644 (file)
index 0000000..38cac88
--- /dev/null
+++ b/Documentation/devicetree/bindings/pci/v3,v360epc-pci.yaml
@@ -0,0 +1,100 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pci/v3,v360epc-pci.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: V3 Semiconductor V360 EPC PCI bridge
+
+maintainers:
+  - Linus Walleij <linus.walleij@linaro.org>
+
+description:
+  This bridge is found in the ARM Integrator/AP (Application Platform)
+
+allOf:
+  - $ref: /schemas/pci/pci-host-bridge.yaml#
+
+properties:
+  compatible:
+    items:
+      - const: arm,integrator-ap-pci
+      - const: v3,v360epc-pci
+
+  reg:
+    items:
+      - description: V3 host bridge controller
+      - description: Configuration space
+
+  clocks:
+    maxItems: 1
+
+  dma-ranges:
+    maxItems: 2
+    description:
+      The inbound ranges must be aligned to a 1MB boundary, and may be 1MB, 2MB,
+      4MB, 8MB, 16MB, 32MB, 64MB, 128MB, 256MB, 512MB, 1GB or 2GB in size. The
+      memory should be marked as pre-fetchable.
+
+  interrupts:
+    description: Bus Error IRQ
+    maxItems: 1
+
+  ranges:
+    description:
+      The non-prefetchable and prefetchable memory windows must each be exactly
+      256MB (0x10000000) in size. The prefetchable memory window must be
+      immediately adjacent to the non-prefetchable memory window.
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - dma-ranges
+  - "#interrupt-cells"
+  - interrupt-map
+  - interrupt-map-mask
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    pci@62000000 {
+        compatible = "arm,integrator-ap-pci", "v3,v360epc-pci";
+        #interrupt-cells = <1>;
+        #size-cells = <2>;
+        #address-cells = <3>;
+        reg = <0x62000000 0x10000>, <0x61000000 0x01000000>;
+        device_type = "pci";
+        interrupt-parent = <&pic>;
+        interrupts = <17>; /* Bus error IRQ */
+        clocks = <&pciclk>;
+        ranges = <0x01000000 0 0x00000000 0x60000000 0 0x01000000>,     /* 16 MiB @ LB 60000000 */
+                 <0x02000000 0 0x40000000 0x40000000 0 0x10000000>,     /* 256 MiB @ LB 40000000 1:1 */
+                 <0x42000000 0 0x50000000 0x50000000 0 0x10000000>;     /* 256 MiB @ LB 50000000 1:1 */
+        dma-ranges = <0x02000000 0 0x20000000 0x20000000 0 0x20000000>, /* EBI: 512 MB @ LB 20000000 1:1 */
+                     <0x02000000 0 0x80000000 0x80000000 0 0x40000000>; /* CM alias: 1GB @ LB 80000000 */
+        interrupt-map-mask = <0xf800 0 0 0x7>;
+        interrupt-map =
+            /* IDSEL 9 */
+            <0x4800 0 0 1 &pic 13>, /* INT A on slot 9 is irq 13 */
+            <0x4800 0 0 2 &pic 14>, /* INT B on slot 9 is irq 14 */
+            <0x4800 0 0 3 &pic 15>, /* INT C on slot 9 is irq 15 */
+            <0x4800 0 0 4 &pic 16>, /* INT D on slot 9 is irq 16 */
+            /* IDSEL 10 */
+            <0x5000 0 0 1 &pic 14>, /* INT A on slot 10 is irq 14 */
+            <0x5000 0 0 2 &pic 15>, /* INT B on slot 10 is irq 15 */
+            <0x5000 0 0 3 &pic 16>, /* INT C on slot 10 is irq 16 */
+            <0x5000 0 0 4 &pic 13>, /* INT D on slot 10 is irq 13 */
+            /* IDSEL 11 */
+            <0x5800 0 0 1 &pic 15>, /* INT A on slot 11 is irq 15 */
+            <0x5800 0 0 2 &pic 16>, /* INT B on slot 11 is irq 16 */
+            <0x5800 0 0 3 &pic 13>, /* INT C on slot 11 is irq 13 */
+            <0x5800 0 0 4 &pic 14>, /* INT D on slot 11 is irq 14 */
+            /* IDSEL 12 */
+            <0x6000 0 0 1 &pic 16>, /* INT A on slot 12 is irq 16 */
+            <0x6000 0 0 2 &pic 13>, /* INT B on slot 12 is irq 13 */
+            <0x6000 0 0 3 &pic 14>, /* INT C on slot 12 is irq 14 */
+            <0x6000 0 0 4 &pic 15>; /* INT D on slot 12 is irq 15 */
+    };
+...

diff --git a/Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt b/Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt
deleted file mode 100644 (file)
index 1106329..0000000
--- a/Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt
+++ /dev/null
@@ -1,76 +0,0 @@
-V3 Semiconductor V360 EPC PCI bridge
-
-This bridge is found in the ARM Integrator/AP (Application Platform)
-
-Required properties:
-- compatible: should be one of:
-  "v3,v360epc-pci"
-  "arm,integrator-ap-pci", "v3,v360epc-pci"
-- reg: should contain two register areas:
-  first the base address of the V3 host bridge controller, 64KB
-  second the configuration area register space, 16MB
-- interrupts: should contain a reference to the V3 error interrupt
-  as routed on the system.
-- bus-range: see pci.txt
-- ranges: this follows the standard PCI bindings in the IEEE Std
-  1275-1994 (see pci.txt) with the following restriction:
-  - The non-prefetchable and prefetchable memory windows must
-    each be exactly 256MB (0x10000000) in size.
-  - The prefetchable memory window must be immediately adjacent
-    to the non-prefetcable memory window
-- dma-ranges: three ranges for the inbound memory region. The ranges must
-  be aligned to a 1MB boundary, and may be 1MB, 2MB, 4MB, 8MB, 16MB, 32MB,
-  64MB, 128MB, 256MB, 512MB, 1GB or 2GB in size. The memory should be marked
-  as pre-fetchable. Two ranges are supported by the hardware.
-
-Integrator-specific required properties:
-- syscon: should contain a link to the syscon device node, since
-  on the Integrator, some registers in the syscon are required to
-  operate the V3 host bridge.
-
-Example:
-
-pci: pciv3@62000000 {
-       compatible = "arm,integrator-ap-pci", "v3,v360epc-pci";
-       #interrupt-cells = <1>;
-       #size-cells = <2>;
-       #address-cells = <3>;
-       reg = <0x62000000 0x10000>, <0x61000000 0x01000000>;
-       interrupt-parent = <&pic>;
-       interrupts = <17>; /* Bus error IRQ */
-       clocks = <&pciclk>;
-       bus-range = <0x00 0xff>;
-       ranges = 0x01000000 0 0x00000000 /* I/O space @00000000 */
-               0x60000000 0 0x01000000 /* 16 MiB @ LB 60000000 */
-               0x02000000 0 0x40000000 /* non-prefectable memory @40000000 */
-               0x40000000 0 0x10000000 /* 256 MiB @ LB 40000000 1:1 */
-               0x42000000 0 0x50000000 /* prefetchable memory @50000000 */
-               0x50000000 0 0x10000000>; /* 256 MiB @ LB 50000000 1:1 */
-       dma-ranges = <0x02000000 0 0x20000000 /* EBI memory space */
-               0x20000000 0 0x20000000 /* 512 MB @ LB 20000000 1:1 */
-               0x02000000 0 0x80000000 /* Core module alias memory */
-               0x80000000 0 0x40000000>; /* 1GB @ LB 80000000 */
-       interrupt-map-mask = <0xf800 0 0 0x7>;
-       interrupt-map = <
-       /* IDSEL 9 */
-       0x4800 0 0 1 &pic 13 /* INT A on slot 9 is irq 13 */
-       0x4800 0 0 2 &pic 14 /* INT B on slot 9 is irq 14 */
-       0x4800 0 0 3 &pic 15 /* INT C on slot 9 is irq 15 */
-       0x4800 0 0 4 &pic 16 /* INT D on slot 9 is irq 16 */
-       /* IDSEL 10 */
-       0x5000 0 0 1 &pic 14 /* INT A on slot 10 is irq 14 */
-       0x5000 0 0 2 &pic 15 /* INT B on slot 10 is irq 15 */
-       0x5000 0 0 3 &pic 16 /* INT C on slot 10 is irq 16 */
-       0x5000 0 0 4 &pic 13 /* INT D on slot 10 is irq 13 */
-       /* IDSEL 11 */
-       0x5800 0 0 1 &pic 15 /* INT A on slot 11 is irq 15 */
-       0x5800 0 0 2 &pic 16 /* INT B on slot 11 is irq 16 */
-       0x5800 0 0 3 &pic 13 /* INT C on slot 11 is irq 13 */
-       0x5800 0 0 4 &pic 14 /* INT D on slot 11 is irq 14 */
-       /* IDSEL 12 */
-       0x6000 0 0 1 &pic 16 /* INT A on slot 12 is irq 16 */
-       0x6000 0 0 2 &pic 13 /* INT B on slot 12 is irq 13 */
-       0x6000 0 0 3 &pic 14 /* INT C on slot 12 is irq 14 */
-       0x6000 0 0 4 &pic 15 /* INT D on slot 12 is irq 15 */
-       >;
-};

diff --git a/MAINTAINERS b/MAINTAINERS
index 9764b87ea3040d2a78bdabcf5dcbe59a11ea3989..c4d000317b848b8e0baeb795e8abdb44c0551b56 100644 (file)
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -18568,7 +18568,7 @@ PCI DRIVER FOR V3 SEMICONDUCTOR V360EPC
 M:     Linus Walleij <linus.walleij@linaro.org>
 L:     linux-pci@vger.kernel.org
 S:     Maintained
-F:     Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt
+F:     Documentation/devicetree/bindings/pci/v3,v360epc-pci.yaml
 F:     drivers/pci/controller/pci-v3-semi.c
 
 PCI DRIVER FOR XILINX VERSAL CPM