dt-bindings: pci: layerscape-pci: Convert to yaml file
Subsystems (4)
Frank Li
maintainerPATCH 1/1 dt-bindings: pci: layerscape-pci: Convert to yaml file
Convert layerscape pcie bind document to yaml file.
--- .../bindings/pci/fsl,layerscape-pcie-ep.yaml | 84 +++++++++ .../bindings/pci/fsl,layerscape-pcie.yaml | 163 ++++++++++++++++++ .../bindings/pci/layerscape-pci.txt | 79 --------- 3 files changed, 247 insertions(+), 79 deletions(-) create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml delete mode 100644 Documentation/devicetree/bindings/pci/layerscape-pci.txt
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +84 -0
@@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie-ep.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+ + This PCIe endpoint controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie-ep.yaml. + + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible: + enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-ep + + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_space + + fsl,pcie-scfg: + $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent: + $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly. + + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify + this property. + +required: + - compatible + - reg + - reg-names + - "#address-cells" + - "#size-cells" + - device_type + - bus-range + - ranges + +allOf: + - $ref: /schemas/pci/snps,dw-pcie-ep.yaml# + + - if: + properties: + compatible: + enum: + - fsl,ls1028a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1088a-pcie-ep + then: + properties: + interrupt-names: + items: + - const: pme + +unevaluatedProperties: false
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +163 -0
163 lines not on this page · raw message
Documentation/devicetree/bindings/pci/layerscape-pci.txt deleted +0 -79
79 lines not on this page · raw message
Signature · 1 line
2.34.1
Hey Frank,
Quoted 20 lines · Frank Li
Convert layerscape pcie bind document to yaml file.
Signed-off-by Frank Li <[email protected]>--- .../bindings/pci/fsl,layerscape-pcie-ep.yaml | 84 +++++++++ .../bindings/pci/fsl,layerscape-pcie.yaml | 163 ++++++++++++++++++ .../bindings/pci/layerscape-pci.txt | 79 --------- 3 files changed, 247 insertions(+), 79 deletions(-) create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml delete mode 100644 Documentation/devicetree/bindings/pci/layerscape-pci.txtDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0@@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 12
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie-ep.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+
Are you sure that you need this chomping operator?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 14
Quoted 3 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ This PCIe endpoint controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie-ep.yaml.
You shouldn't need this statement given you have the ref: below.
Quoted 7 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ information. + +properties: + compatible: + enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-ep
Where did the fallback compatible go?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 39
Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +8
-0+ + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_space
The example uses "regs" and "config". Where did addr_space come from?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 47
Quoted 7 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ fsl,pcie-scfg: + $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent:
dma-coherent: true
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +4
-0+ $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 61
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify + this property. + +required: + - compatible + - reg + - reg-names
This was not previously required, why is it required now?
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ - "#address-cells" + - "#size-cells" + - device_type + - bus-range + - ranges + +allOf: + - $ref: /schemas/pci/snps,dw-pcie-ep.yaml# + + - if: + properties:
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 82
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ compatible: + enum: + - fsl,ls1028a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1088a-pcie-ep + then: + properties: + interrupt-names: + items: + - const: pme
Please define the interrupt properties at the top-level and constrain them on a per-device basis.
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 5
Quoted 13 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ +unevaluatedProperties: falseDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +5
-0@@ -0,0 +1,163 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml#
Only brief comments here, as it most is the same comments as for the
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 14
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +9
-0+ +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+ + This PCIe host controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie.yaml.
Same two comments here as above.
Quoted 31 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +31
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible: + enum: + - fsl,ls1021a-pcie + - fsl,ls2080a-pcie + - fsl,ls2085a-pcie + - fsl,ls2088a-pcie + - fsl,ls1088a-pcie + - fsl,ls1046a-pcie + - fsl,ls1043a-pcie + - fsl,ls1012a-pcie + - fsl,ls1028a-pcie + + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: config + + fsl,pcie-scfg:
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 55
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent: + $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.
Same here.
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +4
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 69
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ this property. + + msi-parent: true + + iommu-map: true + +required: + - compatible + - reg + - reg-names
Same here.
Quoted 49 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +48
-0+ - "#address-cells" + - "#size-cells" + - device_type + - bus-range + - ranges + - interrupts + - interrupt-names + - "#interrupt-cells" + - interrupt-map-mask + - interrupt-map + +allOf: + - $ref: /schemas/pci/pci-bus.yaml# + + - if: + properties: + compatible: + enum: + - fsl,ls1028a-pcie + - fsl,ls1046a-pcie + - fsl,ls1043a-pcie + - fsl,ls1012a-pcie + then: + properties: + interrupts: + maxItems: 2 + interrupt-names: + items: + - const: pme + - const: aer + + - if: + properties: + compatible: + enum: + - fsl,ls2080a-pcie + - fsl,ls2085a-pcie + - fsl,ls2088a-pcie + then: + properties: + interrupts: + maxItems: 1 + interrupt-names: + items: + - const: intr + + - if: + properties:
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 127
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ compatible: + enum: + - fsl,ls1088a-pcie + then: + properties: + interrupts: + maxItems: 1 + interrupt-names: + items: + - const: aer
And same here.
Thanks,
Conor.
Frank Li
maintainerQuoted 53 lines · Conor Dooley
Hey Frank,
Quoted 20 lines · Frank Li
Convert layerscape pcie bind document to yaml file.
Signed-off-by Frank Li <[email protected]>--- .../bindings/pci/fsl,layerscape-pcie-ep.yaml | 84 +++++++++ .../bindings/pci/fsl,layerscape-pcie.yaml | 163 ++++++++++++++++++ .../bindings/pci/layerscape-pci.txt | 79 --------- 3 files changed, 247 insertions(+), 79 deletions(-) create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml delete mode 100644 Documentation/devicetree/bindings/pci/layerscape-pci.txtDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0@@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 12
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie-ep.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+Are you sure that you need this chomping operator?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 14
Quoted 3 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ This PCIe endpoint controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie-ep.yaml.You shouldn't need this statement given you have the ref: below.
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible:
Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 6 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +6
-0+ enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-epWhere did the fallback compatible go?
So far, no fallback compatible needed now. each devices already have its compatible string.
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 39
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +8
-0+ + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?
Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need 'addr_space'.
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 47
Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ fsl,pcie-scfg: + $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent:dma-coherent: true
Quoted 16 lines
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +4
-0+ $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 61
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify + this property. + +required: + - compatible + - reg + - reg-namesThis was not previously required, why is it required now?
Actually its needed.
Quoted 178 lines
Quoted 12 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ - "#address-cells" + - "#size-cells" + - device_type + - bus-range + - ranges + +allOf: + - $ref: /schemas/pci/snps,dw-pcie-ep.yaml# + + - if: + properties:Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 82
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ compatible: + enum: + - fsl,ls1028a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1088a-pcie-ep + then: + properties: + interrupt-names: + items: + - const: pmePlease define the interrupt properties at the top-level and constrain them on a per-device basis.
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 5
Quoted 13 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ +unevaluatedProperties: falseDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +5
-0@@ -0,0 +1,163 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml#Only brief comments here, as it most is the same comments as for the
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 14
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +9
-0+ +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+ + This PCIe host controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie.yaml.Same two comments here as above.
Quoted 31 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +31
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible: + enum: + - fsl,ls1021a-pcie + - fsl,ls2080a-pcie + - fsl,ls2085a-pcie + - fsl,ls2088a-pcie + - fsl,ls1088a-pcie + - fsl,ls1046a-pcie + - fsl,ls1043a-pcie + - fsl,ls1012a-pcie + - fsl,ls1028a-pcie + + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: config + + fsl,pcie-scfg:Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 55
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent: + $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.Same here.
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +4
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specifyDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 69
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ this property. + + msi-parent: true + + iommu-map: true + +required: + - compatible + - reg + - reg-namesSame here.
Quoted 49 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +48
-0+ - "#address-cells" + - "#size-cells" + - device_type + - bus-range + - ranges + - interrupts + - interrupt-names + - "#interrupt-cells" + - interrupt-map-mask + - interrupt-map + +allOf: + - $ref: /schemas/pci/pci-bus.yaml# + + - if: + properties: + compatible: + enum: + - fsl,ls1028a-pcie + - fsl,ls1046a-pcie + - fsl,ls1043a-pcie + - fsl,ls1012a-pcie + then: + properties: + interrupts: + maxItems: 2 + interrupt-names: + items: + - const: pme + - const: aer + + - if: + properties: + compatible: + enum: + - fsl,ls2080a-pcie + - fsl,ls2085a-pcie + - fsl,ls2088a-pcie + then: + properties: + interrupts: + maxItems: 1 + interrupt-names: + items: + - const: intr + + - if: + properties:Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml line 127
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml new file +10
-0+ compatible: + enum: + - fsl,ls1088a-pcie + then: + properties: + interrupts: + maxItems: 1 + interrupt-names: + items: + - const: aerAnd same here.
Thanks,
Conor.
Quoted 63 lines · Frank Li
Quoted 53 lines · Conor Dooley
Hey Frank,
Quoted 20 lines · Frank Li
Convert layerscape pcie bind document to yaml file.
Signed-off-by Frank Li <[email protected]>--- .../bindings/pci/fsl,layerscape-pcie-ep.yaml | 84 +++++++++ .../bindings/pci/fsl,layerscape-pcie.yaml | 163 ++++++++++++++++++ .../bindings/pci/layerscape-pci.txt | 79 --------- 3 files changed, 247 insertions(+), 79 deletions(-) create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml delete mode 100644 Documentation/devicetree/bindings/pci/layerscape-pci.txtDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0@@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 12
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie-ep.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+Are you sure that you need this chomping operator?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 14
Quoted 3 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ This PCIe endpoint controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie-ep.yaml.You shouldn't need this statement given you have the ref: below.
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible:Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 6 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +6
-0+ enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-epWhere did the fallback compatible go?
Quoted 2 lines
So far, no fallback compatible needed now. each devices already have its compatible string.
It used to exist though, have you checked that u-boot or *bsd etc do not use the fallback compatible? You also need to mention your justification for removing it in the commit message.
Quoted 11 lines
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 39
Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +8
-0+ + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?
Quoted 2 lines
Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.
Okay. Again, please mention where this is coming from.
Quoted 29 lines
Quoted 12 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 47
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ fsl,pcie-scfg: + $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent:dma-coherent: true
Quoted 16 lines
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +4
-0+ $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 61
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify + this property. + +required: + - compatible + - reg + - reg-namesThis was not previously required, why is it required now?
Quoted 1 line
Actually its needed.
Well, if it wasn't, I'd hope that you wouldn't be making it required. But I asked /why/ and you've not given a reason. Please mention the why in your commit message for v2.
Cheers,
Conor.
Frank Li
maintainerQuoted 64 lines · Conor Dooley
Quoted 63 lines · Frank Li
Quoted 61 lines · Conor Dooley
Hey Frank,
Quoted 20 lines · Frank Li
Convert layerscape pcie bind document to yaml file.
Signed-off-by Frank Li <[email protected]>--- .../bindings/pci/fsl,layerscape-pcie-ep.yaml | 84 +++++++++ .../bindings/pci/fsl,layerscape-pcie.yaml | 163 ++++++++++++++++++ .../bindings/pci/layerscape-pci.txt | 79 --------- 3 files changed, 247 insertions(+), 79 deletions(-) create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml create mode 100644 Documentation/devicetree/bindings/pci/fsl,layerscape-pcie.yaml delete mode 100644 Documentation/devicetree/bindings/pci/layerscape-pci.txtDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0@@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 12
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+--- +$id: http://devicetree.org/schemas/pci/fsl,layerscape-pcie-ep.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Layerscape PCIe controller + +maintainers: + - Frank Li <[email protected]> + +description: |+Are you sure that you need this chomping operator?
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 14
Quoted 3 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +2
-0+ This PCIe endpoint controller is based on the Synopsys DesignWare PCIe IP + and thus inherits all the common properties defined in snps,dw-pcie-ep.yaml.You shouldn't need this statement given you have the ref: below.
Quoted 7 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller versionDocumentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ information. + +properties: + compatible: + enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-epWhere did the fallback compatible go?
Quoted 6 lines
Quoted 2 lines
So far, no fallback compatible needed now. each devices already have its compatible string.
It used to exist though, have you checked that u-boot or *bsd etc do not use the fallback compatible? You also need to mention your justification for removing it in the commit message.
This commit just convert binding doc from txt to yaml. I just make sure which equal to what descript in txt. If there are someting wrong in "uboot" or "bsd", we can fixed it later. I checked driver code. exited dts tree under kernel, which use unexited fallback compatible string "fsl, lx-pcie-ep", which should be removed at dts file.
Quoted 12 lines
Quoted 12 lines
Quoted 11 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 39
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +8
-0+ + reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?
Quoted 4 lines
Quoted 2 lines
Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
I think it will be deleted soon.
Quoted 30 lines
Quoted 30 lines
Quoted 29 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 47
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ fsl,pcie-scfg: + $ref: /schemas/types.yaml#/definitions/phandle + description: A phandle to the SCFG device node. The second entry is the + physical PCIe controller index starting from '0'. This is used to get + SCFG PEXN registers. + + dma-coherent:dma-coherent: true
Quoted 4 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +4
-0+ $ref: /schemas/types.yaml#/definitions/flag + description: Indicates that the hardware IP block can ensure the coherency + of the data transferred from/to the IP block. This can avoid the software + cache flush/invalid actions, and improve the performance significantly.Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 61
Quoted 10 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +10
-0+ + big-endian: + $ref: /schemas/types.yaml#/definitions/flag + description: If the PEX_LUT and PF register block is in big-endian, specify + this property. + +required: + - compatible + - reg + - reg-namesThis was not previously required, why is it required now?
Quoted 5 lines
Quoted 1 line
Actually its needed.
Well, if it wasn't, I'd hope that you wouldn't be making it required. But I asked /why/ and you've not given a reason. Please mention the why in your commit message for v2.
Sorry, I just sent v2 before see this. According to driver code, it is needed. Please check v2, I will update at v3.
Quoted 4 lines
Cheers,
Conor.
Quoted 28 lines · Frank Li
Quoted 27 lines · Conor Dooley
Quoted 25 lines · Frank Li
Quoted 13 lines · Conor Dooley
Quoted 11 lines · Frank Li
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible:Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 6 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +6
-0+ enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-epWhere did the fallback compatible go?
So far, no fallback compatible needed now. each devices already have its compatible string.
Quoted 6 lines
Quoted 3 lines
It used to exist though, have you checked that u-boot or *bsd etc do not use the fallback compatible? You also need to mention your justification for removing it in the commit message.
This commit just convert binding doc from txt to yaml. I just make sure which equal to what descript in txt.
The text binding does have a fallback compatible though:
EP mode:
"fsl,ls1028a-pcie-ep", "fsl,ls-pcie-ep"
So this is a change compared to the text binding, without any justification for it being okay to do.
Quoted 2 lines
If there are someting wrong in "uboot"
or "bsd", we can fixed it later.
If other bits of software are using the fallback, you cannot remove it.
Quoted 3 lines
I checked driver code. exited dts tree
under kernel, which use unexited fallback compatible string "fsl, lx-pcie-ep", which should be removed at dts file.
What do you mean by "unexisted"? It was in the text binding, so it is perfectly fine to have it in the dts. Given it has users, I don't think you should be removing the fallback without a very good justification.
Quoted 13 lines
Quoted 13 lines
Quoted 12 lines
Quoted 9 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 39
Quoted 7 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.
Quoted 7 lines
Quoted 1 line
Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
I think it will be deleted soon.
What I am looking for here is you to explain in the commit message that the endpoint driver in linux and the dts have always used "addr_space". Checking that there's not a u-boot or *bsd that uses "config" would also be very helpful.
Thanks,
Conor.
Frank Li
maintainerQuoted 33 lines · Conor Dooley
Quoted 32 lines · Frank Li
Quoted 30 lines · Conor Dooley
Quoted 23 lines · Frank Li
Quoted 13 lines · Conor Dooley
Quoted 11 lines · Frank Li
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +11
-0+ + This controller derives its clocks from the Reset Configuration Word (RCW) + which is used to describe the PLL settings at the time of chip-reset. + + Also as per the available Reference Manuals, there is no specific 'version' + register available in the Freescale PCIe controller register set, + which can allow determining the underlying DesignWare PCIe controller version + information. + +properties: + compatible:Quoted 8 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml line 31
Quoted 6 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +6
-0+ enum: + - fsl,ls2088a-pcie-ep + - fsl,ls1088a-pcie-ep + - fsl,ls1046a-pcie-ep + - fsl,ls1028a-pcie-ep + - fsl,lx2160ar2-pcie-epWhere did the fallback compatible go?
Quoted 2 lines
So far, no fallback compatible needed now. each devices already have its compatible string.
It used to exist though, have you checked that u-boot or *bsd etc do not use the fallback compatible? You also need to mention your justification for removing it in the commit message.
Quoted 8 lines
Quoted 2 lines
This commit just convert binding doc from txt to yaml. I just make sure which equal to what descript in txt.
The text binding does have a fallback compatible though:
EP mode:"fsl,ls1028a-pcie-ep", "fsl,ls-pcie-ep"So this is a change compared to the text binding, without any justification for it being okay to do.
Okay, I see what your concern. I think old txt is wrong. Or try to work as it, but actually not.
Quoted 6 lines
Quoted 3 lines
If there are someting wrong in "uboot"
or "bsd", we can fixed it later.If other bits of software are using the fallback, you cannot remove it.
Quoted 8 lines
Quoted 3 lines
I checked driver code. exited dts tree
under kernel, which use unexited fallback compatible string "fsl, lx-pcie-ep", which should be removed at dts file.What do you mean by "unexisted"? It was in the text binding, so it is perfectly fine to have it in the dts. Given it has users, I don't think you should be removing the fallback without a very good justification.
No driver parse "fsl,lx-pcie-ep". I can keep it as equal as old txt file and remove later if need.
Quoted 19 lines
Quoted 19 lines
Quoted 8 lines
Quoted 8 lines
Quoted 8 lines
Quoted 7 lines
Documentation/devicetree/bindings/pci/fsl,layerscape-pcie-ep.yaml new file +7
-0+ reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceQuoted 6 lines
Quoted 4 lines
Quoted 1 line
The example uses "regs" and "config". Where did
addr_spacecome from?Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
Quoted 6 lines
Quoted 1 line
I think it will be deleted soon.
What I am looking for here is you to explain in the commit message that the endpoint driver in linux and the dts have always used "
addr_space". Checking that there's not a u-boot or *bsd that uses "config" would also be very helpful.
I confused. Actually this two part PCIE-RC and PCIE-EP. PCIE-RC using 'config'
PCIE-EP using 'addr_spcae'
I check old txt file, which have not mention it. I can remove it.
Frank
Quoted 4 lines
Thanks,
Conor.
Quoted 21 lines · Frank Li
Quoted 21 lines
Quoted 20 lines
Quoted 8 lines
Quoted 8 lines
Quoted 8 lines
Quoted 7 lines
(quoted diff) +7
-0+ reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceQuoted 6 lines
Quoted 4 lines
Quoted 1 line
The example uses "regs" and "config". Where did
addr_spacecome from?Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
I think it will be deleted soon.
Quoted 8 lines
Quoted 4 lines
What I am looking for here is you to explain in the commit message that the endpoint driver in linux and the dts have always used "
addr_space". Checking that there's not a u-boot or *bsd that uses "config" would also be very helpful.I confused. Actually this two part PCIE-RC and PCIE-EP. PCIE-RC using 'config'
PCIE-EP using 'addr_spcae'
Yeah, I get this. The text binding makes it seem like "config" should be used for both RC and EP, so I am just asking you to check that there are no drivers in other kernels or bootloaders that use "config" for EP mode.
Quoted 1 line
I check old txt file, which have not mention it. I can remove it.
if you drop "addr_space", you'll need to update the endpoint driver so that it supports both "addr_space" and "config". If there are no endpoint drivers using "config" in other operating systems, and all the dts files use "addr_space", documenting "reg" and "addr_space" for endpoint mode seems fair to me.
Thanks,
Conor.
Frank Li
maintainerQuoted 28 lines · Conor Dooley
Quoted 26 lines · Frank Li
Quoted 25 lines
Quoted 13 lines
Quoted 13 lines
Quoted 12 lines
Quoted 9 lines
Review
Quoted 7 lines
(quoted diff) +7
-0+ reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.Quoted 7 lines
Quoted 1 line
Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
I think it will be deleted soon.
What I am looking for here is you to explain in the commit message that the endpoint driver in linux and the dts have always used "
addr_space". Checking that there's not a u-boot or *bsd that uses "config" would also be very helpful.
Quoted 8 lines
Quoted 3 lines
I confused. Actually this two part PCIE-RC and PCIE-EP. PCIE-RC using 'config'
PCIE-EP using 'addr_spcae'Yeah, I get this. The text binding makes it seem like "config" should be used for both RC and EP, so I am just asking you to check that there are no drivers in other kernels or bootloaders that use "config" for EP mode.
There are not 'config' concept for EP mode. Only RC mode have 'config' space concept to get PCIe device's config space. EP mode only have "add_space" for outbound windows. If other place using "config" for EP, it is totally wrong, they should fix it.
Quoted 8 lines
Quoted 2 lines
I check old txt file, which have not mention it. I can remove it.
if you drop "
addr_space", you'll need to update the endpoint driver so that it supports both "addr_space" and "config". If there are no endpoint drivers using "config" in other operating systems, and all the dts files use "addr_space", documenting "reg" and "addr_space" for endpoint mode seems fair to me.
It is up to how to create patches. "addr_space" needs. If you want me to create one version, which 100% match original txt. I can do that. Then create increment patch to fix the problem.
If want to create a basic work version like this, which included some minus fixes.
The both method is fine for me. Second method just need more efforts.
Frank
Quoted 3 lines
Thanks,
Conor.
Quoted 38 lines · Frank Li
Quoted 28 lines · Conor Dooley
Quoted 26 lines · Frank Li
Quoted 25 lines
Quoted 13 lines
Quoted 13 lines
Quoted 12 lines
Quoted 9 lines
Review
Quoted 7 lines
(quoted diff) +7
-0+ reg: + maxItems: 2 + + reg-names: + items: + - const: regs + - const: addr_spaceThe example uses "regs" and "config". Where did
addr_spacecome from?Example just show pcie-host part. Not show pcie-ep part. pcie-ep part need '
addr_space'.Quoted 7 lines
Quoted 1 line
Okay. Again, please mention where this is coming from.
Ideally it comes from snsp,dwc-pcie-ep.yaml. but it is use 'dbi' instead of 'regs'. It needs extra effort to make driver code algin common snps,dwc-pcie-ep.yaml, and update exist all dts files.
I think it will be deleted soon.
What I am looking for here is you to explain in the commit message that the endpoint driver in linux and the dts have always used "
addr_space". Checking that there's not a u-boot or *bsd that uses "config" would also be very helpful.Quoted 8 lines
Quoted 3 lines
I confused. Actually this two part PCIE-RC and PCIE-EP. PCIE-RC using 'config'
PCIE-EP using 'addr_spcae'Yeah, I get this. The text binding makes it seem like "config" should be used for both RC and EP, so I am just asking you to check that there are no drivers in other kernels or bootloaders that use "config" for EP mode.
Quoted 4 lines
There are not 'config' concept for EP mode. Only RC mode have 'config' space concept to get PCIe device's config space. EP mode only have "
add_space" for outbound windows. If other place using "config" for EP, it is totally wrong, they should fix it.
It might be a totally wrong concept, but it is what the binding said, so they are within their rights to use that name.
Quoted 10 lines
Quoted 9 lines
Quoted 3 lines
I check old txt file, which have not mention it. I can remove it.
if you drop "
addr_space", you'll need to update the endpoint driver so that it supports both "addr_space" and "config". If there are no endpoint drivers using "config" in other operating systems, and all the dts files use "addr_space", documenting "reg" and "addr_space" for endpoint mode seems fair to me.
Quoted 8 lines
It is up to how to create patches. "
addr_space" needs. If you want me to create one version, which 100% match original txt. I can do that. Then create increment patch to fix the problem.If want to create a basic work version like this, which included some minus fixes.
The both method is fine for me. Second method just need more efforts.
I don't have a problem with you making it "addr_space" as long as you check to make sure that there are no users of "config" outside the kernel and you mention in the commit message that this is a difference from the text binding (and why).
Thanks,
Conor.