Commit f6b5ad2c authored by Rob Herring (Arm)'s avatar Rob Herring (Arm) Committed by Bjorn Helgaas
Browse files

dt-bindings: PCI: Convert apm,xgene-pcie to DT schema 



Convert the Applied Micro X-Gene PCIe binding to DT schema format. It's
a straight forward conversion.

Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
Signed-off-by: default avatarManivannan Sadhasivam <mani@kernel.org>
Signed-off-by: default avatarBjorn Helgaas <bhelgaas@google.com>
Link: https://patch.msgid.link/20250710180749.2970379-1-robh@kernel.org
parent 5c2796ad

Documentation/devicetree/bindings/pci/apm,xgene-pcie.yaml

0 → 100644
+84 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/pci/apm,xgene-pcie.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: AppliedMicro X-Gene PCIe interface



maintainers:

  - Toan Le <toan@os.amperecomputing.com>



allOf:

  - $ref: /schemas/pci/pci-host-bridge.yaml#



properties:

  compatible:

    oneOf:

      - items:

          - const: apm,xgene-storm-pcie

          - const: apm,xgene-pcie

      - items:

          - const: apm,xgene-pcie



  reg:

    items:

      - description: Controller configuration registers

      - description: PCI configuration space registers



  reg-names:

    items:

      - const: csr

      - const: cfg



  clocks:

    maxItems: 1



  clock-names:

    items:

      - const: pcie



  dma-coherent: true



  msi-parent:

    maxItems: 1



required:

  - compatible

  - reg

  - reg-names

  - '#interrupt-cells'

  - interrupt-map-mask

  - interrupt-map

  - clocks



unevaluatedProperties: false



examples:

  - |

    bus {

        #address-cells = <2>;

        #size-cells = <2>;



        pcie@1f2b0000 {

            compatible = "apm,xgene-storm-pcie", "apm,xgene-pcie";

            device_type = "pci";

            #interrupt-cells = <1>;

            #size-cells = <2>;

            #address-cells = <3>;

            reg = <0x00 0x1f2b0000 0x0 0x00010000>, /* Controller registers */

                  <0xe0 0xd0000000 0x0 0x00040000>; /* PCI config space */

            reg-names = "csr", "cfg";

            ranges = <0x01000000 0x00 0x00000000 0xe0 0x10000000 0x00 0x00010000>, /* io */

                    <0x02000000 0x00 0x80000000 0xe1 0x80000000 0x00 0x80000000>; /* mem */

            dma-ranges = <0x42000000 0x80 0x00000000 0x80 0x00000000 0x00 0x80000000>,

                        <0x42000000 0x00 0x00000000 0x00 0x00000000 0x80 0x00000000>;

            interrupt-map-mask = <0x0 0x0 0x0 0x7>;

            interrupt-map = <0x0 0x0 0x0 0x1 &gic 0x0 0xc2 0x1>,

                            <0x0 0x0 0x0 0x2 &gic 0x0 0xc3 0x1>,

                            <0x0 0x0 0x0 0x3 &gic 0x0 0xc4 0x1>,

                            <0x0 0x0 0x0 0x4 &gic 0x0 0xc5 0x1>;

            dma-coherent;

            clocks = <&pcie0clk 0>;

        };

    };

Documentation/devicetree/bindings/pci/xgene-pci.txt

deleted100644 → 0
+0 −50
Original line number Diff line number Diff line 
* AppliedMicro X-Gene PCIe interface



Required properties:

- device_type: set to "pci"

- compatible: should contain "apm,xgene-pcie" to identify the core.

- reg: A list of physical base address and length for each set of controller

       registers. Must contain an entry for each entry in the reg-names

       property.

- reg-names: Must include the following entries:

  "csr": controller configuration registers.

  "cfg": PCIe configuration space registers.

- #address-cells: set to <3>

- #size-cells: set to <2>

- ranges: ranges for the outbound memory, I/O regions.

- dma-ranges: ranges for the inbound memory regions.

- #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: handle to pci clock.



Optional properties:

- status: Either "ok" or "disabled".

- dma-coherent: Present if DMA operations are coherent



Example:



	pcie0: pcie@1f2b0000 {

		status = "disabled";

		device_type = "pci";

		compatible = "apm,xgene-storm-pcie", "apm,xgene-pcie";

		#interrupt-cells = <1>;

		#size-cells = <2>;

		#address-cells = <3>;

		reg = < 0x00 0x1f2b0000 0x0 0x00010000   /* Controller registers */

			0xe0 0xd0000000 0x0 0x00040000>; /* PCI config space */

		reg-names = "csr", "cfg";

		ranges = <0x01000000 0x00 0x00000000 0xe0 0x10000000 0x00 0x00010000   /* io */

			  0x02000000 0x00 0x80000000 0xe1 0x80000000 0x00 0x80000000>; /* mem */

		dma-ranges = <0x42000000 0x80 0x00000000 0x80 0x00000000 0x00 0x80000000

			      0x42000000 0x00 0x00000000 0x00 0x00000000 0x80 0x00000000>;

		interrupt-map-mask = <0x0 0x0 0x0 0x7>;

		interrupt-map = <0x0 0x0 0x0 0x1 &gic 0x0 0xc2 0x1

				 0x0 0x0 0x0 0x2 &gic 0x0 0xc3 0x1

				 0x0 0x0 0x0 0x3 &gic 0x0 0xc4 0x1

				 0x0 0x0 0x0 0x4 &gic 0x0 0xc5 0x1>;

		dma-coherent;

		clocks = <&pcie0clk 0>;

	};

MAINTAINERS

+1 −1
Original line number Diff line number Diff line
@@ -18913,7 +18913,7 @@ M: Toan Le <toan@os.amperecomputing.com> 
L:	linux-pci@vger.kernel.org

L:	linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)

S:	Maintained

F:	Documentation/devicetree/bindings/pci/xgene-pci.txt

F:	Documentation/devicetree/bindings/pci/apm,xgene-pcie.yaml

F:	drivers/pci/controller/pci-xgene.c









PCI DRIVER FOR ARM VERSATILE PLATFORM